Package org.bukkit

Class NamespacedKey

java.lang.Object

org.bukkit.NamespacedKey

public final class NamespacedKey
extends java.lang.Object

Represents a String based key which consists of two components - a namespace and a key. Namespaces may only contain lowercase alphanumeric characters, periods, underscores, and hyphens.

Keys may only contain lowercase alphanumeric characters, periods, underscores, hyphens, and forward slashes.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	BUKKIT	The namespace representing all keys generated by Bukkit for backwards compatibility measures.
static java.lang.String	MINECRAFT	The namespace representing all inbuilt keys.

Constructor Summary

Constructors

Constructor	Description
NamespacedKey(java.lang.String namespace, java.lang.String key)	Deprecated. should never be used by plugins, for internal use only!!
NamespacedKey(Plugin plugin, java.lang.String key)	Create a key in the plugin's namespace.

Method Summary

Modifier and Type	Method	Description
boolean	equals(java.lang.Object obj)
java.lang.String	getKey()
java.lang.String	getNamespace()
int	hashCode()
static NamespacedKey	minecraft(java.lang.String key)	Get a key in the Minecraft namespace.
static NamespacedKey	randomKey()	Deprecated. should never be used by plugins, for internal use only!!
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MINECRAFT

public static final java.lang.String MINECRAFT

The namespace representing all inbuilt keys.

See Also:

Constant Field Values

BUKKIT

public static final java.lang.String BUKKIT

The namespace representing all keys generated by Bukkit for backwards compatibility measures.

See Also:

Constant Field Values

Constructor Detail

NamespacedKey

@Deprecated
public NamespacedKey(java.lang.String namespace,
                     java.lang.String key)

Deprecated.

should never be used by plugins, for internal use only!!

Create a key in a specific namespace.

Parameters:

namespace -

key -

NamespacedKey

public NamespacedKey(Plugin plugin,
                     java.lang.String key)

Create a key in the plugin's namespace.

Namespaces may only contain lowercase alphanumeric characters, periods, underscores, and hyphens.

Keys may only contain lowercase alphanumeric characters, periods, underscores, hyphens, and forward slashes.

Parameters:

plugin - the plugin to use for the namespace

key - the key to create

Method Detail

getNamespace

public java.lang.String getNamespace()

getKey

public java.lang.String getKey()

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

randomKey

@Deprecated
public static NamespacedKey randomKey()

Deprecated.

should never be used by plugins, for internal use only!!

Return a new random key in the BUKKIT namespace.

Returns:

new key

minecraft

public static NamespacedKey minecraft(java.lang.String key)

Get a key in the Minecraft namespace.

Parameters:

key - the key to use

Returns:

new key in the Minecraft namespace