Skip navigation links

oracle.wcps.property
Interface IPropertyService

All Superinterfaces:

java.io.Serializable

public interface IPropertyService

extends java.io.Serializable

A namespace scoped property service to manage propertydefinitions, propertysetdefinitions and propertysets. The namespaceName (getNamespaceName()) can't be changed once this is created.

Method Summary

<T extends java.io.Serializable> IPreference<T>	createPreference(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPreferenceSetName prefSetName, IPreference<T> pref) Creates a new property in the propertyset identified by the given setDefinitionName and the setName.
IPreferenceSet	createPreferenceSet(IContext context, IPreferenceSet preferenceSet) Creates the given preferenceSet.
<T extends java.io.Serializable> IProperty<T>	createProperty(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IProperty<T> property) Creates a new property in the propertyset identified by the given setDefinitionName and the setName.
IPropertyDefinition	createPropertyDefinition(IContext context, IPropertyDefinition propertyDefinition) Creates the given propertyDefinition.
IPropertySet	createPropertySet(IContext context, IPropertySet propertySet) Creates the given propertySet.
IPropertySetDefinition	createPropertySetDefinition(IContext context, IPropertySetDefinition propertySetDefinition) Creates the given propertySetDefinition.
IPagedList<IPreferenceSet>	filter(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName propertySetName, PreferenceSetFilterContext filterContext) Filters the preferencesets within the scope of the given setDefinitionName, the namespace getNamespaceName(), the propertySetName and based on the given filterContext.
IPagedList<IPropertySet>	filter(IContext context, IPropertySetDefinitionName setDefinitionName, PropertySetFilterContext filterContext) Filters the propertysets within the scope of the given setDefinitionName and the namespace getNamespaceName() and based on the given filterContext.
IPagedList<IPropertyDefinition>	filter(IContext context, PropertyDefinitionFilterContext filterContext) Filters the propertydefinitions within the scope of the namespace getNamespaceName() and based on the given filterContext.
IPagedList<IPropertySetDefinition>	filter(IContext context, PropertySetDefinitionFilterContext filterContext) Filters the propertysetdefinitions within the scope of the namespace getNamespaceName() and based on the given filterContext.
INamespaceName	getNamespaceName() Returns the namespace name to which this is scoped.
<T extends java.io.Serializable> IPreference<T>	getPreference(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName, IPreferenceSetName prefSetName, java.lang.String prefName) Retrieves the preference identified by the given prefName from the preferenceset identified by the given propertySetDefinitionName and the propertySetName and the prefSetName.
IPreferenceSet	getPreferenceSet(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName, IPreferenceSetName preferenceSetName) Retrieves the preferenceset identified by the given propertyDefinitionName ,the propertySetName and the preferenceSetName.
IPagedList<IPreferenceSet>	getPreferenceSets(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName, PaginationContext paginationContext) Retrieves a paged list of preferencesets for the given propertysetdefinition name propertyDefinitionName and the given propertyset name.
<T extends java.io.Serializable> IProperty<T>	getProperty(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName, java.lang.String propertyName) Retrieves the property identified by the given propertyName from the propertyset identified by the given propertySetDefinitionName and the propertySetName.
IPropertyDefinition	getPropertyDefinition(IContext context, IPropertyDefinitionName propertyDefinitionName) Retrieves the propertydefinition identified by the given propertyDefinitionName.
IPagedList<IPropertyDefinition>	getPropertyDefinitions(IContext context, PaginationContext paginationContext) Retrieves a paged list of propertydefinitions in this namespace getNamespaceName().
IPropertySet	getPropertySet(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName) Retrieves the propertyset identified by the given propertyDefinitionName and the propertySetName.
IPropertySetDefinition	getPropertySetDefinition(IContext context, IPropertySetDefinitionName propertySetDefinitionName) Retrieves the propertysetdefinition identified by the given propertySetDefinitionName.
IPagedList<IPropertySetDefinition>	getPropertySetDefinitions(IContext context, PaginationContext paginationContext) Retrieves a paged list of propertysetdefinitions in this namespace getNamespaceName().
IPagedList<IPropertySet>	getPropertySets(IContext context, IPropertySetDefinitionName propertySetDefinitionName, PaginationContext paginationContext) Retrieves a paged list of propertysets for the given propertysetdefinition name propertyDefinitionName.
void	removeAllPreferences(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPreferenceSetName prefSetName) Clears the preferenceset identified by the given setDefinitionName and setName and prefSetName by removing all the preferences from it.
void	removeAllPreferenceSets(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName propertySetName) Removes all the preferencesets within the scope of the namespace returned by the method getNamespaceName() , the given setDefinitionName and the given propertySetName.
void	removeAllProperties(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName) Clears the propertyset identified by the given setDefinitionName and setName by removing all the properties from it.
void	removeAllPropertyDefinitions(IContext context) Removes all the propertydefinitions found in the namespace returned by the method getNamespaceName().
void	removeAllPropertySetDefinitions(IContext context) Removes all the propertysetdefinitions found in the namespace returned by the method getNamespaceName().
void	removeAllPropertySets(IContext context, IPropertySetDefinitionName setDefinitionName) Removes all the propertysets within the scope of the namespace returned by the method getNamespaceName() and the given setDefinitionName.
<T extends java.io.Serializable> IPreference<T>	removePreference(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPreferenceSetName prefSetName, IPreference<T> pref) Removes the given preference from the preferenceset identified by the given setDefinitionName and the setName and the prefSetName.
<T extends java.io.Serializable> IPreference<T>	removePreference(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPreferenceSetName prefSetName, IPreferenceName preferenceName) Removes the preference identified by the given name preferenceName from the preferenceset identified by the given setDefinitionName and the setName and prefSetName.
IPreferenceSet	removePreferenceSet(IContext context, IPreferenceSet preferenceSet) Removes the given preferenceset preferenceSet.
IPreferenceSet	removePreferenceSet(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName, IPreferenceSetName preferenceSetName) Removes the preferenceset identified the given propertySetDefinitionName, propertySetName and the preferenceSetName.
<T extends java.io.Serializable> IProperty<T>	removeProperty(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IName propertyName) Removes the property identified by the given name propertyName from the propertyset identified by the given setDefinitionName and the setName.
<T extends java.io.Serializable> IProperty<T>	removeProperty(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IProperty<T> property) Removes the given property from the propertyset identified by the given setDefinitionName and the setName.
<T extends java.io.Serializable> IProperty<T>	removeProperty(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPropertyName propertyName) Removes the property identified by the given name propertyName from the propertyset identified by the given setDefinitionName and the setName.
IPropertyDefinition	removePropertyDefinition(IContext context, IPropertyDefinition propertyDefinition) Removes the given propertydefinition propertyDefinition.
IPropertyDefinition	removePropertyDefinition(IContext context, IPropertyDefinitionName propertyDefinitionName) Removes the named propertydefinition.
IPropertySet	removePropertySet(IContext context, IPropertySet propertySet) Removes the given propertyset propertySet.
IPropertySet	removePropertySet(IContext context, IPropertySetDefinitionName propertySetDefinitionName, IPropertySetName propertySetName) Removes the propertyset identified the given propertyDefinitionName and the propertySetName.
IPropertySetDefinition	removePropertySetDefinition(IContext context, IPropertySetDefinition propertySetDefinition) Removes the given propertysetdefinition propertySetDefinition.
IPropertySetDefinition	removePropertySetDefinition(IContext context, IPropertySetDefinitionName propertySetDefinitionName) Removes the named propertysetdefinition.
<T extends java.io.Serializable> IPreference<T>	updatePreference(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IPreferenceSetName prefSetName, IPreference<T> pref) Updates the given preference in the preferenceset identified by the given setDefinitionName and the setName and the prefSetName.
IPreferenceSet	updatePreferenceSet(IContext context, IPreferenceSet preferenceSet) Updates an existing preferenceset by replacing it with the given preferenceSet.
<T extends java.io.Serializable> IProperty<T>	updateProperty(IContext context, IPropertySetDefinitionName setDefinitionName, IPropertySetName setName, IProperty<T> property) Updates the given property in the propertyset identified by the given setDefinitionName and the setName.
IPropertyDefinition	updatePropertyDefinition(IContext context, IPropertyDefinition propertyDefinition) Updates an existing propertydefinition by replacing it with the given propertyDefinition.
IPropertySet	updatePropertySet(IContext context, IPropertySet propertySet) Updates an existing propertyset by replacing it with the given propertySet.
IPropertySetDefinition	updatePropertySetDefinition(IContext context, IPropertySetDefinition propertySetDefinition) Updates an existing propertysetdefinition by replacing it with the given propertySetDefinition.

Method Detail

getNamespaceName

INamespaceName getNamespaceName()

Returns the namespace name to which this is scoped.

Returns:

the associated namespace name.

getPropertySets

IPagedList<IPropertySet> getPropertySets(IContext context,
                                         IPropertySetDefinitionName propertySetDefinitionName,
                                         PaginationContext paginationContext)
                                         throws OperationFailedException

Retrieves a paged list of propertysets for the given propertysetdefinition name propertyDefinitionName. The paged list's size and the starting index is determined by the given paginationContext. The paged list will be empty if the current user is not authorized to read the propertysets. This indirectly calls IPropertyLocator.filter(IContext, INamespaceName, IPropertySetDefinitionName, oracle.wcps.property.filter.PropertySetFilterContext).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

paginationContext - contains a page size and a starting index.

Returns:

a paged list of property sets.

Throws:

OperationFailedException - if the backing IPropertyLocator is unable to retrieve the propertysets.

getPropertySet

IPropertySet getPropertySet(IContext context,
                            IPropertySetDefinitionName propertySetDefinitionName,
                            IPropertySetName propertySetName)
                            throws UnauthorizedException

Retrieves the propertyset identified by the given propertyDefinitionName and the propertySetName. This indirectly calls IPropertyLocator.loadProperties(IContext, IPropertySet, IPropertySetDefinition, java.util.List).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

Returns:

the propertyset if found otherwise null.

Throws:

UnauthorizedException - if the currently user is not authorized to read IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this propertyset.

OperationFailedException - if the backing IPropertyLocator is unable to retrieve the propertyset.

createPropertySet

IPropertySet createPropertySet(IContext context,
                               IPropertySet propertySet)
                               throws AlreadyExistsException,
                                      ValidationFailedException,
                                      NotFoundException,
                                      UnauthorizedException

Creates the given propertySet. If the given propertyset's name is not set the system will generate an UUID UUID and use it as its name. The returned propertyset will have values for createdOn and updatedOn set by the system. This indirectly calls IPropertyLocator.storeProperties(IContext, IPropertySet, IPropertySetDefinition, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySet - a new propertyset.

Returns:

the newly created propertyset.

Throws:

AlreadyExistsException - if the system already contains the given propertyset.

ValidationFailedException - if the property values fail validation according to their propertydefinitions.

NotFoundException - if the propertysetdefinition identified by the name in the given propertySet IPropertySet.getPropertySetDefinitionName() is not found in the system.

UnauthorizedException - if the currently user is not authorized to create IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this propertyset.

OperationFailedException - if the backing IPropertyLocator is unable to create the propertyset.

See Also:

IPropertySetDefinition, IPropertyDefinition

updatePropertySet

IPropertySet updatePropertySet(IContext context,
                               IPropertySet propertySet)
                               throws NotFoundException,
                                      ValidationFailedException,
                                      ObjectOutOfSyncException,
                                      UnauthorizedException

Updates an existing propertyset by replacing it with the given propertySet. If the optimistic concurrency feature is enabled IContext.isOptimisticConcurrencyEnabled(), this method updates the given propertyset optimistically. The given propertySet is updated only if its updatedOn time matches with the existing propertyset's updatedOn time. This indirectly calls IPropertyLocator.storeProperties(IContext, IPropertySet, IPropertySetDefinition, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySet - a propertyset that was retrieved from the system.

Returns:

the updated propertyset.

Throws:

NotFoundException - if the given propertyset was not created before or if the propertysetdefinition referred by the given propertyset is not found in the system.

ValidationFailedException - if a property's value fails validation according to the associated propertydefinition. The propertydefinition is associated to a property name in a property mapping IPropertyMapping found in the propertysetdefinition IPropertySetDefinition which is associated to the given propertySet.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertySet doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to update IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this propertyset.

OperationFailedException - if the backing IPropertyLocator is unable to update the given propertyset.

removePropertySet

IPropertySet removePropertySet(IContext context,
                               IPropertySet propertySet)
                               throws ObjectOutOfSyncException,
                                      UnauthorizedException

Removes the given propertyset propertySet. If the optimistic concurrency feature is enabled, this method removes the given propertySet optimistically, it is removed only if its updatedOn time matches the updatedOn time of the existing propertyset in the system. This indirectly calls IPropertyLocator.removeProperties(IContext, IPropertySet, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySet - a propertyset that was retrieved from the system.

Returns:

The removed propertyset.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertySet doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId)this propertyset.

OperationFailedException - if the backing IPropertyLocator is unable to remove the given propertyset.

removePropertySet

IPropertySet removePropertySet(IContext context,
                               IPropertySetDefinitionName propertySetDefinitionName,
                               IPropertySetName propertySetName)
                               throws UnauthorizedException

Removes the propertyset identified the given propertyDefinitionName and the propertySetName. This indirectly calls IPropertyLocator.removeProperties(IContext, IPropertySet, java.util.List).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

Returns:

the removed propertyset.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this propertyset.

OperationFailedException - if the backing IPropertyLocator is unable to remove the propertyset.

removeAllPropertySets

void removeAllPropertySets(IContext context,
                           IPropertySetDefinitionName setDefinitionName)
                           throws UnauthorizedException

Removes all the propertysets within the scope of the namespace returned by the method getNamespaceName() and the given setDefinitionName. This indirectly calls IPropertyLocator.removeProperties(IContext, INamespaceName, IPropertySetDefinitionName).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) all propertysets.

OperationFailedException - if the backing IPropertyLocator is unable to remove all the propertysets.

filter

IPagedList<IPropertySet> filter(IContext context,
                                IPropertySetDefinitionName setDefinitionName,
                                PropertySetFilterContext filterContext)

Filters the propertysets within the scope of the given setDefinitionName and the namespace getNamespaceName() and based on the given filterContext. This indirectly calls IPropertyLocator.filter(IContext, INamespaceName, IPropertySetDefinitionName, oracle.wcps.property.filter.PropertySetFilterContext)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

filterContext - a filter context that contains search expression and pagination context.

Returns:

the paged list of propertysets that satisfies the given filter context.

Throws:

OperationFailedException - if the backing IPropertyLocator is unable to filter the propertysets.

getProperty

<T extends java.io.Serializable> IProperty<T> getProperty(IContext context,
                                                          IPropertySetDefinitionName propertySetDefinitionName,
                                                          IPropertySetName propertySetName,
                                                          java.lang.String propertyName)
                                                      throws UnauthorizedException

Retrieves the property identified by the given propertyName from the propertyset identified by the given propertySetDefinitionName and the propertySetName.

Type Parameters:

T - property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

propertyName - a property's name.

Returns:

a property.

Throws:

UnauthorizedException - if the current user is not authorized to read IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

OperationFailedException - if the backing IPropertyLocator is unable to retrieve the named propertyset.

createProperty

<T extends java.io.Serializable> IProperty<T> createProperty(IContext context,
                                                             IPropertySetDefinitionName setDefinitionName,
                                                             IPropertySetName setName,
                                                             IProperty<T> property)
                                                         throws AlreadyExistsException,
                                                                NotFoundException,
                                                                UnauthorizedException,
                                                                ValidationFailedException

Creates a new property in the propertyset identified by the given setDefinitionName and the setName.

Type Parameters:

T - property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

property - a new property to create.

Returns:

the newly created property.

Throws:

AlreadyExistsException - if the propertyset already contains this property.

NotFoundException - if the propertyset or the propertysetdefinition are not found.

UnauthorizedException - if the current user is not authorized to create IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

ValidationFailedException - if the property's name is null or its value fails to validate according to the propertydefinition that is mapped to this property in the propertysetdefinition identified by the given setDefinitionName.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

updateProperty

<T extends java.io.Serializable> IProperty<T> updateProperty(IContext context,
                                                             IPropertySetDefinitionName setDefinitionName,
                                                             IPropertySetName setName,
                                                             IProperty<T> property)
                                                         throws ObjectOutOfSyncException,
                                                                NotFoundException,
                                                                UnauthorizedException,
                                                                ValidationFailedException

Updates the given property in the propertyset identified by the given setDefinitionName and the setName.

Type Parameters:

T - property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

property - a property to update.

Returns:

the updated property.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given property doesn't match with the current version in the system.

NotFoundException - if the propertyset or the propertysetdefinition not found.

UnauthorizedException - if the current user is not authorized to update IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

ValidationFailedException - if the property's name is null or its value fails to validate according to the propertydefinition that is mapped to this property in the propertysetdefinition identified by the given setDefinitionName.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

removeProperty

<T extends java.io.Serializable> IProperty<T> removeProperty(IContext context,
                                                             IPropertySetDefinitionName setDefinitionName,
                                                             IPropertySetName setName,
                                                             IProperty<T> property)
                                                         throws ObjectOutOfSyncException,
                                                                UnauthorizedException

Removes the given property from the propertyset identified by the given setDefinitionName and the setName. If the optimistic concurrency feature is enabled, this method removes the given property optimistically, it is removed only if its updatedOn time matches the updatedOn time of the property in the system.

Type Parameters:

T - property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

property - a property to update.

Returns:

the removed property.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given property doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

removeProperty

<T extends java.io.Serializable> IProperty<T> removeProperty(IContext context,
                                                             IPropertySetDefinitionName setDefinitionName,
                                                             IPropertySetName setName,
                                                             IPropertyName propertyName)
                                                         throws UnauthorizedException

Removes the property identified by the given name propertyName from the propertyset identified by the given setDefinitionName and the setName.

Type Parameters:

T - the property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

propertyName - a property's name.

Returns:

the removed property.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

removeProperty

<T extends java.io.Serializable> IProperty<T> removeProperty(IContext context,
                                                             IPropertySetDefinitionName setDefinitionName,
                                                             IPropertySetName setName,
                                                             IName propertyName)
                                                         throws UnauthorizedException

Removes the property identified by the given name propertyName from the propertyset identified by the given setDefinitionName and the setName.

Type Parameters:

T - the property value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

propertyName - a property's name. this should be an instan

Returns:

the removed property.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this property.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

removeAllProperties

void removeAllProperties(IContext context,
                         IPropertySetDefinitionName setDefinitionName,
                         IPropertySetName setName)
                         throws UnauthorizedException

Clears the propertyset identified by the given setDefinitionName and setName by removing all the properties from it.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) all properties.

OperationFailedException - if the backing IPropertyLocator is unable to update the named propertyset.

getPropertySetDefinitions

IPagedList<IPropertySetDefinition> getPropertySetDefinitions(IContext context,
                                                             PaginationContext paginationContext)

Retrieves a paged list of propertysetdefinitions in this namespace getNamespaceName(). The paged list size and starting index is determined by the given paginationContext. The paged list will be empty if the current authenticated user is not authorized to read the propertysetdefinitions. This indirectly calls IDefinitionLocator.filter(IContext, INamespaceName, oracle.wcps.property.filter.PropertySetDefinitionFilterContext)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

paginationContext - containing page size and starting index

Returns:

a paged list of propertysetdefinitions.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to retrieve the propertysetdefinitions.

getPropertySetDefinition

IPropertySetDefinition getPropertySetDefinition(IContext context,
                                                IPropertySetDefinitionName propertySetDefinitionName)

Retrieves the propertysetdefinition identified by the given propertySetDefinitionName. This indirectly calls IDefinitionLocator.loadPropertySetDefinition(IContext, INamespaceName, IPropertySetDefinitionName).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

Returns:

the propertysetdefinition if found otherwise null.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to retrieve the propertysetdefinition.

createPropertySetDefinition

IPropertySetDefinition createPropertySetDefinition(IContext context,
                                                   IPropertySetDefinition propertySetDefinition)
                                                   throws AlreadyExistsException

Creates the given propertySetDefinition. If the given propertysetdefinition's name is not set system will generate an UUID UUID and use it as its name. This indirectly calls IDefinitionLocator.storePropertySetDefinition(IContext, IPropertySetDefinition).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinition - a new propertysetdefinition.

Returns:

the newly created propertysetdefinition.

Throws:

AlreadyExistsException - if the system already contains the given propertysetdefinition.

OperationFailedException - if the backing IDefinitionLocator is unable to create the propertysetdefinition.

updatePropertySetDefinition

IPropertySetDefinition updatePropertySetDefinition(IContext context,
                                                   IPropertySetDefinition propertySetDefinition)
                                                   throws NotFoundException,
                                                          ObjectInUseException,
                                                          ObjectOutOfSyncException,
                                                          OperationFailedException

Updates an existing propertysetdefinition by replacing it with the given propertySetDefinition. If the optimistic concurrency feature is enabled IContext.isOptimisticConcurrencyEnabled(), this method updates the given propertysetdefinition optimistically. The given propertySetDefinition is updated only if its updatedOn time matches with the existing propertysetdefinition's updatedOn time. This indirectly calls IDefinitionLocator.storePropertySetDefinition(IContext, IPropertySetDefinition). Note: This update is very restricted and only allows updates if a new property mapping is added.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinition - a propertysetdefinition that was retrieved from the system.

Returns:

an updated propertysetdefinition.

Throws:

NotFoundException - if the propertysetdefinition was not created before.

ObjectInUseException - if there are propertysets that refer this. Remove all the propertysets first by calling removeAllPropertySets(IContext, IPropertySetDefinitionName) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to update the propertysetdefinition.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertySetDefinition doesn't match with the current version in the system.

removePropertySetDefinition

IPropertySetDefinition removePropertySetDefinition(IContext context,
                                                   IPropertySetDefinition propertySetDefinition)
                                                   throws ObjectInUseException,
                                                          ObjectOutOfSyncException

Removes the given propertysetdefinition propertySetDefinition. If the optimistic concurrency feature is enabled, this method removes the given propertySetDefinition optimistically, it is removed only if its updatedOn time matches the updatedOn time of the existing propertysetdefinition in the system. This indirectly calls IDefinitionLocator.remove(IContext, INamespaceName, oracle.wcps.property.model.PropertySetDefinitionName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinition - a propertysetdefinition that was retrieved from the system.

Returns:

the removed propertysetdefinition.

Throws:

ObjectInUseException - if there are propertysets that refer this. Remove all the propertysets first by calling removeAllPropertySets(IContext, IPropertySetDefinitionName) and then call this method to avoid getting this exception.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertySetDefinition doesn't match with the current version in the system.

OperationFailedException - if the backing IDefinitionLocator is unable to remove the given propertysetdefinition.

removePropertySetDefinition

IPropertySetDefinition removePropertySetDefinition(IContext context,
                                                   IPropertySetDefinitionName propertySetDefinitionName)
                                                   throws ObjectInUseException

Removes the named propertysetdefinition. This indirectly calls IDefinitionLocator.remove(IContext, INamespaceName, oracle.wcps.property.model.PropertySetDefinitionName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - the name of a propertysetdefinition.

Returns:

the removed propertysetdefinition.

Throws:

ObjectInUseException - if there are propertysets that refer this. Remove all the propertysets first by calling removeAllPropertySets(IContext, IPropertySetDefinitionName) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to remove the named propertysetdefinition.

removeAllPropertySetDefinitions

void removeAllPropertySetDefinitions(IContext context)
                                     throws ObjectInUseException

Removes all the propertysetdefinitions found in the namespace returned by the method getNamespaceName(). This indirectly calls IDefinitionLocator.removeAllPropertySetDefinitions(IContext, INamespaceName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

Throws:

ObjectInUseException - if there is a propertyset referring one of the propertysetdefinitions. Remove all the propertysets for each propertysetdefinition by calling removeAllPropertySets(IContext, IPropertySetDefinitionName) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to remove the propertysetdefinitions.

filter

IPagedList<IPropertySetDefinition> filter(IContext context,
                                          PropertySetDefinitionFilterContext filterContext)

Filters the propertysetdefinitions within the scope of the namespace getNamespaceName() and based on the given filterContext. This indirectly calls IDefinitionLocator.filter(IContext, INamespaceName, oracle.wcps.property.filter.PropertySetDefinitionFilterContext).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

filterContext - a filter context that contains search expression and pagination context.

Returns:

the paged list of propertysetdefinitions that satisfies the given filter context.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to filter the propertysetdefinitions.

getPropertyDefinitions

IPagedList<IPropertyDefinition> getPropertyDefinitions(IContext context,
                                                       PaginationContext paginationContext)

Retrieves a paged list of propertydefinitions in this namespace getNamespaceName(). The paged list size and starting index is determined by the given paginationContext. The paged list will be empty if the current authenticated user is not authorized to read the propertydefinitions. This indirectly calls IDefinitionLocator.filter(IContext, INamespaceName, oracle.wcps.property.filter.PropertyDefinitionFilterContext)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

paginationContext - containing page size and starting index

Returns:

a paged list of propertydefinitions.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to retrieve the propertydefinitions.

getPropertyDefinition

IPropertyDefinition getPropertyDefinition(IContext context,
                                          IPropertyDefinitionName propertyDefinitionName)

Retrieves the propertydefinition identified by the given propertyDefinitionName. This indirectly calls IDefinitionLocator.loadPropertyDefinition(IContext, INamespaceName, IPropertyDefinitionName).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertyDefinitionName - a propertydefinition's name.

Returns:

a propertydefinition if found otherwise null.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to retrieve the propertydefinition.

createPropertyDefinition

IPropertyDefinition createPropertyDefinition(IContext context,
                                             IPropertyDefinition propertyDefinition)
                                             throws AlreadyExistsException

Creates the given propertyDefinition. If the given propertydefinition's name is not set system will generate an UUID UUID and use it as its name. This indirectly calls IDefinitionLocator.storePropertyDefinition(IContext, IPropertyDefinition).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertyDefinition - a new propertydefinition.

Returns:

the newly created propertydefinition.

Throws:

AlreadyExistsException - if the system already contains the given propertydefinition.

OperationFailedException - if the backing IDefinitionLocator is unable to create the propertydefinition.

updatePropertyDefinition

IPropertyDefinition updatePropertyDefinition(IContext context,
                                             IPropertyDefinition propertyDefinition)
                                             throws NotFoundException,
                                                    ObjectInUseException,
                                                    ObjectOutOfSyncException,
                                                    OperationFailedException

Updates an existing propertydefinition by replacing it with the given propertyDefinition. If the optimistic concurrency feature is enabled IContext.isOptimisticConcurrencyEnabled(), this method updates the given propertydefinition optimistically. The given propertyDefinition is updated only if the updatedOn time matches with the existing propertydefinition's updatedOn time. This indirectly calls IDefinitionLocator.storePropertyDefinition(IContext, IPropertyDefinition).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertyDefinition - a propertydefinition that was retrieved from the system.

Returns:

an updated propertydefinition.

Throws:

NotFoundException - if the propertydefinition was not created before.

ObjectInUseException - if there are propertysetdefinitions that refer this, please remove all the propertysetdefinitions first by calling removeAllPropertySetDefinitions(IContext) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to update the propertysetdefinition.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertySetDefinition doesn't match with the current version in the system.

removePropertyDefinition

IPropertyDefinition removePropertyDefinition(IContext context,
                                             IPropertyDefinition propertyDefinition)
                                             throws ObjectInUseException,
                                                    ObjectOutOfSyncException

Removes the given propertydefinition propertyDefinition. If the optimistic concurrency feature is enabled, this method removes propertyDefinition optimistically, it is removed only if its updatedOn time matches the updatedOn time of the existing propertydefinition in the system. This indirectly calls IDefinitionLocator.remove(IContext, INamespaceName, oracle.wcps.property.model.PropertyDefinitionName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertyDefinition - a propertydefinition that was retrieved from the system.

Returns:

the removed propertydefinition.

Throws:

ObjectInUseException - if there are propertysetdefinitions that refer this. Remove all the propertysetdefinitions first by calling removeAllPropertySetDefinitions(IContext) and then call this to avoid getting this exception.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given propertyDefinition doesn't match with the current version in the system.

OperationFailedException - if the backing IDefinitionLocator is unable to remove the given propertydefinition.

removePropertyDefinition

IPropertyDefinition removePropertyDefinition(IContext context,
                                             IPropertyDefinitionName propertyDefinitionName)
                                             throws ObjectInUseException

Removes the named propertydefinition. This indirectly calls IDefinitionLocator.remove(IContext, INamespaceName, oracle.wcps.property.model.PropertyDefinitionName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertyDefinitionName - the name of a propertydefinition.

Returns:

the removed propertydefinition.

Throws:

ObjectInUseException - if there are propertysetdefinitions that refer this. Remove all the propertysetdefinitions first by calling removeAllPropertySetDefinitions(IContext) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to remove the named propertydefinition.

removeAllPropertyDefinitions

void removeAllPropertyDefinitions(IContext context)
                                  throws ObjectInUseException

Removes all the propertydefinitions found in the namespace returned by the method getNamespaceName(). This indirectly calls IDefinitionLocator.removeAllPropertyDefinitions(IContext, INamespaceName)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

Throws:

ObjectInUseException - if there is at least one propertysetdefinition referring this. Remove all the propertysetdefinitions referring this by calling removeAllPropertySetDefinitions(IContext) and then call this to avoid getting this exception.

OperationFailedException - if the backing IDefinitionLocator is unable to remove propertydefinitions.

filter

IPagedList<IPropertyDefinition> filter(IContext context,
                                       PropertyDefinitionFilterContext filterContext)

Filters the propertydefinitions within the scope of the namespace getNamespaceName() and based on the given filterContext. This indirectly calls IDefinitionLocator.filter(IContext, INamespaceName, oracle.wcps.property.filter.PropertyDefinitionFilterContext).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

filterContext - a filter context that contains search expression and pagination context.

Returns:

the paged list of propertydefinitions that satisfies the given filter context.

Throws:

OperationFailedException - if the backing IDefinitionLocator is unable to filter propertydefinitions.

getPreferenceSets

IPagedList<IPreferenceSet> getPreferenceSets(IContext context,
                                             IPropertySetDefinitionName propertySetDefinitionName,
                                             IPropertySetName propertySetName,
                                             PaginationContext paginationContext)
                                             throws OperationFailedException

Retrieves a paged list of preferencesets for the given propertysetdefinition name propertyDefinitionName and the given propertyset name. The paged list's size and the starting index is determined by the given paginationContext. The paged list will be empty if the current user is not authorized to read the preferencesets. This indirectly calls IPreferenceLocator.filter(IContext, INamespaceName, IPropertySetDefinitionName, IPropertySetName, oracle.wcps.property.filter.PreferenceSetFilterContext).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

paginationContext - contains a page size and a starting index.

Returns:

a paged list of preference sets.

Throws:

OperationFailedException - if the backing IPreferenceLocator is unable to retrieve the preferencesets.

getPreferenceSet

IPreferenceSet getPreferenceSet(IContext context,
                                IPropertySetDefinitionName propertySetDefinitionName,
                                IPropertySetName propertySetName,
                                IPreferenceSetName preferenceSetName)
                                throws UnauthorizedException

Retrieves the preferenceset identified by the given propertyDefinitionName ,the propertySetName and the preferenceSetName. This indirectly calls IPreferenceLocator.loadPreferences(IContext, IPreferenceSet, IPropertySetDefinition, java.util.List).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

preferenceSetName - a preferenceset's name.

Returns:

the preferenceset if found otherwise null.

Throws:

UnauthorizedException - if the currently user is not authorized to read IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preferenceset.

OperationFailedException - if the backing IPropertyLocator is unable to retrieve the preferenceset.

createPreferenceSet

IPreferenceSet createPreferenceSet(IContext context,
                                   IPreferenceSet preferenceSet)
                                   throws AlreadyExistsException,
                                          ValidationFailedException,
                                          NotFoundException,
                                          UnauthorizedException

Creates the given preferenceSet. If the given preferenceset's name is not set the system will generate an UUID UUID and use it as its name. The returned preferenceset will have values for createdOn and updatedOn set by the system. This indirectly calls IPreferenceLocator.storePreferences(IContext, IPreferenceSet, IPropertySetDefinition, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties set.

preferenceSet - a new preferenceset.

Returns:

the newly created preferenceset.

Throws:

AlreadyExistsException - if the system already contains the given preferenceset.

ValidationFailedException - if the preference values fail validation according to their propertydefinitions.

NotFoundException - if the propertysetdefinition or propertyset identified by the name in the given preferenceSet IPreferenceSet.getPropertySetDefinitionName() or IPreferenceSet.getPropertySetName() is not found in the system.

UnauthorizedException - if the currently user is not authorized to create IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preferenceset.

OperationFailedException - if the backing IPreferenceLocator is unable to create the preferenceset.

See Also:

IPropertySetDefinition, IPropertyDefinition

updatePreferenceSet

IPreferenceSet updatePreferenceSet(IContext context,
                                   IPreferenceSet preferenceSet)
                                   throws NotFoundException,
                                          ValidationFailedException,
                                          ObjectOutOfSyncException,
                                          UnauthorizedException

Updates an existing preferenceset by replacing it with the given preferenceSet. If the optimistic concurrency feature is enabled IContext.isOptimisticConcurrencyEnabled(), this method updates the given preferenceset optimistically. The given preferenceSet is updated only if its updatedOn time matches with the existing preferenceset's updatedOn time. This indirectly calls IPreferenceLocator.storePreferences(IContext, IPreferenceSet, IPropertySetDefinition, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

preferenceSet - a preferenceset that was retrieved from the system.

Returns:

the updated preferenceset.

Throws:

NotFoundException - if the given preferenceset was not created before or if the propertysetdefinition referred by the given preferenceset is not found in the system.

ValidationFailedException - if a preference's value fails validation according to the associated propertydefinition. The propertydefinition is associated to a preference name in a preference mapping IPreferenceMapping found in the propertysetdefinition IPropertySetDefinition which is associated to the given preferenceSet.

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given preferenceSet doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to update IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this propertyset.

OperationFailedException - if the backing IPreferenceLocator is unable to update the given preferenceset.

removePreferenceSet

IPreferenceSet removePreferenceSet(IContext context,
                                   IPreferenceSet preferenceSet)
                                   throws ObjectOutOfSyncException,
                                          UnauthorizedException

Removes the given preferenceset preferenceSet. If the optimistic concurrency feature is enabled, this method removes the given preferenceSet optimistically, it is removed only if its updatedOn time matches the updatedOn time of the existing preferenceset in the system. This indirectly calls IPropertyLocator.removeProperties(IContext, IPropertySet, java.util.List)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

preferenceSet - a preferenceset that was retrieved from the system.

Returns:

The removed preferenceset.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given preferenceSet doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId)this preferenceset.

OperationFailedException - if the backing IPreferenceLocator is unable to remove the given preferenceset.

removePreferenceSet

IPreferenceSet removePreferenceSet(IContext context,
                                   IPropertySetDefinitionName propertySetDefinitionName,
                                   IPropertySetName propertySetName,
                                   IPreferenceSetName preferenceSetName)
                                   throws UnauthorizedException

Removes the preferenceset identified the given propertySetDefinitionName, propertySetName and the preferenceSetName. This indirectly calls IPreferenceLocator.removePreferences(IContext, IPreferenceSet, java.util.List).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset name.

preferenceSetName - a preferenceset's name.

Returns:

the removed preferenceset.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preferenceset.

OperationFailedException - if the backing IPropertyLocator is unable to remove the preferenceset.

removeAllPreferenceSets

void removeAllPreferenceSets(IContext context,
                             IPropertySetDefinitionName setDefinitionName,
                             IPropertySetName propertySetName)
                             throws UnauthorizedException

Removes all the preferencesets within the scope of the namespace returned by the method getNamespaceName() , the given setDefinitionName and the given propertySetName. This indirectly calls IPreferenceLocator.removePreferences(IContext, INamespaceName, IPropertySetDefinitionName, IPropertySetName).

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) all preferencesets.

OperationFailedException - if the backing IPropertyLocator is unable to remove all the preferencesets.

filter

IPagedList<IPreferenceSet> filter(IContext context,
                                  IPropertySetDefinitionName setDefinitionName,
                                  IPropertySetName propertySetName,
                                  PreferenceSetFilterContext filterContext)

Filters the preferencesets within the scope of the given setDefinitionName, the namespace getNamespaceName(), the propertySetName and based on the given filterContext. This indirectly calls IPreferenceLocator.filter(IContext, INamespaceName, IPropertySetDefinitionName, IPropertySetName, oracle.wcps.property.filter.PreferenceSetFilterContext)

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

filterContext - a filter context that contains search expression and pagination context.

Returns:

the paged list of preferencesets that satisfies the given filter context.

Throws:

OperationFailedException - if the backing IPropertyLocator is unable to filter the preferencesets.

getPreference

<T extends java.io.Serializable> IPreference<T> getPreference(IContext context,
                                                              IPropertySetDefinitionName propertySetDefinitionName,
                                                              IPropertySetName propertySetName,
                                                              IPreferenceSetName prefSetName,
                                                              java.lang.String prefName)
                                                          throws UnauthorizedException

Retrieves the preference identified by the given prefName from the preferenceset identified by the given propertySetDefinitionName and the propertySetName and the prefSetName.

Type Parameters:

T - preference value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

propertySetDefinitionName - a propertysetdefinition's name.

propertySetName - a propertyset's name.

prefSetName - a preferenceset's name.

prefName - a preference's name.

Returns:

a preference.

Throws:

UnauthorizedException - if the current user is not authorized to read IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preference.

OperationFailedException - if the backing IPreferenceLocator is unable to retrieve the named preferenceset.

createPreference

<T extends java.io.Serializable> IPreference<T> createPreference(IContext context,
                                                                 IPropertySetDefinitionName setDefinitionName,
                                                                 IPropertySetName setName,
                                                                 IPreferenceSetName prefSetName,
                                                                 IPreference<T> pref)
                                                             throws AlreadyExistsException,
                                                                    NotFoundException,
                                                                    UnauthorizedException,
                                                                    ValidationFailedException

Creates a new property in the propertyset identified by the given setDefinitionName and the setName.

Type Parameters:

T - preference value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

prefSetName - a preferenceset's name.

pref - a new preference to create.

Returns:

the newly created preference.

Throws:

AlreadyExistsException - if the preferenceset already contains this preference.

NotFoundException - if the preferenceset or the propertyset or the propertysetdefinition are not found.

UnauthorizedException - if the current user is not authorized to create IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preference.

ValidationFailedException - if the property's name is null or its value fails to validate according to the propertydefinition that is mapped to this property in the propertysetdefinition identified by the given setDefinitionName.

OperationFailedException - if the backing IPreferenceLocator is unable to update the named preferenceset.

updatePreference

<T extends java.io.Serializable> IPreference<T> updatePreference(IContext context,
                                                                 IPropertySetDefinitionName setDefinitionName,
                                                                 IPropertySetName setName,
                                                                 IPreferenceSetName prefSetName,
                                                                 IPreference<T> pref)
                                                             throws ObjectOutOfSyncException,
                                                                    NotFoundException,
                                                                    UnauthorizedException,
                                                                    ValidationFailedException

Updates the given preference in the preferenceset identified by the given setDefinitionName and the setName and the prefSetName.

Type Parameters:

T - preference value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

prefSetName - a preferenceset's name.

pref - a preference to update.

Returns:

the updated preference.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given property doesn't match with the current version in the system.

NotFoundException - if the propertyset or the propertysetdefinition not found.

UnauthorizedException - if the current user is not authorized to update IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preference.

ValidationFailedException - if the preference's name is null or its value fails to validate according to the propertydefinition that is mapped to this preference in the propertysetdefinition identified by the given setDefinitionName.

OperationFailedException - if the backing IPreferenceLocator is unable to update the named preferenceset.

removePreference

<T extends java.io.Serializable> IPreference<T> removePreference(IContext context,
                                                                 IPropertySetDefinitionName setDefinitionName,
                                                                 IPropertySetName setName,
                                                                 IPreferenceSetName prefSetName,
                                                                 IPreference<T> pref)
                                                             throws ObjectOutOfSyncException,
                                                                    UnauthorizedException

Removes the given preference from the preferenceset identified by the given setDefinitionName and the setName and the prefSetName. If the optimistic concurrency feature is enabled, this method removes the given preference optimistically, it is removed only if its updatedOn time matches the updatedOn time of the preference in the system.

Type Parameters:

T - preference value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

prefSetName - a preferenceset's name.

pref - a preference to update.

Returns:

the removed preference.

Throws:

ObjectOutOfSyncException - if the optimistic concurrency feature is enabled and updatedOn time of the given preference doesn't match with the current version in the system.

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preference.

OperationFailedException - if the backing IPreferenceLocator is unable to update the named preferenceset.

removePreference

<T extends java.io.Serializable> IPreference<T> removePreference(IContext context,
                                                                 IPropertySetDefinitionName setDefinitionName,
                                                                 IPropertySetName setName,
                                                                 IPreferenceSetName prefSetName,
                                                                 IPreferenceName preferenceName)
                                                             throws UnauthorizedException

Removes the preference identified by the given name preferenceName from the preferenceset identified by the given setDefinitionName and the setName and prefSetName.

Type Parameters:

T - the preference value's type.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

prefSetName - a preferenceset's name.

preferenceName - a preference's name.

Returns:

the removed preference.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) this preference.

OperationFailedException - if the backing IPreferenceLocator is unable to update the named preferenceset.

removeAllPreferences

void removeAllPreferences(IContext context,
                          IPropertySetDefinitionName setDefinitionName,
                          IPropertySetName setName,
                          IPreferenceSetName prefSetName)
                          throws UnauthorizedException

Clears the preferenceset identified by the given setDefinitionName and setName and prefSetName by removing all the preferences from it.

Parameters:

context - a property service context. If this API is accessed remotely this context must have remote properties.

setDefinitionName - a propertysetdefinition's name.

setName - a propertyset's name.

prefSetName - a preferenceset's name.

Throws:

UnauthorizedException - if the current user is not authorized to remove IPropertyPermission.isAllowed(IContext, oracle.wcps.property.security.Capability, oracle.wcps.property.security.IResourceId) all preferences.

OperationFailedException - if the backing IPreferenceLocator is unable to update the named preferenceset.

Skip navigation links