org.pac4j.core.profile

Class UserProfile

java.lang.Object

org.pac4j.core.profile.UserProfile

All Implemented Interfaces:

Externalizable, Serializable, Clearable

Direct Known Subclasses:

CommonProfile

public class UserProfile
extends Object
implements Serializable, Externalizable, Clearable

This class is the user profile retrieved from a provider after successful authentication : it's an identifier (string) and attributes (objects). The attributes definition is null (generic profile), it must be defined in subclasses. Additional concepts are the "remember me" nature of the user profile and the roles and permissions associated.

Since:

1.0.0

Author:

Jerome Leleu

See Also:

Serialized Form

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
UserProfile()

Method Summary

Modifier and Type	Method and Description
void	addAttribute(String key, Object value) Add an attribute and perform conversion if necessary.
void	addAttributes(Map<String,Object> attributes) Add attributes.
void	addPermission(String permission) Add a permission.
void	addPermissions(List<String> permissions) Add permissions.
void	addRole(String role) Add a role.
void	addRoles(List<String> roles) Add roles.
void	build(Object id, Map<String,Object> attributes) Build a profile from user identifier and attributes.
void	clear() Removes any sensitive or unnecessary information held in the object.
Object	getAttribute(String name) Return the attribute with name.
<T> T	getAttribute(String name, Class<T> clazz) Return the attribute with name.
Map<String,Object>	getAttributes() Get attributes as immutable map.
protected AttributesDefinition	getAttributesDefinition() Return the attributes definition for this user profile.
String	getId() Get the user identifier.
List<String>	getPermissions() Get the permissions of the user.
List<String>	getRoles() Get the roles of the user.
String	getTypedId() Get the user identifier with a prefix which is the profile type.
boolean	isRemembered() Is the user remembered?
void	readExternal(ObjectInput in)
void	setId(Object id) Set the identifier and convert it if necessary.
void	setRemembered(boolean rme) Define if this profile is remembered.
String	toString()
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final transient org.slf4j.Logger logger

SEPARATOR

public static final transient String SEPARATOR

See Also:

Constant Field Values

Constructor Detail

UserProfile

public UserProfile()

Method Detail

build

public void build(Object id,
                  Map<String,Object> attributes)

Build a profile from user identifier and attributes.

Parameters:

id - user identifier

attributes - user attributes

getAttributesDefinition

protected AttributesDefinition getAttributesDefinition()

Return the attributes definition for this user profile. Null for this (generic) user profile.

Returns:

the attributes definition

addAttribute

public void addAttribute(String key,
                         Object value)

Add an attribute and perform conversion if necessary.

Parameters:

key - key of the attribute

value - value of the attribute

addAttributes

public void addAttributes(Map<String,Object> attributes)

Add attributes.

Parameters:

attributes - use attributes

setId

public void setId(Object id)

Set the identifier and convert it if necessary.

Parameters:

id - user identifier

getId

public 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 String getTypedId()

Get the user identifier with a prefix which is the profile type. This identifier is unique through all providers.

Returns:

the typed user identifier

getAttributes

public Map<String,Object> getAttributes()

Get attributes as immutable map.

Returns:

the immutable attributes

getAttribute

public Object getAttribute(String name)

Return the attribute with name.

Parameters:

name - attribute name

Returns:

the attribute with name

getAttribute

public <T> T getAttribute(String name,
                          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

addRole

public void addRole(String role)

Add a role.

Parameters:

role - the role to add.

addRoles

public void addRoles(List<String> roles)

Add roles.

Parameters:

roles - the roles to add.

addPermission

public void addPermission(String permission)

Add a permission.

Parameters:

permission - the permission to add.

addPermissions

public void addPermissions(List<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 List<String> getRoles()

Get the roles of the user.

Returns:

the user roles.

getPermissions

public List<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 String toString()

Overrides:

toString in class Object

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

clear

public void clear()

Description copied from interface: Clearable

Removes any sensitive or unnecessary information held in the object.

Specified by:

clear in interface Clearable