Package com.webmethods.caf.jcr.faces.data

Class BaseIteratorTableContentProvider

java.lang.Object

com.webmethods.caf.faces.bean.PageFlowScopeAdapter

com.webmethods.caf.jcr.faces.data.BaseIteratorTableContentProvider

All Implemented Interfaces:

IPageFlowScopeAdapter, IAddressableTableContentProvider, IContentProvider, IRefreshable, IRefreshableContentProvider, ISelectableTableContentProvider, ISortableTableContentProvider, ITableContentProvider, Serializable

Direct Known Subclasses:

ChildrenTableContentProvider, SearchTableContentProvider, VersionHistoryTableContentProvider

public abstract class BaseIteratorTableContentProvider
extends PageFlowScopeAdapter
implements Serializable, ITableContentProvider, IRefreshableContentProvider, ISelectableTableContentProvider, ISortableTableContentProvider

Base class for all the CAF table content provider that traverse a JCR iterator.

Since:

8.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected int	m_index	Current row index.
protected SelectableTableContentProviderHelper	m_selectableHelper	Holds selection state.
protected String	m_var	Row variable name.

Fields inherited from class com.webmethods.caf.faces.bean.PageFlowScopeAdapter

fExpireWithPageFlow

Constructor Summary

Constructors

Constructor	Description
BaseIteratorTableContentProvider()	Default Constructor.
BaseIteratorTableContentProvider(javax.jcr.Session jcrSession)	Constructor

Method Summary

Modifier and Type	Method	Description
Object	getCurrentRow()	Returns wrapped current row object.
javax.jcr.Session	getJcrSession()	Gets the current JCR session
boolean	getNeedRefresh()	Returns true when IRefreshable.isAutoRefresh() is on and the result properties need to be refreshed from the data source by executing IRefreshable.refresh() method.
Object[]	getPropertyKeys()	Returns list of properties supported by this content provider.
int	getRowCount()	Return the number of rows of data objects represented by this DataModel.
String	getRowId()	Returns unique identifier for the current row.
int	getRowIndex()	Return the zero-relative index of the currently selected row.
int	getRowSelectedCount()	Returns number of selected rows.
Collection<String>	getRowSelectedIds()	Returns collection of String ids of the selected rows.
protected Class	getRowType()	Returns the row type for the table control
Collection<String>	getRowUnselectedIds()	Returns collection of String ids of the un-selected rows (all other rows are selected implicitly) May be empty or contain non-existent ids; never null, never contains null.
String	getRowVariable()	Returns row variable name.
List<Object>	getSelectedRows()	Returns collection of selected row objects (not IDs) from the ISelectableTableContentProvider.
ISortInfo	getSort()	Returns current sort info.
Class<?>	getType(Object propertyKey)	Returns java type of the given property
protected String	getUniqueId(Object temp)	Gets the unique id of the object.
boolean	getUseUnselectedModel()	Returns true if it's more effecient to use unselected model (ie ISelectableTableContentProvider.getRowUnselectedIds() rather than ISelectableTableContentProvider.getRowSelectedIds()).
Object	getValue(Object propertyKey)	Returns value of the given property
boolean	hasProperty(Object propertyKey)	Checks if the given property is supported by this content provider
protected abstract boolean	hasValidInputParameters()	Checks if the provider is configured properly for looking up results
protected abstract javax.jcr.RangeIterator	invokeSearch()	Do the work to return the node iterator
boolean	isAddressable()	Checks if this content provider truly is addressable.
boolean	isAutoRefresh()	Returns true if the provider is currenlty in auto-refresh mode
boolean	isRowAvailable()	Return a flag indicating whether there is rowData available at the current rowIndex.
boolean	isRowSelected()	Returns true if current row is selected.
void	refresh()	(Re)loads data from the data source.
void	setAutoRefresh(boolean autorefresh)	Sets auto refresh mode on.
void	setJcrSession(javax.jcr.Session jcrSession)	Sets the current JCR session
void	setNeedRefresh(boolean needRefresh)	Tells the provider that the input parameters have changed and the output results need to be refreshed the next time any output property is requested via IContentProvider.getValue(Object).
void	setRowById(String id)	Selects current row by its id.
void	setRowIndex(int rowIndex)	Set the zero-relative index of the currently selected row, or -1 to indicate that we are not positioned on a row.
void	setRowSelected(boolean selected)	Sets the selection status for the current row.
void	setRowSelectedIds(Collection ids)	Sets new selection using a collection of String ids of the rows to select.
void	setRowUnselectedIds(Collection ids)	Unselects rows using a collection of String ids of the un-selected rows (all other rows are selected implicitly).
void	setRowVariable(String varName)	Sets row variable name to use for accessing row specific data.
void	setSort(ISortInfo sortInfo)	Sets new sort info, re-sorting the table (if necessary).
boolean	supportsAutoRefresh()	Returns true if this content provider supports auto refresh feature.

Methods inherited from class com.webmethods.caf.faces.bean.PageFlowScopeAdapter

getExpireWithPageFlow, setExpireWithPageFlow

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.webmethods.caf.faces.data.IContentProvider

toString

Field Details

m_index

protected int m_index

Current row index.

m_var

protected String m_var

Row variable name.

m_selectableHelper

protected SelectableTableContentProviderHelper m_selectableHelper

Holds selection state.

Constructor Details

BaseIteratorTableContentProvider

public BaseIteratorTableContentProvider()

Default Constructor. Must call setJcrSession(Session) with a valid JCR session before using.

BaseIteratorTableContentProvider

public BaseIteratorTableContentProvider(javax.jcr.Session jcrSession)

Constructor

Parameters:

jcrSession - the JCR session to query in

Method Details

getJcrSession

public javax.jcr.Session getJcrSession()

Gets the current JCR session

Returns:

the JCR session

setJcrSession

public void setJcrSession(javax.jcr.Session jcrSession)

Sets the current JCR session

Parameters:

jcrSession - the JCR session to set

getRowType

protected Class getRowType()

Returns the row type for the table control

Returns:

always returns the Node class

getPropertyKeys

public Object[] getPropertyKeys()

Description copied from interface: IContentProvider

Returns list of properties supported by this content provider. Can return Object[0], never null.

Specified by:

getPropertyKeys in interface IContentProvider

Returns:

array of property keys which is typically of type String or Integer

getType

public Class<?> getType(Object propertyKey)
                 throws PropertyNotFoundException

Description copied from interface: IContentProvider

Returns java type of the given property

Specified by:

getType in interface IContentProvider

Parameters:

propertyKey - the property key of type String or Integer

Returns:

property java Class

Throws:

PropertyNotFoundException - if property is not supported

getValue

public Object getValue(Object propertyKey)
                throws ELException,
PropertyNotFoundException

Description copied from interface: IContentProvider

Returns value of the given property

Specified by:

getValue in interface IContentProvider

Parameters:

propertyKey - the property key of type String or Integer

Returns:

value of the property, can be null

Throws:

PropertyNotFoundException - if property is not supported

ELException

hasProperty

public boolean hasProperty(Object propertyKey)

Description copied from interface: IContentProvider

Checks if the given property is supported by this content provider

Specified by:

hasProperty in interface IContentProvider

Parameters:

propertyKey - property key of type String or Integer

Returns:

true if property is supported

hasValidInputParameters

protected abstract boolean hasValidInputParameters()

Checks if the provider is configured properly for looking up results

getCurrentRow

public Object getCurrentRow()

Description copied from interface: ITableContentProvider

Returns wrapped current row object. Can be null if not data is available

Specified by:

getCurrentRow in interface ITableContentProvider

Returns:

current row object

See Also:

• ITableContentProvider.isRowAvailable()

getRowCount

public int getRowCount()

Description copied from interface: ITableContentProvider

Return the number of rows of data objects represented by this DataModel.

Return -1, if the number of rows is unknown, or no wrappedData is available.

Specified by:

getRowCount in interface ITableContentProvider

See Also:

• DataModel.getRowCount()

invokeSearch

protected abstract javax.jcr.RangeIterator invokeSearch()

Do the work to return the node iterator

Returns:

node iterator

getRowIndex

public int getRowIndex()

Description copied from interface: ITableContentProvider

Return the zero-relative index of the currently selected row.

If we are not currently positioned on a row, or no wrappedData is available, return -1.

Specified by:

getRowIndex in interface ITableContentProvider

See Also:

• DataModel.getRowIndex()

getRowVariable

public String getRowVariable()

Description copied from interface: ITableContentProvider

Returns row variable name.

If specified row variable can be used to access current row data for the provider internal needs, like sorting or addressing.

Specified by:

getRowVariable in interface ITableContentProvider

Returns:

row variable name or null if not specified

See Also:

• ITableContentProvider.setRowVariable(String)

isRowAvailable

public boolean isRowAvailable()

Description copied from interface: ITableContentProvider

Return a flag indicating whether there is rowData available at the current rowIndex. If no wrappedData is available, return false.

Specified by:

isRowAvailable in interface ITableContentProvider

See Also:

• DataModel.isRowAvailable()

setRowIndex

public void setRowIndex(int rowIndex)

Description copied from interface: ITableContentProvider

Set the zero-relative index of the currently selected row, or -1 to indicate that we are not positioned on a row.

Specified by:

setRowIndex in interface ITableContentProvider

See Also:

• DataModel.getRowIndex()

setRowVariable

public void setRowVariable(String varName)

Description copied from interface: ITableContentProvider

Sets row variable name to use for accessing row specific data. For example, if the provider wrapps an array of a data objects with id property and the variable name is item, then the provider implementation can access id property of each record as item.id.

This property should set only once at the provider initialization time

Specified by:

setRowVariable in interface ITableContentProvider

getNeedRefresh

public boolean getNeedRefresh()

Description copied from interface: IRefreshable

Returns true when IRefreshable.isAutoRefresh() is on and the result properties need to be refreshed from the data source by executing IRefreshable.refresh() method.

Implementations may return an accurate value from this method if they can track the changes to the input parameter properties or they may require the clients to call IRefreshable.setNeedRefresh(boolean) explicitely.

Specified by:

getNeedRefresh in interface IRefreshable

Returns:

true when the output properties are not up-to-date with the current input parameters, i.e. IRefreshable.refresh() needs to be executed manually or automatically.

isAutoRefresh

public boolean isAutoRefresh()

Description copied from interface: IRefreshable

Returns true if the provider is currenlty in auto-refresh mode

Specified by:

isAutoRefresh in interface IRefreshable

Returns:

false if auto-refresh mode is off or not supported

refresh

public void refresh()
             throws ContentProviderException

Description copied from interface: IRefreshable

(Re)loads data from the data source. Implementation specific meaning can be executing a SQL query or a web service call. All current data will be lost and updated with the new results if successful.

Specified by:

refresh in interface IRefreshable

Throws:

ContentProviderException - if error loading data from the data source

setAutoRefresh

public void setAutoRefresh(boolean autorefresh)
                    throws ContentProviderException

Description copied from interface: IRefreshable

Sets auto refresh mode on. When auto refresh mode is on, the provider calls IRefreshable.getNeedRefresh() to determine whether the refresh needs to be done before returning any result properties. If it returns true, the provider calls IRefreshable.refresh() method to updated the result properties.

Specified by:

setAutoRefresh in interface IRefreshable

Parameters:

autorefresh - true to turn it on

Throws:

ContentProviderException - if auto refresh mode is not supported

See Also:

• IRefreshable.supportsAutoRefresh()
• IRefreshable.getNeedRefresh()
• IRefreshable.setNeedRefresh(boolean)

setNeedRefresh

public void setNeedRefresh(boolean needRefresh)

Description copied from interface: IRefreshable

Tells the provider that the input parameters have changed and the output results need to be refreshed the next time any output property is requested via IContentProvider.getValue(Object).

Specified by:

setNeedRefresh in interface IRefreshable

Parameters:

needRefresh - true if the input parameters have changed

supportsAutoRefresh

public boolean supportsAutoRefresh()

Description copied from interface: IRefreshable

Returns true if this content provider supports auto refresh feature.

Specified by:

supportsAutoRefresh in interface IRefreshable

Returns:

true when auto refresh is supported

See Also:

• IRefreshable.setAutoRefresh(boolean)

getRowId

public String getRowId()

Description copied from interface: IAddressableTableContentProvider

Returns unique identifier for the current row. If no current row is avaiable, returns null.

Specified by:

getRowId in interface IAddressableTableContentProvider

Returns:

current row id or null

isAddressable

public boolean isAddressable()

Description copied from interface: IAddressableTableContentProvider

Checks if this content provider truly is addressable.

Specified by:

isAddressable in interface IAddressableTableContentProvider

Returns:

true if addressable.

setRowById

public void setRowById(String id)

Description copied from interface: IAddressableTableContentProvider

Selects current row by its id. If id doesn't identify a row, makes no row current (equivalent to setRowIndex(-1)).

Specified by:

setRowById in interface IAddressableTableContentProvider

Parameters:

id - row id to find and make current

getUniqueId

protected String getUniqueId(Object temp)
                      throws javax.jcr.RepositoryException

Gets the unique id of the object. If temp is a Node, then this will return the node if if available or the node path if no id is available. If temp is a Row, then this returns the row path.

Parameters:

temp - the object to get the id of

Returns:

unique id of the object

Throws:

javax.jcr.RepositoryException

getRowSelectedCount

public int getRowSelectedCount()

Description copied from interface: ISelectableTableContentProvider

Returns number of selected rows.

Specified by:

getRowSelectedCount in interface ISelectableTableContentProvider

Returns:

number of currently selection rows

getRowSelectedIds

public Collection<String> getRowSelectedIds()

Description copied from interface: ISelectableTableContentProvider

Returns collection of String ids of the selected rows. May be empty or contain non-existent ids; never null, never contains null.

Specified by:

getRowSelectedIds in interface ISelectableTableContentProvider

Returns:

collection of ids of selected rows

getRowUnselectedIds

public Collection<String> getRowUnselectedIds()

Description copied from interface: ISelectableTableContentProvider

Returns collection of String ids of the un-selected rows (all other rows are selected implicitly) May be empty or contain non-existent ids; never null, never contains null.

Specified by:

getRowUnselectedIds in interface ISelectableTableContentProvider

Returns:

collection of ids of the un-selection rows

getUseUnselectedModel

public boolean getUseUnselectedModel()

Description copied from interface: ISelectableTableContentProvider

Returns true if it's more effecient to use unselected model (ie ISelectableTableContentProvider.getRowUnselectedIds() rather than ISelectableTableContentProvider.getRowSelectedIds()).

Specified by:

getUseUnselectedModel in interface ISelectableTableContentProvider

Returns:

true if it's more effecient to use unselected model

isRowSelected

public boolean isRowSelected()

Description copied from interface: ISelectableTableContentProvider

Returns true if current row is selected.

Specified by:

isRowSelected in interface ISelectableTableContentProvider

Returns:

true if current row is selection

setRowSelected

public void setRowSelected(boolean selected)

Description copied from interface: ISelectableTableContentProvider

Sets the selection status for the current row.

Specified by:

setRowSelected in interface ISelectableTableContentProvider

Parameters:

selected - true to select current row; false to unselect.

setRowSelectedIds

public void setRowSelectedIds(Collection ids)

Description copied from interface: ISelectableTableContentProvider

Sets new selection using a collection of String ids of the rows to select. May be empty or contain non-existent ids; never null, never contains null.

Specified by:

setRowSelectedIds in interface ISelectableTableContentProvider

Parameters:

ids - the collection of String row ids

setRowUnselectedIds

public void setRowUnselectedIds(Collection ids)

Description copied from interface: ISelectableTableContentProvider

Unselects rows using a collection of String ids of the un-selected rows (all other rows are selected implicitly). May be empty or contain non-existent ids; never null, never contains null.

Specified by:

setRowUnselectedIds in interface ISelectableTableContentProvider

Parameters:

ids - collection of String row ids

getSelectedRows

public List<Object> getSelectedRows()

Returns collection of selected row objects (not IDs) from the ISelectableTableContentProvider.

Parameters:

provider - selectable table provider

Returns:

collection if selected row objects, never null, can be empty, can be up to ITableContentProvider.getRowCount() size

getSort

public ISortInfo getSort()

Description copied from interface: ISortableTableContentProvider

Returns current sort info. Never null.

Specified by:

getSort in interface ISortableTableContentProvider

Returns:

currenly set sort info

setSort

public void setSort(ISortInfo sortInfo)

Description copied from interface: ISortableTableContentProvider

Sets new sort info, re-sorting the table (if necessary). This does not change the model's rowIndex property, even though it will probably now point to a different row.

Specified by:

setSort in interface ISortableTableContentProvider

Parameters:

sortInfo - Sort info, must not be null.