Repository: syncope
Updated Branches:
  refs/heads/master cad371cec -> 4b4b13565


Updating the javadoc for AnyService to make it clearer how the "key" parameter 
is used


Project: http://git-wip-us.apache.org/repos/asf/syncope/repo
Commit: http://git-wip-us.apache.org/repos/asf/syncope/commit/4b4b1356
Tree: http://git-wip-us.apache.org/repos/asf/syncope/tree/4b4b1356
Diff: http://git-wip-us.apache.org/repos/asf/syncope/diff/4b4b1356

Branch: refs/heads/master
Commit: 4b4b135659d597fcafd5d844954dfa92988dede2
Parents: cad371c
Author: Colm O hEigeartaigh <cohei...@apache.org>
Authored: Wed Apr 26 14:26:28 2017 +0100
Committer: Colm O hEigeartaigh <cohei...@apache.org>
Committed: Wed Apr 26 14:26:50 2017 +0100

----------------------------------------------------------------------
 .../apache/syncope/common/rest/api/service/AnyService.java  | 9 +++++++++
 1 file changed, 9 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/syncope/blob/4b4b1356/common/rest-api/src/main/java/org/apache/syncope/common/rest/api/service/AnyService.java
----------------------------------------------------------------------
diff --git 
a/common/rest-api/src/main/java/org/apache/syncope/common/rest/api/service/AnyService.java
 
b/common/rest-api/src/main/java/org/apache/syncope/common/rest/api/service/AnyService.java
index ac958e1..d288e59 100644
--- 
a/common/rest-api/src/main/java/org/apache/syncope/common/rest/api/service/AnyService.java
+++ 
b/common/rest-api/src/main/java/org/apache/syncope/common/rest/api/service/AnyService.java
@@ -47,6 +47,9 @@ public interface AnyService<TO extends AnyTO, P extends 
AnyPatch> extends JAXRSS
     /**
      * Reads the list of attributes owned by the given any object for the 
given schema type.
      *
+     * Note that for the UserService, GroupService and AnyObjectService 
subclasses, if the key parameter
+     * looks like a UUID then it is interpreted as as key, otherwise as a 
(user)name.
+     *
      * @param key any object key
      * @param schemaType schema type
      * @return list of attributes, owned by the given any object, for the 
given schema type
@@ -59,6 +62,9 @@ public interface AnyService<TO extends AnyTO, P extends 
AnyPatch> extends JAXRSS
     /**
      * Reads the attribute, owned by the given any object, for the given 
schema type and schema.
      *
+     * Note that for the UserService, GroupService and AnyObjectService 
subclasses, if the key parameter
+     * looks like a UUID then it is interpreted as as key, otherwise as a 
(user)name.
+     *
      * @param key any object key
      * @param schemaType schema type
      * @param schema schema
@@ -75,6 +81,9 @@ public interface AnyService<TO extends AnyTO, P extends 
AnyPatch> extends JAXRSS
     /**
      * Reads the any object matching the provided key.
      *
+     * Note that for the UserService, GroupService and AnyObjectService 
subclasses, if the key parameter
+     * looks like a UUID then it is interpreted as as key, otherwise as a 
(user)name.
+     *
      * @param key key of any object to be read
      * @return any object with matching key
      */

Reply via email to