InstanceContainer
The InstanceContainer
interface is a root of the data containers hierarchy. It is designed to hold a single entity instance.
You can define InstanceContainer
in the XML descriptor in the following way:
<instance id="departmentDc"
class="com.company.onboarding.entity.Department">
<fetchPlan extends="_base">
<property name="hrManager" fetchPlan="_base"/>
</fetchPlan>
<loader id="departmentDl"/>
</instance>
Methods
InstanceContainer
has the following methods:
-
setItem()
- sets an entity instance to the container. -
getItem()
- returns the instance stored in the container. If the container is empty, the method throws an exception. Use this method when you are sure that an entity has been set in the container, then you don’t have to check the returned value fornull
. -
getItemOrNull()
- returns the instance stored in the container. If the container is empty, this method returnsnull
. You should always check the returned value fornull
before using it. -
getEntityMetaClass()
- returns the metaclass of the entity that can be stored in this container. -
setFetchPlan
- sets a fetch plan that must be used when loading entities for this container. Keep in mind that containers themselves do not load data, so this attribute just indicates the desired view for a loader connected to this container. -
getFetchPlan()
- returns a fetch plan that must be used when loading entities for this container.
Events
The InstanceContainer
interface allows you to register listeners to the following events:
-
ItemPropertyChangeEvent
is sent when the value of an attribute of the instance stored in the container is changed. Example of subscribing to the event for a container defined in the screen XML withdepartmentDc
id:@Subscribe(id = "departmentDc", target = Target.DATA_CONTAINER) public void onDepartmentDcItemPropertyChange( final InstanceContainer.ItemPropertyChangeEvent<Department> event) { Department department = event.getItem(); String changedProperty = event.getProperty(); Object currentValue = event.getValue(); Object previousValue = event.getPrevValue(); // ... }
-
ItemChangeEvent
is sent when another instance (ornull
) is set in the container. Example of subscribing to the event for a container defined in the screen XML withdepartmentDc
id:@Subscribe(id = "departmentDc", target = Target.DATA_CONTAINER) public void onDepartmentDcItemChange(final InstanceContainer.ItemChangeEvent<Department> event) { Department department = event.getItem(); Department previouslySelectedDepartment = event.getPrevItem(); // ... }