An implementation of Group that allows that acts as a stack of Groups
with a single Group member active at any time.
When one adds a Group to a NestableGroup the Group is pushed onto
the active Group stack and any of the Group methods operate as though the
NestableGroup contains only the Group. When removing the Group that
corresponds to the active Group, the active Group is popped from the stack and
the new active Group is set to the new top of the stack.
The typical usage of this class is when doing a JAAS LoginContext login
to runAs a new Principal with a new set of roles that should be added
without destroying the current identity and roles.
- $Revision: 2 $
The stack of the Groups. Elements are pushed/poped by
inserting/removing element 0.
Creates new NestableGroup with the given name
Returns an enumeration that contains the single active Principal.
- an Enumeration of the single active Principal.
Removes the first occurence of user from the Principal stack.
user the principal to remove from this group.
- true if the principal was removed, or
false if the principal was not a member.
Pushes the group onto the Group stack and makes it the active
group the instance of Group that contains the roles to set as the
- true always.
java.lang.IllegalArgumentException thrown if group is not an instance of Group.
if( (group instanceof Group) == false )
Returns true if the passed principal is a member of the active 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.
member the principal whose membership is to be checked.
- true if the principal is a member of this group, false otherwise.
boolean isMember = activeGroup.isMember(member);