X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=security%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fusermgt%2FUserSet.java;h=c8912a839b18a6b43eded6a230714d176c8dc1f0;hb=17775e14ecfb286e59f67117e5cee7e21e95ab1f;hp=ffff4abd8d3b87e095032175551075ce8c032141;hpb=162af365e45e54e5e8d656be276914df2005eaec;p=utils

diff --git a/security/src/main/java/org/wamblee/usermgt/UserSet.java b/security/src/main/java/org/wamblee/usermgt/UserSet.java
index ffff4abd..c8912a83 100644
--- a/security/src/main/java/org/wamblee/usermgt/UserSet.java
+++ b/security/src/main/java/org/wamblee/usermgt/UserSet.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2005 the original author or authors.
+ * Copyright 2005-2010 the original author or authors.
  * 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,78 +13,102 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 
-
 package org.wamblee.usermgt;
 
 import java.util.Set;
 
 /**
- * Represents a set of users.
- * Typical implementations would be an implementation based on a static configuration file or 
- * an implementation backed by a database.  
+ * Represents a set of users. Typical implementations would be an implementation
+ * based on a static configuration file or an implementation backed by a
+ * database.
+ * 
+ * @author Erik Brakkee
  */
 public interface UserSet {
-    
     /**
-     * Creates a user. 
-     * @param aUsername User name. 
-     * @param aPassword Password. 
-     * @param aGroup Group.
-     * @return New user.  
-     * @throws UserMgtException In case the user cannot be created. 
-     */ 
-    User createUser(String aUsername, String aPassword, Group aGroup) throws UserMgtException; 
-    
+     * Creates a user.
+     * 
+     * @param aUsername
+     *            User name.
+     * @param aPassword
+     *            Password.
+     * @param aGroup
+     *            Group.
+     * 
+     * @return New user.
+     * 
+     * @throws UserMgtException
+     *             In case the user cannot be created.
+     */
+    User createUser(String aUsername, String aPassword, Group aGroup)
+        throws UserMgtException;
+
     /**
      * Must be called whenever a user object has been modified to notify the
-     * user set.  
-     * @param aUser Modified user. 
+     * user set.
+     * 
+     * @param aUser
+     *            Modified user.
      */
-    void userModified(User aUser); 
-    
+    void userModified(User aUser);
+
     /**
-     * Finds  user. 
-     * @param aName Username. 
-     * @return User or null if not found. 
+     * Finds user.
+     * 
+     * @param aName
+     *            Username.
+     * 
+     * @return User or null if not found.
      */
     User find(String aName);
-    
+
     /**
-     * Checks if a user exists. 
-     * @param aUser User. 
-     * @return True iff the user exists. 
+     * Checks if a user exists.
+     * 
+     * @param aUser
+     *            User.
+     * 
+     * @return True iff the user exists.
      */
-    boolean contains(User aUser); 
-    
+    boolean contains(User aUser);
+
     /**
-     * Adds a user. If the user already exists, the user details are updated with that
-     * of the specified user object. 
-     * @param aUser User to add. 
+     * Adds a user. If the user already exists, the user details are updated
+     * with that of the specified user object.
+     * 
+     * @param aUser
+     *            User to add.
+     * 
      */
     boolean add(User aUser);
-    
+
     /**
-     * Removes a user. If the user does not exist, nothing happens. 
+     * Removes a user. If the user does not exist, nothing happens.
+     * 
      * @param aUser
+     * 
      */
     boolean remove(User aUser);
-    
+
     /**
-     * Lists the current users. 
-     * @return Users. 
+     * Lists the current users.
+     * 
+     * @return Users.
      */
-    Set<User> list(); 
-    
+    Set<User> list();
+
     /**
-     * Lists the users belonging to a particular group. 
-     * @param aGroup Group. 
-     * @return Groups. 
+     * Lists the users belonging to a particular group.
+     * 
+     * @param aGroup
+     *            Group.
+     * @return Groups.
      */
     Set<User> list(Group aGroup);
 
     /**
      * 
-     * @return The number of users. 
+     * @return The number of users.
      */
-    int size(); 
+    int size();
 }