Reference elements are as follows:
This element maps the res-ref-name Element in the corresponding Java EE web.xml file resource-env-ref entry to the absolute jndi-name of a resource.
The following table describes subelements for the resource-env-ref element.
Table A–20 resource-env-ref Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the res-ref-name in the corresponding Java EE web.xml file resource-env-ref entry. |
|
only one |
Specifies the absolute jndi-name of a resource. |
none
Contains data that specifies the res-ref-name Element in the corresponding Java EE web.xml file resource-env-ref entry.
none
none
This element specifies the runtime settings for a web service reference. Runtime information is only needed in the following cases:
To define the port used to resolve a container-managed port
To define the default Stub/Call property settings for Stub objects
To define the URL of a final WSDL document to be used instead of the one associated with service-ref in the standard Java EE deployment descriptor
Element |
Required |
Description |
only one |
Specifies the web service reference name relative to java:comp/env |
|
zero or more |
Specifies information for a port within a web service reference |
|
zero or more |
Specifies JAX-RPC property values that can be set on a javax.xml.rpc. Call object before it is returned to the web service client |
|
zero or more |
Specifies the name of the generated service implementation class |
|
zero or one |
Specifies the WSDL service element that is being referenced. |
This element specifies the web service reference name relative to java:comp/env.
none
none
Either a service-endpoint-interface or a wsdl-port or both ports must be specified. If both ports are specified, wsdl-port specifies the port that the container chooses for container-managed port selection. The same wsdl-port value must not appear in more than one port-info element within the same service-ref. If a service-endpoint-interface is using container-managed port selection, its value must not appear in more than one port-info element within the same service-ref.
The following table describes subelements for the port-info element.
Table A–22 port-info Subelements
Element |
Required |
Description |
zero or one |
Specifies the web service reference name relative to java:comp/env. |
|
zero or one |
Specifies the WSDL port. |
|
zero or one |
Specifies JAX-RPC property values that are set on thejavax.xml.rpc.Stub object before it is returned to the web service client. |
|
zero or one |
Specifies JAX-RPC property values that are set on thejavax.xml.rpc.Stub object before it is returned to the web service client. |
|
zero or one |
Specifies a custom authentication provider binding. |
This element specifies the web service reference name relative to java:comp/env.
none
none
Specifies the WSDL port.
The following table describes subelements for the wsdl-port element
Table A–23 wsdl-port Subelements
Element |
Required |
Description |
only one |
Specifies the namespace URI. |
|
only one |
Specifies the local part of a QNAME. |
This element specifies the namespace URI.
none
none
Specifies the local part of a QNAME.
none
none
This element specifies JAX-RPC property values that are set on a javax.xml.rpc. Stub object before it is returned to the web service client. The property names can be any properties supported by the JAX-RPC Stub implementation.
The following table describes subelements for the stub-property element.
Table A–24 stub-property subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the name of the entity. |
|
only one |
Specifies the value of the entity. |
This element specifies JAX-RPC property values that can be set on a javax.xml.rpc call object before it is returned to the web service client. The property names can be any properties supported by the JAX-RPC Call implementation.
Table A–25 call-property Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the name of the entity. |
|
only one |
Specifies the value of the entity. |
This element specifies a valid URL pointing to a final WSDL document. If not specified, the WSDL document associated with the service-ref in the standard J2EE deployment descriptor is used.
none
none
Specifies the name of the generated service implementation class.
none
none
This element specifies the WSDL service element that is being referred to
The following table describes subelements for the service-qname element.
Table A–26 service-qname Subelements
Element |
Required |
Description |
only one |
Specifies the namespace URI. |
|
only one |
Specifies the local part of a QNAME. |
This element maps the res-ref-name Element in the corresponding Java EE web.xml file resource-ref entry to the absolute jndi-name Element of a resource.
The following table describes subelements for the resource-ref element. The left column lists the subelement name, the middle column indicates the requirement rule, and the right column describes what the element does.
Table A–27 resource-ref Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the res-ref-name in the corresponding Java EE web.xml file resource-ref entry |
|
only one |
Specifies the absolute jndi-name of a resource |
|
zero or one |
Specifies the default principal (user) for the resource |
none
This element contains data that specifies the res-ref-name in the corresponding Java EE web.xml file resource-ref entry.
none
none
This element specifies the default principal (user) for the resource.
If this element is used in conjunction with a JMS Connection Factory resource, the name and password subelements must be valid entries in Message Queue's broker user repository.
The following table describes subelements for the default-resource-principal element.
Table A–28 default-resource-principal Subelements
Element |
Required |
Description |
---|---|---|
only one |
Contains the name of the principal |
|
only one |
Contains the password for the principal |
none
This element contains data that specifies the name of the principal.
none
none
This element contains data that specifies the password for the principal.
none
none
This element contains data that specifies the absolute jndi-name of a URL resource or a resource in the server.xml file.
To avoid collisions with names of other enterprise resources in JNDI, and to avoid portability problems, all names in a Web Server application should begin with the string java:comp/env.
none
none