manifold.sql.rt.api

Interface CustomEntityFactory

All Known Implementing Classes:

DefaultCustomEntityFactory

public interface CustomEntityFactory

Method Summary

Modifier and Type	Method and Description
<T extends Entity> T	newInstance(TxBindings txBindings, java.lang.Class<T> entityInterface) Constructs classes implementing the entity API interfaces.

Method Detail

newInstance

<T extends Entity> T newInstance(TxBindings txBindings,
                                 java.lang.Class<T> entityInterface)

Constructs classes implementing the entity API interfaces.

Entity interfaces are self-implementing; default methods delegate to bindings. As such, a custom entity class can focus on custom behavior and not be concerned about delegating existing behavior.

A typical custom entity class.

     import org.example.schema.mydatabase.Actor;
     import manifold.sql.rt.api.*;

     public class MyActor extends BaseEntity implements Actor {
       private MyActor(TxBindings bindings) {
         super(bindings);
       }

       // your code here...

     } 

A custom class may override any of the entityInterface methods and provide any number of its own methods.

Type Parameters:

T - The entity interface to implement.

Parameters:

txBindings - The TxBindings instance the returned class instance receives in its constructor. This instance must be maintained by this class and returned from the getBindings() method.

entityInterface - The interface the class of the returned entity instance must implement.

Returns:

An instance of the entityInterface or null the entity is not customized.