org.cyclos.services.access

Interface AccessClientService

All Superinterfaces:

CRUDService<AccessClientDTO,AccessClientData,AccessClientDataParams>, Service

public interface AccessClientService
extends CRUDService<AccessClientDTO,AccessClientData,AccessClientDataParams>

Service interface used for managing access clients

Author:

luis

Method Summary

Modifier and Type	Method and Description
ActivateAccessClientDTO	activate(java.lang.String activationCode, java.lang.String prefix) Activates an access client for the current user, using the given activation code.
void	block(AccessClientActionParams params) Blocks the given an access client
java.lang.String	getActivationCode(AccessClientActionParams params) Returns the code which can be used to activate the access client, connecting an application
AccessClientsListData	getListData(PrincipalTypeVO principalType, UserLocatorVO user) Returns data for listing access clients of a given type and user
AccessClientsSearchData	getSearchData() Returns data for searching access clients
java.util.List<AccessClientTypeData>	getTypeData(UserLocatorVO user, ChannelVO channel) Returns data each access client type the authenticated user can see for the given user.
AccessClientVO	locate(AccessClientLocator locator) Returns an access client by either id or token, but only if it belongs (or is managed by) the authenticated user
Page<AccessClientDetailedVO>	search(AccessClientQuery query) Searches for access clients according to the given criteria
void	unassign(AccessClientActionParams params) Unassigns the given access client from its connected application
void	unassignCurrent(ActionWithConfirmationPassword action) Unassigns the access client in the current authorization.
void	unblock(AccessClientActionParams params) Unblocks the given access client

Methods inherited from interface org.cyclos.services.CRUDService

getData, getDataForNew, load, remove, removeAll, save

Method Detail

activate

ActivateAccessClientDTO activate(java.lang.String activationCode,
                                 java.lang.String prefix)
                          throws FrameworkException

Activates an access client for the current user, using the given activation code. It is possible to pass in a prefix (optional) to have it appended before the activation code itself. Returns a dto containing the principal type and a token which is then used to identify the remote application. The prefix is not returned. So, if for example, "123" is passed as prefix, and "ABCDEF", the token needed to be used on web service requests will be "123ABCDEF", but only "ABCDEF" is returned. If the prefix is null, no prefix is used.

Throws:

FrameworkException

block

void block(AccessClientActionParams params)
    throws FrameworkException

Blocks the given an access client

Throws:

IllegalActionException - When the status is not active

FrameworkException

getActivationCode

java.lang.String getActivationCode(AccessClientActionParams params)
                            throws FrameworkException

Returns the code which can be used to activate the access client, connecting an application

Throws:

IllegalActionException - When the status is not unassigned

FrameworkException

getListData

AccessClientsListData getListData(PrincipalTypeVO principalType,
                                  UserLocatorVO user)
                           throws FrameworkException

Returns data for listing access clients of a given type and user

Throws:

FrameworkException

getSearchData

AccessClientsSearchData getSearchData()
                               throws FrameworkException

Returns data for searching access clients

Throws:

FrameworkException

getTypeData

java.util.List<AccessClientTypeData> getTypeData(UserLocatorVO user,
                                                 ChannelVO channel)
                                          throws FrameworkException

Returns data each access client type the authenticated user can see for the given user. If a channel is passed in, will only return types that can be used to access it.

Throws:

FrameworkException

locate

AccessClientVO locate(AccessClientLocator locator)
               throws FrameworkException

Returns an access client by either id or token, but only if it belongs (or is managed by) the authenticated user

Throws:

FrameworkException

search

Page<AccessClientDetailedVO> search(AccessClientQuery query)
                             throws FrameworkException

Searches for access clients according to the given criteria

Throws:

FrameworkException

unassign

void unassign(AccessClientActionParams params)
       throws FrameworkException

Unassigns the given access client from its connected application

Throws:

IllegalActionException - When the status is unassigned

FrameworkException

unassignCurrent

void unassignCurrent(ActionWithConfirmationPassword action)
              throws FrameworkException

Unassigns the access client in the current authorization. No-op if not authorized as an access client.

Throws:

FrameworkException

unblock

void unblock(AccessClientActionParams params)
      throws FrameworkException

Unblocks the given access client

Throws:

IllegalActionException - When the status is not blocked

FrameworkException