org.cyclos.services.access

Interface AccessClientService

All Superinterfaces:

CRUDService<AccessClientDTO,AccessClientData,AccessClientDataParams>, Service

All Known Subinterfaces:

AccessClientServiceLocal

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

Service interface used for managing access clients

Author:

luis

Method Summary

Methods

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(java.lang.Long typeId, UserLocatorVO user) Returns data for listing access clients of a given type and user
AccessClientsSearchData	getSearchData() Returns data for searching access clients
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	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(java.lang.Long typeId,
                                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

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

unblock

void unblock(AccessClientActionParams params)
             throws FrameworkException

Unblocks the given access client

Throws:

IllegalActionException - When the status is not blocked

FrameworkException