service-ref (Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide)

Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide

service-ref

Specifies 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 the service-ref in the standard J2EE deployment descriptor

sun-web-app (sun-web.xml), ejb (sun-ejb-jar.xml), sun-application-client (sun-application-client.xml)

The following table describes subelements for the service-ref element.

Table A–100 service-ref subelements


Element	Required	Description
service-ref-name	only one	Specifies the web service reference name relative to `java:comp/env`.
port-info	zero or more	Specifies information for a port within a web service reference.
call-property	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.
wsdl-override	zero or one	Specifies a valid URL pointing to a final WSDL document.
service-impl-class	zero or one	Specifies the name of the generated service implementation class.
service-qname	zero or one	Specifies the WSDL service element that is being referenced.