The Java EE 6 Tutorial

A Web Service Example: helloservice

This example demonstrates a simple web service that generates a response based on information received from the client. HelloServiceBean is a stateless session bean that implements a single method: sayHello. This method matches the sayHello method invoked by the client described in A Simple JAX-WS Application Client.

The Web Service Endpoint Implementation Class

HelloServiceBean is the endpoint implementation class, typically the primary programming artifact for enterprise bean web service endpoints. The web service endpoint implementation class has the following requirements.

Stateless Session Bean Implementation Class

The HelloServiceBean class implements the sayHello method, which is annotated @WebMethod. The source code for the HelloServiceBean class follows:

package com.sun.tutorial.javaee.ejb;

import javax.ejb.Stateless;
import javax.jws.WebMethod;
import javax.jws.WebService;

public class HelloServiceBean {
    private String message = "Hello, ";

    public void HelloServiceBean() {}

    public String sayHello(String name) {
        return message + name + ".";

Building, Packaging, Deploying, and Testing the helloservice Example

You can build, package, and deploy the helloservice example using either NetBeans IDE or Ant. You can then use the Administration Console to test the web service endpoint methods.

ProcedureTo Build, Package, and Deploy the helloservice Example Using NetBeans IDE

  1. In NetBeans IDE, select File->Open Project.

  2. In the Open Project dialog, navigate to:

  3. Select the helloservice folder.

  4. Select the Open as Main Project and Open Required Projects check boxes.

  5. Click Open Project.

  6. In the Projects tab, right-click the helloservice project and select Deploy.

    This builds and packages the application into helloservice.ear, located in tut-install/examples/ejb/helloservice/dist, and deploys this EAR file to the GlassFish Server.

ProcedureTo Build, Package, and Deploy the helloservice Example Using Ant

  1. In a terminal window, go to:

  2. Type the following command:


    This runs the default task, which compiles the source files and packages the application into a JAR file located at tut-install/examples/ejb/helloservice/dist/helloservice.jar.

  3. To deploy helloservice, type the following command:

    ant deploy

    Upon deployment, the GlassFish Server generates additional artifacts required for web service invocation, including the WSDL file.

ProcedureTo Test the Service without a Client

The GlassFish Server Administration Console allows you to test the methods of a web service endpoint. To test the sayHello method of HelloServiceBean, follow these steps.

  1. Open the Administration Console by opening the following URL in a web browser:

  2. In the left pane of the Administration Console, select the Applications node.

  3. In the Applications table, click helloservice.

  4. In the Modules and Components table, click View Endpoint.

  5. On the Web Service Endpoint Information page, click the Tester link:


    The tester page opens in a browser window or tab.

  6. Under Methods, type a name as the parameter to the sayHello method.

  7. Click the sayHello button.

    The sayHello Method invocation page opens. Under Method returned, you’ll see the response from the endpoint.