Package org.ametys.plugins.core.user

Class UserHelper

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.core.user.UserHelper

All Implemented Interfaces:

LogEnabled, Initializable, Component, Serviceable

public class UserHelper
extends AbstractLogEnabled
implements Component, Serviceable, Initializable

Simple user helper, for common function working on User

Field Summary

Fields

Modifier and Type	Field	Description
private static String	__USER_CACHE_BY_EMAIL_ID
private static String	__USER_CACHE_ID
private AbstractCacheManager	_abstractCacheManager
private UserDirectoryFactory	_userDirectoryFactory	The user directory factory
private UserManager	_userManager
private UserPopulationDAO	_userPopulationDAO	The user population DAO
static String	ROLE	The Avalon role

Constructor Summary

Constructors

Constructor	Description
UserHelper()

Method Summary

Modifier and Type	Method	Description
private Map<String,Object>	_user2json(User user, boolean full)
User	getUser(UserIdentity userIdentity)	Get the user from its identity
User	getUserByEmail(String populationId, String email)	Get the user from its email
private Cache<Pair<String,String>,User>	getUserByEmailCache()
private Cache<UserIdentity,User>	getUserCache()
String	getUserFullName(UserIdentity userIdentity)	Get the user's full name handling request cache
String	getUserSortableName(UserIdentity userIdentity)	Get the user's sortable name handling request cache
void	initialize()
UserIdentity	json2userIdentity(Map<String,? extends Object> json)	Get the user identity from a JSON object
void	saxUser(User user, ContentHandler handler)	SAX an user
void	saxUser(User user, ContentHandler handler, String tagName)	SAX an user
void	saxUserIdentity(UserIdentity userIdentity, ContentHandler handler)	SAX an user identity
void	saxUserIdentity(UserIdentity userIdentity, ContentHandler handler, String tagName)	SAX an user identity
void	service(ServiceManager smanager)
Map<String,Object>	user2json(User user)	Get the JSON object representing a user
Map<String,Object>	user2json(UserIdentity userIdentity)	Get the JSON object representing a user
Map<String,Object>	user2json(UserIdentity userIdentity, boolean full)	Get the JSON object representing a user
Map<String,Object>	user2json(User user, boolean full)	Get the JSON object representing a user
List<Map<String,Object>>	userIdentities2json(Collection<UserIdentity> users)	Populate a list of map, where each map representing an user.
List<Map<String,Object>>	users2json(Collection<User> users)	Populate a list of map, where each map representing an user.
List<Map<String,Object>>	users2json(Collection<User> users, boolean full)	Populate a list of map, where each map representing an user.
UserIdentity	xml2userIdentity(Node userNode)	Get the user identity from a DOM Node object

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

The Avalon role

__USER_CACHE_ID

private static final String __USER_CACHE_ID

__USER_CACHE_BY_EMAIL_ID

private static final String __USER_CACHE_BY_EMAIL_ID

_userPopulationDAO

private UserPopulationDAO _userPopulationDAO

The user population DAO

_userDirectoryFactory

private UserDirectoryFactory _userDirectoryFactory

The user directory factory

_userManager

private UserManager _userManager

_abstractCacheManager

private AbstractCacheManager _abstractCacheManager

Constructor Detail

UserHelper

public UserHelper()

Method Detail

service

public void service(ServiceManager smanager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

getUserFullName

public String getUserFullName(UserIdentity userIdentity)

Get the user's full name handling request cache

Parameters:

userIdentity - The user identity

Returns:

user's full name or null if user does not exist

getUserSortableName

public String getUserSortableName(UserIdentity userIdentity)

Get the user's sortable name handling request cache

Parameters:

userIdentity - The user identity

Returns:

user's full name or null if user does not exist

userIdentities2json

public List<Map<String,Object>> userIdentities2json(Collection<UserIdentity> users)

Populate a list of map, where each map representing an user.

Parameters:

users - The list of users

Returns:

The list of map.

users2json

public List<Map<String,Object>> users2json(Collection<User> users)

Populate a list of map, where each map representing an user.

Parameters:

users - The list of users

Returns:

The list of map.

users2json

public List<Map<String,Object>> users2json(Collection<User> users,
                                                 boolean full)

Populate a list of map, where each map representing an user.

Parameters:

users - The list of users

full - Set to true to get full information on user

Returns:

The list of map.

user2json

public Map<String,Object> user2json(UserIdentity userIdentity)

Get the JSON object representing a user

Parameters:

userIdentity - The user identity

Returns:

The user as JSON object

user2json

public Map<String,Object> user2json(UserIdentity userIdentity,
                                          boolean full)

Get the JSON object representing a user

Parameters:

userIdentity - The user identity

full - Set to true to get full information on user

Returns:

The user as JSON object

user2json

public Map<String,Object> user2json(User user)

Get the JSON object representing a user

Parameters:

user - The user

Returns:

The user as JSON object

user2json

public Map<String,Object> user2json(User user,
                                          boolean full)

Get the JSON object representing a user

Parameters:

user - The user

full - Set to true to get full information on user

Returns:

The user as JSON object or null, if the given user is null

_user2json

private Map<String,Object> _user2json(User user,
                                            boolean full)

json2userIdentity

public UserIdentity json2userIdentity(Map<String,? extends Object> json)

Get the user identity from a JSON object

Parameters:

json - the JSON object representing the user

Returns:

the user identity

getUser

public User getUser(UserIdentity userIdentity)

Get the user from its identity

Parameters:

userIdentity - The user identity

Returns:

The user or null if not found

getUserCache

private Cache<UserIdentity,User> getUserCache()

getUserByEmail

public User getUserByEmail(String populationId,
                           String email)

Get the user from its email

Parameters:

populationId - The population id

email - The email

Returns:

The user or null if not found or if multiple user were found with this email

getUserByEmailCache

private Cache<Pair<String,String>,User> getUserByEmailCache()

saxUserIdentity

public void saxUserIdentity(UserIdentity userIdentity,
                            ContentHandler handler)
                     throws SAXException

SAX an user identity

Parameters:

userIdentity - The user identity to SAX

handler - The content handler

Throws:

SAXException - If a SAX error occurs

saxUserIdentity

public void saxUserIdentity(UserIdentity userIdentity,
                            ContentHandler handler,
                            String tagName)
                     throws SAXException

SAX an user identity

Parameters:

userIdentity - The user identity to SAX

handler - The content handler

tagName - The XML tag for saxed user

Throws:

SAXException - If a SAX error occurs

saxUser

public void saxUser(User user,
                    ContentHandler handler)
             throws SAXException

SAX an user

Parameters:

user - The user. If null no sax events will be generated.

handler - The content handler

Throws:

SAXException - If a SAX error occurs

saxUser

public void saxUser(User user,
                    ContentHandler handler,
                    String tagName)
             throws SAXException

SAX an user

Parameters:

user - The user. If null no sax events will be generated.

handler - The content handler

tagName - The XML tag for saxed user

Throws:

SAXException - If a SAX error occurs

xml2userIdentity

public UserIdentity xml2userIdentity(Node userNode)
                              throws TransformerException

Get the user identity from a DOM Node object

Parameters:

userNode - The node

Returns:

The user identity

Throws:

TransformerException - if an error occurs during value retrieving