svn commit: r485180 - /directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java

[tr...@apache.org]

Author: trustin
Date: Sun Dec 10 05:18:34 2006
New Revision: 485180

URL: http://svn.apache.org/viewvc?view=rev&rev=485180
Log:
Added JavaDoc for ClientConnectionManager

Modified:
    directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java

Modified: directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java
URL: http://svn.apache.org/viewvc/directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java?view=diff&rev=485180&r1=485179&r2=485180
==============================================================================
--- directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java (original)
+++ directory/trunks/apacheds/mitosis/src/main/java/org/apache/directory/mitosis/service/ClientConnectionManager.java Sun Dec 10 05:18:34 2006
@@ -28,6 +28,7 @@
 import org.apache.directory.mitosis.common.ReplicaId;
 import org.apache.directory.mitosis.configuration.ReplicationConfiguration;
 import org.apache.directory.mitosis.service.protocol.codec.ReplicationClientProtocolCodecFactory;
+import org.apache.directory.mitosis.service.protocol.handler.ReplicationClientContextHandler;
 import org.apache.directory.mitosis.service.protocol.handler.ReplicationClientProtocolHandler;
 import org.apache.directory.mitosis.service.protocol.handler.ReplicationProtocolHandler;
 import org.apache.mina.common.ConnectFuture;
@@ -51,6 +52,18 @@
 
 /**
  * Manages all outgoing connections to remote replicas.
+ * It gets the list of the peer {@link Replica}s from
+ * {@link ReplicationService} and keeps trying to connect to them.
+ * <p>
+ * When the connection attempt fails, the interval between each connection
+ * attempt doubles up (2, 4, 8, 16, ...) to 60 seconds at maximum.
+ * <p>
+ * Once the connection attempt succeeds, the interval value is reset to
+ * its initial value (0 second) and the established connection is handled
+ * by {@link ReplicationClientProtocolHandler}.
+ * The {@link ReplicationClientProtocolHandler} actually wraps
+ * a {@link ReplicationClientContextHandler} that drives the actual
+ * replication process.
  *
  * @author Trustin Lee
  * @version $Rev: 116 $, $Date: 2006-09-18 13:47:53Z $