org.opends.server.admin.client

Interface ManagedObject<T extends ConfigurationClient>

Type Parameters:

T - The type of client configuration represented by the client managed object.

All Superinterfaces:

PropertyProvider

All Known Implementing Classes:

AbstractManagedObject

public interface ManagedObject<T extends ConfigurationClient>
extends PropertyProvider

A generic interface for accessing client-side managed objects.

A managed object comprises of zero or more properties. A property has associated with it three sets of property value(s). These are:

• default value(s) - these value(s) represent the default behavior for the property when it has no active values. When a property inherits its default value(s) from elsewhere (i.e. a property in another managed object), the default value(s) represent the active value(s) of the inherited property at the time the managed object was retrieved
• active value(s) - these value(s) represent the state of the property at the time the managed object was retrieved
• pending value(s) - these value(s) represent any modifications made to the property's value(s) since the managed object object was retrieved and before the changes have been committed using the commit() method, the pending values can be empty indicating that the property should be modified back to its default values.

In addition, a property has an effective state defined by its effective values which are derived by evaluating the following rules in the order presented:

• the pending values if defined and non-empty
• or, the default values if the pending values are defined but are empty
• or, the active values if defined and non-empty
• or, the default values if there are no active values
• or, an empty set of values, if there are no default values.

Field Summary

Fields inherited from interface org.opends.server.admin.PropertyProvider

DEFAULT_PROVIDER

Method Summary

Methods

Modifier and Type	Method and Description
void	commit() Adds this managed object to the server or commits any changes made to it depending on whether or not the managed object already exists on the server.
<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC>	createChild(InstantiableRelationDefinition<C,S> r, ManagedObjectDefinition<CC,? extends S> d, String name, Collection<PropertyException> exceptions) Creates a new child managed object bound to the specified instantiable relation.
<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC>	createChild(OptionalRelationDefinition<C,S> r, ManagedObjectDefinition<CC,? extends S> d, Collection<PropertyException> exceptions) Creates a new child managed object bound to the specified optional relation.
<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC>	createChild(SetRelationDefinition<C,S> r, ManagedObjectDefinition<CC,? extends S> d, Collection<PropertyException> exceptions) Creates a new child managed object bound to the specified set relation.
<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C>	getChild(InstantiableRelationDefinition<C,S> r, String name) Retrieves an instantiable child managed object.
<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C>	getChild(OptionalRelationDefinition<C,S> r) Retrieves an optional child managed object.
<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C>	getChild(SetRelationDefinition<C,S> r, String name) Retrieves a set child managed object.
<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C>	getChild(SingletonRelationDefinition<C,S> r) Retrieves a singleton child managed object.
T	getConfiguration() Creates a client configuration view of this managed object.
ManagedObjectDefinition<T,? extends Configuration>	getManagedObjectDefinition() Gets the definition associated with this managed object.
ManagedObjectPath<T,? extends Configuration>	getManagedObjectPath() Gets the path of this managed object.
<PD> SortedSet<PD>	getPropertyDefaultValues(PropertyDefinition<PD> pd) Gets a mutable copy of the set of default values for the specified property.
<PD> PD	getPropertyValue(PropertyDefinition<PD> pd) Gets the effective value of the specified property.
<PD> SortedSet<PD>	getPropertyValues(PropertyDefinition<PD> pd) Gets a mutable copy of the set of effective values for the specified property.
<C extends ConfigurationClient,S extends Configuration> boolean	hasChild(OptionalRelationDefinition<C,S> r) Determines whether or not the optional managed object associated with the specified optional relations exists.
boolean	isModified() Determines whether or not this managed object has been modified since it was constructed.
boolean	isPropertyPresent(PropertyDefinition<?> pd) Determines whether or not the specified property is set.
<C extends ConfigurationClient,S extends Configuration> String[]	listChildren(InstantiableRelationDefinition<C,S> r) Lists the child managed objects associated with the specified instantiable relation.
<C extends ConfigurationClient,S extends Configuration> String[]	listChildren(InstantiableRelationDefinition<C,S> r, AbstractManagedObjectDefinition<? extends C,? extends S> d) Lists the child managed objects associated with the specified instantiable relation which are a sub-type of the specified managed object definition.
<C extends ConfigurationClient,S extends Configuration> String[]	listChildren(SetRelationDefinition<C,S> r) Lists the child managed objects associated with the specified set relation.
<C extends ConfigurationClient,S extends Configuration> String[]	listChildren(SetRelationDefinition<C,S> r, AbstractManagedObjectDefinition<? extends C,? extends S> d) Lists the child managed objects associated with the specified set relation which are a sub-type of the specified managed object definition.
<C extends ConfigurationClient,S extends Configuration> void	removeChild(InstantiableRelationDefinition<C,S> r, String name) Removes the named instantiable child managed object.
<C extends ConfigurationClient,S extends Configuration> void	removeChild(OptionalRelationDefinition<C,S> r) Removes an optional child managed object.
<C extends ConfigurationClient,S extends Configuration> void	removeChild(SetRelationDefinition<C,S> r, String name) Removes s set child managed object.
<PD> void	setPropertyValue(PropertyDefinition<PD> pd, PD value) Sets a new pending value for the specified property.
<PD> void	setPropertyValues(PropertyDefinition<PD> pd, Collection<PD> values) Sets a new pending values for the specified property.

Method Detail

commit

void commit()
            throws ManagedObjectAlreadyExistsException,
                   MissingMandatoryPropertiesException,
                   ConcurrentModificationException,
                   OperationRejectedException,
                   AuthorizationException,
                   CommunicationException

Adds this managed object to the server or commits any changes made to it depending on whether or not the managed object already exists on the server. Pending property values will be committed to the managed object. If successful, the pending values will become active values.

See the class description for more information regarding pending and active values.

Throws:

ManagedObjectAlreadyExistsException - If the managed object cannot be added to the server because it already exists.

MissingMandatoryPropertiesException - If the managed object contains some mandatory properties which have been left undefined.

ConcurrentModificationException - If the managed object is being added to the server but its parent has been removed by another client, or if this managed object is being modified but it has been removed from the server by another client.

OperationRejectedException - If this managed object cannot be added or modified due to some client-side or server-side constraint which cannot be satisfied.

AuthorizationException - If the server refuses to add or modify this managed object because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

isModified

boolean isModified()

Determines whether or not this managed object has been modified since it was constructed. In other words, whether or not the set of pending values differs from the set of active values.

Returns:

Returns true if this managed object has been modified since it was constructed.

createChild

<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC> createChild(InstantiableRelationDefinition<C,S> r,
                                                                                                 ManagedObjectDefinition<CC,? extends S> d,
                                                                                                 String name,
                                                                                                 Collection<PropertyException> exceptions)
                                        throws IllegalManagedObjectNameException,
                                               IllegalArgumentException

Creates a new child managed object bound to the specified instantiable relation. The new managed object will initially not contain any property values (including mandatory properties). Once the managed object has been configured it can be added to the server using the commit() method.

Type Parameters:

C - The expected type of the child managed object configuration client.

S - The expected type of the child managed object server configuration.

CC - The actual type of the added managed object configuration client.

Parameters:

r - The instantiable relation definition.

d - The definition of the managed object to be created.

name - The name of the child managed object.

exceptions - A collection in which to place any PropertyExceptions that occurred whilst attempting to determine the managed object's default values.

Returns:

Returns a new child managed object bound to the specified instantiable relation.

Throws:

IllegalManagedObjectNameException - If the name of the child managed object is invalid.

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

createChild

<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC> createChild(OptionalRelationDefinition<C,S> r,
                                                                                                 ManagedObjectDefinition<CC,? extends S> d,
                                                                                                 Collection<PropertyException> exceptions)
                                        throws IllegalArgumentException

Creates a new child managed object bound to the specified optional relation. The new managed object will initially not contain any property values (including mandatory properties). Once the managed object has been configured it can be added to the server using the commit() method.

Type Parameters:

C - The expected type of the child managed object configuration client.

S - The expected type of the child managed object server configuration.

CC - The actual type of the added managed object configuration client.

Parameters:

r - The optional relation definition.

d - The definition of the managed object to be created.

exceptions - A collection in which to place any PropertyExceptions that occurred whilst attempting to determine the managed object's default values.

Returns:

Returns a new child managed object bound to the specified optional relation.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

createChild

<C extends ConfigurationClient,S extends Configuration,CC extends C> ManagedObject<CC> createChild(SetRelationDefinition<C,S> r,
                                                                                                 ManagedObjectDefinition<CC,? extends S> d,
                                                                                                 Collection<PropertyException> exceptions)
                                        throws IllegalArgumentException

Creates a new child managed object bound to the specified set relation. The new managed object will initially not contain any property values (including mandatory properties). Once the managed object has been configured it can be added to the server using the commit() method.

Type Parameters:

C - The expected type of the child managed object configuration client.

S - The expected type of the child managed object server configuration.

CC - The actual type of the added managed object configuration client.

Parameters:

r - The set relation definition.

d - The definition of the managed object to be created.

exceptions - A collection in which to place any PropertyExceptions that occurred whilst attempting to determine the managed object's default values.

Returns:

Returns a new child managed object bound to the specified set relation.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

getChild

<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C> getChild(InstantiableRelationDefinition<C,S> r,
                                                                                          String name)
                                                                throws IllegalArgumentException,
                                                                       DefinitionDecodingException,
                                                                       ManagedObjectDecodingException,
                                                                       ManagedObjectNotFoundException,
                                                                       ConcurrentModificationException,
                                                                       AuthorizationException,
                                                                       CommunicationException

Retrieves an instantiable child managed object.

Type Parameters:

C - The requested type of the child managed object configuration client.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The instantiable relation definition.

name - The name of the child managed object.

Returns:

Returns the instantiable child managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

DefinitionDecodingException - If the managed object was found but its type could not be determined.

ManagedObjectDecodingException - If the managed object was found but one or more of its properties could not be decoded.

ManagedObjectNotFoundException - If the requested managed object could not be found on the server.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to retrieve the managed object because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getChild

<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C> getChild(OptionalRelationDefinition<C,S> r)
                                                                throws IllegalArgumentException,
                                                                       DefinitionDecodingException,
                                                                       ManagedObjectDecodingException,
                                                                       ManagedObjectNotFoundException,
                                                                       ConcurrentModificationException,
                                                                       AuthorizationException,
                                                                       CommunicationException

Retrieves an optional child managed object.

Type Parameters:

C - The requested type of the child managed object configuration client.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The optional relation definition.

Returns:

Returns the optional child managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

DefinitionDecodingException - If the managed object was found but its type could not be determined.

ManagedObjectDecodingException - If the managed object was found but one or more of its properties could not be decoded.

ManagedObjectNotFoundException - If the requested managed object could not be found on the server.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to retrieve the managed object because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getChild

<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C> getChild(SingletonRelationDefinition<C,S> r)
                                                                throws IllegalArgumentException,
                                                                       DefinitionDecodingException,
                                                                       ManagedObjectDecodingException,
                                                                       ManagedObjectNotFoundException,
                                                                       ConcurrentModificationException,
                                                                       AuthorizationException,
                                                                       CommunicationException

Retrieves a singleton child managed object.

Type Parameters:

C - The requested type of the child managed object configuration client.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The singleton relation definition.

Returns:

Returns the singleton child managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

DefinitionDecodingException - If the managed object was found but its type could not be determined.

ManagedObjectDecodingException - If the managed object was found but one or more of its properties could not be decoded.

ManagedObjectNotFoundException - If the requested managed object could not be found on the server.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to retrieve the managed object because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getChild

<C extends ConfigurationClient,S extends Configuration> ManagedObject<? extends C> getChild(SetRelationDefinition<C,S> r,
                                                                                          String name)
                                                                throws IllegalArgumentException,
                                                                       DefinitionDecodingException,
                                                                       ManagedObjectDecodingException,
                                                                       ManagedObjectNotFoundException,
                                                                       ConcurrentModificationException,
                                                                       AuthorizationException,
                                                                       CommunicationException

Retrieves a set child managed object.

Type Parameters:

C - The requested type of the child managed object configuration client.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The set relation definition.

name - The name of the child managed object.

Returns:

Returns the set child managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

DefinitionDecodingException - If the managed object was found but its type could not be determined.

ManagedObjectDecodingException - If the managed object was found but one or more of its properties could not be decoded.

ManagedObjectNotFoundException - If the requested managed object could not be found on the server.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to retrieve the managed object because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getConfiguration

T getConfiguration()

Creates a client configuration view of this managed object. Modifications made to this managed object will be reflected in the client configuration view and vice versa.

Returns:

Returns a client configuration view of this managed object.

getManagedObjectDefinition

ManagedObjectDefinition<T,? extends Configuration> getManagedObjectDefinition()

Gets the definition associated with this managed object.

Returns:

Returns the definition associated with this managed object.

getManagedObjectPath

ManagedObjectPath<T,? extends Configuration> getManagedObjectPath()

Gets the path of this managed object.

Returns:

Returns the path of this managed object.

getPropertyDefaultValues

<PD> SortedSet<PD> getPropertyDefaultValues(PropertyDefinition<PD> pd)
                                       throws IllegalArgumentException

Gets a mutable copy of the set of default values for the specified property.

Type Parameters:

PD - The type of the property to be retrieved.

Parameters:

pd - The property to be retrieved.

Returns:

Returns the property's default values, or an empty set if there are no default values defined.

Throws:

IllegalArgumentException - If the property definition is not associated with this managed object's definition.

getPropertyValue

<PD> PD getPropertyValue(PropertyDefinition<PD> pd)
                    throws IllegalArgumentException

Gets the effective value of the specified property.

See the class description for more information about how the effective property value is derived.

Type Parameters:

PD - The type of the property to be retrieved.

Parameters:

pd - The property to be retrieved.

Returns:

Returns the property's effective value, or null if there is no effective value defined.

Throws:

IllegalArgumentException - If the property definition is not associated with this managed object's definition.

getPropertyValues

<PD> SortedSet<PD> getPropertyValues(PropertyDefinition<PD> pd)
                                throws IllegalArgumentException

Gets a mutable copy of the set of effective values for the specified property.

See the class description for more information about how the effective property values are derived.

Specified by:

getPropertyValues in interface PropertyProvider

Type Parameters:

PD - The type of the property to be retrieved.

Parameters:

pd - The property to be retrieved.

Returns:

Returns the property's effective values, or an empty set if there are no effective values defined.

Throws:

IllegalArgumentException - If the property definition is not associated with this managed object's definition.

isPropertyPresent

boolean isPropertyPresent(PropertyDefinition<?> pd)
                          throws IllegalArgumentException

Determines whether or not the specified property is set. If the property is unset, then any default behavior associated with the property applies.

Parameters:

pd - The property definition.

Returns:

Returns true if the property has been set, or false if it is unset and any default behavior associated with the property applies.

Throws:

IllegalArgumentException - If the property definition is not associated with this managed object's definition.

hasChild

<C extends ConfigurationClient,S extends Configuration> boolean hasChild(OptionalRelationDefinition<C,S> r)
                 throws IllegalArgumentException,
                        ConcurrentModificationException,
                        AuthorizationException,
                        CommunicationException

Determines whether or not the optional managed object associated with the specified optional relations exists.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The optional relation definition.

Returns:

Returns true if the optional managed object exists, false otherwise.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to make the determination because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

listChildren

<C extends ConfigurationClient,S extends Configuration> String[] listChildren(InstantiableRelationDefinition<C,S> r)
                      throws IllegalArgumentException,
                             ConcurrentModificationException,
                             AuthorizationException,
                             CommunicationException

Lists the child managed objects associated with the specified instantiable relation.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The instantiable relation definition.

Returns:

Returns the names of the child managed objects.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to list the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

listChildren

<C extends ConfigurationClient,S extends Configuration> String[] listChildren(InstantiableRelationDefinition<C,S> r,
                                                                            AbstractManagedObjectDefinition<? extends C,? extends S> d)
                      throws IllegalArgumentException,
                             ConcurrentModificationException,
                             AuthorizationException,
                             CommunicationException

Lists the child managed objects associated with the specified instantiable relation which are a sub-type of the specified managed object definition.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The instantiable relation definition.

d - The managed object definition.

Returns:

Returns the names of the child managed objects which are a sub-type of the specified managed object definition.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to list the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

listChildren

<C extends ConfigurationClient,S extends Configuration> String[] listChildren(SetRelationDefinition<C,S> r)
                      throws IllegalArgumentException,
                             ConcurrentModificationException,
                             AuthorizationException,
                             CommunicationException

Lists the child managed objects associated with the specified set relation.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The set relation definition.

Returns:

Returns the names of the child managed objects which for set relations are the definition names of each managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to list the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

listChildren

<C extends ConfigurationClient,S extends Configuration> String[] listChildren(SetRelationDefinition<C,S> r,
                                                                            AbstractManagedObjectDefinition<? extends C,? extends S> d)
                      throws IllegalArgumentException,
                             ConcurrentModificationException,
                             AuthorizationException,
                             CommunicationException

Lists the child managed objects associated with the specified set relation which are a sub-type of the specified managed object definition.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The set relation definition.

d - The managed object definition.

Returns:

Returns the names of the child managed objects which for set relations are the definition names of each managed object.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to list the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

removeChild

<C extends ConfigurationClient,S extends Configuration> void removeChild(InstantiableRelationDefinition<C,S> r,
                                                                       String name)
                 throws IllegalArgumentException,
                        ManagedObjectNotFoundException,
                        OperationRejectedException,
                        ConcurrentModificationException,
                        AuthorizationException,
                        CommunicationException

Removes the named instantiable child managed object.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The instantiable relation definition.

name - The name of the child managed object to be removed.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ManagedObjectNotFoundException - If the managed object could not be removed because it could not found on the server.

OperationRejectedException - If the managed object cannot be removed due to some client-side or server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to remove the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

removeChild

<C extends ConfigurationClient,S extends Configuration> void removeChild(OptionalRelationDefinition<C,S> r)
                 throws IllegalArgumentException,
                        ManagedObjectNotFoundException,
                        OperationRejectedException,
                        ConcurrentModificationException,
                        AuthorizationException,
                        CommunicationException

Removes an optional child managed object.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The optional relation definition.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ManagedObjectNotFoundException - If the managed object could not be removed because it could not found on the server.

OperationRejectedException - If the managed object cannot be removed due to some client-side or server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to remove the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

removeChild

<C extends ConfigurationClient,S extends Configuration> void removeChild(SetRelationDefinition<C,S> r,
                                                                       String name)
                 throws IllegalArgumentException,
                        ManagedObjectNotFoundException,
                        OperationRejectedException,
                        ConcurrentModificationException,
                        AuthorizationException,
                        CommunicationException

Removes s set child managed object.

Type Parameters:

C - The type of client managed object configuration that the relation definition refers to.

S - The type of server managed object configuration that the relation definition refers to.

Parameters:

r - The set relation definition.

name - The name of the child managed object to be removed.

Throws:

IllegalArgumentException - If the relation definition is not associated with this managed object's definition.

ManagedObjectNotFoundException - If the managed object could not be removed because it could not found on the server.

OperationRejectedException - If the managed object cannot be removed due to some client-side or server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).

ConcurrentModificationException - If this managed object has been removed from the server by another client.

AuthorizationException - If the server refuses to remove the managed objects because the client does not have the correct privileges.

CommunicationException - If the client cannot contact the server due to an underlying communication problem.

setPropertyValue

<PD> void setPropertyValue(PropertyDefinition<PD> pd,
                         PD value)
                      throws PropertyException,
                             IllegalArgumentException

Sets a new pending value for the specified property.

See the class description for more information regarding pending values.

Type Parameters:

PD - The type of the property to be modified.

Parameters:

pd - The property to be modified.

value - The new pending value for the property, or null if the property should be reset to its default behavior.

Throws:

PropertyException - If the new pending value is deemed to be invalid according to the property definition, or if this is not a new managed object and the property is read-only or for monitoring purposes, or if an attempt was made to remove a mandatory property.

IllegalArgumentException - If the specified property definition is not associated with this managed object.

setPropertyValues

<PD> void setPropertyValues(PropertyDefinition<PD> pd,
                          Collection<PD> values)
                       throws PropertyException,
                              IllegalArgumentException

Sets a new pending values for the specified property.

See the class description for more information regarding pending values.

Type Parameters:

PD - The type of the property to be modified.

Parameters:

pd - The property to be modified.

values - A non-null set of new pending values for the property (an empty set indicates that the property should be reset to its default behavior). The set will not be referenced by this managed object.

Throws:

PropertyException - If a new pending value is deemed to be invalid according to the property definition, or if an attempt was made to add multiple pending values to a single-valued property, or if this is not a new managed object and the property is read-only or for monitoring purposes, or if an attempt was made to remove a mandatory property.

IllegalArgumentException - If the specified property definition is not associated with this managed object.