org.apache.jetspeed.security

Interface JetspeedPrincipalManager

All Superinterfaces:

Serializable

public interface JetspeedPrincipalManager
extends Serializable

Version:

$Id$

Method Summary

Methods

Modifier and Type	Method and Description
void	addAssociation(JetspeedPrincipal from, JetspeedPrincipal to, String associationName)
void	addListener(PrincipalManagerEventListener listener)
void	addPrincipal(JetspeedPrincipal principal, Set<JetspeedPrincipalAssociationReference> associations)
List<? extends JetspeedPrincipal>	getAssociatedFrom(String principalFromName, JetspeedPrincipalType from, String associationName) Retrieves a detached and modifiable JetspeedPrincipal list of all the principals managed by this manager which are associated from the specified principal by the specified association.
List<String>	getAssociatedNamesFrom(String principalFromName, JetspeedPrincipalType from, String associationName) Retrieves a detached and modifiable list of the names of all the principals managed by this manager which are associated from the specified principal by the specified association.
List<String>	getAssociatedNamesTo(String principalToName, JetspeedPrincipalType to, String associationName) Retrieves a detached and modifiable list of the names of all the principals managed by this manager which are associated to the specified principal by the specified association.
List<? extends JetspeedPrincipal>	getAssociatedTo(String principalToName, JetspeedPrincipalType to, String associationName) Retrieves a detached and modifiable JetspeedPrincipal list of all the principals managed by this manager which are associated to the specified principal by the specified association.
List<JetspeedPrincipalAssociationType>	getAssociationTypes()
JetspeedPrincipal	getPrincipal(String name)
List<String>	getPrincipalNames(String nameFilter) Retrieves a detached and modifiable List of principal names, finding principals matching the corresponding principal name filter.
JetspeedPrincipalResultList	getPrincipals(JetspeedPrincipalQueryContext queryContext) Retrieve all principals that match the queryContext.
List<? extends JetspeedPrincipal>	getPrincipals(String nameFilter) Retrieves a detached and modifiable JetspeedPrincipal list matching the corresponding principal name filter.
List<? extends JetspeedPrincipal>	getPrincipalsByAttribute(String attributeName, String attributeValue)
JetspeedPrincipalType	getPrincipalType()
JetspeedPrincipal	newPrincipal(String name, boolean mapped)
JetspeedPrincipal	newTransientPrincipal(String name)
boolean	principalExists(String name)
void	removeAssociation(JetspeedPrincipal from, JetspeedPrincipal to, String associationName)
void	removeListener(PrincipalManagerEventListener listener)
void	removePrincipal(JetspeedPrincipal principal)
void	removePrincipal(String name)
void	transferAssociationFrom(JetspeedPrincipal from, JetspeedPrincipal to, JetspeedPrincipal target, String associationName)
void	transferAssociationTo(JetspeedPrincipal from, JetspeedPrincipal to, JetspeedPrincipal target, String associationName)
void	updatePrincipal(JetspeedPrincipal principal)

Method Detail

getPrincipalType

JetspeedPrincipalType getPrincipalType()

getAssociationTypes

List<JetspeedPrincipalAssociationType> getAssociationTypes()

principalExists

boolean principalExists(String name)

getPrincipal

JetspeedPrincipal getPrincipal(String name)

getPrincipalNames

List<String> getPrincipalNames(String nameFilter)

Retrieves a detached and modifiable List of principal names, finding principals matching the corresponding principal name filter.

Parameters:

nameFilter - The filter used to retrieve matching principals.

Returns:

A list of principal names

getPrincipals

List<? extends JetspeedPrincipal> getPrincipals(String nameFilter)

Retrieves a detached and modifiable JetspeedPrincipal list matching the corresponding principal name filter.

Parameters:

nameFilter - The filter used to retrieve matching principal.

Returns:

a list of JetspeedPrincipal

getPrincipals

JetspeedPrincipalResultList getPrincipals(JetspeedPrincipalQueryContext queryContext)

Retrieve all principals that match the queryContext. It returns a JetspeedPrincipalResultList, containing the actual result list an the total number of results from the query. The returned principals are detached.

Parameters:

queryContext - The (@see JetspeedPrincipalQueryContext) for this query.

Returns:

getPrincipalsByAttribute

List<? extends JetspeedPrincipal> getPrincipalsByAttribute(String attributeName,
                                                         String attributeValue)

newPrincipal

JetspeedPrincipal newPrincipal(String name,
                             boolean mapped)

newTransientPrincipal

JetspeedPrincipal newTransientPrincipal(String name)

removePrincipal

void removePrincipal(String name)
                     throws SecurityException

Throws:

SecurityException

getAssociatedFrom

List<? extends JetspeedPrincipal> getAssociatedFrom(String principalFromName,
                                                  JetspeedPrincipalType from,
                                                  String associationName)

Retrieves a detached and modifiable JetspeedPrincipal list of all the principals managed by this manager which are associated from the specified principal by the specified association.

If the association is JetspeedPrincipalAssociationType.isSingular() at most one principal will be returned.

Parameters:

principalFromName - The principal name to find the other principals associated to.

from - The principal type of the provided principal name

associationName - The name of the association from the provided principal type to this Manager principal type.

Returns:

The list of JetspeedPrincipal in the to side of the provided association for the provided principal name and its type

getAssociatedTo

List<? extends JetspeedPrincipal> getAssociatedTo(String principalToName,
                                                JetspeedPrincipalType to,
                                                String associationName)

Retrieves a detached and modifiable JetspeedPrincipal list of all the principals managed by this manager which are associated to the specified principal by the specified association.

If the association is JetspeedPrincipalAssociationType.isDominant() at most one principal will be returned.

Parameters:

principalToName - The principal name to find the other principals associated from.

to - The principal type of the provided principal name

associationName - The name of the association from this Manager principal type to the provided principal type

Returns:

The list of JetspeedPrincipal in the from side of the provided association for the provided principal name and its type

getAssociatedNamesFrom

List<String> getAssociatedNamesFrom(String principalFromName,
                                  JetspeedPrincipalType from,
                                  String associationName)

Retrieves a detached and modifiable list of the names of all the principals managed by this manager which are associated from the specified principal by the specified association.

If the association is JetspeedPrincipalAssociationType.isSingular() at most one principal name will be returned.

Parameters:

principalFromName - The principal name to find the other principals associated to.

from - The principal type of the provided principal name

associationName - The name of the association from the provided principal type to this Manager principal type

Returns:

The list of the names of the principals in the from side of the provided association for the provided principal name and its type

getAssociatedNamesTo

List<String> getAssociatedNamesTo(String principalToName,
                                JetspeedPrincipalType to,
                                String associationName)

Retrieves a detached and modifiable list of the names of all the principals managed by this manager which are associated to the specified principal by the specified association.

If the association is JetspeedPrincipalAssociationType.isDominant() at most one principal name will be returned.

Parameters:

principalToName - The principal name to find the other principals associated from.

to - The principal type of the provided principal name

associationName - The name of the association from this Manager principal type the to principal type

Returns:

The list of the names of the principals in the from side of the provided association for the provided principal name and its type

addPrincipal

void addPrincipal(JetspeedPrincipal principal,
                Set<JetspeedPrincipalAssociationReference> associations)
                  throws SecurityException

Throws:

SecurityException

updatePrincipal

void updatePrincipal(JetspeedPrincipal principal)
                     throws SecurityException

Throws:

SecurityException

removePrincipal

void removePrincipal(JetspeedPrincipal principal)
                     throws SecurityException

Throws:

SecurityException

addAssociation

void addAssociation(JetspeedPrincipal from,
                  JetspeedPrincipal to,
                  String associationName)
                    throws SecurityException

Throws:

SecurityException

transferAssociationTo

void transferAssociationTo(JetspeedPrincipal from,
                         JetspeedPrincipal to,
                         JetspeedPrincipal target,
                         String associationName)
                           throws SecurityException

Throws:

SecurityException

transferAssociationFrom

void transferAssociationFrom(JetspeedPrincipal from,
                           JetspeedPrincipal to,
                           JetspeedPrincipal target,
                           String associationName)
                             throws SecurityException

Throws:

SecurityException

removeAssociation

void removeAssociation(JetspeedPrincipal from,
                     JetspeedPrincipal to,
                     String associationName)
                       throws SecurityException

Throws:

SecurityException

addListener

void addListener(PrincipalManagerEventListener listener)

removeListener

void removeListener(PrincipalManagerEventListener listener)