Sun GlassFish Enterprise Server 2.1 Application Deployment 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–131 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–132 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–133 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. 

debugging-enabled

zero or one 

Specifies whether the debugging servlet is enabled for this web service endpoint. Allowed values are true and false (the default).

property (with attributes) (sun-web.xml)

property (with subelements) (sun-ejb-jar.xml)

zero or more 

Specifies a property, which has a name and a value. 

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 Java EE 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–134 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.