Document Information


Part I Introduction

1.  Overview

2.  Using the Tutorial Examples

Part II The Web Tier

3.  Getting Started with Web Applications

4.  JavaServer Faces Technology

5.  Introduction to Facelets

6.  Expression Language

7.  Using JavaServer Faces Technology in Web Pages

8.  Using Converters, Listeners, and Validators

9.  Developing with JavaServer Faces Technology

10.  JavaServer Faces Technology: Advanced Concepts

11.  Using Ajax with JavaServer Faces Technology

12.  Composite Components: Advanced Topics and Example

13.  Creating Custom UI Components and Other Custom Objects

14.  Configuring JavaServer Faces Applications

15.  Java Servlet Technology

16.  Uploading Files with Java Servlet Technology

17.  Internationalizing and Localizing Web Applications

Part III Web Services

18.  Introduction to Web Services

19.  Building Web Services with JAX-WS

20.  Building RESTful Web Services with JAX-RS

21.  JAX-RS: Advanced Topics and Example

Part IV Enterprise Beans

22.  Enterprise Beans

23.  Getting Started with Enterprise Beans

24.  Running the Enterprise Bean Examples

The cart Example

The Business Interface

Session Bean Class

Lifecycle Callback Methods

Business Methods

The @Remove Method

Helper Classes

Running the cart Example

To Run the cart Example Using NetBeans IDE

To Run the cart Example Using Ant

The all Task

A Singleton Session Bean Example: counter

Creating a Singleton Session Bean

Initializing Singleton Session Beans

Managing Concurrent Access in a Singleton Session Bean

Handling Errors in a Singleton Session Bean

The Architecture of the counter Example

Running the counter Example

To Run the counter Example Using NetBeans IDE

To Run the counter Example Using Ant

Using the Timer Service

Creating Calendar-Based Timer Expressions

Specifying Multiple Values in Calendar Expressions

Programmatic Timers

The @Timeout Method

Creating Programmatic Timers

Automatic Timers

Canceling and Saving Timers

Getting Timer Information

Transactions and Timers

The timersession Example

Running the timersession Example

To Run the timersession Example Using NetBeans IDE

To Build, Package, and Deploy the timersession Example Using Ant

To Run the Web Client

Handling Exceptions

25.  A Message-Driven Bean Example

26.  Using the Embedded Enterprise Bean Container

27.  Using Asynchronous Method Invocation in Session Beans

Part V Contexts and Dependency Injection for the Java EE Platform

28.  Introduction to Contexts and Dependency Injection for the Java EE Platform

29.  Running the Basic Contexts and Dependency Injection Examples

30.  Contexts and Dependency Injection for the Java EE Platform: Advanced Topics

31.  Running the Advanced Contexts and Dependency Injection Examples

Part VI Persistence

32.  Introduction to the Java Persistence API

33.  Running the Persistence Examples

34.  The Java Persistence Query Language

35.  Using the Criteria API to Create Queries

36.  Creating and Using String-Based Criteria Queries

37.  Controlling Concurrent Access to Entity Data with Locking

38.  Using a Second-Level Cache with Java Persistence API Applications

Part VII Security

39.  Introduction to Security in the Java EE Platform

40.  Getting Started Securing Web Applications

41.  Getting Started Securing Enterprise Applications

42.  Java EE Security: Advanced Topics

Part VIII Java EE Supporting Technologies

43.  Introduction to Java EE Supporting Technologies

44.  Transactions

45.  Resources and Resource Adapters

46.  The Resource Adapter Example

47.  Java Message Service Concepts

48.  Java Message Service Examples

49.  Bean Validation: Advanced Topics

50.  Using Java EE Interceptors

Part IX Case Studies

51.  Duke's Bookstore Case Study Example

52.  Duke's Tutoring Case Study Example

53.  Duke's Forest Case Study Example



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.

  • The class must be annotated with either the javax.jws.WebService or the javax.jws.WebServiceProvider annotation.

  • The implementing class may explicitly reference an SEI through the endpointInterface element of the @WebService annotation but is not required to do so. If no endpointInterface is specified in @WebService, an SEI is implicitly defined for the implementing class.

  • The business methods of the implementing class must be public and must not be declared static or final.

  • Business methods that are exposed to web service clients must be annotated with javax.jws.WebMethod.

  • Business methods that are exposed to web service clients must have JAXB-compatible parameters and return types. See the list of JAXB default data type bindings at Types Supported by JAX-WS.

  • The implementing class must not be declared final and must not be abstract.

  • The implementing class must have a default public constructor.

  • The endpoint class must be annotated @Stateless.

  • The implementing class must not define the finalize method.

  • The implementing class may use the javax.annotation.PostConstruct or javax.annotation.PreDestroy annotations on its methods for lifecycle event callbacks.

    The @PostConstruct method is called by the container before the implementing class begins responding to web service clients.

    The @PreDestroy method is called by the container before the endpoint is removed from operation.

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 + ".";

Running the helloservice Example

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

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

  1. From the File menu, choose Open Project.
  2. In the Open Project dialog, navigate to:
  3. Select the helloservice folder.
  4. Select the Open as Main Project check box.
  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.

To 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.

To 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:

    A Web Service Test Links page opens.

  6. On the Web Service Test Links page, click the non-secure link (the one that specifies port 8080).

    A HelloServiceBeanService Web Service Tester page opens.

  7. Under Methods, type a name as the parameter to the sayHello method.
  8. Click the sayHello button.

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