Java EE 6 SDK 

Samples Main Page

The EJB 3.1 Singleton Web Services Sample Application

This is a very simple EJB 3.1 Singleton webservice application

Singleton Webservice

There are two annotations: @Singleton and @Webservice with a single web method.

@Singleton
@Webservice
public class HelloSingletonImpl {

    public String hello();

}
@javax.ejb.Singleton is a component-defining annotation that designates this class as the bean class for a Singleton Session Bean.  
@javax.jws.Webservice is a component-defining annotation that designates this class as a Webservice Service Implementation Bean.

Deployment Descriptor

The good news is the deployment descriptor is no longer required!  The two java files above are sufficient to completely describe this singleton webservice.  

Java EE 6 SDK Specific Deployment Configuration

There is no need to define Sun GlassFish Enterprise Server specific deployment descriptors, such as sun-ejb-jar.xml, sun-application-client.xml, for this example.

Building, Deploying, and Running the Application

Perform the following steps to build, deploy, and run the application:

  1. Set up your build environment and configure the application server with which the build system has to work by following the common build instructions.
  2. app_dir is the sample application base directory: samples_install_dir/javaee6/webservices/hello-singleton-ejb.
  3. Change directory to app_dir.
  4. Build, deploy, and run the sample application using the all target.
  5. app_dir> ant all

    You can replace the ant all command with the following set of commands:

    app_dir> ant default compiles and packages the application

    app_dir> ant deploy deploys it to application server

    app_dir> ant run runs the test java client

  6. Use the target clean to undeploy the sample application and to remove the temporary directories such as build and dist.

    app_dir> ant clean

Building, Deploying, and Running the Application in NetBeans IDE

Perform the following steps to build, deploy, and run the application using NetBeans IDE:

  1. Refer to the common build instructions for setting up NetBeans IDE and Java EE 6 SDK.
  2. In the NetBeans IDE, choose File → Open Project (Ctrl-Shift-O), navigate to the samples_install_dir/javaee6/webservices/ directory, select hello-singleton-ejb, and click Open Project.
  3. In the Projects tab, right click hhello-singleton-ejb and select Run to build, deploy, and run the project.

Troubleshooting

If you have problems when running the application, refer the troubleshooting document.

 

Copyright © 1997-2010 Oracle and/or its affiliates. All rights reserved.