ResourceRef

The resource-refType contains a declaration of aDeployment Component's reference to an external resource. Itconsists of an optional description, the resource managerconnection factory reference name, the indication of theresource manager connection factory type expected by theDeployment Component code, the type of authentication(Application or Container), and an optional specification ofthe shareability of connections obtained from the resource(Shareable or Unshareable).Example:<resource-ref> <res-ref-name>jdbc/EmployeeAppDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope></resource-ref>



Attributes Summary
description : String@since J2EE1.
name : StringThe res-ref-name element specifies the name of a resource manager connection factory reference.
type : StringThe res-type element specifies the type of the data source.
auth : ResAuthTypeBaseThe res-auth element specifies whether the enterprise bean code signs on programmatically to the resource manager, or whether the Container will sign on to the resource manager on behalf of the bean.
link : String@since J2EE1.
resSharingScope : ResSharingScopeTypeThe res-sharing-scope element specifies whether connections obtainedthrough the given resource manager connection factory reference can beshared.
descriptions : Description *  

Attribute Details

description    -    @since J2EE1.4 deprecated, becomes descriptionsThe description element is used by the ejb-jar file producer to provide text describing the parent element. The description element should include any information that the ejb-jar file producer wants to provide to the consumer of the ejb-jar file (i.e. to the Deployer). Typically, the tools used by the ejb-jar file consumer will display the description when processing the parent element.
     data type:  String
     default Value:   unspecified



name    -    The res-ref-name element specifies the name of a resource manager connection factory reference. The name is a JNDI name relative to the java:comp/env context. The name must be unique within a Deployment File.
     data type:  String
     default Value:   unspecified



type    -    The res-type element specifies the type of the data source. The type is specified by the fully qualified Java language class or interface expected to be implemented by the data source.
     data type:  String
     default Value:   unspecified



auth    -    The res-auth element specifies whether the enterprise bean code signs on programmatically to the resource manager, or whether the Container will sign on to the resource manager on behalf of the bean. In the latter case, the Container uses information that is supplied by the Deployer. The value of this element must be one of the two following:<res-auth>Application</res-auth><res-auth>Container</res-auth>
     data type: ResAuthTypeBase
     default Value:   unspecified
     Allowed Values:  Container   Application   SERVLET  



link    -    @since J2EE1.4 deprecated
     data type:  String
     default Value:   unspecified



resSharingScope    -    The res-sharing-scope element specifies whether connections obtainedthrough the given resource manager connection factory reference can beshared. The value of this element, if specified, must be one of thetwo following: Shareable, UnshareableThe default value is Shareable.
     data type: ResSharingScopeType
     default Value:   unspecified
     Allowed Values:  Shareable   Unshareable  



descriptions    -     
     data type: Description*


Copyright IBM Corp. 1997-2004