Web Service Deployment Guidelines

If you installed the Web Profile, web services are not supported unless the optional Metro Web Services Stack add-on component is downloaded from the Update Tool. Without the Metro add-on component, a servlet or EJB component cannot be a web service endpoint, and the sun-web.xml and sun-ejb-jar.xml elements related to web services are ignored.

For information about Update Tool, see Update Tool in Oracle GlassFish Server 3.0.1 Administration Guide.

The following guidelines apply when deploying a web service in GlassFish Server:

• Web Service Endpoint. Deploy a web service endpoint to GlassFish Server as you would any servlet or stateless session bean. If the deployed module has a web service endpoint, the endpoint is detected automatically during deployment. The GlassFish Server -specific deployment descriptor files, sun-web.xml and sun-ejb-jar.xml, provide optional web service enhancements in their webservice-endpoint and webservice-description elements.

• JSR 181 Annotated File. Use the autodeployment feature to deploy a JSR 181 annotated file. See To Deploy an Application or Module Automatically.

  For more information about web services, see JSR 181 and Chapter 6, Developing Web Services, in Oracle GlassFish Server 3.0.1 Application Development Guide.