com.prosyst.mprm.admin.operations (Bosch IoT Remote Manager 7.1 Generic Device Management Package API)

Interface Summary
Interface	Description
CommandResultListener	`CommandResultListener` objects receive command return results caused of operation executions.
FinishedOperation
Operation	Represents management operation tracked by mPRM.
OperationEvent	Represents event occurred during a management operation lifecycle.
OperationFilter	OperationFilter instances could be used for retrieving operations conforming arbitrary filter criteria on their states. Usage: `OperationFilter` instances are created using the `OperationManager.createOperationFilter(String)` method.
OperationListener	Operation listener objects are registered in order to obtain notifications for the events occurred with the state of executed management operations.
OperationManager	Represents the main service for administering operations in mPRM.
OperationResult	Represents error or warning message returned by a device in result of operation execution.
PendingCommand	Represents single command pending for execution on a device.

Class Summary
Class Description

OperationPermanentOptions
The OperationPermanentOption class defines the execution behavior of permanent operations.

Class Summary
Class	Description
OperationPermanentOptions	The `OperationPermanentOption` class defines the execution behavior of permanent operations.

Package com.prosyst.mprm.admin.operations Description

Provides API for controling and monitoring Management Operations.

The API's basic interface is OperationManager and it can be accessed in two ways:

as a service on the backend framework and it is accessible to the other bundles through methods defined by the OSGi Framework specification.

Example :

import com.prosyst.mprm.admin.operations.OperationManager;
import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceReference;

.....

  public OperationManager getOperationManager(BundleContext context) {
    OperationManager operationManager = null;
    ServiceReference omRef = context.getServiceReference("com.prosyst.mprm.admin.operations.OperationManager");
    if (omRef != null) {
      operationManager = (OperationManager)context.getService(omRef);
    }
    return operationManager;
  }

.....

as a stand-alone application, not depending on OSGi Framework, by using com.prosyst.mprm.rac.RemoteAccessClient. An external stand-alone application can use this package by including system-rac.jar and gdm-rac.jar in its classpath.

Example :

import com.prosyst.mprm.admin.operations.OperationManager;
import com.prosyst.mprm.rac.RemoteAccessClient;
import java.util.Hashtable;

.....

  public OperationManager getOperationManager(RemoteAccessClient rac) {
    OperationManager operationManager = null;
    if (rac != null) {
      operationManager = (OperationManager)rac.getService("com.prosyst.mprm.admin.operations.OperationManager");
    }
    return operationManager;
  }

.....

  public static void main(String[] args) {

    //Open session using the system account.
    Hashtable credentials = new Hashtable();
    credentials.put(RemoteAccessClient.USER_PASSWORD, "system");
    RemoteAccessClient rac = RemoteAccessClient.connect("socket://mprm.acme.com:11449", "system", credentials, null);
    ...

    //Now the application can access OperationManager service
    OperationManager operationManager = getOperationManager(rac);

    ...
    //closing session
    rac.close();
  }

.....