org.eclipse.mtj.api.extension
Interface DeviceDescriptionProvider

All Superinterfaces:
org.eclipse.emf.ecore.EObject, MtjExtension, org.eclipse.emf.common.notify.Notifier

public interface DeviceDescriptionProvider
extends MtjExtension

Device Description Provider offers information about devices and groups them by similar capabilities. Functionalities, that the Device Description Provider implements, are: Device Description database, matching Device Descriptions query based on a Device Group and management of custom Device Groups.

Device Description shows basic capabilities of devices. Every Device Description instance represents one real device and is identified by vendor name and device model. Capabilities could be device configuration, device profiles or services API that are supported by the device. Capabilities could be also e.g. color depth, screen size, canvas size, camera resolution, supported data exchange protocol, heap size, max jar size, operating system, supported video format or supported sound format.


Method Summary
 DeviceDescription getDeviceDescription(java.lang.String vendor, java.lang.String model)
          Returns DeviceDescription object based on the vendor and model.
 DeviceGroup[] getDeviceGroups()
          Returns all defined device groups.
 DeviceDescription[] getMatchingDeviceDescriptions(DeviceGroup group)
          Returns DeviceDescription objects that match to the device group.
 
Methods inherited from interface org.eclipse.mtj.api.extension.MtjExtension
getDescription, getId, getType, getVendor, getVersion, isActive, setActive, setDescription, setId, setType, setVendor, setVersion
 
Methods inherited from interface org.eclipse.emf.ecore.EObject
eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eIsProxy, eIsSet, eResource, eSet, eUnset
 
Methods inherited from interface org.eclipse.emf.common.notify.Notifier
eAdapters, eDeliver, eNotify, eSetDeliver
 

Method Detail

getDeviceDescription

DeviceDescription getDeviceDescription(java.lang.String vendor,
                                       java.lang.String model)
                                       throws org.eclipse.mtj.exception.MtjException
Returns DeviceDescription object based on the vendor and model.

Parameters:
vendor -
model -
Returns:
Throws:
org.eclipse.mtj.exception.MtjException

getMatchingDeviceDescriptions

DeviceDescription[] getMatchingDeviceDescriptions(DeviceGroup group)
                                                  throws org.eclipse.mtj.exception.MtjException
Returns DeviceDescription objects that match to the device group.

Device Groups are representing a group of devices that have similar capabilities. The groups capabilities are same that the Device Descriptions’. Device Group has also name and description that help to realize the groups devices capabilities.

Parameters:
group -
Returns:
Throws:
org.eclipse.mtj.exception.MtjException

getDeviceGroups

DeviceGroup[] getDeviceGroups()
                              throws org.eclipse.mtj.exception.MtjException
Returns all defined device groups.

Returns:
Throws:
org.eclipse.mtj.exception.MtjException