From 6d64a3e1615538f21b20cbff6cc019960f3af7e5 Mon Sep 17 00:00:00 2001
From: Michael Jumper <zhangmaike@users.sourceforge.net>
Date: Sat, 26 Jan 2013 14:09:16 -0800
Subject: [PATCH] Add CRUD operations for GuacacmoleConfigurations (#266), bump
 version to 0.8.0.

---
 guacamole-ext/pom.xml                         |  2 +-
 .../net/auth/AuthenticationProvider.java      | 61 +++++++++++++++++--
 2 files changed, 56 insertions(+), 7 deletions(-)

diff --git a/guacamole-ext/pom.xml b/guacamole-ext/pom.xml
index d02b2c908..f6287c45e 100644
--- a/guacamole-ext/pom.xml
+++ b/guacamole-ext/pom.xml
@@ -5,7 +5,7 @@
     <groupId>net.sourceforge.guacamole</groupId>
     <artifactId>guacamole-ext</artifactId>
     <packaging>jar</packaging>
-    <version>0.7.0</version>
+    <version>0.8.0</version>
     <name>guacamole-ext</name>
     <url>http://guac-dev.org/</url>
 
diff --git a/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/auth/AuthenticationProvider.java b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/auth/AuthenticationProvider.java
index 3a47309b5..935d3f2ce 100644
--- a/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/auth/AuthenticationProvider.java
+++ b/guacamole-ext/src/main/java/net/sourceforge/guacamole/net/auth/AuthenticationProvider.java
@@ -42,17 +42,18 @@ import net.sourceforge.guacamole.GuacamoleException;
 import net.sourceforge.guacamole.protocol.GuacamoleConfiguration;
 
 /**
- * Provides means of retrieving a set of named GuacamoleConfigurations for a
- * given Credentials object.
+ * Provides means of accessing and managing the available
+ * GuacamoleConfiguration objects and User objects. Access to each configuration
+ * and each user is limited by a given Credentials object.
  *
  * @author Michael Jumper
  */
 public interface AuthenticationProvider {
 
     /**
-     * Given an arbitrary credentials object, returns a Map containing all
-     * configurations authorized by those credentials. The keys of this Map
-     * are Strings which uniquely identify each configuration.
+     * Given an arbitrary Credentials object, returns a Map containing all
+     * GuacamoleConfigurations authorized by those credentials. The keys of
+     * this Map are Strings which uniquely identify each configuration.
      *
      * @param credentials The credentials to use to retrieve authorized
      *                    configurations.
@@ -62,7 +63,55 @@ public interface AuthenticationProvider {
      *                            configurations.
      */
     Map<String, GuacamoleConfiguration>
-            getAuthorizedConfigurations(Credentials credentials)
+            getConfigurations(Credentials credentials)
             throws GuacamoleException;
 
+    /**
+     * Adds the given GuacamoleConfiguration to the overall set of available
+     * GuacamoleConfigurations, using the given unique identifier and
+     * credentials.
+     * 
+     * @param credentials The credentials to use when adding the given
+     *                    configuration.
+     * @param identifier The identifier to assign to the configuration.
+     * @param config The configuration to add.
+     * @throws GuacamoleException If an error occurs while adding the
+     *                            configuration, or if adding the configuration
+     *                            is not allowed.
+     */
+    void addConfiguration(Credentials credentials, String identifier,
+            GuacamoleConfiguration config) throws GuacamoleException;
+    
+    /**
+     * Updates the GuacamoleConfiguration having the given unique identifier
+     * with the data contained in the given GuacamoleConfiguration, using the
+     * given credentials.
+     * 
+     * @param credentials The credentials to use when updating the configuration
+     *                    having the given identifier.
+     * @param identifier The identifier to use when locating the configuration
+     *                   to update.
+     * @param config The configuration to use when updating the stored
+     *               configuration.
+     * @throws GuacamoleException If an error occurs while updating the
+     *                            configuration, or if updating the
+     *                            configuration is not allowed.
+     */
+    void updateConfiguration(Credentials credentials, String identifier,
+            GuacamoleConfiguration config) throws GuacamoleException;
+    
+    /**
+     * Removes the GuacamoleConfiguration having the given unique identifier,
+     * using the given credentials.
+     * 
+     * @param credentials The credentials to use when removing the configuration
+     *                    having the given identifier.
+     * @param identifier The identifier of the configuration to remove.
+     * @throws GuacamoleException If an error occurs while removing the
+     *                            configuration, or if removing the
+     *                            configuration is not allowed.
+     */
+    void removeConfiguration(Credentials credentials, String identifier)
+            throws GuacamoleException;
+    
 }