com.prosyst.mprm.admin.devices

Class DeviceCapabilities

java.lang.Object

java.util.Dictionary

com.prosyst.mprm.admin.devices.DeviceCapabilities

All Implemented Interfaces:

javax.provisioning.Capabilities

public abstract class DeviceCapabilities
extends java.util.Dictionary
implements javax.provisioning.Capabilities

Represents a set of name-value properties characterizing the different aspects of the hardware and system software of a device registered in the mPRM. Device capabilities of the devices determine the ability of the system to execute particular application and system bundles. Device capabilities of a device could consist of several capabilities with the same name and different values. Some of the capabilities can be automatically determined by the Management Agent and mPRM, but the system administrator could assign additional capabilities with the device.

Constructor Summary

Constructors

Constructor and Description
DeviceCapabilities()

Method Summary

Modifier and Type	Method and Description
abstract DeviceCapability	addDeviceCapability(java.lang.String capabilityName, java.lang.String capabilityValue) Assigns a new capability with the supplied value to the capability set of the device.
abstract DeviceCapability[]	getDeviceCapabilities() Returns all device capabilities assigned with the device object.
abstract DeviceCapability[]	getDeviceCapability(java.lang.String name) Returns device capabilities assigned with the supplied name or null if the device has no such capability.
abstract boolean	isReadOnly(java.lang.String name, java.lang.String value) Returns if this property with a given name and value can be manually modified.
abstract void	reset() Discards any changes made to the capabilities set of the device since the last update() method.
abstract void	update() Commits the changes made to the capabilities set of the device.

Methods inherited from class java.util.Dictionary

elements, get, isEmpty, keys, put, remove, size

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.provisioning.Capabilities

getCapability, getCapabilityNames

Constructor Detail

DeviceCapabilities

public DeviceCapabilities()

Method Detail

getDeviceCapabilities

public abstract DeviceCapability[] getDeviceCapabilities()

Returns all device capabilities assigned with the device object.

Returns:

an array of DeviceCapability objects encapsulating the values of the capabilities and methods for modifying them.

getDeviceCapability

public abstract DeviceCapability[] getDeviceCapability(java.lang.String name)
                                                throws ManagementException

Returns device capabilities assigned with the supplied name or null if the device has no such capability.

Parameters:

name - the name of the requested device capability.

Returns:

an array of DeviceCapability objects encapsulating the values of the capability and methods for modifying them.

Throws:

ManagementException - if a system error occurs.

addDeviceCapability

public abstract DeviceCapability addDeviceCapability(java.lang.String capabilityName,
                                                     java.lang.String capabilityValue)
                                              throws ManagementException

Assigns a new capability with the supplied value to the capability set of the device. The newly added value will not be made persistent until update() is called.

Parameters:

capabilityName - name of the new capability.

capabilityValue - value of the new capability.

Returns:

a DeviceCapability object encapsulating the value of the added capability and methods for modifying it.

Throws:

ManagementException - if a system error occurs.

isReadOnly

public abstract boolean isReadOnly(java.lang.String name,
                                   java.lang.String value)

Returns if this property with a given name and value can be manually modified. Automatically collected device capabilities are read only.

Parameters:

name - name of the platform capability.

value - value of the device capability.

Returns:

true if the capability is read only.

update

public abstract void update()
                     throws ManagementException

Commits the changes made to the capabilities set of the device.

Throws:

ManagementException - if a system error occurs.

reset

public abstract void reset()
                    throws ManagementException

Discards any changes made to the capabilities set of the device since the last update() method.

Throws:

ManagementException - if a system error occurs.