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

Interface Summary
Interface	Description
ControlUnitTracker	Administration service for monitoring the control unit tracker.
TrackedControlUnit	Represents record in the control unit tracker.
TrackListener	Application may implement this interface an register it in the `ControlUnitTracker` service to receive notification about events in the tracker.

Class Summary
Class	Description
TrackerHierarchyDisplayScheme	This is an utility class defining the display tree of the control unit tracker and can be used in benefit of gui applications.
TrackEvent	Represents event occurred in the control unit tracker.

Package com.prosyst.mprm.admin.cutracker Description

Provides API for monitoring the Control Unit Tracker.

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

As a service on the backend framework - It is accessible to the other bundles through methods defined by the OSGi Framework specification.

Example :

import com.prosyst.mprm.admin.cutracker.ControlUnitTracker;
import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceReference;

.....

  public ControlUnitTracker getControlUnitTracker(BundleContext context) {
    ControlUnitTracker tracker = null;
    ServiceReference trRef = context.getServiceReference("com.prosyst.mprm.admin.cutracker.ControlUnitTracker");
    if (piRef != null) {
      tracker = (ControlUnitTracker)context.getService(trRef);
    }
    return tracker;
  }

.....

As a stand-alone application, not depending on OSGi Framework - it is accessible 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.cutracker.ControlUnitTracker;
import com.prosyst.mprm.rac.RemoteAccessClient;
import java.util.Hashtable;

.....

  public ControlUnitTracker getControlUnitTracker(RemoteAccessClient rac) {
    ControlUnitTracker tracker = null;
    if (rac != null) {
      pi = (ControlUnitTracker)rac.getService("com.prosyst.mprm.admin.cutracker.ControlUnitTracker");
    }
    return tracker;
  }

.....

  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 mPRM ControlUnitTracker service
    ControlUnitTracker tracker = getControlUnitTracker(rac);

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

.....