org.opends.server.admin.std.client
Interface ReplicationSynchronizationProviderCfgClient

All Superinterfaces:
ConfigurationClient, SynchronizationProviderCfgClient

public interface ReplicationSynchronizationProviderCfgClient
extends SynchronizationProviderCfgClient

A client-side interface for reading and modifying Replication Synchronization Provider settings.

The Replication Synchronization Provider provides multi-master replication of data across multiple Directory Server instances.


Method Summary
<C extends ReplicationDomainCfgClient>
C
createReplicationDomain(ManagedObjectDefinition<C,? extends ReplicationDomainCfg> d, java.lang.String name, java.util.Collection<DefaultBehaviorException> exceptions)
          Creates a new Replication Domain.
<C extends ReplicationServerCfgClient>
C
createReplicationServer(ManagedObjectDefinition<C,? extends ReplicationServerCfg> d, java.util.Collection<DefaultBehaviorException> exceptions)
          Creates a new Replication Server.
 ManagedObjectDefinition<? extends ReplicationSynchronizationProviderCfgClient,? extends ReplicationSynchronizationProviderCfg> definition()
          Get the configuration definition associated with this Replication Synchronization Provider.
 java.lang.String getJavaClass()
          Gets the "java-class" property.
 int getNumUpdateReplayThreads()
          Gets the "num-update-replay-threads" property.
 ReplicationDomainCfgClient getReplicationDomain(java.lang.String name)
          Gets the named Replication Domain.
 ReplicationServerCfgClient getReplicationServer()
          Gets the Replication Server if it is present.
 boolean hasReplicationServer()
          Determines whether or not the Replication Server exists.
 java.lang.String[] listReplicationDomains()
          Lists the Replication Domains.
 void removeReplicationDomain(java.lang.String name)
          Removes the named Replication Domain.
 void removeReplicationServer()
          Removes the Replication Server if it exists.
 void setJavaClass(java.lang.String value)
          Sets the "java-class" property.
 void setNumUpdateReplayThreads(java.lang.Integer value)
          Sets the "num-update-replay-threads" property.
 
Methods inherited from interface org.opends.server.admin.std.client.SynchronizationProviderCfgClient
isEnabled, setEnabled
 
Methods inherited from interface org.opends.server.admin.ConfigurationClient
commit, properties
 

Method Detail

definition

ManagedObjectDefinition<? extends ReplicationSynchronizationProviderCfgClient,? extends ReplicationSynchronizationProviderCfg> definition()
Get the configuration definition associated with this Replication Synchronization Provider.

Specified by:
definition in interface ConfigurationClient
Specified by:
definition in interface SynchronizationProviderCfgClient
Returns:
Returns the configuration definition associated with this Replication Synchronization Provider.

getJavaClass

java.lang.String getJavaClass()
Gets the "java-class" property.

Specifies the fully-qualified name of the Java class that provides the Replication Synchronization Provider implementation.

Specified by:
getJavaClass in interface SynchronizationProviderCfgClient
Returns:
Returns the value of the "java-class" property.

setJavaClass

void setJavaClass(java.lang.String value)
                  throws IllegalPropertyValueException
Sets the "java-class" property.

Specifies the fully-qualified name of the Java class that provides the Replication Synchronization Provider implementation.

Specified by:
setJavaClass in interface SynchronizationProviderCfgClient
Parameters:
value - The value of the "java-class" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getNumUpdateReplayThreads

int getNumUpdateReplayThreads()
Gets the "num-update-replay-threads" property.

Specifies the number of update replay threads.

This value is the number of threads created for replaying every updates received for all the replication domains.

Returns:
Returns the value of the "num-update-replay-threads" property.

setNumUpdateReplayThreads

void setNumUpdateReplayThreads(java.lang.Integer value)
                               throws IllegalPropertyValueException
Sets the "num-update-replay-threads" property.

Specifies the number of update replay threads.

This value is the number of threads created for replaying every updates received for all the replication domains.

Parameters:
value - The value of the "num-update-replay-threads" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

listReplicationDomains

java.lang.String[] listReplicationDomains()
                                          throws ConcurrentModificationException,
                                                 AuthorizationException,
                                                 CommunicationException
Lists the Replication Domains.

Returns:
Returns an array containing the names of the Replication Domains.
Throws:
ConcurrentModificationException - If this Replication Synchronization Provider has been removed from the server by another client.
AuthorizationException - If the server refuses to list the Replication Domains because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

getReplicationDomain

ReplicationDomainCfgClient getReplicationDomain(java.lang.String name)
                                                throws DefinitionDecodingException,
                                                       ManagedObjectDecodingException,
                                                       ManagedObjectNotFoundException,
                                                       ConcurrentModificationException,
                                                       AuthorizationException,
                                                       CommunicationException
Gets the named Replication Domain.

Parameters:
name - The name of the Replication Domain to retrieve.
Returns:
Returns the named Replication Domain.
Throws:
DefinitionDecodingException - If the named Replication Domain was found but its type could not be determined.
ManagedObjectDecodingException - If the named Replication Domain was found but one or more of its properties could not be decoded.
ManagedObjectNotFoundException - If the named Replication Domain was not found on the server.
ConcurrentModificationException - If this Replication Synchronization Provider has been removed from the server by another client.
AuthorizationException - If the server refuses to retrieve the named Replication Domain because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

createReplicationDomain

<C extends ReplicationDomainCfgClient> C createReplicationDomain(ManagedObjectDefinition<C,? extends ReplicationDomainCfg> d,
                                                                 java.lang.String name,
                                                                 java.util.Collection<DefaultBehaviorException> exceptions)
                                                             throws IllegalManagedObjectNameException
Creates a new Replication Domain. The new Replication Domain will initially not contain any property values (including mandatory properties). Once the Replication Domain has been configured it can be added to the server using the ConfigurationClient.commit() method.

Type Parameters:
C - The type of the Replication Domain being created.
Parameters:
d - The definition of the Replication Domain to be created.
name - The name of the new Replication Domain.
exceptions - An optional collection in which to place any DefaultBehaviorExceptions that occurred whilst attempting to determine the default values of the Replication Domain. This argument can be null.
Returns:
Returns a new Replication Domain configuration instance.
Throws:
IllegalManagedObjectNameException - If the name of the new Replication Domain is invalid.

removeReplicationDomain

void removeReplicationDomain(java.lang.String name)
                             throws ManagedObjectNotFoundException,
                                    OperationRejectedException,
                                    ConcurrentModificationException,
                                    AuthorizationException,
                                    CommunicationException
Removes the named Replication Domain.

Parameters:
name - The name of the Replication Domain to remove.
Throws:
ManagedObjectNotFoundException - If the Replication Domain does not exist.
OperationRejectedException - If the server refuses to remove the Replication Domain due to some server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).
ConcurrentModificationException - If this Replication Synchronization Provider has been removed from the server by another client.
AuthorizationException - If the server refuses to remove the Replication Domain because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

hasReplicationServer

boolean hasReplicationServer()
                             throws ConcurrentModificationException,
                                    AuthorizationException,
                                    CommunicationException
Determines whether or not the Replication Server exists.

Returns:
Returns if the Replication Server exists.
Throws:
ConcurrentModificationException - If this Replication Synchronization Provider 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.

getReplicationServer

ReplicationServerCfgClient getReplicationServer()
                                                throws DefinitionDecodingException,
                                                       ManagedObjectDecodingException,
                                                       ManagedObjectNotFoundException,
                                                       ConcurrentModificationException,
                                                       AuthorizationException,
                                                       CommunicationException
Gets the Replication Server if it is present.

Returns:
Returns the Replication Server if it is present.
Throws:
DefinitionDecodingException - If the Replication Server was found but its type could not be determined.
ManagedObjectDecodingException - If the Replication Server was found but one or more of its properties could not be decoded.
ManagedObjectNotFoundException - If the Replication Server is not present.
ConcurrentModificationException - If this Replication Synchronization Provider has been removed from the server by another client.
AuthorizationException - If the server refuses to retrieve the Replication Server because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.

createReplicationServer

<C extends ReplicationServerCfgClient> C createReplicationServer(ManagedObjectDefinition<C,? extends ReplicationServerCfg> d,
                                                                 java.util.Collection<DefaultBehaviorException> exceptions)
Creates a new Replication Server. The new Replication Server will initially not contain any property values (including mandatory properties). Once the Replication Server has been configured it can be added to the server using the ConfigurationClient.commit() method.

Type Parameters:
C - The type of the Replication Server being created.
Parameters:
d - The definition of the Replication Server to be created.
exceptions - An optional collection in which to place any DefaultBehaviorExceptions that occurred whilst attempting to determine the default values of the Replication Server. This argument can be null.
Returns:
Returns a new Replication Server configuration instance.

removeReplicationServer

void removeReplicationServer()
                             throws ManagedObjectNotFoundException,
                                    OperationRejectedException,
                                    ConcurrentModificationException,
                                    AuthorizationException,
                                    CommunicationException
Removes the Replication Server if it exists.

Throws:
ManagedObjectNotFoundException - If the Replication Server does not exist.
OperationRejectedException - If the server refuses to remove the Replication Server due to some server-side constraint which cannot be satisfied (for example, if it is referenced by another managed object).
ConcurrentModificationException - If this Replication Synchronization Provider has been removed from the server by another client.
AuthorizationException - If the server refuses to remove the Replication Server because the client does not have the correct privileges.
CommunicationException - If the client cannot contact the server due to an underlying communication problem.