org.apache.jackrabbit.oak.spi.security.principal

Class EmptyPrincipalProvider

java.lang.Object

org.apache.jackrabbit.oak.spi.security.principal.EmptyPrincipalProvider

All Implemented Interfaces:

PrincipalProvider

public final class EmptyPrincipalProvider
extends Object
implements PrincipalProvider

Implementation of the PrincipalProvider interface that never returns any principals.

Field Summary

Fields

Modifier and Type	Field and Description
static PrincipalProvider	INSTANCE

Method Summary

Modifier and Type	Method and Description
Iterator<? extends Principal>	findPrincipals(int searchType) Find all principals that match the search type.
Iterator<? extends Principal>	findPrincipals(String nameHint, int searchType) Find the principals that match the specified nameHint and search type.
Set<Group>	getGroupMembership(Principal principal) Returns an iterator over all group principals for which the given principal is either direct or indirect member of.
Principal	getPrincipal(String principalName) Returns the principal with the specified name or null if the principal does not exist.
Set<? extends Principal>	getPrincipals(String userID) Tries to resolve the specified userID to a valid principal and it's group membership.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INSTANCE

public static final PrincipalProvider INSTANCE

Method Detail

getPrincipal

public Principal getPrincipal(@Nonnull
                              String principalName)

Description copied from interface: PrincipalProvider

Returns the principal with the specified name or null if the principal does not exist.

Specified by:

getPrincipal in interface PrincipalProvider

Parameters:

principalName - the name of the principal to retrieve

Returns:

return the requested principal or null

getGroupMembership

@Nonnull
public Set<Group> getGroupMembership(@Nonnull
                                              Principal principal)

Description copied from interface: PrincipalProvider

Returns an iterator over all group principals for which the given principal is either direct or indirect member of. Thus for any principal returned in the iterator Group.isMember(Principal) must return true.

Example:
If Principal is member of Group A, and Group A is member of Group B, this method will return Group A and Group B.

Specified by:

getGroupMembership in interface PrincipalProvider

Parameters:

principal - the principal to return it's membership from.

Returns:

an iterator returning all groups the given principal is member of.

See Also:

Group.isMember(java.security.Principal)

getPrincipals

@Nonnull
public Set<? extends Principal> getPrincipals(@Nonnull
                                                       String userID)

Description copied from interface: PrincipalProvider

Tries to resolve the specified userID to a valid principal and it's group membership. This method returns an empty set if the specified ID cannot be resolved.

Specified by:

getPrincipals in interface PrincipalProvider

Parameters:

userID - A userID.

Returns:

The set of principals associated with the specified userID or an empty set if it cannot be resolved.

findPrincipals

@Nonnull
public Iterator<? extends Principal> findPrincipals(@Nullable
                                                             String nameHint,
                                                             int searchType)

Description copied from interface: PrincipalProvider

Find the principals that match the specified nameHint and search type.

Specified by:

findPrincipals in interface PrincipalProvider

Parameters:

nameHint - A name hint to use for non-exact matching.

searchType - Limit the search to certain types of principals. Valid values are any of

• PrincipalManager.SEARCH_TYPE_ALL

• PrincipalManager.SEARCH_TYPE_NOT_GROUP

• PrincipalManager.SEARCH_TYPE_GROUP

Returns:

An iterator of principals.

findPrincipals

@Nonnull
public Iterator<? extends Principal> findPrincipals(int searchType)

Description copied from interface: PrincipalProvider

Find all principals that match the search type.

Specified by:

findPrincipals in interface PrincipalProvider

Parameters:

searchType - Limit the search to certain types of principals. Valid values are any of

• PrincipalManager.SEARCH_TYPE_ALL

• PrincipalManager.SEARCH_TYPE_NOT_GROUP

• PrincipalManager.SEARCH_TYPE_GROUP

Returns:

An iterator of principals.