Java EE 7 SDK

The Stateless Bean EJB Sample Application (Test Client)

This sample is a Java client that uses a EJB stateless session bean with a remote business interface. The Java client runs outside of a Java EE container and performs a global JNDI lookup, since dependency injection is not available outside of a Java EE component.

Description

This sample application consists of two parts: an EJB module and a test client (this project). The rest of this document describes the test client.

Standalone Java Client

public class StatelessJavaClient {

    public static void main(String args[]) {
        try {
            InitialContext ic = new InitialContext();
            StatelessSession sless = (StatelessSession) ic.lookup("javaee_samples.hello.stateless.StatelessSession");
            System.out.println("StatelessSession bean says : " + sless.hello());
        } catch(Exception e) {
            e.printStackTrace();
        }
    }
}

Key Features

The test client demonstrates how to perform a JNDI lookup for an EJB and how to use its business methods.

Building, Deploying, and Running the Java Client

Perform the following steps to build, deploy, and run the Java Client:

Set up your build environment and configure the application server with which the build system has to work by following the common build instructions.
This project depends on hello-stateless-ejb-bean. Follow the instruction for deploying hello-stateless-ejb-bean first. Ensure that the EJB bean has been built and deployed. Ensure also that the GlassFish server is running.
app_dir is the sample application base directory: samples_install_dir/javaee7/ejb/hello-stateless-ejb/hello-stateless-ejb-client.
Change directory to app_dir.
Build, deploy, and run the sample application using the run outcome.
mvn clean verify exec:java
Use the clean outcome to undeploy the sample application and to remove the temporary directories such as target.
mvn clean

Troubleshooting

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