com.cumulocity.sdk.client.devicecontrol

Class DeviceControlApiImpl

java.lang.Object

com.cumulocity.sdk.client.devicecontrol.DeviceControlApiImpl

All Implemented Interfaces:

DeviceControlApi

public class DeviceControlApiImpl
extends Object
implements DeviceControlApi

Constructor Summary

Constructors

Constructor and Description
DeviceControlApiImpl(PlatformParameters parameters, RestConnector restConnector, UrlProcessor urlProcessor, DeviceControlRepresentation deviceControlRepresentation, int pageSize)

Method Summary

Modifier and Type	Method and Description
OperationRepresentation	create(OperationRepresentation operation) Creates operation in the platform.
Subscriber<com.cumulocity.model.idtype.GId,OperationRepresentation>	getNotificationsSubscriber() Gets the notifications subscriber, which allows to receive newly created operations for agent.
OperationRepresentation	getOperation(com.cumulocity.model.idtype.GId gid) Gets operation by id
OperationCollection	getOperations() Gets the all the operation in the platform
OperationCollection	getOperationsByFilter(OperationFilter filter) Gets the operations from the platform based on specified filter.
OperationRepresentation	update(OperationRepresentation operation) Updates operation in the platform.
Future	updateAsync(OperationRepresentation operation) Updates operation in the platform.

Methods inherited from class java.lang.Object

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

Constructor Detail

DeviceControlApiImpl

public DeviceControlApiImpl(PlatformParameters parameters,
                            RestConnector restConnector,
                            UrlProcessor urlProcessor,
                            DeviceControlRepresentation deviceControlRepresentation,
                            int pageSize)

Method Detail

getOperation

public OperationRepresentation getOperation(com.cumulocity.model.idtype.GId gid)
                                     throws SDKException

Description copied from interface: DeviceControlApi

Gets operation by id

Specified by:

getOperation in interface DeviceControlApi

Parameters:

gid - id of the operation to search for

Returns:

the operation with the given id

Throws:

SDKException - if the operation is not found or if the query failed

getOperations

public OperationCollection getOperations()
                                  throws SDKException

Description copied from interface: DeviceControlApi

Gets the all the operation in the platform

Specified by:

getOperations in interface DeviceControlApi

Returns:

collection of operations with paging functionality

Throws:

SDKException - if the query failed

create

public OperationRepresentation create(OperationRepresentation operation)
                               throws SDKException

Description copied from interface: DeviceControlApi

Creates operation in the platform. The id of the operation must not be set, since it will be generated by the platform

Specified by:

create in interface DeviceControlApi

Parameters:

operation - operation to be created

Returns:

the created operation with the generated id

Throws:

SDKException - if the operation could not be created

update

public OperationRepresentation update(OperationRepresentation operation)
                               throws SDKException

Description copied from interface: DeviceControlApi

Updates operation in the platform. The operation to be updated is identified by the id within the given operation.

Specified by:

update in interface DeviceControlApi

Parameters:

operation - to be updated

Returns:

the updated operation

Throws:

SDKException - if the operation could not be updated

updateAsync

public Future updateAsync(OperationRepresentation operation)
                   throws SDKException

Description copied from interface: DeviceControlApi

Updates operation in the platform. Immediate response is available through the Future object. In case of lost connection, buffers data in persistence provider.

Specified by:

updateAsync in interface DeviceControlApi

Parameters:

operation - to be updated

Returns:

the updated operation

Throws:

SDKException - if the operation could not be updated

getOperationsByFilter

public OperationCollection getOperationsByFilter(OperationFilter filter)
                                          throws SDKException

Description copied from interface: DeviceControlApi

Gets the operations from the platform based on specified filter. Queries based on [status, deviceId, agentId] and [deviceId, agentId] are not supported. currently not supported.

Specified by:

getOperationsByFilter in interface DeviceControlApi

Parameters:

filter - the filter criteria(s)

Returns:

collection of operations matched by the filter with paging functionality

Throws:

SDKException - if the query failed

getNotificationsSubscriber

public Subscriber<com.cumulocity.model.idtype.GId,OperationRepresentation> getNotificationsSubscriber()
                                                                                               throws SDKException

Description copied from interface: DeviceControlApi

Gets the notifications subscriber, which allows to receive newly created operations for agent.

 
 Example:

  final GId agentId = ...
  Subscriber<GId, OperationRepresentation> subscriber = deviceControlApi.getNotificationsSubscriber();

  subscriber.subscribe( agentId , new SubscriptionListener<GId, OperationRepresentation>() {

       @Override
      public void onNotification(Subscription<GId> subscription, OperationRepresentation operation) {
             //process operation
      }

       @Override
      public void onError(Subscription<GId> subscription, Throwable ex) {
          // handle subscribe operation error
      }
  });
  
  

Specified by:

getNotificationsSubscriber in interface DeviceControlApi

Returns:

subscriber

Throws:

SDKException - when subscriber creation fail