Author: tommaso Date: Wed Sep 10 09:26:17 2014 New Revision: 1623955 URL: http://svn.apache.org/r1623955 Log: SLING-3891 - added README.md, fixing stale javadocs, adding some TODOs
Added: sling/trunk/contrib/extensions/replication/core/README.md Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/ReplicationAgent.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/CompactSimpleReplicationAgentFactory.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgent.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgentFactory.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/communication/ReplicationResponse.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/packaging/impl/exporter/AgentReplicationPackageExporterFactory.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueue.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueDistributionStrategy.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueItem.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueProvider.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/ErrorAwareQueueDistributionStrategy.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/PriorityPathDistributionStrategy.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/SingleQueueDistributionStrategy.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/jobhandling/JobHandlingReplicationQueue.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/simple/SimpleReplicationQueue.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/rule/impl/ChainReplicateReplicationRule.java sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/servlet/ReplicationPackageExporterServlet.java Added: sling/trunk/contrib/extensions/replication/core/README.md URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/README.md?rev=1623955&view=auto ============================================================================== --- sling/trunk/contrib/extensions/replication/core/README.md (added) +++ sling/trunk/contrib/extensions/replication/core/README.md Wed Sep 10 09:26:17 2014 @@ -0,0 +1,50 @@ +Sling Replication +================= + +This is the README for the Sling Replication module. + +Overview +======== + +Configuration +============= + +Resource providers +================== + +One can configure a resource provider for a replication resource to give access to OSGI replication services. +Already configured ones are: ReplicationAgents, ReplicationPackageExporters and ReplicationPackageImporters. +Here is an example of the configuration for exposing _ReplicationAgent_ services as resources: + + { + Â Â "jcr:primaryType" : "sling:OsgiConfig", + + Â Â "name" : "replicationAgents", + + Â Â "provider.roots" : [ "/libs/sling/replication/services/agents" ], + + Â Â "serviceType" : "org.apache.sling.replication.agent.ReplicationAgent", + + Â Â "resourceProperties" : [ + + Â Â Â Â "sling:resourceType=sling/replication/service/agent", + + Â Â Â Â "sling:resourceSuperType=sling/replication/service", + + Â Â Â Â "name={name}", + + Â Â Â Â "queue/sling:resourceType=replication/agent/queue" + + Â Â ] + + } + +When configuring such a provider you specify the service interface _ReplicationAgent_, the url and some properties one +wants that resource to have like resourceType so basically this config governs _/libs/sling/replication/services/agents_. +Sub resources to an agent can also be added, as the _queue_ for example and add properties to it by specifying _queue/propertyName = propertyValue_. +That's the mechanism to expose services as resources. + +HTTP API +======== + +See the [wiki](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=38572805). Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/ReplicationAgent.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/ReplicationAgent.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/ReplicationAgent.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/ReplicationAgent.java Wed Sep 10 09:26:17 2014 @@ -24,7 +24,11 @@ import org.apache.sling.replication.queu import org.apache.sling.replication.queue.ReplicationQueueException; /** - * A replication agent is responsible for delivering content to another instance + * A replication agent is responsible for handling {@link org.apache.sling.replication.communication.ReplicationRequest}s. + * + * This means executing actions of a specific {@link org.apache.sling.replication.communication.ReplicationActionType}s on + * specific path(s) which will resume in e.g. polling resources from a certain Sling instance and / or sending resources to + * other instances. */ public interface ReplicationAgent { Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/CompactSimpleReplicationAgentFactory.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/CompactSimpleReplicationAgentFactory.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/CompactSimpleReplicationAgentFactory.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/CompactSimpleReplicationAgentFactory.java Wed Sep 10 09:26:17 2014 @@ -31,7 +31,8 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** - * An OSGi service factory for {@link ReplicationAgent}s + * An OSGi service factory for {@link ReplicationAgent}s using a compact configuration, already existing OSGi services + * for the components to be wired can be used as well as directly instantiated components (called by type name). */ @Component(metatype = true, label = "Compact Replication Agents Factory", Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgent.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgent.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgent.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgent.java Wed Sep 10 09:26:17 2014 @@ -32,9 +32,16 @@ import org.apache.sling.replication.even import org.apache.sling.replication.packaging.ReplicationPackage; import org.apache.sling.replication.packaging.ReplicationPackageExporter; import org.apache.sling.replication.packaging.ReplicationPackageImporter; -import org.apache.sling.replication.queue.*; +import org.apache.sling.replication.queue.ReplicationQueue; +import org.apache.sling.replication.queue.ReplicationQueueDistributionStrategy; +import org.apache.sling.replication.queue.ReplicationQueueException; +import org.apache.sling.replication.queue.ReplicationQueueItem; +import org.apache.sling.replication.queue.ReplicationQueueItemState; +import org.apache.sling.replication.queue.ReplicationQueueProcessor; +import org.apache.sling.replication.queue.ReplicationQueueProvider; import org.apache.sling.replication.rule.ReplicationRuleEngine; -import org.apache.sling.replication.serialization.*; +import org.apache.sling.replication.serialization.ReplicationPackageBuildingException; +import org.apache.sling.replication.serialization.ReplicationPackageReadingException; import org.slf4j.Logger; import org.slf4j.LoggerFactory; @@ -85,13 +92,8 @@ public class SimpleReplicationAgent impl public ReplicationResponse execute(ReplicationRequest replicationRequest) throws AgentReplicationException { - - // create packages from request - List<ReplicationPackage> replicationPackages; try { - replicationPackages = buildPackages(replicationRequest); - return schedule(replicationPackages); - + return schedule(buildPackages(replicationRequest)); } catch (ReplicationPackageBuildingException e) { log.error("Error building packages", e); throw new AgentReplicationException(e); @@ -103,7 +105,6 @@ public class SimpleReplicationAgent impl return passive; } - private List<ReplicationPackage> buildPackages(ReplicationRequest replicationRequest) throws ReplicationPackageBuildingException { List<ReplicationPackage> replicationPackages = new ArrayList<ReplicationPackage>(); @@ -125,6 +126,7 @@ public class SimpleReplicationAgent impl } private ReplicationResponse schedule(List<ReplicationPackage> replicationPackages) { + // TODO : create a composite replication response otherwise only the last response will be returned ReplicationResponse replicationResponse = new ReplicationResponse(); for (ReplicationPackage replicationPackage : replicationPackages) { @@ -150,8 +152,13 @@ public class SimpleReplicationAgent impl try { ReplicationQueueItemState state = queueDistributionStrategy.add(getName(), replicationQueueItem, queueProvider); + + // TODO : it probably makes sense to always generate the package queued event if (isPassive()) { - generatePackageQueuedEvent(replicationQueueItem); + Dictionary<Object, Object> properties = new Properties(); + properties.put("replication.package.paths", replicationQueueItem.getPaths()); + properties.put("replication.agent.name", name); + replicationEventFactory.generateEvent(ReplicationEventType.PACKAGE_QUEUED, properties); } if (state != null) { replicationResponse.setStatus(state.getItemState().toString()); @@ -169,14 +176,6 @@ public class SimpleReplicationAgent impl return replicationResponse; } - private void generatePackageQueuedEvent(ReplicationQueueItem replicationQueueItem) { - Dictionary<Object, Object> properties = new Properties(); - properties.put("replication.package.paths", replicationQueueItem.getPaths()); - properties.put("replication.agent.name", name); - replicationEventFactory.generateEvent(ReplicationEventType.PACKAGE_QUEUED, properties); - } - - public String getName() { return name; } Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgentFactory.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgentFactory.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgentFactory.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/agent/impl/SimpleReplicationAgentFactory.java Wed Sep 10 09:26:17 2014 @@ -39,7 +39,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** - * An OSGi service factory for {@link ReplicationAgent}s + * An OSGi service factory for {@link ReplicationAgent}s which references already existing OSGi services. */ @Component(metatype = true, label = "Simple Replication Agents Factory", Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/communication/ReplicationResponse.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/communication/ReplicationResponse.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/communication/ReplicationResponse.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/communication/ReplicationResponse.java Wed Sep 10 09:26:17 2014 @@ -40,7 +40,7 @@ public class ReplicationResponse { } public String getStatus() { - return status; + return status != null ? status : "done nothing"; } public void setStatus(String status) { Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/packaging/impl/exporter/AgentReplicationPackageExporterFactory.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/packaging/impl/exporter/AgentReplicationPackageExporterFactory.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/packaging/impl/exporter/AgentReplicationPackageExporterFactory.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/packaging/impl/exporter/AgentReplicationPackageExporterFactory.java Wed Sep 10 09:26:17 2014 @@ -71,10 +71,10 @@ public class AgentReplicationPackageExpo ReplicationQueue queue = agent.getQueue(queueName); ReplicationQueueItem info = queue.getHead(); - ReplicationPackage replicationPackage = null; + ReplicationPackage replicationPackage; if (info != null) { - queue.removeHead(); replicationPackage = replicationPackageBuilder.getPackage(info.getId()); + queue.remove(info.getId()); if (replicationPackage != null) { result.add(replicationPackage); } Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueue.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueue.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueue.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueue.java Wed Sep 10 09:26:17 2014 @@ -33,18 +33,18 @@ public interface ReplicationQueue { String getName(); /** - * add a replication package to this queue + * add a replication item to this queue * - * @param replicationPackage a replication package to replicate - * @return <code>true</code> if the replication package was added correctly to the queue, + * @param item a replication item representing the package to replicate + * @return <code>true</code> if the replication item was added correctly to the queue, * <code>false</code otherwise */ - boolean add(ReplicationQueueItem replicationPackage); + boolean add(ReplicationQueueItem item); /** - * get the status of a certain package in the queue + * get the status of a certain item in the queue * - * @param item the replication package to get the status for + * @param item the replication item to get the status for * @return the item status in the queue * @throws ReplicationQueueException */ @@ -59,7 +59,7 @@ public interface ReplicationQueue { ReplicationQueueItem getHead(); /** - * remove the first package into the queue from it + * remove the first item into the queue from it */ void removeHead(); Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueDistributionStrategy.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueDistributionStrategy.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueDistributionStrategy.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueDistributionStrategy.java Wed Sep 10 09:26:17 2014 @@ -19,33 +19,32 @@ package org.apache.sling.replication.queue; import org.apache.sling.replication.agent.ReplicationAgent; -import org.apache.sling.replication.packaging.ReplicationPackage; /** * a {@link ReplicationQueueDistributionStrategy} implements an algorithm for the distribution of - * replication packages among the available queues for a certain agent + * {@link org.apache.sling.replication.queue.ReplicationQueueItem}s among the available queues for a certain agent */ public interface ReplicationQueueDistributionStrategy { /** - * synchronously distribute a {@link ReplicationPackage} to a {@link ReplicationAgent} to a {@link ReplicationQueue} - * provided by the given {@link ReplicationQueueProvider} + * synchronously distribute a {@link org.apache.sling.replication.queue.ReplicationQueueItem} to a {@link ReplicationAgent} + * to a {@link ReplicationQueue} provided by the given {@link ReplicationQueueProvider} * - * @param agentName the name of a {@link ReplicationAgent} - * @param replicationPackage a {@link org.apache.sling.replication.packaging.ReplicationPackage} to distribute - * @param queueProvider the {@link ReplicationQueueProvider} used to provide the queue to be used for the given package + * @param agentName the name of a {@link ReplicationAgent} + * @param item a {@link org.apache.sling.replication.queue.ReplicationQueueItem} to distribute + * @param queueProvider the {@link ReplicationQueueProvider} used to provide the queue to be used for the given package * @return a {@link ReplicationQueueItemState} representing the state of the package in the queue after its distribution * @throws ReplicationQueueException */ - ReplicationQueueItemState add(String agentName, ReplicationQueueItem replicationPackage, + ReplicationQueueItemState add(String agentName, ReplicationQueueItem item, ReplicationQueueProvider queueProvider) throws ReplicationQueueException; /** - * asynchronously distribute a {@link ReplicationPackage} to a {@link ReplicationAgent} to a {@link ReplicationQueue} - * provided by the given {@link ReplicationQueueProvider} + * asynchronously distribute a {@link org.apache.sling.replication.queue.ReplicationQueueItem} to a {@link ReplicationAgent} + * to a {@link ReplicationQueue} provided by the given {@link ReplicationQueueProvider} * - * @param agentName the name of a {@link ReplicationAgent} - * @param replicationPackage a {@link org.apache.sling.replication.packaging.ReplicationPackage} to distribute + * @param agentName the name of a {@link ReplicationAgent} + * @param replicationPackage a {@link org.apache.sling.replication.queue.ReplicationQueueItem} to distribute * @param queueProvider the {@link ReplicationQueueProvider} used to provide the queue to be used for the given package * @return <code>true</code> if the package could be distributed to a {@link ReplicationQueue}, <code>false</code> otherwise * @throws ReplicationQueueException Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueItem.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueItem.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueItem.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueItem.java Wed Sep 10 09:26:17 2014 @@ -20,6 +20,10 @@ package org.apache.sling.replication.que /** * An item in a {@link org.apache.sling.replication.queue.ReplicationQueue} + * + * This is basically a proxy to {@link org.apache.sling.replication.packaging.ReplicationPackage} designed to avoid having + * to keep the package {@link org.apache.sling.replication.packaging.ReplicationPackage#createInputStream() stream} into + * the queues. */ public class ReplicationQueueItem { Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueProvider.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueProvider.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueProvider.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/ReplicationQueueProvider.java Wed Sep 10 09:26:17 2014 @@ -26,9 +26,8 @@ import java.util.Collection; public interface ReplicationQueueProvider { /** - * provide the queue to be used for a certain agent and package or creates it if it doesn't + * provide a named queue for the given agent or creates it if the agent doesn't * exist - * * * @param agentName * the replication agent needing the queue @@ -43,7 +42,6 @@ public interface ReplicationQueueProvide /** * get the default queue to be used for a certain agent - * * * @param agentName * a replication agent Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/ErrorAwareQueueDistributionStrategy.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/ErrorAwareQueueDistributionStrategy.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/ErrorAwareQueueDistributionStrategy.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/ErrorAwareQueueDistributionStrategy.java Wed Sep 10 09:26:17 2014 @@ -69,7 +69,7 @@ public class ErrorAwareQueueDistribution timeThreshold = PropertiesUtil.toInteger(ctx.getProperties().get(TIME_THRESHOLD), 600000); } - public ReplicationQueueItemState add(String agentName, ReplicationQueueItem replicationPackage, + public ReplicationQueueItemState add(String agentName, ReplicationQueueItem item, ReplicationQueueProvider queueProvider) throws ReplicationQueueException { try { @@ -78,9 +78,9 @@ public class ErrorAwareQueueDistribution ReplicationQueue queue = queueProvider.getDefaultQueue(agentName); log.info("obtained queue {}", queue); if (queue != null) { - if (queue.add(replicationPackage)) { + if (queue.add(item)) { log.info("replication status: {}", state); - state = queue.getStatus(replicationPackage); + state = queue.getStatus(item); } else { log.error("could not add the item to the queue {}", queue); state.setItemState(ItemState.ERROR); Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/PriorityPathDistributionStrategy.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/PriorityPathDistributionStrategy.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/PriorityPathDistributionStrategy.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/PriorityPathDistributionStrategy.java Wed Sep 10 09:26:17 2014 @@ -54,19 +54,19 @@ public class PriorityPathDistributionStr priorityPaths = PropertiesUtil.toStringArray(context.getProperties().get(PRIORITYPATHS)); } - public ReplicationQueueItemState add(String agentName, ReplicationQueueItem replicationPackage, + public ReplicationQueueItemState add(String agentName, ReplicationQueueItem item, ReplicationQueueProvider queueProvider) throws ReplicationQueueException { log.info("using path priority based queue distribution"); ReplicationQueueItemState state = new ReplicationQueueItemState(); - ReplicationQueue queue = getQueue(agentName, replicationPackage, queueProvider); + ReplicationQueue queue = getQueue(agentName, item, queueProvider); log.info("obtained queue {}", queue); if (queue != null) { - if (queue.add(replicationPackage)) { + if (queue.add(item)) { log.info("replication status: {}", state); - state = queue.getStatus(replicationPackage); + state = queue.getStatus(item); } else { log.error("could not add the item to the queue {}", queue); state.setItemState(ItemState.ERROR); Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/SingleQueueDistributionStrategy.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/SingleQueueDistributionStrategy.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/SingleQueueDistributionStrategy.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/SingleQueueDistributionStrategy.java Wed Sep 10 09:26:17 2014 @@ -40,7 +40,7 @@ public class SingleQueueDistributionStra private final Logger log = LoggerFactory.getLogger(getClass()); - public ReplicationQueueItemState add(String agentName, ReplicationQueueItem replicationPackage, + public ReplicationQueueItemState add(String agentName, ReplicationQueueItem item, ReplicationQueueProvider queueProvider) throws ReplicationQueueException { log.info("using single queue distribution"); @@ -50,8 +50,8 @@ public class SingleQueueDistributionStra log.info("obtained queue {}", queue); if (queue != null) { - if (queue.add(replicationPackage)) { - state = queue.getStatus(replicationPackage); + if (queue.add(item)) { + state = queue.getStatus(item); log.info("replication status: {}", state); } else { log.error("could not add the item to the queue {}", queue); Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/jobhandling/JobHandlingReplicationQueue.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/jobhandling/JobHandlingReplicationQueue.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/jobhandling/JobHandlingReplicationQueue.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/jobhandling/JobHandlingReplicationQueue.java Wed Sep 10 09:26:17 2014 @@ -56,11 +56,11 @@ public class JobHandlingReplicationQueue return name; } - public boolean add(ReplicationQueueItem replicationPackage) { + public boolean add(ReplicationQueueItem item) { boolean result = true; try { Map<String, Object> properties = JobHandlingUtils - .createFullPropertiesFromPackage(replicationPackage); + .createFullPropertiesFromPackage(item); Job job = jobManager.createJob(topic).properties(properties).add(); log.info("job {} added", job.getId()); Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/simple/SimpleReplicationQueue.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/simple/SimpleReplicationQueue.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/simple/SimpleReplicationQueue.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/queue/impl/simple/SimpleReplicationQueue.java Wed Sep 10 09:26:17 2014 @@ -60,17 +60,17 @@ public class SimpleReplicationQueue impl return name; } - public boolean add(ReplicationQueueItem replicationPackage) { + public boolean add(ReplicationQueueItem item) { ReplicationQueueItemState status = new ReplicationQueueItemState(); boolean result = false; try { - result = queue.offer(replicationPackage, 10, TimeUnit.SECONDS); + result = queue.offer(item, 10, TimeUnit.SECONDS); status.setEntered(Calendar.getInstance()); } catch (InterruptedException e) { log.error("cannot add an item to the queue", e); status.setSuccessful(false); } finally { - statusMap.put(replicationPackage, status); + statusMap.put(item, status); } return result; } Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/rule/impl/ChainReplicateReplicationRule.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/rule/impl/ChainReplicateReplicationRule.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/rule/impl/ChainReplicateReplicationRule.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/rule/impl/ChainReplicateReplicationRule.java Wed Sep 10 09:26:17 2014 @@ -43,7 +43,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** - * a rule for triggering a chain replication upon replication package installation {@link org.apache.sling.replication.event.ReplicationEventType.PACKAGE_INSTALLED} + * a rule for triggering a chain replication upon replication package installation {@link org.apache.sling.replication.event.ReplicationEventType#PACKAGE_INSTALLED} */ @Component(immediate = true, label = "Rule for Chain Replication") @Service(value = ReplicationRule.class) Modified: sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/servlet/ReplicationPackageExporterServlet.java URL: http://svn.apache.org/viewvc/sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/servlet/ReplicationPackageExporterServlet.java?rev=1623955&r1=1623954&r2=1623955&view=diff ============================================================================== --- sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/servlet/ReplicationPackageExporterServlet.java (original) +++ sling/trunk/contrib/extensions/replication/core/src/main/java/org/apache/sling/replication/servlet/ReplicationPackageExporterServlet.java Wed Sep 10 09:26:17 2014 @@ -44,7 +44,7 @@ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** - * Servlet to handle reception of replication content. + * Servlet to handle fetching of replication content. */ @SuppressWarnings("serial") @Component(metatype = false)