7.2.3. Create an EAR Project containing an EJB Project

This task describes how to create a new Enterprise Archive (EAR) project in JBoss Developer Studio that contains an EJB Project.

Prerequisites

Procedure 7.3. Create an EAR Project containing an EJB Project

  1. Open the New EAR Application Project Wizard

    Navigate to the File menu, select New, then Project and the New Project wizard appears. Select Java EE/Enterprise Application Project and click Next.
    New EAR Application Project Wizard

    Figure 7.4. New EAR Application Project Wizard

  2. Supply details

    Supply the following details:
    • Project name.
      As well as the being the name of the project that appears in JBoss Developer Studio this is also the default filename for the deployed EAR file.
    • Project location.
      The directory where the project's files will be saved. The default is a directory in the current workspace.
    • Target Runtime.
      This is the server runtime used for the project. This will need to be set to the same JBoss EAP 6 runtime used by the server that you will be deploying to.
    • EAR version.
      This is the version of the Java Enterprise Edition specification that your project will comply with. Red Hat recommends using 6.
    • Configuration. This allows you to adjust the supported features in your project. Use the default configuration for your selected runtime.
    Click Next to continue.
  3. Add a new EJB Module

    New Modules can be added from the Enterprise Application page of the wizard. To add a new EJB Project as a module follow the steps below:
    1. Add new EJB Module

      Click New Module, uncheck Create Default Modules checkbox, select the Enterprise Java Bean and click Next. The New EJB Project wizard appears.
    2. Create EJB Project

      New EJB Project wizard is the same as the wizard used to create new standalone EJB Projects and is described in Section 7.2.1, “Create an EJB Archive Project Using JBoss Developer Studio”.
      The minimal details required to create the project are:
      • Project name
      • Target Runtime
      • EJB Module version
      • Configuration
      All the other steps of the wizard are optional. Click Finish to complete creating the EJB Project.
    The newly created EJB project is listed in the Java EE module dependencies and the checkbox is checked.
  4. Optional: add an application.xml deployment descriptor

    Check the Generate application.xml deployment descriptor checkbox if one is required.
  5. Click Finish

    Two new project will appear, the EJB project and the EAR project
  6. Add Build Artifact to Server for Deployment

    Open the Add and Remove dialog by right-clicking in the Servers tab on the server you want to deploy the built artifact to in the server tab, and select Add and Remove.
    Select the EAR resource to deploy from the Available column and click the Add button. The resource will be moved to the Configured column. Click Finish to close the dialog.
    Add and Remove dialog

    Figure 7.5. Add and Remove dialog

Result

You now have an Enterprise Application Project with a member EJB Project. This will build and deploy to the specified server as a single EAR deployment containing an EJB subdeployment.