Creating a JAX-WS enabled web project

If you plan to create a JAX-WS web service, a web project with the Java™ version 5 or 6 facet must be created before you begin creating your web service.

Before you begin

Before you create a web project you should create a WebSphere® server as described in: Creating a JAX-WS enabled WebSphere server

About this task

To build a Web project that points to the WebSphere server that you have created:

Procedure

  1. In the Java EE perspective, right-click your enterprise application project and select New > Web Project to open the web project wizard.
  2. In the Name field, type a name for your new web project.
  3. In the Project Templates section, select the type of web template you want to use: select Simple to create a simple web project.
  4. In the Programming Model section, select the programming model you want to use: select Java EE programming model. Click Next to configure your new web project.
  5. On the deployment page, from the list of available configuration options, click Deployment to open the Deployment configuration page.
    • You can change Target runtime by selecting another one from the drop-down box. Click Change Features to open the Project Facets window. If you are targeting WebSphere Application Server v7.0 or later, the default configuration is adequate for JAX-WS web service development. If you are targeting WebSphere Application Server v6.1 with the Feature Pack for Web Services, you will need to manually add the following facets to your project:
      • WebSphere 6.1 Feature Pack for Web Services facet
      • Java facet Version 5.0
      • WebSphere Web (Co-existence) Version 6.1
      Tip: If you have a an existing web project, the Web services wizards will add the WebSphere 6.1 Feature Pack for Web Services facet for you. However if the Java facet Version 5.0 or later is not enabled the wizards will not recognize it as a valid project for a JAX-WS web service or client.
    • Click Add support for WebSphere bindings and extensions or clear this field.
    • In the Web module version field, select the web module version you want to use.
    • In the EAR membership field, click Add project to an EAR, if you want to include EAR membership; clear this field if you do not want to add the web project to an EAR file. Ensure that Add project to an EAR is selected. The New project wizard generates the EAR
    • In the EAR project name field, the name of your existent EAR file appears. You can click Browse to select a different EAR file.
    Note: The deployment option is available only if you selected to use the Java EE programming model for your new web project.
  6. From the list of available configuration options, click Java to open the Java configuration page.
    • In the Source folders on build path field, accept the default src directory, or click Add Folder, Edit... or Remove to specify a folder for your source files.
    • In the Default output folder: field, specify a folder for your output files or accept the default value (WebContent\WEB-INF\classes).
  7. From the list of available configuration options, click Web Module.. On the Web Module configuration page,
    • In the Context root field, type the name of your web project root, or accept the default (which is the name of your web project).
    • In the Content directory field, type the name of your content directory, or accept the default (WebContent).
    • Select Generate web.xml deployment descriptor if you want to create a deployment descriptor. You can also add a deployment descriptor to your web module later.
  8. To associate the project with the server, right-click the WebSphere server that you created in the Servers view and click Add and Remove Projects. Select the service and client projects from the Available projects list and click Add.

Feedback