Package com.logicaldoc.webservice.soap.client

Class SoapSecurityClient

java.lang.Object

com.logicaldoc.webservice.soap.client.SoapClient<SecurityService>

com.logicaldoc.webservice.soap.client.SoapSecurityClient

All Implemented Interfaces:

SecurityService

public class SoapSecurityClient
extends SoapClient<SecurityService>
implements SecurityService

Security Web Service client.

Since:

7.5

Author:

Marco Meschieri - LogicalDOC

Constructor Summary

Constructors

Constructor	Description
SoapSecurityClient(String endpoint)

Method Summary

Modifier and Type	Method	Description
int	changePassword(String sid, long userId, String oldPassword, String newPassword)	changes the password of a user. 0 if all is ok, 1 if the password is incorrect, 2 if the new password cannot be notified, otherwise a positive number grater than 2
void	deleteGroup(String sid, long groupId)	Deletes an existing group with the given identifier
void	deleteUser(String sid, long userId)	Deletes an existing user with the given identifier
WSGroup	getGroup(String sid, long groupId)	Gets group metadata of an existing group with the given identifier
WSUser	getUser(String sid, long userId)	Gets user metadata of an existing user with the given identifier
WSUser	getUserByUsername(String sid, String username)	Gets user metadata of an existing user with the given username
List<WSGroup>	listGroups(String sid)	Gets group metadata of all existing groups.
List<WSUser>	listUsers(String sid, String group)	Gets metadata of all existing users
long	storeGroup(String sid, WSGroup group)	Creates/Updates a group.
long	storeUser(String sid, WSUser user)	Creates/Updates a user.

Methods inherited from class java.lang.Object

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

Constructor Details

SoapSecurityClient

public SoapSecurityClient(String endpoint)

Method Details

listUsers

public List<WSUser> listUsers(String sid,
 String group)
                       throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Gets metadata of all existing users

Specified by:

listUsers in interface SecurityService

Parameters:

sid - identifier of the session, must be an administrator

group - name od the group

Returns:

the list of users

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

listGroups

public List<WSGroup> listGroups(String sid)
                         throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Gets group metadata of all existing groups.

Specified by:

listGroups in interface SecurityService

Parameters:

sid - identifier of the session, must be an administrator

Returns:

List of groups

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

storeUser

public long storeUser(String sid,
 WSUser user)
               throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Creates/Updates a user. You can completely customize the user through a value object containing the user's metadata. The current user must be an administrator

Specified by:

storeUser in interface SecurityService

Parameters:

sid - identifier of the session, must be an administrator

user - Web service value object containing the user's metadata

Returns:

the identifier of the created/updated user

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

storeGroup

public long storeGroup(String sid,
 WSGroup group)
                throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Creates/Updates a group. You can completely customize the group through a value object containing the group's metadata.

Specified by:

storeGroup in interface SecurityService

Parameters:

sid - Session identifier. Must be an administrator.

group - Web service value object containing the group's metadata

Returns:

id of the created/updated group.

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

deleteUser

public void deleteUser(String sid,
 long userId)
                throws PermissionException,
WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Deletes an existing user with the given identifier

Specified by:

deleteUser in interface SecurityService

Parameters:

sid - Session identifier. Must be an administrator

userId - The user id

Throws:

PermissionException - The user does not have the required permission

WebserviceException - Error in the webservice

PersistenceException - Error in the database

deleteGroup

public void deleteGroup(String sid,
 long groupId)
                 throws PermissionException,
PersistenceException,
WebserviceException

Description copied from interface: SecurityService

Deletes an existing group with the given identifier

Specified by:

deleteGroup in interface SecurityService

Parameters:

sid - Session identifier. Must be an administrator

groupId - The group id

Throws:

PermissionException - The user does not have the required permission

PersistenceException - Error in the database

WebserviceException - Error in the webservice

changePassword

public int changePassword(String sid,
 long userId,
 String oldPassword,
 String newPassword)
                   throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

changes the password of a user.
0 if all is ok, 1 if the password is incorrect, 2 if the new password cannot be notified, otherwise a positive number grater than 2

Specified by:

changePassword in interface SecurityService

Parameters:

sid - identifier of the session

userId - The user Identifier. Must be an administrator.

oldPassword - can be null

newPassword - the new password

Returns:

0 if all is ok, 1 if the password is incorrect, 2 if the new password cannot be notified, otherwise a positive number grater than 2

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

getUser

public WSUser getUser(String sid,
 long userId)
               throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Gets user metadata of an existing user with the given identifier

Specified by:

getUser in interface SecurityService

Parameters:

sid - Session identifier

userId - The user id

Returns:

A value object containing the user's metadata

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

getUserByUsername

public WSUser getUserByUsername(String sid,
 String username)
                         throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Gets user metadata of an existing user with the given username

Specified by:

getUserByUsername in interface SecurityService

Parameters:

sid - Session identifier

username - The user name

Returns:

A value object containing the user's metadata

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database

getGroup

public WSGroup getGroup(String sid,
 long groupId)
                 throws WebserviceException,
PersistenceException

Description copied from interface: SecurityService

Gets group metadata of an existing group with the given identifier

Specified by:

getGroup in interface SecurityService

Parameters:

sid - Session identifier

groupId - The group id

Returns:

A value object containing the group's metadata

Throws:

WebserviceException - Error in the webservice

PersistenceException - Error in the database