BEA WebLogic J2EE Connector Architecture Attribute Descriptions

 

 

---

ra.xml Attributes

ra.xml Deployment Descriptor Editor Attributes

Attribute	Description	Range of Values	Default Value
Connector Description	This optional element specifies any resource adapter specific requirement for the support of security contract and authentication mechanism.	String	NULL
Connector Display Name	This element contains a short name that is intended to be displayed by tools. The display name need not be unique.	String	NULL
Small Icon	This element contains the name of a file containing a small (16 x 16) icon image. The file name is a relative path within the resource adapter's rar file. The image may be either in the JPEG or GIF format.	JPEG GIF
Large Icon	This element contains the name of a file containing a large (32 x 32) icon image. The file name is a relative path within the resource adapter's rar file. The image may be either in the JPEG or GIF format.	JPEG GIF
Connector Vendor Name	This element specifies the name of resource adapter provider vendor.	String	NULL
Connector Spec Version	This element 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.	String	NULL
Connector Eis Type	This element 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.	String	NULL
Connector Version	This element specifies a string-based version of the resource adapter from the resource adapter provider.	String	NULL
License Description	This element is used to provide text describing the license element. This is an optional element.	String	NULL
License Required	This element specifies whether a license is required to deploy and use the resource adapter.	True False	NULL
Resourceadapter Managedconnectionfactory Class	This element specifies the fully qualified name of the Java class that implements the javax.resource.spi.Managed- ConnectionFactory interface.	String	NULL
Resourceadapter Connectionfactory Interface	This element specifies the fully-qualified name of the ConnectionFactory interface supported by the resource adapter.	String	NULL
Resourceadapter Connectionfactory Impl Class	This element specifies the fully-qualified name of the ConnectionFactory class that implements resource adapter specific ConnectionFactory interface.	String	NULL
Resourceadapter Connection Interface	This element specifies the fully-qualified name of the Connection interface supported by the resource adapter.	String	NULL
Resourceadapter Connection Impl Class	This element specifies the fully-qualified name of the Connection class that implements resource adapter specific Connection interface.	String	NULL
Transaction Support	This element specifies the level of transaction support provided by the resource adapter.	NoTransaction LocalTransaction XATransaction	NULL
Reauthentication Support	This element specifies whether the resource adapter implementation supports re-authentication of existing Managed-Connection instance.	True False	NULL

ra.xml Config Properties

Attribute	Description	Range of Values	Default Value
Description	This element is used to describe any bounds or well-defined values of properties.	String	NULL
Config Property Name	This element contains the name of a configuration property. The connector architecture defines a set of well-defined properties all of type java.lang.String. A resource adapter provider can extend this property set to include properties specific to the resource adapter and its underlying EIS.	ServerName PortNumber UserName Password ConnectionURL	NULL
Config Property Type	This element contains the fully qualified Java type of a configuration property as required by ManagedConnection-Factory instance.	java.lang.Boolean java.lang.String java.lang.Integer java.lang.Double java.lang.Byte java.lang.Short java.lang.Long java.lang.Float java.lang.Character	NULL
Config Property Value	This element contains the value of a configuration entry.	Various	NULL

 

---

ra.xml Authentication Mechanisms

ra.xml Authentication Mechanisms

Attribute	Description	Range of Values	Default Value
Description	This element is used to provide text describing the authentication mechanism type.	String	NULL
Authentication Mechanism Type	This element 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 BasicPassword mechanism type should support the javax.resource.spi.security.PasswordCredential interface. The Kerbv5 mechanism type should support the javax.resource.spi.security.GenericCredential interface.	String	NULL
Credential Interface	This element 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.	String	NULL

ra.xml Security Permissions

Attribute	Description	Range of Values	Default Value
Description	This element is used to provide text describing the security permission.	String	NULL
Security Permission Spec	This element specifies a security permission based on the Security policy file syntax.	String	NULL

 

---

weblogic-ra.xml Attributes

weblogic-ra.xml Deployment Descriptor Editor Attributes

Attribute	Description	Range of Values	Default Value
Description	This element is used to provide text describing the parent element. The description element should include any information that the deployer wants to describe about the deployed Connection Factory. This is an optional element.	String	NULL
Connection Factory Name	This element defines that logical name that will be associated with this specific deployment of the Resource Adapter and its corresponding Connection Factory. The value of connection-factory-name can be used in other deployed Resource Adapters via the ra-link-ref element. This will allow multiple deployed Connection Factories to utilize a common deployed Resource Adapter, as well as share configuration specifications. This is a required element.	String	NULL
Jndi Name	This element defines the name that will be used to bind the Connection Factory Object into the Weblogic JNDI Namespace. Client EJBs and Servlets will use this same JNDI in their defined Reference Desciptor elements of the weblogic specific deployment descriptors. This is a required element.	String	NULL
Initial Capacity	This element identifies the initial number of managed connections which the Weblogic Server will attempt to obtain during deployment. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	Integer	1
Max Capacity	This element identifies the maximum number of managed connections which the Weblogic Server will allow. Requests for newly allocated managed connections beyond this limit will result in a ResourceAllocationException being returned to the caller. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	Integer	10
Capacity Increment	This element identifies the number of additional managed connections which the Weblogic Server will attempt to obtain during resizing of the maintained connection pool. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	Integer	1
Shrinking Enabled	This element indicates whether or not the Connection Pool should have unused Managed Connections reclaimed as a means to control system resources. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	True False	True
Shrink Period Minutes	This element identifies the amount of time the Connection Pool Management will wait between attempts to reclaim unused Managed Connections. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	Integer	1
Ra Link Ref	This element allows for the logical association of multiple deployed Connection Factories with a single deployed Resource Adapter. The specification of this element with a value identifying a separately deployed Connection Factory will result in this newly deployed Connection Factory sharing the Resource Adapter which had been deployed with the referenced Connection Factory. In addition, any values defined in the referred Connection Factories deployment will be inherited by this newly deployed Connection Factory unless specified. This is an optional element.	String	NULL
Native Lib Dir	This element identifies the directory location to be used for all native libraries present in this resource adapter deployment. As part of deployment processing, all encountered native libraries will be copied to the location specified. It is the responsibility of the Administrator to perform the necessary platform actions such that these libraries will be found during Weblogic Server runtime. This is a required element IF native libraries are present.	String	NULL
Logging Enabled	This element indicates whether or not the log writer is set for either the ManagedConnectionFactory or ManagedConnection. If this element is set to true, output generated from either the ManagedConnectionFactory or ManagedConnection will be sent to the file specified by the log-filename element. This is an optional element. Failure to specify this value will result in Weblogic using its defined default value.	True False	False
Log Filename	This element specifies the name of the log file which output generated from either the ManagedConnectionFactory or a ManagedConnection are sent. The full address of the filename is required. This is an optional element.	String	NULL

weblogic-ra.xml Config Properties

Attribute	Description	Range of Values	Default Value
Description	This element is used to provide text describing the config properties.	String	NULL
Config Property Name	This element identifies a name that corresponds to an ra.xml config-entry element with the corresponding config-property-name.	String	NULL
Config Property Type	This element identifies a type that corresponds to an ra.xml config-entry element with the corresponding config-property-name.	String	NULL
Config Property Value	This element identifies a value that corresponds to an ra.xml config-entry element with the corresponding config-property-name.		NULL

weblogic-ra.xml Security Principal Map Entries

Attribute	Description	Range of Values	Default Value
Initiating Principal	The security-principal-map element provides a mechanism to define appropriate resource-principal values for resource adapter and EIS authorization processing, based upon the known WebLogic run time initiating-principal. This map allows for the specification of a defined set of initiating principals and the corresponding resource principal's username and password that should be used when allocating managed connections and connection handles.	0 or More
Resource Username	This element specifies the username identified with the resource-principal. Used when allocating managed connections and connection handles.
Resource Userpassword	This element specifies the password identified with the resource-principal. Used when allocating managed connections and connection handles.	String	NULL