org.jboss.security
Class SimpleGroup

java.lang.Object
  extended byorg.jboss.security.SimplePrincipal (src) 
      extended byorg.jboss.security.SimpleGroup
All Implemented Interfaces:
java.security.acl.Group, java.security.Principal, java.io.Serializable

public class SimpleGroup
extends SimplePrincipal (src)
implements java.security.acl.Group

An implementation of Group that manages a collection of Principal objects based on their hashCode() and equals() methods. This class is not thread safe.

See Also:
Serialized Form

Constructor Summary
SimpleGroup(java.lang.String groupName)
           
 
Method Summary
 boolean addMember(java.security.Principal user)
          Adds the specified member to the group.
 boolean isMember(java.security.Principal member)
          Returns true if the passed principal is a member of the group.
 java.util.Enumeration members()
          Returns an enumeration of the members in the group.
 boolean removeMember(java.security.Principal user)
          Removes the specified member from the group.
 java.lang.String toString()
           
 
Methods inherited from class org.jboss.security.SimplePrincipal (src)
equals, getName, hashCode
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.security.Principal
equals, getName, hashCode
 

Constructor Detail

SimpleGroup

public SimpleGroup(java.lang.String groupName)
Method Detail

addMember

public boolean addMember(java.security.Principal user)
Adds the specified member to the group.

Specified by:
addMember in interface java.security.acl.Group
Parameters:
user - the principal to add to this group.
Returns:
true if the member was successfully added, false if the principal was already a member.

isMember

public boolean isMember(java.security.Principal member)
Returns true if the passed principal is a member of the group. This method does a recursive search, so if a principal belongs to a group which is a member of this group, true is returned. A special check is made to see if the member is an instance of org.jboss.security.AnybodyPrincipal or org.jboss.security.NobodyPrincipal since these classes do not hash to meaningful values.

Specified by:
isMember in interface java.security.acl.Group
Parameters:
member - the principal whose membership is to be checked.
Returns:
true if the principal is a member of this group, false otherwise.

members

public java.util.Enumeration members()
Returns an enumeration of the members in the group. The returned objects can be instances of either Principal or Group (which is a subinterface of Principal).

Specified by:
members in interface java.security.acl.Group
Returns:
an enumeration of the group members.

removeMember

public boolean removeMember(java.security.Principal user)
Removes the specified member from the group.

Specified by:
removeMember in interface java.security.acl.Group
Parameters:
user - the principal to remove from this group.
Returns:
true if the principal was removed, or false if the principal was not a member.

toString

public java.lang.String toString()
Specified by:
toString in interface java.security.Principal
Overrides:
toString in class SimplePrincipal (src)