Package org.wildfly.security.auth.principal

Class CompositePrincipal

java.lang.Object

org.wildfly.security.auth.principal.CompositePrincipal

All Implemented Interfaces:

Serializable, Iterable<Principal>, Principal

public final class CompositePrincipal
extends Object
implements Principal, Serializable, Iterable<Principal>

A composite principal that consists of multiple elements of possibly disparate type. This may be used to locate a unique principal in a realm which is backed by a database that uses a composite key; in this case, the constituent principals may be names or numbers, or a combination of both.

Author:

David M. Lloyd

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private static Principal[]	NO_PRINCIPALS
private Principal[]	p
private static long	serialVersionUID

Constructor Summary

Constructors

Modifier	Constructor	Description
	CompositePrincipal(Principal... principals)	Construct a new instance.
private	CompositePrincipal(Principal[] principals, boolean clone)
	CompositePrincipal(Collection<Principal> principals)	Construct a new instance.

Method Summary

Modifier and Type	Method	Description
boolean	contains(Class<? extends Principal> type)	Determine whether this composite principal contains the a nested principal of the given type class.
boolean	contains(Principal principal)	Determine whether this composite principal contains the given nested principal.
boolean	equals(Object obj)	Determine whether this principal is equal to the given object.
boolean	equals(CompositePrincipal obj)	Determine whether this principal is equal to the given object.
Principal	get(int idx)	Get the principal at the given index.
<P extends Principal> P	get(int idx, Class<P> type)	Get the principal at the given index, if it is of the given type.
<P extends Principal> P	get(Class<P> type)	Get the first principal with the given type, if any.
String	getName()	Get the principal name.
int	hashCode()	Get the hash code of this principal.
Iterator<Principal>	iterator()	Get an iterator over this principal.
private void	readObject(ObjectInputStream ois)
int	size()	Get the number of nested principals.
String	toString()	Get this principal as a string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface java.security.Principal

implies

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

NO_PRINCIPALS

private static final Principal[] NO_PRINCIPALS

p

private final Principal[] p

Constructor Detail

CompositePrincipal

public CompositePrincipal(Collection<Principal> principals)

Construct a new instance.

Parameters:

principals - the collection of principals to use (must not be null)

CompositePrincipal

public CompositePrincipal(Principal... principals)

Construct a new instance.

Parameters:

principals - the principals to use (must not be null)

CompositePrincipal

private CompositePrincipal(Principal[] principals,
                           boolean clone)

Method Detail

getName

public String getName()

Get the principal name.

Specified by:

getName in interface Principal

Returns:

the principal name, which is a string containing all of the nested principals

contains

public boolean contains(Principal principal)

Determine whether this composite principal contains the given nested principal.

Parameters:

principal - the nested principal (must not be null)

Returns:

true if this principal contains the nested principal, false otherwise

contains

public boolean contains(Class<? extends Principal> type)

Determine whether this composite principal contains the a nested principal of the given type class.

Parameters:

type - the nested principal type class (must not be null)

Returns:

true if this principal contains a nested principal of the given type, false otherwise

size

public int size()

Get the number of nested principals.

Returns:

the number of nested principals

get

public Principal get(int idx)

Get the principal at the given index.

Parameters:

idx - the index

Returns:

the principal at the given index (not null)

Throws:

IndexOutOfBoundsException - if the given index is less than zero or greater than or equal to size()

get

public <P extends Principal> P get(int idx,
                                   Class<P> type)

Get the principal at the given index, if it is of the given type.

Type Parameters:

P - the principal type

Parameters:

idx - the index

type - the principal type class (must not be null)

Returns:

the principal at the given index or null if that principal is not of the given type

Throws:

IndexOutOfBoundsException - if the given index is less than zero or greater than or equal to size()

get

public <P extends Principal> P get(Class<P> type)

Get the first principal with the given type, if any.

Type Parameters:

P - the principal type

Parameters:

type - the principal type class (must not be null)

Returns:

the first principal with the given type, or null if none was found

Throws:

IndexOutOfBoundsException - if the given index is less than zero or greater than or equal to size()

iterator

public Iterator<Principal> iterator()

Get an iterator over this principal.

Specified by:

iterator in interface Iterable<Principal>

Returns:

an iterator over this principal (not null)

equals

public boolean equals(Object obj)

Determine whether this principal is equal to the given object.

Specified by:

equals in interface Principal

Overrides:

equals in class Object

Parameters:

obj - the object

Returns:

true if they are equal, false otherwise

equals

public boolean equals(CompositePrincipal obj)

Determine whether this principal is equal to the given object.

Parameters:

obj - the object

Returns:

true if they are equal, false otherwise

hashCode

public int hashCode()

Get the hash code of this principal.

Specified by:

hashCode in interface Principal

Overrides:

hashCode in class Object

Returns:

the hash code of this principal

toString

public String toString()

Get this principal as a string.

Specified by:

toString in interface Principal

Overrides:

toString in class Object

Returns:

this principal as a string (not null)

readObject

private void readObject(ObjectInputStream ois)
                 throws IOException,
                        ClassNotFoundException

Throws:

IOException

ClassNotFoundException