com.sapportals.wcm.repository.filter

Interface IPropertyFilter

All Superinterfaces:

IFilter

All Known Implementing Classes:

AbstractPropertyFilter, AttachmentCountPropertyFilter, AttachmentDisplayNamePropertyFilter, GroupWareAttachmentStylePropertyFilter

public interface IPropertyFilter
extends IFilter

Property filters are used to manipulate resource properties and their visibility. They can modify, delete or add properties to a resource.

For example, with the help of a filter it is possible to change the property that specifies the author of resource. The personal name of the author can be changed to the company name.

Method Summary

IPropertyMap	filter() Returns the filtered property map.
Properties	getFilterContext()
PropertyFilterMode	getFilterMode() Get the FilterMode attribute of the IPropertyFilter object.
IPropertyNameList	getPropertyNameList() Get the property name list if mode is SINGLE_PROPERTY or PROPERTY_LIST.
IRepositoryManager	getRepositoryManager() Returns the repository manager of the new resource in case the write filter is applied to a create operation.
IResource	getResource() Returns the resource that will be filtered.
com.sapportals.wcm.util.uri.URI	getURI() Deprecated. as of NW04

Method Detail

getFilterContext

Properties getFilterContext()

Returns:

filterContext

getResource

IResource getResource()
                      throws com.sapportals.wcm.WcmException

Returns the resource that will be filtered. Will return null if a property write filter is applied to a create operation.

Returns:

The resource

Throws:

com.sapportals.wcm.WcmException

getURI

com.sapportals.wcm.util.uri.URI getURI()
                                       throws com.sapportals.wcm.WcmException

Deprecated. as of NW04

Returns the URI of the new resource in case the property write filter is applied to a create operation.

Returns:

The URI

Throws:

com.sapportals.wcm.WcmException

getRepositoryManager

IRepositoryManager getRepositoryManager()
                                        throws com.sapportals.wcm.WcmException

Returns the repository manager of the new resource in case the write filter is applied to a create operation.

Returns:

A reference to a repository manager instance

Throws:

com.sapportals.wcm.WcmException

getFilterMode

PropertyFilterMode getFilterMode()
                                 throws com.sapportals.wcm.WcmException

Get the FilterMode attribute of the IPropertyFilter object.

Returns:

The FilterMode value

Throws:

com.sapportals.wcm.WcmException - Exception raised in failure situation

getPropertyNameList

IPropertyNameList getPropertyNameList()
                                      throws com.sapportals.wcm.WcmException

Get the property name list if mode is SINGLE_PROPERTY or PROPERTY_LIST.

Returns:

The FilterMode value

Throws:

com.sapportals.wcm.WcmException - Exception raised in failure situation

filter

IPropertyMap filter()
                    throws com.sapportals.wcm.WcmException

Returns the filtered property map. A filter implementation must never return null or a new empty map. If the filter will not change the map or encounters an error it must return the map returned by the predecessor filter's filter() method. If the predecessor's filter() method throws an exception this exception should not be catched (or catched and re-thrown).

Returns:

The filtered property map

Throws:

com.sapportals.wcm.WcmException

Access Rights

This class can be accessed from:

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