org.pac4j.core.profile

Class UserProfile

java.lang.Object

org.pac4j.core.profile.UserProfile

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable

Direct Known Subclasses:

CommonProfile

public abstract class UserProfile
extends java.lang.Object
implements java.io.Serializable, java.io.Externalizable

This class is the user profile retrieved from a provider after successful authentication: it's an identifier (string) and attributes (objects). Additional concepts are the "remember me" nature of the user profile, the associated roles, permissions, client name and linked identifier.

Since:

1.0.0

Author:

Jerome Leleu

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger
static java.lang.String	SEPARATOR

Constructor Summary

Constructors

Constructor and Description
UserProfile()

Method Summary

Modifier and Type	Method and Description
void	addAttribute(java.lang.String key, java.lang.Object value) Add an attribute.
void	addAttributes(java.util.Map<java.lang.String,java.lang.Object> attributes) Add attributes.
void	addAuthenticationAttribute(java.lang.String key, java.lang.Object value) Add an authentication-related attribute
void	addAuthenticationAttributes(java.util.Map<java.lang.String,java.lang.Object> attributeMap) Add authentication attributes.
void	addPermission(java.lang.String permission) Add a permission.
void	addPermissions(java.util.Collection<java.lang.String> permissions) Add permissions.
void	addRole(java.lang.String role) Add a role.
void	addRoles(java.util.Collection<java.lang.String> roles) Add roles.
void	addRoles(java.util.Set<java.lang.String> roles) Add roles.
void	build(java.lang.Object id, java.util.Map<java.lang.String,java.lang.Object> attributes) Build a profile from user identifier and attributes.
void	build(java.lang.Object id, java.util.Map<java.lang.String,java.lang.Object> attributes, java.util.Map<java.lang.String,java.lang.Object> authenticationAttributes) Build a profile from user identifier, attributes, and authentication attributes.
void	clearSensitiveData()
boolean	containsAttribute(java.lang.String name) Check to see if profile contains attribute name.
boolean	containsAuthenicationAttribute(java.lang.String name) Check to see if profile contains attribute name.
java.lang.Object	getAttribute(java.lang.String name) Return the attribute with name.
<T> T	getAttribute(java.lang.String name, java.lang.Class<T> clazz) Return the attribute with name.
java.util.Map<java.lang.String,java.lang.Object>	getAttributes() Get all attributes as immutable map.
java.lang.Object	getAuthenticationAttribute(java.lang.String name) Return the authentication attribute with name.
<T> T	getAuthenticationAttribute(java.lang.String name, java.lang.Class<T> clazz) Return authentication attribute with name
java.util.Map<java.lang.String,java.lang.Object>	getAuthenticationAttributes() Get all authentication attributes as an immutable map
java.lang.String	getClientName()
java.lang.String	getId() Get the user identifier.
java.lang.String	getLinkedId()
java.util.Set<java.lang.String>	getPermissions() Get the permissions of the user.
java.util.Set<java.lang.String>	getRoles() Get the roles of the user.
java.lang.String	getTypedId() Get the user identifier with a prefix which is the profile type (full class name with package).
boolean	isRemembered() Is the user remembered?
void	readExternal(java.io.ObjectInput in)
void	removeAttribute(java.lang.String key) Remove an attribute by its key.
void	removeAuthenticationAttribute(java.lang.String key) Remove an authentication attribute by its key
void	setClientName(java.lang.String clientName)
void	setId(java.lang.Object id) Set the identifier and convert it if necessary.
void	setLinkedId(java.lang.String linkedId)
void	setRemembered(boolean rme) Define if this profile is remembered.
java.lang.String	toString()
void	writeExternal(java.io.ObjectOutput out)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final transient org.slf4j.Logger logger

SEPARATOR

public static final transient java.lang.String SEPARATOR

See Also:

Constant Field Values

Constructor Detail

UserProfile

public UserProfile()

Method Detail

build

public void build(java.lang.Object id,
                  java.util.Map<java.lang.String,java.lang.Object> attributes)

Build a profile from user identifier and attributes.

Parameters:

id - user identifier

attributes - user attributes

build

public void build(java.lang.Object id,
                  java.util.Map<java.lang.String,java.lang.Object> attributes,
                  java.util.Map<java.lang.String,java.lang.Object> authenticationAttributes)

Build a profile from user identifier, attributes, and authentication attributes.

Parameters:

id - user identifier

attributes - user attributes

authenticationAttributes - authentication attributes

addAttribute

public void addAttribute(java.lang.String key,
                         java.lang.Object value)

Add an attribute.

Parameters:

key - key of the attribute

value - value of the attribute

addAuthenticationAttribute

public void addAuthenticationAttribute(java.lang.String key,
                                       java.lang.Object value)

Add an authentication-related attribute

Parameters:

key -

value -

addAttributes

public void addAttributes(java.util.Map<java.lang.String,java.lang.Object> attributes)

Add attributes.

Parameters:

attributes - use attributes

addAuthenticationAttributes

public void addAuthenticationAttributes(java.util.Map<java.lang.String,java.lang.Object> attributeMap)

Add authentication attributes.

Parameters:

attributeMap - the authentication attributes

removeAttribute

public void removeAttribute(java.lang.String key)

Remove an attribute by its key.

Parameters:

key - the key

removeAuthenticationAttribute

public void removeAuthenticationAttribute(java.lang.String key)

Remove an authentication attribute by its key

Parameters:

key - the key

setId

public void setId(java.lang.Object id)

Set the identifier and convert it if necessary.

Parameters:

id - user identifier

getId

public java.lang.String getId()

Get the user identifier. This identifier is unique for this provider but not necessarily through all providers.

Returns:

the user identifier

getTypedId

public java.lang.String getTypedId()

Get the user identifier with a prefix which is the profile type (full class name with package). This identifier is unique through all providers.

Returns:

the typed user identifier

getAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAttributes()

Get all attributes as immutable map.

Returns:

the immutable attributes

getAuthenticationAttributes

public java.util.Map<java.lang.String,java.lang.Object> getAuthenticationAttributes()

Get all authentication attributes as an immutable map

Returns:

the immutable authentication attributes

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Return the attribute with name.

Parameters:

name - attribute name

Returns:

the attribute with name

getAuthenticationAttribute

public java.lang.Object getAuthenticationAttribute(java.lang.String name)

Return the authentication attribute with name.

Parameters:

name - authentication attribute name

Returns:

the authentication attribute with name

containsAttribute

public boolean containsAttribute(java.lang.String name)

Check to see if profile contains attribute name.

Parameters:

name - the name

Returns:

true/false

containsAuthenicationAttribute

public boolean containsAuthenicationAttribute(java.lang.String name)

Check to see if profile contains attribute name.

Parameters:

name - the name

Returns:

true/false

getAttribute

public <T> T getAttribute(java.lang.String name,
                          java.lang.Class<T> clazz)

Return the attribute with name.

Type Parameters:

T - the type of the attribute

Parameters:

name - the attribute name

clazz - the class of the attribute

Returns:

the attribute by its name

Since:

1.8

getAuthenticationAttribute

public <T> T getAuthenticationAttribute(java.lang.String name,
                                        java.lang.Class<T> clazz)

Return authentication attribute with name

Type Parameters:

T - The type of the authentication attribute

Parameters:

name - Name of authentication attribute

clazz - The class of the authentication attribute

Returns:

the named attribute

addRole

public void addRole(java.lang.String role)

Add a role.

Parameters:

role - the role to add.

addRoles

public void addRoles(java.util.Collection<java.lang.String> roles)

Add roles.

Parameters:

roles - the roles to add.

addRoles

public void addRoles(java.util.Set<java.lang.String> roles)

Add roles.

Parameters:

roles - the roles to add.

addPermission

public void addPermission(java.lang.String permission)

Add a permission.

Parameters:

permission - the permission to add.

addPermissions

public void addPermissions(java.util.Collection<java.lang.String> permissions)

Add permissions.

Parameters:

permissions - the permissions to add.

setRemembered

public void setRemembered(boolean rme)

Define if this profile is remembered.

Parameters:

rme - whether the user is remembered.

getRoles

public java.util.Set<java.lang.String> getRoles()

Get the roles of the user.

Returns:

the user roles.

getPermissions

public java.util.Set<java.lang.String> getPermissions()

Get the permissions of the user.

Returns:

the user permissions.

isRemembered

public boolean isRemembered()

Is the user remembered?

Returns:

whether the user is remembered.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Specified by:

writeExternal in interface java.io.Externalizable

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Specified by:

readExternal in interface java.io.Externalizable

Throws:

java.io.IOException

java.lang.ClassNotFoundException

clearSensitiveData

public void clearSensitiveData()

getClientName

public java.lang.String getClientName()

setClientName

public void setClientName(java.lang.String clientName)

getLinkedId

public java.lang.String getLinkedId()

setLinkedId

public void setLinkedId(java.lang.String linkedId)