Package com.priint.pubserver.plannerapi.interfaces

Interface UsersLocal

public interface UsersLocal

Local interface for the Users service from the Planner API

Method Summary

Modifier and Type	Method	Description
java.util.List<User>	addUsers(java.util.List<User> users)	Adds a new users
boolean	deleteUserByID(java.lang.String login)	Deletes the user from the system at the specified login
java.util.List<UserAccessRight>	getUserAccessRights(java.lang.String login, java.lang.String rightId)	Returns the access rights (with permissions) assigned to the user
User	getUserByID(java.lang.String login)	Returns the user at the specified login
java.util.List<CheckedoutDocument>	getUserCheckedoutDocuments(java.lang.String login)	Returns the checked-out documents by the user
java.util.List<Dataset>	getUserDatasets(java.lang.String login)	Returns the datasets assigned to the user
java.util.List<UserRole>	getUserRoles(java.lang.String login)	Returns the roles with user assigned at the specified login
java.util.List<User>	getUsers(UsersFilter filter)	Returns users at the specified criteria.
java.util.List<Session>	getUserSessions(java.lang.String login)	Returns the sessions assigned to the user
User	setUser(User user)	Modifies existing user
java.util.List<Dataset>	setUserDatasets(java.lang.String login, java.util.List<Dataset> datasets)	Modifies the datasets assigned to the user
java.util.List<User>	setUsers(java.util.List<User> users)	Modifies existing users
java.util.List<UserRole>	setUserToRoles(java.lang.String login, java.util.List<UserRole> roles)	Modifies role assignment to the specified user

Method Detail

getUserByID

User getUserByID(java.lang.String login)
          throws ServiceException,
                 ResourceNotFoundException

Returns the user at the specified login

Parameters:

login - login of the user

Returns:

User

Throws:

ServiceException

ResourceNotFoundException

deleteUserByID

boolean deleteUserByID(java.lang.String login)
                throws ServiceException

Deletes the user from the system at the specified login

Parameters:

login - login of the user

Returns:

boolean true if done successfully

Throws:

ServiceException

setUser

User setUser(User user)
      throws ServiceException

Modifies existing user

Parameters:

user - object with user data to modify

Returns:

User object after modification

Throws:

ServiceException

See Also:

User

getUsers

java.util.List<User> getUsers(UsersFilter filter)
                       throws ServiceException

Returns users at the specified criteria.

Parameters:

filter - filter object

Returns:

List of Users

Throws:

ServiceException

addUsers

java.util.List<User> addUsers(java.util.List<User> users)
                       throws ServiceException

Adds a new users

Parameters:

users - List of Users to create

Returns:

List of Users

Throws:

ServiceException

See Also:

User

setUsers

java.util.List<User> setUsers(java.util.List<User> users)
                       throws ServiceException

Modifies existing users

Parameters:

users - List of Users to modify

Returns:

List of users after modification

Throws:

ServiceException

See Also:

User

getUserRoles

java.util.List<UserRole> getUserRoles(java.lang.String login)
                               throws ServiceException

Returns the roles with user assigned at the specified login

Parameters:

login - login of the user

Returns:

List of Roles

Throws:

ServiceException

See Also:

UserRole

setUserToRoles

java.util.List<UserRole> setUserToRoles(java.lang.String login,
                                        java.util.List<UserRole> roles)
                                 throws ServiceException

Modifies role assignment to the specified user

If we want remove user from the role, we should set delete flag of the role to "1"

Parameters:

login - login of the user

roles - List of UserRole to modify

Returns:

List of Roles after modification

Throws:

ServiceException

See Also:

UserRole

getUserSessions

java.util.List<Session> getUserSessions(java.lang.String login)
                                 throws ServiceException

Returns the sessions assigned to the user

Parameters:

login - login of the user

Returns:

List of Session

Throws:

ServiceException

See Also:

Session

getUserCheckedoutDocuments

java.util.List<CheckedoutDocument> getUserCheckedoutDocuments(java.lang.String login)
                                                       throws ServiceException

Returns the checked-out documents by the user

Parameters:

login - login of the user

Returns:

List of CheckoutDocument

Throws:

ServiceException

See Also:

CheckedoutDocument

getUserDatasets

java.util.List<Dataset> getUserDatasets(java.lang.String login)
                                 throws ServiceException

Returns the datasets assigned to the user

Parameters:

login - login of the user

Returns:

List of Dataset

Throws:

ServiceException

See Also:

Dataset

setUserDatasets

java.util.List<Dataset> setUserDatasets(java.lang.String login,
                                        java.util.List<Dataset> datasets)
                                 throws ServiceException

Modifies the datasets assigned to the user

If we want remove dataset assignment from the user, we should set delete flag of the Dataset to "1"

Parameters:

login - login of the user

Returns:

List of Dataset

Throws:

ServiceException

See Also:

Dataset

getUserAccessRights

java.util.List<UserAccessRight> getUserAccessRights(java.lang.String login,
                                                    java.lang.String rightId)
                                             throws ServiceException

Returns the access rights (with permissions) assigned to the user

Parameters:

login - login of the user

rightId - - optional, if not empty we can get specified right of the user

Returns:

List of UserAccessRight

Throws:

ServiceException

See Also:

UserAccessRight