org.cyclos.services.users

Interface UserService

All Superinterfaces:

CRUDService<UserDTO,UserData,UserDataParams>, CRUDWithConfirmationPasswordService<UserDTO,UserData,UserDataParams>, Service

public interface UserService
extends CRUDWithConfirmationPasswordService<UserDTO,UserData,UserDataParams>

Service interface for user operations

Author:

luis

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ANY_PRINCIPAL_TYPE String that can be used to locate users by any possible principal type, even if there is a default.
static java.lang.String	SELF Identifier to locate the authenticated user

Method Summary

Modifier and Type	Method and Description
boolean	addContact(UserLocatorVO owner, UserLocatorVO contact) Adds the given contact to the given user (or logged user if null)'s contact list, returning whether the list has changed
SerializableInputStream	exportToCSV(UserQuery params) Generates a CSV with the query result
ActiveConfigurationData	getActiveConfiguration(UserLocatorVO locator) Returns the ActiveConfigurationData, containing all the actual configuration for the user matching the given locator
UserWithRolesVO	getCurrentUser() Returns the current user logged in
PublicRegistrationData	getPublicRegistrationData(InitialGroupVO group) Returns data for registering a user from the public registration
java.util.List<InitialGroupVO>	getPublicRegistrationGroups() Return the list of groups guests user can register
UserSearchData	getSearchData(UserSearchContext context) Gets data used on the search page, according to the given search type
java.util.List<InitialGroupVO>	getUserRegistrationGroups(boolean asMember) Return the list of groups the logged user can register new users.
ViewProfileData	getViewProfileData(UserLocatorVO locator) Return a ViewProfileData for the user matching the given locator
UserDetailedVO	locate(UserLocatorVO locator) Locates a user by a customizable key.
SerializableInputStream	printUsers(UserQuery query) Generates the PDF content for a user listing
UserRegistrationResult	publicRegister(PublicRegistrationDTO user) Registers a user from a public registration
UserRegistrationResult	register(UserRegistrationDTO user) Registers a user
UserRegistrationResult	registerByMember(UserRegistrationByMemberDTO user) Registers a user by a regular member.
boolean	removeContact(UserLocatorVO owner, UserLocatorVO contact) Removes the given contact to the given user (or logged user if null)'s contact list, returning whether the list has changed
Page<UserWithFieldsVO>	search(UserQuery query) Search users according to the specified query parameters.
void	updateUserActivity(UserActivityType type) Updates user information status according to the given activity

Methods inherited from interface org.cyclos.services.CRUDWithConfirmationPasswordService

getConfirmationPasswordInputForRemove, removeAllWithConfirmationPassword, removeWithConfirmationPassword, saveWithConfirmationPassword

Methods inherited from interface org.cyclos.services.CRUDService

getData, getDataForNew, load, remove, removeAll, save

Field Detail

SELF

static final java.lang.String SELF

Identifier to locate the authenticated user

See Also:

Constant Field Values

ANY_PRINCIPAL_TYPE

static final java.lang.String ANY_PRINCIPAL_TYPE

String that can be used to locate users by any possible principal type, even if there is a default. Otherwise, if none is specified and there is a default, the default is used.

See Also:

Constant Field Values

Method Detail

addContact

boolean addContact(UserLocatorVO owner,
                   @NotNull
                   UserLocatorVO contact)
            throws FrameworkException

Adds the given contact to the given user (or logged user if null)'s contact list, returning whether the list has changed

Throws:

FrameworkException

exportToCSV

SerializableInputStream exportToCSV(@NotNull
                                    UserQuery params)

Generates a CSV with the query result

getActiveConfiguration

ActiveConfigurationData getActiveConfiguration(@NotNull
                                               UserLocatorVO locator)
                                        throws FrameworkException

Returns the ActiveConfigurationData, containing all the actual configuration for the user matching the given locator

Throws:

FrameworkException

getCurrentUser

UserWithRolesVO getCurrentUser()
                        throws FrameworkException

Returns the current user logged in

Throws:

FrameworkException

getPublicRegistrationData

PublicRegistrationData getPublicRegistrationData(@NotNull
                                                 InitialGroupVO group)
                                          throws FrameworkException

Returns data for registering a user from the public registration

Throws:

FrameworkException

getPublicRegistrationGroups

java.util.List<InitialGroupVO> getPublicRegistrationGroups()
                                                    throws FrameworkException

Return the list of groups guests user can register

Throws:

FrameworkException

getSearchData

UserSearchData getSearchData(UserSearchContext context)
                      throws FrameworkException

Gets data used on the search page, according to the given search type

Throws:

FrameworkException

getUserRegistrationGroups

java.util.List<InitialGroupVO> getUserRegistrationGroups(boolean asMember)
                                                  throws FrameworkException

Return the list of groups the logged user can register new users.

Parameters:

asMember - flag used only in case the logged user is a broker to distinguish between registering as member/broker.

Throws:

FrameworkException

getViewProfileData

ViewProfileData getViewProfileData(@NotNull
                                   UserLocatorVO locator)
                            throws FrameworkException

Return a ViewProfileData for the user matching the given locator

Throws:

FrameworkException

locate

UserDetailedVO locate(@NotNull
                      UserLocatorVO locator)
               throws FrameworkException

Locates a user by a customizable key. Fields are attempted in the following order (only the first non-blank field will be used for the search):

• Id
• Username
• E-mail
• Field value with field's id
• Field value with field's internal name
• Mobile phone

Throws:

ValidationException: - if the locator is invalid (there is no fields non null).

EntityNotFoundException: - if the user was not found or more than one user was found with the specified locator.

FrameworkException

printUsers

SerializableInputStream printUsers(@NotNull
                                   UserQuery query)
                            throws FrameworkException,
                                   ReportExecutionException,
                                   QueryParseException

Generates the PDF content for a user listing

Throws:

FrameworkException

ReportExecutionException

QueryParseException

publicRegister

UserRegistrationResult publicRegister(@NotNull
                                      PublicRegistrationDTO user)
                               throws FrameworkException

Registers a user from a public registration

Throws:

FrameworkException

register

UserRegistrationResult register(@NotNull
                                UserRegistrationDTO user)
                         throws FrameworkException

Registers a user

Throws:

FrameworkException

registerByMember

UserRegistrationResult registerByMember(@NotNull
                                        UserRegistrationByMemberDTO user)
                                 throws FrameworkException

Registers a user by a regular member.

Throws:

FrameworkException

removeContact

boolean removeContact(UserLocatorVO owner,
                      @NotNull
                      UserLocatorVO contact)
               throws FrameworkException

Removes the given contact to the given user (or logged user if null)'s contact list, returning whether the list has changed

Throws:

FrameworkException

search

Page<UserWithFieldsVO> search(@NotNull
                              UserQuery query)
                       throws FrameworkException,
                              QueryParseException

Search users according to the specified query parameters. The returned objects will either contain the BasicUserVO.DISPLAY and BasicUserVO.SHORT_DISPLAY properties filled in or specific profile fields, depending on the products (permissions) of the viewing user. If there are profile fields marked to be returned, display and short display are not returned, as in most cases it would mean repeated information.

Throws:

FrameworkException

QueryParseException

updateUserActivity

void updateUserActivity(@NotNull
                        UserActivityType type)
                 throws FrameworkException

Updates user information status according to the given activity

Throws:

FrameworkException