sirius.db.jdbc

Class SQLEntityRef<E extends SQLEntity>

java.lang.Object

sirius.db.mixing.types.BaseEntityRef<Long,E>

sirius.db.jdbc.SQLEntityRef<E>

Type Parameters:

E - the generic type of the referenced entity

public class SQLEntityRef<E extends SQLEntity>
extends BaseEntityRef<Long,E>

Represents a reference from one entity to another.

Instead of directly keeping the entity in a Java field, it is wrapped in an EntityRef. This leads to clean semantics for lazy loading as both the ID and (if fetched) the value are stored in this wrapper.

Nested Class Summary

Nested classes/interfaces inherited from class sirius.db.mixing.types.BaseEntityRef

BaseEntityRef.OnDelete

Field Summary

Fields inherited from class sirius.db.mixing.types.BaseEntityRef

deleteHandler, id, type, value

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SQLEntityRef(Class<E> type, BaseEntityRef.OnDelete deleteHandler)

Method Summary

Modifier and Type	Method and Description
protected Long	coerceToId(Object id) Converts the given object into an id.
protected Optional<E>	find(Class<E> type, Long id) Performs the lookup of the entity with the given id.
static <E extends SQLEntity> SQLEntityRef<E>	on(Class<E> type, BaseEntityRef.OnDelete deleteHandler) Generates an entity reference to the given entity type.

Methods inherited from class sirius.db.mixing.types.BaseEntityRef

containsNonpersistentValue, getDeleteHandler, getId, getType, getUniqueObjectName, getValue, is, isEmpty, isFilled, isValueLoaded, setId, setValue

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLEntityRef

protected SQLEntityRef(Class<E> type,
                       BaseEntityRef.OnDelete deleteHandler)

Method Detail

on

public static <E extends SQLEntity> SQLEntityRef<E> on(Class<E> type,
                                                       BaseEntityRef.OnDelete deleteHandler)

Generates an entity reference to the given entity type.

Type Parameters:

E - the generic type of the referenced entity

Parameters:

type - the target type to reference

deleteHandler - determines what happens if the referenced entity is deleted

Returns:

a new entity ref, representing the given settings

find

protected Optional<E> find(Class<E> type,
                           Long id)

Description copied from class: BaseEntityRef

Performs the lookup of the entity with the given id.

Specified by:

find in class BaseEntityRef<Long,E extends SQLEntity>

Parameters:

type - the type to search for

id - the id to lookup

Returns:

the matching entity wrapped as optional or an empty optional of the entity doesn't exist

coerceToId

protected Long coerceToId(Object id)

Description copied from class: BaseEntityRef

Converts the given object into an id.

Specified by:

coerceToId in class BaseEntityRef<Long,E extends SQLEntity>

Parameters:

id - the value to coerce

Returns:

the value represented in the correct type