|
<connector> |
|
The connector element is the root element of the deployment descriptor for the resource adapter. This element includes general information - vendor name, version, specification version supported, icon - about the resource adapter module. It also includes information specific to the implementation of the resource adapter library as specified through the element resourceadapter.
|
|
<display-name>The name</display-name> |
| |
The element display-name contains a short name for the resource adapter that is intended to be displayed by the tools
|
|
<description>The description...</description> |
| |
The element description is used by resource adapter provider to provide text describing the parent element. The description element should include any information that the resource provider wants to provide to the deployer. Typically tools used by the consumer of resource adapter module will display the description when processing the parent element
|
|
<icon> |
| |
The icon element contains a small icon and large icon element which specify the URIs for a small and a large GIF or JPEG icon image to represent the application in GUI.
|
| |
<small-icon>lib/images/wombatadapter_small.jpg</small-icon> |
| | |
The small-icon element contains the name of a file containing an icon for the resource adapter module. The file name is relative path within the resource adapter module. This file must be either in JPEG or GIF format. The icon is used by tools to display information about the resource adapter module. Example: lib/images/wombatadapter_small.jpg.
|
| |
<large-icon>lib/images/wombatadapter_large.jpg</large-icon> |
| | |
The large-icon element contains the name of a file containing an icon for the resource adapter module. The file name is relative path within the resource adapter module. This file must be either in JPEG or GIF format. The icon is used by tools to display information about the resource adapter module. Example: lib/images/wombatadapter_large.jpg.
|
| |
|
<vendor-name>Wombat Corp.</vendor-name> |
| |
The element vendor-name specifies the name of resource adapter provider vendor. Example: Wombat Corp.
|
|
<spec-version>1.0</spec-version> |
| |
The element spec-version specifies the version of the connector architecture specification that is supported by this resource adapter. This information enables deployer to configure the resource adapter to support deployment and runtime requirements of the corresponding connector architecture specification. Example: 1.0.
|
|
<eis-type>Type info...</eis-type> |
| |
The element eis-type contains information about the type of the EIS. For example, the type of an EIS can be product name of EIS independent of any version info. This helps in identifying EIS instances that can be used with this resource adapter.
|
|
<version>1.0</version> |
| |
The element version specifies a string-based version of the resource adapter from the resource adapter provider. Example: 1.0.
|
|
<license> |
| |
The element license specifies licensing requirements for the resource adapter module. This element specifies whether a license is required to deploy and use this resource adapter, and an optional description of the licensing terms (examples: duration of license, number of connection restrictions).
|
| |
<description>The description...</description> |
| | |
The element description is used by resource adapter provider to provide text describing the parent element. The description element should include any information that the resource provider wants to provide to the deployer. Typically tools used by the consumer of resource adapter module will display the description when processing the parent element
|
| |
<license-required>true|false</license-required> |
| | |
The element license-required specifies whether a license is required to deploy and use the resource adapter. This element must be one of the following: true or false.
|
| |
|
<resourceadapter> |
| |
The element resourceadapter specifies information about the resource adapter. The information includes fully-qualified names of class/interfaces required as part of the connector architecture specified contracts, level of transaction support provided, configurable properties for ManagedConnectionFactory instances, one or more authentication mechanisms supported and additional required security permissions. If there is no auth-mechanism specified as part of resource adapter element then the resource adapter does not support any standard security authentication mechanisms as part of security contract.
|
| |
<managedconnectionfactory-class>com.wombat.ManagedConnectionFactoryImpl</managedconnectionfactory-class> |
| | |
The element managedconnectionfactory-class specifies the fully qualified name of the Java class that implements the javax.resource.Managed- ConnectionFactory interface. This Java class is provided as part of resource adapter's implementation of connector architecture specified contracts. Example: com.wombat.ManagedConnectionFactoryImpl.
|
| |
<connectionfactory-interface>com.wombat.ConnectionFactory|javax.resource.cci.ConnectionFactory</connectionfactory-interface> |
| | |
The element connectionfactory-interface specifies the fully-qualified name of the ConnectionFactory interface supported by the resource adapter. Example: com.wombat.ConnectionFactory or javax.resource.cci.ConnectionFactory
|
| |
<connectionfactory-impl-class>com.wombat.ConnectionFactoryImpl</connectionfactory-impl-class> |
| | |
The element connectionfactory-impl-class specifies the fully-qualified name of the ConnectionFactory class that implements resource adapter specific ConnectionFactory interface. Example: com.wombat.ConnectionFactoryImpl.
|
| |
<connection-interface>javax.resource.cci.Connection</connection-interface> |
| | |
The element connection-interface specifies the fully-qualified name of the Connection interface supported by the resource adapter. Example: javax.resource.cci.Connection.
|
| |
<connection-impl-class>com.wombat.ConnectionImpl</connection-impl-class> |
| | |
The element connection-impl-class specifies the fully-qualified name of the Connection class that implements resource adapter specific Connection interface. Example: com.wombat.ConnectionImpl.
|
| |
<transaction-support>no_transaction</transaction-support> |
| | |
The transaction-support element specifies the level of transaction support provided by the resource adapter. The value of transaction-support must be one of the following: NoTransaction, LocalTransaction, XaTansaction.
|
| |
<config-property> |
| | |
The element config-entry contains a declaration of a single configuration property for a ManagedConnectionFactory instance. Each ManagedConnectionFactory instance creates connections to a specific EIS instance based on the properties configured on the ManagedConnectionFactory instance. The configurable properties are specified only once in the deployment descriptor, even though a resource adapter can be used to configure multiple ManagedConnnection- Factory instances (that create connections to different instances of the same EIS). The declaration consists of an optional description, name, type and an optional value of the configuration property. If the resource adapter provider does not specify a value than the deployer is responsible for providing a valid value for a configuration property. Any bounds or well-defined values of properties should be described in the description element.
|
| | |
<description>The description...</description> |
| | | |
The element description is used by resource adapter provider to provide text describing the parent element. The description element should include any information that the resource provider wants to provide to the deployer. Typically tools used by the consumer of resource adapter module will display the description when processing the parent element
|
| | |
<config-property-name>ServerName</config-property-name> |
| | | |
The element config-property-name contains the name of a configuration property. Example: ServerName. The connector architecture defines a set of well-defined properties all of type java.lang.String. These are as follows: ServerName, PortNumber, UserName, Password, ConnectionURL. A resource adapter provider can extend this property set to include properties specific to the resource adapter and its underlying EIS.
|
| | |
<config-property-type>java.lang.String</config-property-type> |
| | | |
The element config-property-type contains the fully qualified Java type of a configuration property as required by ManagedConnection- Factory instance. The following are the legal values of config-property-type: java.lang.Boolean, java.lang.String, java.lang.Integer, java.lang.Double, java.lang.Byte, java.lang.Short, java.lang.Long, java.lang.Float.
|
| | |
<config-property-value>WombatServer</config-property-value> |
| | | |
The element config-property-value contains the value of a configuration entry. Example: WombatServer.
|
| |
| |
<auth-mechanism> |
| | |
The element auth-mechanism specifies an authentication mechanism supported by the resource adapter. Note that this support is for the resource adapter and not for the underlying EIS instance. The optional description specifies any resource adapter specific requirement for the support of security contract and authentication mechanism. Note that basic-password mech-type by default supports the javax.resource.security.PasswordCredential interface as part of the security contract.
|
| | |
<description>The description...</description> |
| | | |
The element description is used by resource adapter provider to provide text describing the parent element. The description element should include any information that the resource provider wants to provide to the deployer. Typically tools used by the consumer of resource adapter module will display the description when processing the parent element
|
| | |
<auth-mech-type>basic-password|kerbv5</auth-mech-type> |
| | | |
The element auth-mech-type specifies type of an authentication mechanism. The example values are: basic-password and kerbv5. Any additional security mechanisms are outside the scope of the Connector architecture specification.
|
| | |
<credential-interface>javax.resource.security.PasswordCredential|javax.resource.security.GenericCredential</credential-interface> |
| | | |
The element credential-interface specifies the interface that the resource adapter implementation supports for the representation of the credentials. This element should be used by application server to find out the Credential interface it should use as part of the security contract. The possible values are: javax.resource.security.PasswordCredential and javax.resource.security.GenericCredential.
|
| |
| |
<reauthentication-support>true|false</reauthentication-support> |
| | |
The element reauthentication-support specifies whether the resource adapter implementation supports re-authentication of existing Managed- Connection instance. Note that this information is for the resource adapter implementation and not for the underlying EIS instance. This element must be one of the following: true or false.
|
| |
<security-permission> |
| | |
The element security permission specifies a security permission that is required by the resource adapter code. The security permission listed in the deployment descriptor are ones that are different from those required by the default permission set as specified in the connector specification. The optional description can mention specific reason that resource adapter requires a given security permission.
|
| | |
<description>The description...</description> |
| | | |
The element description is used by resource adapter provider to provide text describing the parent element. The description element should include any information that the resource provider wants to provide to the deployer. Typically tools used by the consumer of resource adapter module will display the description when processing the parent element
|
| | |
<security-permission-spec>PERMISSION TEXT</security-permission-spec> |
| | | |
The element permission-spec specifies a security permission based on the Security policy file syntax [reference: Java 2, Security architecture specification] http://java.sun.com/products/jdk/1.3/docs/guide/security/PolicyFiles.html#FileSyntax
|
| |
| |
| |