org.apache.catalina.users
Class AbstractGroup

java.lang.Object
  org.apache.catalina.users.AbstractGroup

All Implemented Interfaces:

java.security.Principal, Group

Direct Known Subclasses:

MemoryGroup

public abstract class AbstractGroup
extends java.lang.Object
implements Group

Convenience base class for Group implementations.

Since:

4.1

Author:

Craig R. McClanahan

description

protected java.lang.String description

The description of this group.

groupname

protected java.lang.String groupname

The group name of this group.

AbstractGroup

public AbstractGroup()

getDescription

public java.lang.String getDescription()

Return the description of this group.

Specified by:

getDescription in interface Group

setDescription

public void setDescription(java.lang.String description)

Set the description of this group.

Specified by:

setDescription in interface Group

Parameters:

description - The new description

getGroupname

public java.lang.String getGroupname()

Return the group name of this group, which must be unique within the scope of a UserDatabase.

Specified by:

getGroupname in interface Group

setGroupname

public void setGroupname(java.lang.String groupname)

Set the group name of this group, which must be unique within the scope of a UserDatabase.

Specified by:

setGroupname in interface Group

Parameters:

groupname - The new group name

getRoles

public abstract java.util.Iterator getRoles()

Return the set of Roles assigned specifically to this group.

Specified by:

getRoles in interface Group

getUserDatabase

public abstract UserDatabase getUserDatabase()

Return the UserDatabase within which this Group is defined.

Specified by:

getUserDatabase in interface Group

getUsers

public abstract java.util.Iterator getUsers()

Return an Iterator over the set of Users that are members of this group.

Specified by:

getUsers in interface Group

addRole

public abstract void addRole(Role role)

Add a new Role to those assigned specifically to this group.

Specified by:

addRole in interface Group

Parameters:

role - The new role

isInRole

public abstract boolean isInRole(Role role)

Is this group specifically assigned the specified Role?

Specified by:

isInRole in interface Group

Parameters:

role - The role to check

removeRole

public abstract void removeRole(Role role)

Remove a Role from those assigned to this group.

Specified by:

removeRole in interface Group

Parameters:

role - The old role

removeRoles

public abstract void removeRoles()

Remove all Roles from those assigned to this group.

Specified by:

removeRoles in interface Group

getName

public java.lang.String getName()

Make the principal name the same as the group name.

Specified by:

getName in interface java.security.Principal