Top Description Fields Methods
org.osgi.service.dmt.spi

public Interface ExecPlugin

Imports
org.osgi.service.dmt.DmtException, .DmtSession
An implementation of this interface takes the responsibility of handling node execute requests in a subtree of the DMT.

In an OSGi environment such implementations should be registered at the OSGi service registry specifying the list of root node URIs in a String array or in case of a single value as String in the execRootURIs registration parameter.

Author
$Id: e457351f598885e0774abeff2331cbda238df609 $

Field Summary

Modifier and TypeField and Description
public static final String
EXEC_ROOT_URIS

The string to be used as key for the "execRootURIs" property when an ExecPlugin is registered.

public static final String
MOUNT_POINTS

The string to be used as key for the mount points property when an Exec Plugin is registered with mount points.

Method Summary

Modifier and TypeMethod and Description
public void
execute(DmtSession
a reference to the session in which the operation was issued, must not be null
session, String[]
the absolute path of the node to be executed, must not be null
nodePath, String
an identifier to associate this operation with any alerts sent in response to it, can be null
correlator, String
the parameter of the execute operation, can be null
data)

Execute the given node with the given data.

Field Detail

EXEC_ROOT_URISback to summary
public static final String EXEC_ROOT_URIS

The string to be used as key for the "execRootURIs" property when an ExecPlugin is registered.

Since
2.0
MOUNT_POINTSback to summary
public static final String MOUNT_POINTS

The string to be used as key for the mount points property when an Exec Plugin is registered with mount points.

Method Detail

executeback to summary
public void execute(DmtSession session, String[] nodePath, String correlator, String data) throws DmtException

Execute the given node with the given data. This operation corresponds to the EXEC command in OMA DM.

The semantics of an execute operation and the data parameter it takes depends on the definition of the managed object on which the command is issued. Session information is given as it is needed for sending alerts back from the plugin. If a correlation ID is specified, it should be used as the correlator parameter for alerts sent in response to this execute operation.

The nodePath parameter contains an array of path segments identifying the node to be executed in the subtree of this plugin. This is an absolute path, so the first segment is always ".". Special characters appear escaped in the segments.

Parameters
session:DmtSession

a reference to the session in which the operation was issued, must not be null

nodePath:String[]

the absolute path of the node to be executed, must not be null

correlator:String

an identifier to associate this operation with any alerts sent in response to it, can be null

data:String

the parameter of the execute operation, can be null

Exceptions
DmtException:
with the following possible error codes:
  • NODE_NOT_FOUND if the node does not exist
  • METADATA_MISMATCH if the command failed because of meta-data restrictions
  • DATA_STORE_FAILURE if an error occurred while accessing the data store
  • COMMAND_FAILED if some unspecified error is encountered while attempting to complete the command
See Also
DmtSession#execute(String, String), DmtSession#execute(String, String, String)