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

- Previous: service-qname
- Next: service-ref-name

## 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

### Superelements

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

### Subelements

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.

- Previous: service-qname
- Next: service-ref-name

- © 2010, Oracle Corporation and/or its affiliates