Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Developer's Guide

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–126 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–127 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–128 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–129 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.