org.nuiton.topia.persistence

Interface TopiaEntityEnum

All Superinterfaces:

Serializable

public interface TopiaEntityEnum
extends Serializable

This contract represents a generated entity. It provides some information about the classes for any entity managed by the dao helper. More precisely :

• - contract class of the entity (this must be an interface class)
• - the implementation FQN class of an entity (at generation time, we might not have the implementation class)
• - the implementation class (will be looked up at runtime, in that way we make possible to used a different implementation at runtime.
• - a method to accept any TopiaEntity class for this entity description

For each entity of the model, a realisation of this contract is generated in an enum named XxxEntityEnum (where Xxx is the name of your project).

Since:

2.2.0

Author:

Tony Chemit - chemit@codelutin.com

Method Summary

Modifier and Type	Method and Description
boolean	accept(Class<? extends TopiaEntity> klass) Test if a given type of entity is matching the contract of this entity.
String	dbSchemaName()
String	dbTableName()
Class<? extends TopiaEntity>	getContract()
Class<? extends TopiaEntity>	getImplementation() Note : this is a lazy accessor.
String	getImplementationFQN()
String[]	getNaturalIds()
String[]	getNotNulls()
boolean	isUseNaturalIds()
boolean	isUseNotNulls()
String	name() This is a convenient method, as entity enum offers this method from Enum.name().
void	setImplementationFQN(String implementationFQN) Change the implementation class of the entity.

Method Detail

name

String name()

This is a convenient method, as entity enum offers this method from Enum.name().

Returns:

the name of the underlying entity type.

Since:

2.6.12

dbSchemaName

String dbSchemaName()

Returns:

the name of database schema (null if none was filled).

Since:

2.9.2

dbTableName

String dbTableName()

Returns:

the name of database table

Since:

2.9.2

getContract

Class<? extends TopiaEntity> getContract()

Returns:

the contract class of the entity

getImplementation

Class<? extends TopiaEntity> getImplementation()

Note : this is a lazy accessor.

Returns:

the implementation class of the entity

getImplementationFQN

String getImplementationFQN()

Returns:

the fully qualifed name of the implementation class of the entity

getNaturalIds

String[] getNaturalIds()

Returns:

the array of property names involved in the natural key of the entity.

getNotNulls

String[] getNotNulls()

Returns:

the array of property names which are marked as not-null.

Since:

2.6.9

isUseNaturalIds

boolean isUseNaturalIds()

Returns:

true if entity use natural ids, false otherwise.

Since:

2.6.9

isUseNotNulls

boolean isUseNotNulls()

Returns:

true if entity use some not-null properties, false otherwise.

Since:

2.6.9

setImplementationFQN

void setImplementationFQN(String implementationFQN)

Change the implementation class of the entity. Note : this method should reset all states of the object (implementation class, operators,...).

Parameters:

implementationFQN - the new fully qualified name of the new implementation class of the entity.

accept

boolean accept(Class<? extends TopiaEntity> klass)

Test if a given type of entity is matching the contract of this entity. Note : make sure to accept type only on the given contract class of this entity, can not accept an ancestor type, since there is a specific contract for this. Example : A → B

 XxxEntityEnum.A.accept(Class<A>) → true
 XxxEntityEnum.A.accept(Class<B>) → false
 XxxEntityEnum.B.accept(Class<B>) → true
 XxxEntityEnum.B.accept(Class<A>) → false
 

Parameters:

klass - the type of an entity to test.

Returns:

true if given type is dealed directly by this entity, false otherwise.