org.sakaiproject.entitybroker.providers

Class UserEntityProvider

java.lang.Object

org.sakaiproject.entitybroker.util.AbstractEntityProvider

org.sakaiproject.entitybroker.providers.UserEntityProvider

All Implemented Interfaces:

org.sakaiproject.entitybroker.entityprovider.capabilities.ActionsExecutable, org.sakaiproject.entitybroker.entityprovider.capabilities.CollectionResolvable, org.sakaiproject.entitybroker.entityprovider.capabilities.Createable, org.sakaiproject.entitybroker.entityprovider.capabilities.CRUDable, org.sakaiproject.entitybroker.entityprovider.capabilities.Deleteable, org.sakaiproject.entitybroker.entityprovider.capabilities.Describeable, org.sakaiproject.entitybroker.entityprovider.capabilities.Inputable, org.sakaiproject.entitybroker.entityprovider.capabilities.Outputable, org.sakaiproject.entitybroker.entityprovider.capabilities.Redirectable, org.sakaiproject.entitybroker.entityprovider.capabilities.Resolvable, org.sakaiproject.entitybroker.entityprovider.capabilities.RESTful, org.sakaiproject.entitybroker.entityprovider.capabilities.Sampleable, org.sakaiproject.entitybroker.entityprovider.capabilities.Saveable, org.sakaiproject.entitybroker.entityprovider.capabilities.Updateable, org.sakaiproject.entitybroker.entityprovider.CoreEntityProvider, org.sakaiproject.entitybroker.entityprovider.EntityProvider, org.sakaiproject.entitybroker.entityprovider.extension.Formats, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.InitializingBean

public class UserEntityProvider
extends org.sakaiproject.entitybroker.util.AbstractEntityProvider
implements org.sakaiproject.entitybroker.entityprovider.CoreEntityProvider, org.sakaiproject.entitybroker.entityprovider.capabilities.RESTful, org.sakaiproject.entitybroker.entityprovider.capabilities.Describeable

Entity Provider for users

Author:

Aaron Zeckoski (azeckoski @ gmail.com)

Field Summary

Fields

Modifier and Type	Field and Description
static String	PREFIX

Fields inherited from interface org.sakaiproject.entitybroker.entityprovider.capabilities.CollectionResolvable

SEARCH_LOCATION_REFERENCE, SEARCH_TAGS, SEARCH_USER_REFERENCE

Fields inherited from interface org.sakaiproject.entitybroker.entityprovider.extension.Formats

ALL_KNOWN_FORMATS, ATOM, ATOM_EXTENSIONS, ATOM_MIME_TYPE, FORM, FORM_EXTENSIONS, FORM_MIME_TYPE, HTML, HTML_EXTENSIONS, HTML_MIME_TYPE, JSON, JSON_EXTENSIONS, JSON_MIME_TYPE, JSONP, JSONP_EXTENSIONS, JSONP_MIME_TYPE, RSS, RSS_EXTENSIONS, RSS_MIME_TYPE, TXT, TXT_EXTENSIONS, TXT_MIME_TYPE, UTF_8, XML, XML_EXTENSIONS, XML_MIME_TYPE

Fields inherited from interface org.sakaiproject.entitybroker.entityprovider.capabilities.ActionsExecutable

ACTION_METHOD_SUFFIX

Constructor Summary

Constructors

Constructor and Description
UserEntityProvider()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkUserExists(org.sakaiproject.entitybroker.EntityView view)
EntityUser	convertUser(org.sakaiproject.user.api.User user)
String	createEntity(org.sakaiproject.entitybroker.EntityReference ref, Object entity, Map<String,Object> params)
void	deleteEntity(org.sakaiproject.entitybroker.EntityReference ref, Map<String,Object> params)
boolean	entityExists(String id)
String	findAndCheckUserId(String currentUserId, String currentUserEid) Will check that a userId/eid is valid and will produce a valid userId from the check
EntityUser	findUserFromSearchValue(String userSearchValue)
EntityUser	getCurrentUser(org.sakaiproject.entitybroker.EntityView view)
List<?>	getEntities(org.sakaiproject.entitybroker.EntityReference ref, org.sakaiproject.entitybroker.entityprovider.search.Search search) WARNING: The search results may be drawn from different populations depending on the search parameters specified.
Object	getEntity(org.sakaiproject.entitybroker.EntityReference ref)
String	getEntityPrefix()
String[]	getHandledInputFormats()
String[]	getHandledOutputFormats()
Object	getSampleEntity()
EntityUser	getUserById(String userId) Allows for easy retrieval of the user object
void	setDeveloperHelperService(org.sakaiproject.entitybroker.DeveloperHelperService developerHelperService)
void	setServerConfigurationService(org.sakaiproject.component.api.ServerConfigurationService serverConfigurationService)
void	setUserDirectoryService(org.sakaiproject.user.api.UserDirectoryService userDirectoryService)
void	updateEntity(org.sakaiproject.entitybroker.EntityReference ref, Object entity, Map<String,Object> params)
org.sakaiproject.entitybroker.entityprovider.extension.ActionReturn	validatePassword(org.sakaiproject.entitybroker.EntityView view, Map<String,Object> params)

Methods inherited from class org.sakaiproject.entitybroker.util.AbstractEntityProvider

afterPropertiesSet, destroy, setEntityProviderManager

Methods inherited from class java.lang.Object

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

Field Detail

PREFIX

public static String PREFIX

Constructor Detail

UserEntityProvider

public UserEntityProvider()

Method Detail

setUserDirectoryService

public void setUserDirectoryService(org.sakaiproject.user.api.UserDirectoryService userDirectoryService)

setDeveloperHelperService

public void setDeveloperHelperService(org.sakaiproject.entitybroker.DeveloperHelperService developerHelperService)

Overrides:

setDeveloperHelperService in class org.sakaiproject.entitybroker.util.AbstractEntityProvider

setServerConfigurationService

public void setServerConfigurationService(org.sakaiproject.component.api.ServerConfigurationService serverConfigurationService)

getEntityPrefix

public String getEntityPrefix()

Specified by:

getEntityPrefix in interface org.sakaiproject.entitybroker.entityprovider.EntityProvider

getCurrentUser

public EntityUser getCurrentUser(org.sakaiproject.entitybroker.EntityView view)

checkUserExists

public boolean checkUserExists(org.sakaiproject.entitybroker.EntityView view)

validatePassword

public org.sakaiproject.entitybroker.entityprovider.extension.ActionReturn validatePassword(org.sakaiproject.entitybroker.EntityView view,
                                                                                   Map<String,Object> params)

entityExists

public boolean entityExists(String id)

Specified by:

entityExists in interface org.sakaiproject.entitybroker.entityprovider.CoreEntityProvider

createEntity

public String createEntity(org.sakaiproject.entitybroker.EntityReference ref,
                  Object entity,
                  Map<String,Object> params)

Specified by:

createEntity in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Createable

getSampleEntity

public Object getSampleEntity()

Specified by:

getSampleEntity in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Sampleable

updateEntity

public void updateEntity(org.sakaiproject.entitybroker.EntityReference ref,
                Object entity,
                Map<String,Object> params)

Specified by:

updateEntity in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Updateable

deleteEntity

public void deleteEntity(org.sakaiproject.entitybroker.EntityReference ref,
                Map<String,Object> params)

Specified by:

deleteEntity in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Deleteable

getEntity

public Object getEntity(org.sakaiproject.entitybroker.EntityReference ref)

Specified by:

getEntity in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Resolvable

getEntities

public List<?> getEntities(org.sakaiproject.entitybroker.EntityReference ref,
                  org.sakaiproject.entitybroker.entityprovider.search.Search search)

WARNING: The search results may be drawn from different populations depending on the search parameters specified. A straight listing with no filtering, or a search on "search" or "criteria", will only retrieve matches from the Sakai-maintained user records. A search on "email" may also check the records maintained by the user directory provider.

Specified by:

getEntities in interface org.sakaiproject.entitybroker.entityprovider.capabilities.CollectionResolvable

getHandledInputFormats

public String[] getHandledInputFormats()

Specified by:

getHandledInputFormats in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Inputable

getHandledOutputFormats

public String[] getHandledOutputFormats()

Specified by:

getHandledOutputFormats in interface org.sakaiproject.entitybroker.entityprovider.capabilities.Outputable

getUserById

public EntityUser getUserById(String userId)

Allows for easy retrieval of the user object

Parameters:

userId - a user ID (must be internal ID only and not EID)

Returns:

the user object

Throws:

IllegalArgumentException - if the user Id is invalid

findAndCheckUserId

public String findAndCheckUserId(String currentUserId,
                        String currentUserEid)

Will check that a userId/eid is valid and will produce a valid userId from the check

Parameters:

currentUserId - user id (can be eid)

currentUserEid - user eid (can be id)

Returns:

a valid user id OR null if not valid

findUserFromSearchValue

public EntityUser findUserFromSearchValue(String userSearchValue)

Parameters:

userSearchValue - either a user ID, a user EID, or a user email address

Returns:

the first matching user, or null if no search method worked

convertUser

public EntityUser convertUser(org.sakaiproject.user.api.User user)