mirror of
				https://github.com/gyurix1968/guacamole-client.git
				synced 2025-10-31 17:13:21 +00:00 
			
		
		
		
	GUAC-800: Clarify semantics of getAttributes() / setAttributes().
This commit is contained in:
		| @@ -86,21 +86,23 @@ public interface Connection extends Identifiable, Connectable { | ||||
|     public void setConfiguration(GuacamoleConfiguration config); | ||||
|  | ||||
|     /** | ||||
|      * Returns all attributes associated with this connection. | ||||
|      * Returns all attributes associated with this connection. The returned map | ||||
|      * may not be modifiable. | ||||
|      * | ||||
|      * @return | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this connection. | ||||
|      *     for all attributes associated with this connection, which may not be | ||||
|      *     modifiable. | ||||
|      */ | ||||
|     Map<String, String> getAttributes(); | ||||
|  | ||||
|     /** | ||||
|      * Replaces all attributes associated with this connection with the | ||||
|      * attributes in the given map. | ||||
|      * Sets the given attributes. If an attribute within the map is not | ||||
|      * supported, it will simply be dropped. Any attributes not within the | ||||
|      * given map will be left untouched. | ||||
|      * | ||||
|      * @param attributes | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this connection. | ||||
|      *     A map of all attribute identifiers to their corresponding values. | ||||
|      */ | ||||
|     void setAttributes(Map<String, String> attributes); | ||||
|  | ||||
|   | ||||
| @@ -130,21 +130,23 @@ public interface ConnectionGroup extends Identifiable, Connectable { | ||||
|             throws GuacamoleException; | ||||
|  | ||||
|     /** | ||||
|      * Returns all attributes associated with this connection group. | ||||
|      * Returns all attributes associated with this connection group. The | ||||
|      * returned map may not be modifiable. | ||||
|      * | ||||
|      * @return | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this connection group. | ||||
|      *     for all attributes associated with this connection group, which may | ||||
|      *     not be modifiable. | ||||
|      */ | ||||
|     Map<String, String> getAttributes(); | ||||
|  | ||||
|     /** | ||||
|      * Replaces all attributes associated with this connection group with the | ||||
|      * attributes in the given map. | ||||
|      * Sets the given attributes. If an attribute within the map is not | ||||
|      * supported, it will simply be dropped. Any attributes not within the | ||||
|      * given map will be left untouched. | ||||
|      * | ||||
|      * @param attributes | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this connection group. | ||||
|      *     A map of all attribute identifiers to their corresponding values. | ||||
|      */ | ||||
|     void setAttributes(Map<String, String> attributes); | ||||
|  | ||||
|   | ||||
| @@ -53,21 +53,23 @@ public interface User extends Identifiable { | ||||
|     public void setPassword(String password); | ||||
|  | ||||
|     /** | ||||
|      * Returns all attributes associated with this user. | ||||
|      * Returns all attributes associated with this user. The returned map may | ||||
|      * not be modifiable. | ||||
|      * | ||||
|      * @return | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this user. | ||||
|      *     for all attributes associated with this user, which may not be | ||||
|      *     modifiable. | ||||
|      */ | ||||
|     Map<String, String> getAttributes(); | ||||
|  | ||||
|     /** | ||||
|      * Replaces all attributes associated with this user with the attributes in | ||||
|      * the given map. | ||||
|      * Sets the given attributes. If an attribute within the map is not | ||||
|      * supported, it will simply be dropped. Any attributes not within the | ||||
|      * given map will be left untouched. | ||||
|      * | ||||
|      * @param attributes | ||||
|      *     A map of all attribute identifiers to their corresponding values, | ||||
|      *     for all attributes associated with this user. | ||||
|      *     A map of all attribute identifiers to their corresponding values. | ||||
|      */ | ||||
|     void setAttributes(Map<String, String> attributes); | ||||
|  | ||||
|   | ||||
		Reference in New Issue
	
	Block a user