Putting it all together

Typically your entity API will support a number of persistence operations, as evidence by its inheritance hierarchy:

Figure 1. Entity API extending multiple interfaces for persistence
/**
    * Description of my wonderful new entity.
    */
    public interface MyNewEntity extends StandardEntity, DateRanged,
        Lifecycle<MyNewEntity.State>, Insertable,
        OptimisticLockModifiable, LogicallyDeleteable {