Examples of org.osgi.service.monitor.Monitorable

org.osgi.service.monitor.Monitorable

A {@code Monitorable} can provide information about itself in the form of{@code StatusVariables}. Instances of this interface should register themselves at the OSGi Service Registry. The {@code MonitorAdmin} listens tothe registration of {@code Monitorable} services, and makes the informationthey provide available also through the Device Management Tree (DMT) for remote access.

The monitorable service is identified by its PID string which must be a non- {@code null}, non-empty string that conforms to the "symbolic-name" definition in the OSGi core specification. This means that only the characters [-_.a-zA-Z0-9] may be used. The length of the PID must not exceed 32 characters.

A {@code Monitorable} may optionally support sending notifications when thestatus of its {@code StatusVariables} change. Support for changenotifications can be defined per {@code StatusVariable}.

Publishing {@code StatusVariables} requires the presence of the{@code MonitorPermission} with the {@code publish} action string. Thispermission, however, is not checked during registration of the {@code Monitorable} service. Instead, the {@code MonitorAdmin} implementationmust make sure that when a {@code StatusVariable} is queried, it is shownonly if the {@code Monitorable} is authorized to publish the given{@code StatusVariable}. @author $Id: 27679a7cfe46ef95bdce89e82dbaf3f277243865 $

    public StatusVariable getStatusVariable(String path)
            throws IllegalArgumentException {
        logVisitor.debug("ENTRY: getStatusVariable: " + path, null);
        try {
            StatusVariablePath statusVariablePath = new StatusVariablePath(path);
            Monitorable monitorable = findMonitorableById(statusVariablePath.getMonitorableId());


            return monitorable.getStatusVariable(statusVariablePath.getStatusVariableId());
        } finally {
            logVisitor.debug("EXIT: getStatusVariable: " + path, null);
        }
    }

     *          if <code>monitorableId</code>
     *          is <code>null</code> or otherwise invalid, or points to a
     *          non-existing <code>Monitorable</code>
     */
    public String[] getStatusVariableNames(String monitorableId) {
        Monitorable monitorable = findMonitorableById(monitorableId);
        String[] statusVariableNames = monitorable.getStatusVariableNames();


        List<String> result = new ArrayList<String>();


        for (String statusVariableName : statusVariableNames) {
            if (isValidId(statusVariableName)) {

Examples of org.osgi.service.monitor.Monitorable

Related Classes of org.osgi.service.monitor.Monitorable