com.softwareag.mobile.runtime.toolkit.model

Class EntityListDatasource

java.lang.Object

com.softwareag.mobile.runtime.toolkit.util.Observable

com.softwareag.mobile.runtime.toolkit.delegates.AbstractListDatasource

com.softwareag.mobile.runtime.toolkit.model.EntityListDatasource

All Implemented Interfaces:

IDatasource, IListDatasource

public class EntityListDatasource
extends AbstractListDatasource

An EntityListDatasource provides a IListDatasource implementation to manage and represent a data model based on the IEntitys defined in the application model. This datasource is to be used in ListViews.

Version:

10.3.0.0004-0525

Constructor Summary

Constructors

Constructor and Description
EntityListDatasource()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getExpressionValue(java.lang.String rootExpression) This method is used to retrieve an object from the data model using an expression. An expression can be any String an IDatasource implementation uses to reference an object.
java.lang.Object	getExpressionValue(java.lang.String relativeExpression, int elementIndex) This method is used to get the object from the data model using an expression that is relative to on object in the data model with the given row index. An expression can be any String an IDatasource implementation uses to reference an object.
boolean	matchesExpression(java.lang.String filterExpression, int elementIndex) Returns a boolean value indicating whether the passed filterExpression is applicable for the underlying element, represented by it's elementIndex.
void	reloadElements() Use to reload the objects managed by the datasource.
void	setExpressionValue(java.lang.String rootExpression, java.lang.Object value) This method is used to update an object in the data model. An expression can be any String an IDatasource implementation uses to reference an object.
void	setExpressionValue(java.lang.String relativeExpression, java.lang.Object value, int elementIndex) This method is used to set the object in the data model using an expression that is relative to on object in the data model with the given row index. An expression can be any String an IDatasource implementation uses to reference an object.

Methods inherited from class com.softwareag.mobile.runtime.toolkit.delegates.AbstractListDatasource

addElement, addElementAtIndex, addElements, compare, getComparator, getElementAtIndex, getElements, getException, getFilteredElements, getFilterExpression, getNumberOfElements, getSelectedElement, hasException, isFilteredElement, removeAllElements, removeElement, removeElementAtIndex, resort, setComparator, setElements, setFilterExpression, setSelectedElement

Methods inherited from class com.softwareag.mobile.runtime.toolkit.util.Observable

addObserver, deleteObserver, notifyObservers, notifyObservers

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityListDatasource

public EntityListDatasource()

Method Detail

getExpressionValue

public java.lang.Object getExpressionValue(java.lang.String relativeExpression,
                                           int elementIndex)
                                    throws java.lang.Exception

Description copied from interface: IListDatasource

This method is used to get the object from the data model using an expression that is relative to on object in the data model with the given row index.
An expression can be any String an IDatasource implementation uses to reference an object.

elementIndex - the index of the object to be used to evaluate the given expression

Returns:

the object for the given expression or null if there was no object

Throws:

java.lang.Exception - if an error occured evaluating the given expression

setExpressionValue

public void setExpressionValue(java.lang.String relativeExpression,
                               java.lang.Object value,
                               int elementIndex)
                        throws java.lang.Exception

Description copied from interface: IListDatasource

This method is used to set the object in the data model using an expression that is relative to on object in the data model with the given row index.
An expression can be any String an IDatasource implementation uses to reference an object.

Parameters:

relativeExpression - String that references an object in the data model

value - the new value for the given expression

elementIndex - the index of the object to be used to evaluate the given expression

Throws:

java.lang.Exception - if an error occured evaluating the given expression

matchesExpression

public boolean matchesExpression(java.lang.String filterExpression,
                                 int elementIndex)

Description copied from interface: IListDatasource

Returns a boolean value indicating whether the passed filterExpression is applicable for the underlying element, represented by it's elementIndex.
Returns false if the passed elementIndex is out of range.

This method is used to determine the expression to template mapping used in ContentAdapter.

Parameters:

filterExpression - String that references an object in the data model

elementIndex - the index of the object to be used to evaluate the given expression

getExpressionValue

public java.lang.Object getExpressionValue(java.lang.String rootExpression)
                                    throws java.lang.Exception

Description copied from interface: IDatasource

This method is used to retrieve an object from the data model using an expression.
An expression can be any String an IDatasource implementation uses to reference an object.

Parameters:

rootExpression - String that references an object in the data model

Returns:

the object for the given expression or null if there was no object

Throws:

java.lang.Exception - if an error occured evaluating the given expression

setExpressionValue

public void setExpressionValue(java.lang.String rootExpression,
                               java.lang.Object value)
                        throws java.lang.Exception

Description copied from interface: IDatasource

This method is used to update an object in the data model.
An expression can be any String an IDatasource implementation uses to reference an object.

Parameters:

rootExpression - String that references an object in the data model

value - new object value for the given expression

Throws:

java.lang.Exception - if an error occured evaluating the given expression

reloadElements

public void reloadElements()

Description copied from interface: IListDatasource

Use to reload the objects managed by the datasource.

Specified by:

reloadElements in interface IListDatasource

Specified by:

reloadElements in class AbstractListDatasource