Eclipse.org Eclipse.org connection Device Kit

XML Element 

<connection> element

Device Kit Attributes Elements XML Reference
Specifies a connection.

Release: 1.1.0

Examples: connection examples


NameTypeDescriptionUse
Element <connection> attributes
idIDSpecifies an unique identifier for this element. After defining an element with the id attribute, other elements can reference this element by using the idref attribute. Since the id attribute value is used by the code generator to generate field and method names, no spaces, periods or commas should be used.optional
implementationNameSpecifies the implementation class name.optional
servicestringSpecifies the Open Services Gateway Initiative (OSGi) service interface name.optional
bundlestringSpecifies the Open Services Gateway Initiative (OSGi) bundle name.optional
bundleidstringSpecifies the Open Services Gateway Initiative (OSGi) bundle symbolic id.optional
superclassNameSpecifies the implementation superclass name.optional
abstractbooleanSpecifies an abstract implementation class. The default is false.optional
idrefanyURISpecifies a reference to the element with the matching id attribute. The matching id attribute must be specified before the idref attribute can be used.optional
packagebasestringSpecifies the start of the generated code''s package. That is, any code that Device Kit generates will be in a package starting with this value. A common value is ""com.company-name"".optional
executionenvironmentsstringSpecifies the Execution Environments for the bundle Manifest.optional
oldbooleanSpecifies if old code should be generated. The default value is defined in the Device Kit preference settings. optional

NameDescriptionUse
Element <connection> elements
<description>Description of the connection.0 to unbounded
<history>New Specifies the connection history.0 to unbounded
<deprecated>Specifies that the contents of this element should be marked as deprecated.0 to 1
<provider>Specifies the provider.0 to 1
<version>Specifies the current version level. The format of the version number should be n.n.n where n is a number. For example, 1.0.0 is a valid version.0 to 1
<vendor>Specifies an implementing vendor.0 to unbounded
<incubation>If the contents of this element is true, then this is an incubation project.0 to 1
<spec>Hardware specification documentation for this device.0 to unbounded
<specreference>Specification reference for this connection.0 to unbounded
<multiplex>Specifies that this is a multiplex connection.0 to 1
<customparameter>Specifies a custom parameter for this connection.0 to unbounded
<bundle>Specifies an Open Services Gateway Initiative (OSGi) bundle should be created.0 to 1
<managedbundle>Specifies an Open Services Gateway Initiative (OSGi) managed bundle should be created.0 to 1
<managedfactorybundle>Specifies an Open Services Gateway Initiative (OSGi) managed factory bundle should be created.0 to 1

Sibling NameSibling Description
Element <connection> element siblings
<adapter>Specifies an adapter.
<adaptertest>Specifies an adapter test.
<agent>Specifies an agent.
<agentmodel>Specifies the agent model used by the agent.
<agenttest>Specifies an agent test.
<agentmodeltest>Specifies an agent model test.
<concrete>Specifies a concrete device.
<concretetest>Specifies a concrete test.
<connectiontest>Specifies an connection test.
<device>Specifies a device.
<devicetest>Specifies a device test.
<profile>Specifies a profile.
<profiletest>Specifies a profile test.
<testagent>Specifies a test agent.
<receivertest>Specifies a receiver transport test.
<transport>Specifies a transport.
<transporttest>Specifies a transport test.
<description>Description of the connection test.
<history>New Specifies the connection test history.
<deprecated>Specifies that the contents of this element should be marked as deprecated.
<provider>Specifies the provider.
<version>Specifies the current version level. The format of the version number should be n.n.n where n is a number. For example, 1.0.0 is a valid version.
<vendor>Specifies an implementing vendor.
<incubation>If the contents of this element is true, then this is an incubation project.
<spec>Hardware specification documentation for this connection.
<send>Specifies the message(s) to send during the test.
<testcount>Unsigned integer that specifies the number of times to execute tests.
<testdelay>Specifies the milliseconds to sleep between each test.
<junit>Specifies a junit test. Currently, not supported.
<monitor>Specifies a monitor test. Currently, not supported.
<playback>Specifies a playback test. Currently, not supported.
<swt>Specifies a Standard Widget Toolkit (SWT) user interface connection test.
<testcase>Specifies a junit testcase.

Element NameElement Description
Element <connection> element tree
<dkml>Specifies the root element of a Device Kit &lt;b&gt;D&lt;/b&gt;evice &lt;b&gt;K&lt;/b&gt;it &lt;b&gt;L&lt;/b&gt;anguage (dkml) document.
¦-<adapter>Specifies an adapter.
¦ ¦-<device>Specifies the device used by the adapter.
¦ ¦ ¦-<transport>Specifies the transport used by the device.
¦ ¦ ¦ ¦-<connection>Specifies an connection to be used by the transport.
¦ ¦ ¦ ¦ ¦-<description>Description of the connection.
¦ ¦ ¦ ¦ ¦-<history>New Specifies the connection history.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the history.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<provider>Specifies the provider history.
¦ ¦ ¦ ¦ ¦ ¦-<version>Version of the history documentation.
¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.
¦ ¦ ¦ ¦ ¦-<provider>Specifies the provider.(see provider)
¦ ¦ ¦ ¦ ¦-<version>Specifies the current version level. The format of the version number should be n.n.n where n is a number. For example, 1.0.0 is a valid version.(see version)
¦ ¦ ¦ ¦ ¦-<vendor>Specifies an implementing vendor.
¦ ¦ ¦ ¦ ¦-<incubation>If the contents of this element is true, then this is an incubation project.
¦ ¦ ¦ ¦ ¦-<spec>Hardware specification documentation for this device.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the specification.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the specification history.(see history)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦-<speccomment>Comment about the protocol specification documentation.
¦ ¦ ¦ ¦ ¦ ¦-<specdate>Date of the protocol specification documentation.
¦ ¦ ¦ ¦ ¦ ¦-<spectitle>Title of the protoocol specification documentation.
¦ ¦ ¦ ¦ ¦ ¦-<specurl>Url of the protocol specification documentation.
¦ ¦ ¦ ¦ ¦ ¦-<specvendor>Vendor of the protocol specification documentation.
¦ ¦ ¦ ¦ ¦ ¦-<specversion>Version of the protocol specification documentation.
¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this connection.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the specification reference.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦-<spec>The protocol specification documentation.(see spec)
¦ ¦ ¦ ¦ ¦ ¦-<specsection>The reference to section in the protocol specification documentation.
¦ ¦ ¦ ¦ ¦-<multiplex>Specifies that this is a multiplex connection.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the multiplex object.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the multiplex history.(see history)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this multiplex.(see specreference)
¦ ¦ ¦ ¦ ¦-<customparameter>Specifies a custom parameter for this connection.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the custom parameter.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the custom parameter history.(see history)
¦ ¦ ¦ ¦ ¦ ¦-<displayname>Description of the custom parameter.
¦ ¦ ¦ ¦ ¦ ¦-<units>Specifies the custom parameter units.
¦ ¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the units.(see description)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the units history.(see history)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this units.(see specreference)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this custom parameter.(see specreference)
¦ ¦ ¦ ¦ ¦ ¦-<enum>Specifies a enumeration option configuration.
¦ ¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the enumeration.(see description)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the enumeration history.(see history)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<units>Specifies the enum units.(see units)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this enumeration.(see specreference)
¦ ¦ ¦ ¦ ¦ ¦ ¦-<key>Specifies a enumeration key.
¦ ¦ ¦ ¦ ¦ ¦ ¦-<label>Specifies a enumeration label.
¦ ¦ ¦ ¦ ¦ ¦ ¦-<value>Specifies the enumeration value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the value.(see description)
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<history>New Specifies the value history.(see history)
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<specreference>Specification reference for this value.(see specreference)
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<ascii>New Specifies a set of ASCII characters (8 bits) value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<bigdecimal>New Specifies an BigDecimal value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<biginteger>New Specifies an BigInteger value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<boolean>Specifies a Boolean value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<byte>Specifies a Byte value (8 bits).
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<bytes>Specifies bytes.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<character>Specifies a character value (16 bits).
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<double>Specifies a Double value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<float>Specifies a Float value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<int>Specifies an Integer value (32 bits).
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<list>Specifies list data.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<long>Specifies a Long value (64 bits).
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<map>Specifies a Map value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<short>Specifies a Short value (16 bits).
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<string>Specifies a String value.
¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦-<encoding>New Specifies string encoding.
¦ ¦ ¦ ¦ ¦ ¦-<minimum>Specifies the minimum value.
¦ ¦ ¦ ¦ ¦ ¦-<maximum>Specifies the maximum value.
¦ ¦ ¦ ¦ ¦-<bundle>Specifies an Open Services Gateway Initiative (OSGi) bundle should be created.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the bundle.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦-<managedbundle>Specifies an Open Services Gateway Initiative (OSGi) managed bundle should be created.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the managed bundle.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦ ¦ ¦ ¦ ¦-<managedfactorybundle>Specifies an Open Services Gateway Initiative (OSGi) managed factory bundle should be created.
¦ ¦ ¦ ¦ ¦ ¦-<description>Description of the factory bundle.(see description)
¦ ¦ ¦ ¦ ¦ ¦-<deprecated>Specifies that the contents of this element should be marked as deprecated.(see deprecated)
¦-<adaptertest>Specifies an adapter test.
¦ ¦-<adapter>Specifies the adapter to be tested.(see adapter)
¦-<agent>Specifies an agent.
¦ ¦-<agentmodel>Specifies the agent model used by the agent.
¦ ¦ ¦-<device>Specifies the device used by the agent model.(see device)
¦ ¦-<device>Specifies the device used by the agent.(see device)
¦-<agentmodel>Specifies the agent model used by the agent.(see agentmodel)
¦-<agenttest>Specifies an agent test.
¦ ¦-<agent>Specifies the agent to be tested.(see agent)
¦ ¦-<agentmodeltest>Specifies the agent model test.
¦ ¦ ¦-<agentmodel>Specifies the agent model to be tested.(see agentmodel)
¦-<agentmodeltest>Specifies an agent model test.(see agentmodeltest)
¦-<concrete>Specifies a concrete device.
¦ ¦-<transport>Specifies the transport used by the concrete device.(see transport)
¦-<concretetest>Specifies a concrete test.
¦ ¦-<concrete>Specifies the concrete device to be tested.(see concrete)
¦-<connection>Specifies an connection.(see connection)
¦-<connectiontest>Specifies an connection test.
¦ ¦-<connection>Specifies the connection to be tested.(see connection)
¦-<device>Specifies a device.(see device)
¦-<devicetest>Specifies a device test.
¦ ¦-<device>Specifies the device to be tested.(see device)
¦-<profile>Specifies a profile.
¦ ¦-<adapter>Specifies the adapter used by the profile.(see adapter)
¦ ¦-<device>Specifies the device used by the profile.(see device)
¦-<profiletest>Specifies a profile test.
¦ ¦-<profile>Specifies the profile to be tested.(see profile)
¦-<testagent>Specifies a test agent.
¦ ¦-<profile>Specifies the profile to be tested.(see profile)
¦-<transport>Specifies a transport.(see transport)
¦-<transporttest>Specifies a transport test.
¦ ¦-<transport>Specifies the transport to be tested.(see transport)

Copyright (c) 2009 IBM. See license in Legal section. 2009-01-22 Device Kit XML Reference 1.2.0