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

- Previous: V

# W

## web

Specifies the application’s web tier configuration.

### Superelements

sun-application (`sun-application.xml`)

### Subelements

The following table describes subelements for the `web` element.

Table A–123 `web` Subelements

Element | Required | Description
--- | --- | ---
web-uri | only one | Contains the web URI for the application.
context-root | only one | Contains the web context root for the application.

## web-uri

Contains the web URI for the application. Must match the corresponding element in the `application.xml` file.

### Superelements

web (`sun-application.xml`)

### Subelements

none - contains data

## webservice-description

Specifies a name and optional publish location for a web service.

### Superelements

sun-web-app (`sun-web.xml`), enterprise-beans (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `webservice-description` element.

Table A–124 `webservice-description` subelements

Element | Required | Description
--- | --- | ---
webservice-description-name | only one | Specifies a unique name for the web service within a web or EJB module.
wsdl-publish-location | zero or one | Specifies the URL of a directory to which a web service’s WSDL is published during deployment.

## webservice-description-name

Specifies a unique name for the web service within a web or EJB module.

### Superelements

webservice-description (`sun-web.xml`, `sun-ejb-jar.xml`)

### Subelements

none - contains data

## webservice-endpoint

Specifies information about a web service endpoint.

### Superelements

servlet (`sun-web.xml`), ejb (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `webservice-endpoint` element.

Table A–125 `webservice-endpoint` subelements

Element | Required | Description
--- | --- | ---
port-component-name | only one | Specifies a unique name for a port component within a web or EJB module.
endpoint-address-uri | zero or one | Specifies the automatically generated endpoint address.
login-config | zero or one | Specifies the authentication configuration for an EJB web service endpoint.
message-security-binding | zero or one | Specifies a custom authentication provider binding.
transport-guarantee | zero or one | Specifies that the communication between client and server is `NONE`, `INTEGRAL`, or `CONFIDENTIAL`.
service-qname | zero or one | Specifies the WSDL service element that is being referenced.
tie-class | zero or one | Specifies the automatically generated name of a tie implementation class for a port component.
servlet-impl-class | zero or one | Specifies the automatically generated name of the generated servlet implementation class.

## wsdl-override

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.

### Superelements

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

### Subelements

none - contains data

### Example

    // available via HTTP
    <wsdl-override>http://localhost:8000/myservice/myport?WSDL</wsdl-override>

    // in a file
    <wsdl-override>file:/home/user1/myfinalwsdl.wsdl</wsdl-override>

## wsdl-port

Specifies the WSDL port.

### Superelements

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

### Subelements

The following table describes subelements for the `wsdl-port` element.

Table A–126 `wsdl-port` subelements

Element | Required | Description
--- | --- | ---
namespaceURI | only one | Specifies the namespace URI.
localpart | only one | Specifies the local part of a QNAME.

## wsdl-publish-location

Specifies the URL of a directory to which a web service’s WSDL is published during deployment. Any required files are published to this directory, preserving their location relative to the module-specific WSDL directory (`META-INF/wsdl` or `WEB-INF/wsdl`).

### Superelements

webservice-description (`sun-web.xml`, `sun-ejb-jar.xml`)

### Subelements

none - contains data

### Example

Suppose you have an `ejb.jar` file whose `webservices.xml` file’s `wsdl-file` element contains the following reference:

    META-INF/wsdl/a/Foo.wsdl

Suppose your `sun-ejb-jar` file contains the following element:

    <wsdl-publish-location>file:/home/user1/publish</wsdl-publish-location>

The final WSDL is stored in `/home/user1/publish/a/Foo.wsdl`.

- Previous: V

- © 2010, Oracle Corporation and/or its affiliates