This is an automated email from the ASF dual-hosted git repository.
rombert pushed a commit to branch master
in repository
https://gitbox.apache.org/repos/asf/sling-org-apache-sling-discovery-api.git
commit d61f9a5c8d3ae0644967e069bd9f6638e75476c1
Author: Stefan Egli <stefane...@apache.org>
AuthorDate: Mon Oct 14 09:25:32 2013 +0000
SLING-3164 : deprecating ClusterView.getId - and adjusting the javadoc
accordingly
git-svn-id: https://svn.apache.org/repos/asf/sling/trunk@1531829
13f79535-47bb-0310-9956-ffa450edef68
---
src/main/java/org/apache/sling/discovery/ClusterView.java | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/src/main/java/org/apache/sling/discovery/ClusterView.java
b/src/main/java/org/apache/sling/discovery/ClusterView.java
index 2b3c75e..07d5f7f 100644
--- a/src/main/java/org/apache/sling/discovery/ClusterView.java
+++ b/src/main/java/org/apache/sling/discovery/ClusterView.java
@@ -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();
--
To stop receiving notification emails like this one, please contact
"commits@sling.apache.org" <commits@sling.apache.org>.
