cern.cmw.rda.client
Interface IRDAService

All Known Implementing Classes:

RDAService

public interface IRDAService

Nested Class Summary

static class	IRDAService.GetElement
static class	IRDAService.SubscriptionResult

Method Summary

IDeviceHandle	getDeviceHandle(String deviceName)
List<IRDAService.GetElement>	listGet(List<String> parameters, String cycleSelector) Performs an optimized (bulk) call for multiple get operation.
List<IRDAService.GetElement>	listGet(List<String> parameters, String cycleSelector, Data context)
List<String>	listSet(List<String> parameters, List<Data> values, String cycleSelector) Performs an optimized (bulk) call for multiple set operation.
List<String>	listSet(List<String> parameters, List<Data> values, String cycleSelector, Data context)
List<IRDAService.SubscriptionResult>	listSubscribe(List<String> parameters, String cycleSelector, Data context, ReplyHandler replyHandler) Performs an optimized (bulk) call for multiple subscriptions, possibly with context.
List<IRDAService.SubscriptionResult>	listSubscribe(List<String> parameters, String cycleSelector, ReplyHandler replyHandler) Performs an optimized (bulk) call for multiple subscriptions.
void	listUnsubscribe(List<ISubscriptionRequest> requests) Performs an optimized (bulk) cancellation for multiple subscriptions.
void	setRBACToken(byte[] token)

Method Detail

setRBACToken

void setRBACToken(byte[] token)
                  throws BadToken,
                         TokenExpired

Throws:

BadToken

TokenExpired

getDeviceHandle

IDeviceHandle getDeviceHandle(String deviceName)
                              throws BadParameter,
                                     InternalException

Throws:

BadParameter

InternalException

listSubscribe

List<IRDAService.SubscriptionResult> listSubscribe(List<String> parameters,
                                                   String cycleSelector,
                                                   ReplyHandler replyHandler)
                                                   throws BadParameter,
                                                          InternalException

Performs an optimized (bulk) call for multiple subscriptions. Returns a sequence of subscription requests matching the given list of parameters. Those requests that failed have null entries at relevant positions in the returned sequence.

Throws:

BadParameter - thrown to indicate that some parameter is malformed or does not describe a valid device/property pair

InternalException - thrown if the device could not be located due to an internal RDA error

listSubscribe

List<IRDAService.SubscriptionResult> listSubscribe(List<String> parameters,
                                                   String cycleSelector,
                                                   Data context,
                                                   ReplyHandler replyHandler)
                                                   throws BadParameter,
                                                          InternalException

Performs an optimized (bulk) call for multiple subscriptions, possibly with context. Returns a sequence of subscription requests matching the given list of parameters. Those requests that failed have null entries at relevant positions in the returned sequence.

Throws:

BadParameter - thrown to indicate that some parameter is malformed or does not describe a valid device/property pair

InternalException - thrown if the device could not be located due to an internal RDA error

listUnsubscribe

void listUnsubscribe(List<ISubscriptionRequest> requests)
                     throws BadParameter

Performs an optimized (bulk) cancellation for multiple subscriptions.

Throws:

BadParameter

listGet

List<IRDAService.GetElement> listGet(List<String> parameters,
                                     String cycleSelector)
                                     throws BadParameter

Performs an optimized (bulk) call for multiple get operation. Returns a sequence of pairs matching the given list of parameters. Each pair contains either the Data object or a String error description. This method does not throw any exceptions (see exception below) - all problems are reported in the String component of returned elements, separately for each requested parameter. The only exception that is thrown reports the duplicated entries in the given parameter list (there would be no way to match results to requests properly).

Throws:

BadParameter

listGet

List<IRDAService.GetElement> listGet(List<String> parameters,
                                     String cycleSelector,
                                     Data context)
                                     throws BadParameter

Throws:

BadParameter

listSet

List<String> listSet(List<String> parameters,
                     List<Data> values,
                     String cycleSelector)
                     throws BadParameter

Performs an optimized (bulk) call for multiple set operation. Returns a sequence of string matching the given list of parameters. Each string is either empty (null) in case of success or contains an error description. This method does not throw any exceptions (see exception below) - all problems are reported in the String values of returned elements, separately for each requested parameter. The only exception that is thrown reports the duplicated entries in the given parameter list (there would be no way to match results to requests properly).

Throws:

BadParameter

listSet

List<String> listSet(List<String> parameters,
                     List<Data> values,
                     String cycleSelector,
                     Data context)
                     throws BadParameter

Throws:

BadParameter