org.cyclos.services.access

Interface PinService

All Superinterfaces:

Service

public interface PinService
extends Service

Service interface for device pins.

Author:

ameyer

Method Summary

Modifier and Type	Method and Description
UserPinsData	getData(UserLocatorVO locator) Returns data regarding pins for the given user (null resolves to the logged user).
PinData	getEditData(PinLocatorVO locator) Returns data for editing a pin.
java.util.List<PinVO>	list(UserLocatorVO locator) Returns the list of device pins for the given user (null resolves to the logged user).
PinVO	locate(PinLocatorVO locator) Locates a device pin, either by id or principal.
void	remove(PinLocatorVO locator) Removes the given pin.
void	save(@NotNull PinDTO dto) Updates a given device pin for the logged user.
CreatePinDTO	set(@NotNull SetPinParams params) Creates a new pin for the logged user and associates it to the current principal type and password type.

Method Detail

getData

UserPinsData getData(UserLocatorVO locator)
              throws FrameworkException

Returns data regarding pins for the given user (null resolves to the logged user).

Throws:

FrameworkException

getEditData

PinData getEditData(PinLocatorVO locator)
             throws FrameworkException

Returns data for editing a pin.

Parameters:

locator - Optional if authenticated with a pin. Otherwise it must not be null.

Throws:

FrameworkException

list

java.util.List<PinVO> list(UserLocatorVO locator)
                    throws FrameworkException

Returns the list of device pins for the given user (null resolves to the logged user).
Manager users must have the Permission.USER_PINS_VIEW permission.

Throws:

FrameworkException

locate

PinVO locate(PinLocatorVO locator)

Locates a device pin, either by id or principal. For users other than the pin's owner (admin / brokers) the Permission.USER_PINS_VIEW permission must be granted

Parameters:

locator - Optional if authenticated with a pin. Otherwise it must not be null.

remove

void remove(PinLocatorVO locator)
     throws FrameworkException

Removes the given pin. For managers (admin / brokers) the Permission.USER_PINS_MANAGE permission must be granted.

Parameters:

locator - Optional if authenticated with a pin. Otherwise it must not be null.

Throws:

FrameworkException

save

void save(@NotNull
          @NotNull PinDTO dto)
   throws FrameworkException

Updates a given device pin for the logged user. It will be used from the mobile in the settings page. The given pin's name must be unique, otherwise it throws a ValidationException

Throws:

FrameworkException

set

CreatePinDTO set(@NotNull
                 @NotNull SetPinParams params)
          throws FrameworkException

Creates a new pin for the logged user and associates it to the current principal type and password type. The result will contain the generated principal and a salt that must be prepended to the pin entered by the user when login.

Throws:

FrameworkException