org.bukkit.configuration.serialization

Class ConfigurationSerialization

java.lang.Object

org.bukkit.configuration.serialization.ConfigurationSerialization

public class ConfigurationSerialization
extends Object

Utility class for storing and retrieving classes for Configuration.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERIALIZED_TYPE_KEY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConfigurationSerialization(@NotNull Class<? extends ConfigurationSerializable> clazz)

Method Summary

Modifier and Type	Method and Description
@Nullable ConfigurationSerializable	deserialize(@NotNull Map<String,?> args)
static @Nullable ConfigurationSerializable	deserializeObject(@NotNull Map<String,?> args) Attempts to deserialize the given arguments into a new instance of the given class.
static @Nullable ConfigurationSerializable	deserializeObject(@NotNull Map<String,?> args, @NotNull Class<? extends ConfigurationSerializable> clazz) Attempts to deserialize the given arguments into a new instance of the given class.
protected @Nullable ConfigurationSerializable	deserializeViaCtor(@NotNull Constructor<? extends ConfigurationSerializable> ctor, @NotNull Map<String,?> args)
protected @Nullable ConfigurationSerializable	deserializeViaMethod(@NotNull Method method, @NotNull Map<String,?> args)
static @NotNull String	getAlias(@NotNull Class<? extends ConfigurationSerializable> clazz) Gets the correct alias for the given ConfigurationSerializable class
static @Nullable Class<? extends ConfigurationSerializable>	getClassByAlias(@NotNull String alias) Attempts to get a registered ConfigurationSerializable class by its alias
protected @Nullable Constructor<? extends ConfigurationSerializable>	getConstructor()
protected @Nullable Method	getMethod(@NotNull String name, boolean isStatic)
static void	registerClass(@NotNull Class<? extends ConfigurationSerializable> clazz) Registers the given ConfigurationSerializable class by its alias
static void	registerClass(@NotNull Class<? extends ConfigurationSerializable> clazz, @NotNull String alias) Registers the given alias to the specified ConfigurationSerializable class
static void	unregisterClass(@NotNull Class<? extends ConfigurationSerializable> clazz) Unregisters any aliases for the specified ConfigurationSerializable class
static void	unregisterClass(@NotNull String alias) Unregisters the specified alias to a ConfigurationSerializable

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERIALIZED_TYPE_KEY

public static final String SERIALIZED_TYPE_KEY

See Also:

Constant Field Values

Constructor Detail

ConfigurationSerialization

protected ConfigurationSerialization(@NotNull
                                     @NotNull Class<? extends ConfigurationSerializable> clazz)

Method Detail

getMethod

@Nullable
protected @Nullable Method getMethod(@NotNull
                                               @NotNull String name,
                                               boolean isStatic)

getConstructor

@Nullable
protected @Nullable Constructor<? extends ConfigurationSerializable> getConstructor()

deserializeViaMethod

@Nullable
protected @Nullable ConfigurationSerializable deserializeViaMethod(@NotNull
                                                                             @NotNull Method method,
                                                                             @NotNull
                                                                             @NotNull Map<String,?> args)

deserializeViaCtor

@Nullable
protected @Nullable ConfigurationSerializable deserializeViaCtor(@NotNull
                                                                           @NotNull Constructor<? extends ConfigurationSerializable> ctor,
                                                                           @NotNull
                                                                           @NotNull Map<String,?> args)

deserialize

@Nullable
public @Nullable ConfigurationSerializable deserialize(@NotNull
                                                                 @NotNull Map<String,?> args)

deserializeObject

@Nullable
public static @Nullable ConfigurationSerializable deserializeObject(@NotNull
                                                                              @NotNull Map<String,?> args,
                                                                              @NotNull
                                                                              @NotNull Class<? extends ConfigurationSerializable> clazz)

Attempts to deserialize the given arguments into a new instance of the given class.

The class must implement ConfigurationSerializable, including the extra methods as specified in the javadoc of ConfigurationSerializable.

If a new instance could not be made, an example being the class not fully implementing the interface, null will be returned.

Parameters:

args - Arguments for deserialization

clazz - Class to deserialize into

Returns:

New instance of the specified class

deserializeObject

@Nullable
public static @Nullable ConfigurationSerializable deserializeObject(@NotNull
                                                                              @NotNull Map<String,?> args)

Attempts to deserialize the given arguments into a new instance of the given class.

The class must implement ConfigurationSerializable, including the extra methods as specified in the javadoc of ConfigurationSerializable.

If a new instance could not be made, an example being the class not fully implementing the interface, null will be returned.

Parameters:

args - Arguments for deserialization

Returns:

New instance of the specified class

registerClass

public static void registerClass(@NotNull
                                 @NotNull Class<? extends ConfigurationSerializable> clazz)

Registers the given ConfigurationSerializable class by its alias

Parameters:

clazz - Class to register

registerClass

public static void registerClass(@NotNull
                                 @NotNull Class<? extends ConfigurationSerializable> clazz,
                                 @NotNull
                                 @NotNull String alias)

Registers the given alias to the specified ConfigurationSerializable class

Parameters:

clazz - Class to register

alias - Alias to register as

See Also:

SerializableAs

unregisterClass

public static void unregisterClass(@NotNull
                                   @NotNull String alias)

Unregisters the specified alias to a ConfigurationSerializable

Parameters:

alias - Alias to unregister

unregisterClass

public static void unregisterClass(@NotNull
                                   @NotNull Class<? extends ConfigurationSerializable> clazz)

Unregisters any aliases for the specified ConfigurationSerializable class

Parameters:

clazz - Class to unregister

getClassByAlias

@Nullable
public static @Nullable Class<? extends ConfigurationSerializable> getClassByAlias(@NotNull
                                                                                             @NotNull String alias)

Attempts to get a registered ConfigurationSerializable class by its alias

Parameters:

alias - Alias of the serializable

Returns:

Registered class, or null if not found

getAlias

@NotNull
public static @NotNull String getAlias(@NotNull
                                                @NotNull Class<? extends ConfigurationSerializable> clazz)

Gets the correct alias for the given ConfigurationSerializable class

Parameters:

clazz - Class to get alias for

Returns:

Alias to use for the class