com.sapportals.wcm.rendering.base

Interface IRendererStatus

All Superinterfaces:

IControlStatus, IMassDataControlStatus

All Known Subinterfaces:

IConfigurableRendererStatus

All Known Implementing Classes:

AbstractRendererStatus, CLPRendererStatus, CollectionRendererStatus, JanusHeadedStatusFlipSide, JanusHeadedStatusFrontside, SearchRendererStatus

Deprecated. As of NetWeaver 7.1

public interface IRendererStatus
extends IControlStatus, IMassDataControlStatus

allows to keep data regarding a list of IResource and metadata about that list across http-request-cycles, so that rendering classes such as an ICollectionRenderer can use this as persistence mechanism. The status supports some basic user-resourcelist-interactions such as sorting, filtering and selection. The status only creates new IResource elements (which is an expensive operation) in the methods refresh setTypedResourceList setParent For the sort method, only the ResourcePropertyComparator attribute is used, not the SortDefinition attribute. This attribute is only needed by the classes which use this status as a model to persist their data across http-requests.

Since:

EP5 SP6 and EP6 SP1

Field Summary

static FieldIdentifier	DESELECT_ALL Deprecated.
static FieldIdentifier	ID Deprecated.
static FieldIdentifier	NAME Deprecated.
static FieldIdentifier	SELECT_ALL Deprecated.

Method Summary

void	filter() Deprecated. As of NetWeaver 7.1
ResourcePropertyComparator	getComparator() Deprecated. As of NetWeaver 7.1
int	getCurrentIndex() Deprecated. As of NetWeaver 7.1
FieldSet	getFieldSet(IResource res) Deprecated. As of NetWeaver 7.1
ICollection	getParent() Deprecated. As of NetWeaver 7.1
IPropertyColumn[]	getPropertyColumns() Deprecated. As of NetWeaver 7.1
IResource	getResource(int index) Deprecated. As of NetWeaver 7.1
IResourceList	getResourceList() Deprecated. As of NetWeaver 7.1
IResourceList	getSelectedResources() Deprecated. As of NetWeaver 7.1
SortDefinition	getSortDefintion() Deprecated. As of NetWeaver 7.1
ITypedResourceList	getTypedResourceList() Deprecated. As of NetWeaver 7.1
boolean	hasMore() Deprecated. As of NetWeaver 7.1
void	refresh() Deprecated. As of NetWeaver 7.1
void	setComparator(ResourcePropertyComparator comp) Deprecated. As of NetWeaver 7.1
void	setCurrentIndex(int index) Deprecated. As of NetWeaver 7.1
void	setFilter(IResourceListFilter filter) Deprecated. As of NetWeaver 7.1
void	setFilterParameters(IParameters filterparameters) Deprecated. As of NetWeaver 7.1
void	setParent(ICollection parent) Deprecated. As of NetWeaver 7.1
void	setPropertyColumns(IPropertyColumn[] columns) Deprecated. As of NetWeaver 7.1
void	setSortDefinition(SortDefinition sd) Deprecated. As of NetWeaver 7.1
void	setTypedResourceList(ITypedResourceList list, IResourceContext context) Deprecated. As of NetWeaver 7.1
void	sort() Deprecated. As of NetWeaver 7.1

Methods inherited from interface com.sapportals.wcm.util.controlstatus.IControlStatus

execute, execute, getAction, getActions, getField, getFields, getID, getStatusInformation, setID

Methods inherited from interface com.sapportals.wcm.util.controlstatus.IMassDataControlStatus

getEntrySize, getFieldSet, getMassFields

Field Detail

ID

static final FieldIdentifier ID

Deprecated.

NAME

static final FieldIdentifier NAME

Deprecated.

SELECT_ALL

static final FieldIdentifier SELECT_ALL

Deprecated.

DESELECT_ALL

static final FieldIdentifier DESELECT_ALL

Deprecated.

Method Detail

getResourceList

IResourceList getResourceList()

Deprecated. As of NetWeaver 7.1

returns an IResourceList that does not have to be equal to either the ITypedResourceList or the result of the getChildren method on the ICollection attribute. It may be different because of the sort and filter methods or any other operation the implementing class decides to perform. As an implementation rule, a new creation of IResource elements to fill this list should be avoided due to the performance overhead associated with that operation.

Returns:

an IResourceList that might be empty. Must not return null.

setParent

void setParent(ICollection parent)
               throws WcmException

Deprecated. As of NetWeaver 7.1

sets the collection whose children are to be handled within this status. Any filtering of these children can only be done via the filter method of this status. If this method is called, the status will throw away all selection information and recreate its internal list of resources. The setTypedResourceList shows a similar behavior. Must not be null.

Throws:

WcmException, - if the RepositoryFramework does so

WcmException

getParent

ICollection getParent()

Deprecated. As of NetWeaver 7.1

returns the ICollection, whose children are handled within this status. Might be null.

getTypedResourceList

ITypedResourceList getTypedResourceList()

Deprecated. As of NetWeaver 7.1

returns the ITypedResourceList, whose elements are handled within this status. Might be null or might be of size 0.

setTypedResourceList

void setTypedResourceList(ITypedResourceList list,
                          IResourceContext context)
                          throws WcmException

Deprecated. As of NetWeaver 7.1

sets the ITypedResourceList, whose elements are handled within this status. Must not be null but might be of size 0. The second parameter, the context, is needed to set the IResourceContext attribute of the status. This is normally retrieved from an IResource within the list, but the list might be empty.

Throws:

WcmException, - if the RepositoryFramework does so

WcmException

setCurrentIndex

void setCurrentIndex(int index)
                     throws WcmException

Deprecated. As of NetWeaver 7.1

sets the index-attribute of the status to the given value. This is needed e.g. to store the part of the resourcelist that is currently displayed within an iView.

Throws:

an - IndexOutOfBoundsException, if it is set to a value that exceeds the number of IResources within this status. If not all elements of the ITypedResourceList or all children of the ICollection have been retrieved yet (e.g. because of performance reasons), this method might trigger a refresh of the list and increase that number.

WcmException

getCurrentIndex

int getCurrentIndex()
                    throws WcmException

Deprecated. As of NetWeaver 7.1

Returns:

the current position within the internal list of IResource objects.

Throws:

WcmException

getResource

IResource getResource(int index)

Deprecated. As of NetWeaver 7.1

Returns:

the IResource that is situated at this position of the internal list of IResource objects. Note that this position might change due to sort and filter methods. Returns null, if the parameter exceeds the size of the internal list.

getFieldSet

FieldSet getFieldSet(IResource res)

Deprecated. As of NetWeaver 7.1

Returns:

the FieldSet defined for this IResource. This set is needed to e.g. change the selection state of the resource.

getSelectedResources

IResourceList getSelectedResources()

Deprecated. As of NetWeaver 7.1

Returns:

a list of all resources that have been set to selected.

setSortDefinition

void setSortDefinition(SortDefinition sd)

Deprecated. As of NetWeaver 7.1

sets the SortDefinition attribute of the status. Might be null.

getSortDefintion

SortDefinition getSortDefintion()

Deprecated. As of NetWeaver 7.1

Returns:

the SortDefinition attribute of the status. Might be null.

setComparator

void setComparator(ResourcePropertyComparator comp)

Deprecated. As of NetWeaver 7.1

sets the ResourcePropertyComparator attribute of the status. Might be null.

getComparator

ResourcePropertyComparator getComparator()

Deprecated. As of NetWeaver 7.1

Returns:

the ResourcePropertyComparator attribute of the status. Might be null.

setPropertyColumns

void setPropertyColumns(IPropertyColumn[] columns)

Deprecated. As of NetWeaver 7.1

TODO what about null? sets the IPropertyColumn[] attribute of the status. Might be null.

getPropertyColumns

IPropertyColumn[] getPropertyColumns()

Deprecated. As of NetWeaver 7.1

TODO what about null?

Returns:

the IPropertyColumn[] attribute of the status. Might be null.

sort

void sort()

Deprecated. As of NetWeaver 7.1

sorts the internal list of resources. It uses the ResourcePropertyComparator attribute to do this sorting. If that attribute is null, no sorting will be done and the list will be sorted as it was before this method was called.

filter

void filter()
            throws WcmException

Deprecated. As of NetWeaver 7.1

filters the internal list of resources. The selection status of all IResource objects will be set to false, if and only if at least one of the two attributes IResourceListFilter or (IParameters has changed since the last call of this method.

Throws:

WcmException - if the filtering class throws it

WcmException

setFilter

void setFilter(IResourceListFilter filter)

Deprecated. As of NetWeaver 7.1

sets the class, that is used to filter out resources from the given parent-collection or the ITypedResourceList. A change of this parameter will result in a new filtering, if the filter method is called afterwards. The call of this method alone does not lead to a new filtering (and a reset of selected resources).

Parameters:

filter - the filter instance to use, can be null

setFilterParameters

void setFilterParameters(IParameters filterparameters)

Deprecated. As of NetWeaver 7.1

sets the parameters, that are used by the IResourceListFilter to determine which resources are to be filtered out. A change of this parameter will result in a new filtering, if the filter method is called afterwards. The call of this method alone does not lead to a new filtering (and a reset of selected resources).

Parameters:

filterparameters - determine which rules apply to filtering, can be null

refresh

void refresh()
             throws WcmException

Deprecated. As of NetWeaver 7.1

reloads resources from RF revokes all selections

Throws:

WcmException

hasMore

boolean hasMore()

Deprecated. As of NetWeaver 7.1

flag telling if all IResource objects that belong to the ICollection or the TypedResourceList attribute have already been instantiated (and added to the internal resourcelist) or not.

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] KMC-CM	[sap.com] tc/km/nonwduideprecated	api	EP-KM-CM
[sap.com] KMC-WPC	[sap.com] tc/kmc/wpc/wpcfacade	api	EP-PIN-WPC-WCM