org.glassfish.deployment.common

Interface SecurityRoleMapper

public interface SecurityRoleMapper

This interface defines the protocol used by the DOL to access the role mapping information of a J2EE application. This class is implemented by other modules and their instanciation is done through the SecurityRoleMapperFactory class.

Author:

Jerome Dochez

Method Summary

Methods

Modifier and Type	Method and Description
void	assignRole(Principal p, org.glassfish.security.common.Role r, RootDeploymentDescriptor rdd) Assigns a Principal to the specified role.
Enumeration	getGroupsAssignedTo(org.glassfish.security.common.Role r) Returns an enumeration of Groups assigned to the given role
String	getName()
Iterator	getRoles()
Map	getRoleToSubjectMapping()
Enumeration	getUsersAssignedTo(org.glassfish.security.common.Role r)
void	setName(String name) Set the role mapper application name
void	unassignPrincipalFromRole(org.glassfish.security.common.Role role, Principal principal) Remove the given role-principal mapping
void	unassignRole(org.glassfish.security.common.Role role) Remove all the role mapping information for this role

Method Detail

setName

void setName(String name)

Set the role mapper application name

Parameters:

the - app name

getName

String getName()

Returns:

the role mapper application name

getRoles

Iterator getRoles()

Returns:

an iterator on all the assigned roles

getUsersAssignedTo

Enumeration getUsersAssignedTo(org.glassfish.security.common.Role r)

Parameters:

The - Role to which the principals are assigned to.

getGroupsAssignedTo

Enumeration getGroupsAssignedTo(org.glassfish.security.common.Role r)

Returns an enumeration of Groups assigned to the given role

Parameters:

The - Role to which the groups are assigned to.

assignRole

void assignRole(Principal p,
              org.glassfish.security.common.Role r,
              RootDeploymentDescriptor rdd)

Assigns a Principal to the specified role.

Parameters:

p - The principal that needs to be assigned to the role.

r - The Role the principal is being assigned to.

rdd - The descriptor of the module calling assignRole.

unassignPrincipalFromRole

void unassignPrincipalFromRole(org.glassfish.security.common.Role role,
                             Principal principal)

Remove the given role-principal mapping

Parameters:

role, - Role object

principal, - the principal

unassignRole

void unassignRole(org.glassfish.security.common.Role role)

Remove all the role mapping information for this role

Parameters:

role, - the role object

getRoleToSubjectMapping

Map getRoleToSubjectMapping()