org.dspace.eperson

Class EPersonServiceImpl

java.lang.Object

org.dspace.content.DSpaceObjectServiceImpl<EPerson>

org.dspace.eperson.EPersonServiceImpl

All Implemented Interfaces:

DSpaceObjectLegacySupportService<EPerson>, DSpaceObjectService<EPerson>, EPersonService

public class EPersonServiceImpl
extends DSpaceObjectServiceImpl<EPerson>
implements EPersonService

Service implementation for the EPerson object. This class is responsible for all business logic calls for the EPerson object and is autowired by spring. This class should never be accessed directly.

Author:

kevinvandevelde at atmire.com

Field Summary

Fields

Modifier and Type	Field and Description
protected AuthorizeService	authorizeService
protected EPersonDAO	ePersonDAO
protected ItemService	itemService
protected SubscribeService	subscribeService

Fields inherited from class org.dspace.content.DSpaceObjectServiceImpl

choiceAuthorityService, handleService, metadataAuthorityService, metadataFieldService, metadataValueService

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EPersonServiceImpl()

Method Summary

Modifier and Type	Method and Description
boolean	checkPassword(Context context, EPerson ePerson, String attempt) Check EPerson's password.
int	countTotal(Context context)
EPerson	create(Context context) Create a new eperson
void	delete(Context context, EPerson ePerson)
EPerson	find(Context context, UUID id) Generic find for when the precise type of a DSO is not known, just the a pair of type number and database ID.
List<EPerson>	findAll(Context context, int sortField) Find all the epeople that match a particular query ID LASTNAME EMAIL NETID
EPerson	findByEmail(Context context, String email) Find the eperson by their email address.
List<EPerson>	findByGroups(Context c, Set<Group> groups)
EPerson	findByIdOrLegacyId(Context context, String id)
EPerson	findByLegacyId(Context context, int legacyId) Generic find for when the precise type of a DSO is not known, just the a pair of type number and database ID.
EPerson	findByNetid(Context context, String netId) Find the eperson by their netid.
List<EPerson>	findEPeopleWithSubscription(Context context)
List<EPerson>	findNotActiveSince(Context context, Date date)
List<EPerson>	findUnsalted(Context context) Retrieve all accounts which have a password but do not have a digest algorithm
List<String>	getDeleteConstraints(Context context, EPerson ePerson) Check for presence of EPerson in tables that have constraints on EPersons.
String	getMetadata(EPerson dso, String field) Get the value of a metadata field
PasswordHash	getPasswordHash(EPerson ePerson) Return the EPerson's password hash.
int	getSupportsTypeConstant() Returns the Constants which this service supports
List<EPerson>	search(Context context, String query) Find the epeople that match the search query across firstname, lastname or email.
List<EPerson>	search(Context context, String query, int offset, int limit) Find the epeople that match the search query across firstname, lastname or email.
int	searchResultCount(Context context, String query) Returns the total number of epeople returned by a specific query, without the overhead of creating the EPerson objects to store the results.
void	setMetadata(Context context, EPerson ePerson, String field, String value) Set a metadata value
void	setPassword(EPerson ePerson, String password) Set the EPerson's password.
void	setPasswordHash(EPerson ePerson, PasswordHash password) Set the EPerson's password hash.
void	update(Context context, EPerson ePerson)
void	updateLastModified(Context context, EPerson dso)

Methods inherited from class org.dspace.content.DSpaceObjectServiceImpl

addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, clearMetadata, getAdminObject, getAuthoritiesAndConfidences, getElements, getElementsFilled, getIdentifiers, getMDValueByField, getMDValueByLegacyField, getMetadata, getMetadata, getMetadata, getMetadataByMetadataString, getMetadataFirstValue, getMetadataValuePlace, getName, getParentObject, getTypeText, match, removeMetadataValues, setMetadataSingleValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.dspace.content.service.DSpaceObjectService

addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, addMetadata, clearMetadata, getAdminObject, getIdentifiers, getMetadata, getMetadata, getMetadata, getMetadataByMetadataString, getMetadataFirstValue, getName, getParentObject, getTypeText, removeMetadataValues, setMetadataSingleValue

Field Detail

ePersonDAO

@Autowired(required=true)
protected EPersonDAO ePersonDAO

authorizeService

@Autowired(required=true)
protected AuthorizeService authorizeService

itemService

@Autowired(required=true)
protected ItemService itemService

subscribeService

@Autowired(required=true)
protected SubscribeService subscribeService

Constructor Detail

EPersonServiceImpl

protected EPersonServiceImpl()

Method Detail

find

public EPerson find(Context context,
                    UUID id)
             throws SQLException

Description copied from interface: DSpaceObjectService

Generic find for when the precise type of a DSO is not known, just the a pair of type number and database ID.

Specified by:

find in interface DSpaceObjectService<EPerson>

Parameters:

context - - the context

id - - id within table of type'd objects

Returns:

the object found, or null if it does not exist.

Throws:

SQLException - only upon failure accessing the database.

findByIdOrLegacyId

public EPerson findByIdOrLegacyId(Context context,
                                  String id)
                           throws SQLException

Specified by:

findByIdOrLegacyId in interface DSpaceObjectLegacySupportService<EPerson>

Throws:

SQLException

findByLegacyId

public EPerson findByLegacyId(Context context,
                              int legacyId)
                       throws SQLException

Description copied from interface: DSpaceObjectLegacySupportService

Generic find for when the precise type of a DSO is not known, just the a pair of type number and database ID.

Specified by:

findByLegacyId in interface DSpaceObjectLegacySupportService<EPerson>

Parameters:

context - - the context

legacyId - - the legacy id within table of type'd objects

Returns:

the object found, or null if it does not exist.

Throws:

SQLException - only upon failure accessing the database.

findByEmail

public EPerson findByEmail(Context context,
                           String email)
                    throws SQLException

Description copied from interface: EPersonService

Find the eperson by their email address.

Specified by:

findByEmail in interface EPersonService

Returns:

EPerson, or null if none such exists.

Throws:

SQLException

findByNetid

public EPerson findByNetid(Context context,
                           String netId)
                    throws SQLException

Description copied from interface: EPersonService

Find the eperson by their netid.

Specified by:

findByNetid in interface EPersonService

Parameters:

context - DSpace context

netId - Network ID

Returns:

corresponding EPerson, or null

Throws:

SQLException

search

public List<EPerson> search(Context context,
                            String query)
                     throws SQLException

Description copied from interface: EPersonService

Find the epeople that match the search query across firstname, lastname or email.

Specified by:

search in interface EPersonService

Parameters:

context - DSpace context

query - The search string

Returns:

array of EPerson objects

Throws:

SQLException

search

public List<EPerson> search(Context context,
                            String query,
                            int offset,
                            int limit)
                     throws SQLException

Description copied from interface: EPersonService

Find the epeople that match the search query across firstname, lastname or email. This method also allows offsets and limits for pagination purposes.

Specified by:

search in interface EPersonService

Parameters:

context - DSpace context

query - The search string

offset - Inclusive offset

limit - Maximum number of matches returned

Returns:

array of EPerson objects

Throws:

SQLException

searchResultCount

public int searchResultCount(Context context,
                             String query)
                      throws SQLException

Description copied from interface: EPersonService

Returns the total number of epeople returned by a specific query, without the overhead of creating the EPerson objects to store the results.

Specified by:

searchResultCount in interface EPersonService

Parameters:

context - DSpace context

query - The search string

Returns:

the number of epeople matching the query

Throws:

SQLException

findAll

public List<EPerson> findAll(Context context,
                             int sortField)
                      throws SQLException

Description copied from interface: EPersonService

Find all the epeople that match a particular query

• ID
• LASTNAME
• EMAIL
• NETID

Specified by:

findAll in interface EPersonService

Returns:

array of EPerson objects

Throws:

SQLException

create

public EPerson create(Context context)
               throws SQLException,
                      AuthorizeException

Description copied from interface: EPersonService

Create a new eperson

Specified by:

create in interface EPersonService

Parameters:

context - DSpace context object

Throws:

SQLException

AuthorizeException

delete

public void delete(Context context,
                   EPerson ePerson)
            throws SQLException,
                   AuthorizeException

Specified by:

delete in interface DSpaceObjectService<EPerson>

Throws:

SQLException

AuthorizeException

getSupportsTypeConstant

public int getSupportsTypeConstant()

Description copied from interface: DSpaceObjectService

Returns the Constants which this service supports

Specified by:

getSupportsTypeConstant in interface DSpaceObjectLegacySupportService<EPerson>

Specified by:

getSupportsTypeConstant in interface DSpaceObjectService<EPerson>

Returns:

a org.dspace.core.Constants that represents a DSpaceObjct type

setPassword

public void setPassword(EPerson ePerson,
                        String password)

Description copied from interface: EPersonService

Set the EPerson's password.

Specified by:

setPassword in interface EPersonService

password - the new password.

setPasswordHash

public void setPasswordHash(EPerson ePerson,
                            PasswordHash password)

Description copied from interface: EPersonService

Set the EPerson's password hash.

Specified by:

setPasswordHash in interface EPersonService

password - hashed password, or null to set row data to NULL.

getPasswordHash

public PasswordHash getPasswordHash(EPerson ePerson)

Description copied from interface: EPersonService

Return the EPerson's password hash.

Specified by:

getPasswordHash in interface EPersonService

Returns:

hash of the password, or null on failure (such as no password).

checkPassword

public boolean checkPassword(Context context,
                             EPerson ePerson,
                             String attempt)

Description copied from interface: EPersonService

Check EPerson's password. Side effect: original unsalted MD5 hashes are converted using the current algorithm.

Specified by:

checkPassword in interface EPersonService

attempt - the password attempt

Returns:

boolean successful/unsuccessful

update

public void update(Context context,
                   EPerson ePerson)
            throws SQLException,
                   AuthorizeException

Specified by:

update in interface DSpaceObjectService<EPerson>

Overrides:

update in class DSpaceObjectServiceImpl<EPerson>

Throws:

SQLException

AuthorizeException

getDeleteConstraints

public List<String> getDeleteConstraints(Context context,
                                         EPerson ePerson)
                                  throws SQLException

Description copied from interface: EPersonService

Check for presence of EPerson in tables that have constraints on EPersons. Called by delete() to determine whether the eperson can actually be deleted. An EPerson cannot be deleted if it exists in the item, workflowitem, or tasklistitem tables.

Specified by:

getDeleteConstraints in interface EPersonService

Returns:

List of tables that contain a reference to the eperson.

Throws:

SQLException

findByGroups

public List<EPerson> findByGroups(Context c,
                                  Set<Group> groups)
                           throws SQLException

Specified by:

findByGroups in interface EPersonService

Throws:

SQLException

findEPeopleWithSubscription

public List<EPerson> findEPeopleWithSubscription(Context context)
                                          throws SQLException

Specified by:

findEPeopleWithSubscription in interface EPersonService

Throws:

SQLException

updateLastModified

public void updateLastModified(Context context,
                               EPerson dso)
                        throws SQLException

Specified by:

updateLastModified in interface DSpaceObjectService<EPerson>

Throws:

SQLException

getMetadata

public String getMetadata(EPerson dso,
                          String field)

Description copied from interface: DSpaceObjectService

Get the value of a metadata field

Specified by:

getMetadata in interface DSpaceObjectService<EPerson>

Overrides:

getMetadata in class DSpaceObjectServiceImpl<EPerson>

Parameters:

dso - DSpaceObject

field - the name of the metadata field to get

Returns:

the value of the metadata field (or null if the column is an SQL NULL)

setMetadata

public void setMetadata(Context context,
                        EPerson ePerson,
                        String field,
                        String value)
                 throws SQLException

Description copied from interface: EPersonService

Set a metadata value

Specified by:

setMetadata in interface EPersonService

field - the name of the metadata field to set

value - value to set the field to

Throws:

SQLException

findUnsalted

public List<EPerson> findUnsalted(Context context)
                           throws SQLException

Description copied from interface: EPersonService

Retrieve all accounts which have a password but do not have a digest algorithm

Specified by:

findUnsalted in interface EPersonService

Parameters:

context - the dspace context

Returns:

a list of epeople

Throws:

SQLException

findNotActiveSince

public List<EPerson> findNotActiveSince(Context context,
                                        Date date)
                                 throws SQLException

Specified by:

findNotActiveSince in interface EPersonService

Throws:

SQLException

countTotal

public int countTotal(Context context)
               throws SQLException

Specified by:

countTotal in interface EPersonService

Throws:

SQLException