You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by st...@apache.org on 2013/10/14 11:25:32 UTC
svn commit: r1531829 -
/sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java
Author: stefanegli
Date: Mon Oct 14 09:25:32 2013
New Revision: 1531829
URL: http://svn.apache.org/r1531829
Log:
SLING-3164 : deprecating ClusterView.getId - and adjusting the javadoc accordingly
Modified:
sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java
Modified: sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java
URL: http://svn.apache.org/viewvc/sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java?rev=1531829&r1=1531828&r2=1531829&view=diff
==============================================================================
--- sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java (original)
+++ sling/trunk/bundles/extensions/discovery/api/src/main/java/org/apache/sling/discovery/ClusterView.java Mon Oct 14 09:25:32 2013
@@ -32,8 +32,20 @@ import aQute.bnd.annotation.ProviderType
public interface ClusterView {
/**
- * Returns an id of this cluster view
+ * Returns an id of this cluster view.
+ * <p>
+ * Note that this id is not guaranteed to be stable between
+ * instances of ClusterViews. The id is identifying only the
+ * current view of the cluster, not the cluster itself, and
+ * thus if the view changes the id might (or might not) change.
* @return an id of this cluster view
+ * @deprecated due to the unstable nature of this id - it only
+ * identifies the current view of the cluster, not the cluster
+ * itself - this id has been deprecated. If an id of the cluster
+ * itself is needed, this must be dealt with on an application
+ * level - for example by letting the cluster leader define
+ * such an id and taking care of special cases like cluster joins.
+ * @see <a href="http://issues.apache.org/jira/browse/SLING-3164">SLING-3164</a>
*/
String getId();