Package net.citizensnpcs.api.persistence

Class PersistenceLoader

java.lang.Object

net.citizensnpcs.api.persistence.PersistenceLoader

public class PersistenceLoader
extends Object

Performs reflective persistence of objects into DataKeys. Persist annotations are used to mark fields for annotation.

See Also:

• Persist

Constructor Summary

Constructors

Constructor	Description
PersistenceLoader()

Method Summary

Modifier and Type	Method	Description
static <T> PersisterRegistry<T>	createRegistry(Class<?> base)
static <T> T	load(Class<? extends T> clazz, DataKey root)	Creates an instance of the given class using the default constructor and loads it using load(Object, DataKey).
static <T> T	load(T instance, DataKey root)	Analyses the class for Fields with the Persist annotation and loads data into them using the given DataKey.
static void	registerPersistDelegate(Class<?> clazz, Class<? extends Persister<?>> delegateClass)	Registers a Persister redirect.
static void	save(Object instance, DataKey root)	Scans the object for fields annotated with Persist and saves them to the given DataKey.

Methods inherited from class java.lang.Object

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

Constructor Details

PersistenceLoader

public PersistenceLoader()

Method Details

createRegistry

public static <T> PersisterRegistry<T> createRegistry(Class<?> base)

load

public static <T> T load(Class<? extends T> clazz,
 DataKey root)

Creates an instance of the given class using the default constructor and loads it using load(Object, DataKey). Will return null if an exception occurs.

Parameters:

clazz - The class to create an instance from

root - The root key to load from

Returns:

The loaded instance

See Also:

• load(Object, DataKey)

load

public static <T> T load(T instance,
 DataKey root)

Analyses the class for Fields with the Persist annotation and loads data into them using the given DataKey. If a DelegatePersistence annotation is provided the referenced Persister will be used to create the instance. This annotation can be omitted if the Persister has been registered using registerPersistDelegate(Class, Class)

Parameters:

instance - The instance to load data into

root - The key to load data from

Returns:

The instance, with persisted fields loaded

registerPersistDelegate

public static void registerPersistDelegate(Class<?> clazz,
 Class<? extends Persister<?>> delegateClass)

Registers a Persister redirect. Fields or constructors with the Persist annotation with a type that has been registered using this method will use the supplied Persister for (de)serialisation. The DelegatePersistence annotation will be preferred if present.

Parameters:

clazz - The class to redirect

delegateClass - The Persister class to use when loading and saving

save

public static void save(Object instance,
 DataKey root)

Scans the object for fields annotated with Persist and saves them to the given DataKey.

Parameters:

instance - The instance to save

root - The key to save into