Developing an Entity Bean and Session Bean Facade

Wednesday Oct 12th 2016 by Deepak Vohra

Follow along and create an entity bean and a session sean façade as JBoss Seam components.

In the previous article, we got started with developing an MVC application with JBoss Seam in JBoss Application Server 7. We created a JBoss Seam project and a JBoss Seam deployment structure. In this tutorial, we shall create an entity bean and a Session Bean façade as JBoss Seam components. Subsequently, JBoss Seam is integrated with EJB Session Beans.

This tutorial has the following sections:

  • Creating an Entity Bean JBoss Seam Component
  • Creating a Session Bean Façade JBoss Seam Component
  • Creating a JPA Configuration File
  • Integrating JBoss Seam with EJB Session Beans
  • Creating a JBoss Seam Component File

Creating an Entity Bean JBoss Seam Component

We shall use an EJB 3.0 entity bean for the domain model. In the next section on creating a session bean, we shall inject the entity bean as a Seam component into an annotated field. An entity bean is a POJO that represents a database table row. Annotate the entity class Catalog with the @Entity annotation and the @Table annotation. In the @Table annotation, specify the table name as catalogs. Also, annotate the entity class with the @NAME annotation, which specifies the component name of a Seam component. Specify scope with the @Scope annotation as SESSION, the default being CONVERSATION. The entity class implements the Serializable interface. Declare variables and getter/setter methods for bean properties id, journal, publisher, edition, title, and author. The @Id annotation specifies the identifier property. The @Column annotation specifies the column name associated with the property. The nullable element is set to false because the primary key is not nullable. Specify the generation strategy with the @GeneratedValue annotation. Because a MySQL database supports autoincrement of primary key column values by generating a sequence, set the generation strategy to GenerationType.AUTO. The entity class is listed below.

package org.jboss.seam.catalog;

import static org.jboss.seam.ScopeType.SESSION;

import javax.persistence.*;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Scope;

public class Catalog implements Serializable
   private static final long serialVersionUID =

   private int id;
   private String journal;
   private String publisher;
   private String edition;
   private String title;
   private String author;

   public Catalog(){}
   public Catalog(String journal, String publisher,
      String edition, String title, String author)
      this.journal = journal;
      this.publisher = publisher;
      this.edition = edition;
      this.title = title; = author;

   @Column(name = "ID", nullable = false)
   @GeneratedValue(strategy = GenerationType.AUTO)
   public int getId() {

   public void setId(int id) { = id;

   public String getJournal() {
      return this.journal;

   public void setJournal(String journal) {
      this.journal = journal;

   public String getPublisher() {
      return this.publisher;

   public void setPublisher(String publisher) {
      this.publisher = publisher;

   public String getEdition() {
      return this.edition;

   public void setEdition(String edition) {
      this.edition = edition;

   public String getTitle() {
      return this.title;

   public void setTitle(String title) {
      this.title = title;

   public String getAuthor() {

   public void setAuthor(String author) { = author;


The is shown in the Package Explorer.

Figure 1: The file

Creating a Session Bean Façade JBoss Seam Component

In this section, we shall create a stateful session bean as a wrapper for the entity bean. The session bean has a method, create, to create an Catalog entity instance and a method, remove, to remove to remove a Catalog instance. Create a local interface CatalogSessionBean with just the method definitions for create and remove.

package org.jboss.seam.catalog;

import javax.ejb.Local;

public interface CatalogSessionBean
   public String create();

   public void remove();


Create a Stateful session CatalogBean that implements the local interface. Annotate the session bean with @Stateful to make the session bean stateful. Add the @Scope annotation to set the scope to ScopeType.CONVERSATION, which is also the default scope for a stateful session bean in Seam. Annotate the session bean class with @Name to make the session bean a Seam component and specify the component name in the name element.

public class CatalogBean implements


Inject the Seam component Catalog into a session bean field by using the @In annotation.

private Catalog catalog;

Because Seam provides integration between the business logic layer and the presentation layer, the values are injected from the context variable into the attributes of the component instance annotated with @In. The catalog context variable values get injected into the attributes of the catalog component instance. The default name of the context variable is the same as the field annotated. Inject an EntityManager using the @PersistenceContext annotation.

private EntityManager em;

Add a method remove() annotated with @Remove because Seam stateful session beans are required to include a method without parameters annotated with @Remove. Add a method, create, to create a Catalog instance. The create method shall be invoked from a JSF page. The Catalog entry values specified in the JSF page have value binding to the Seam component catalog. In the create() method, create a Query object using the createQuery(String) method of EntityManager. Run the SELECT query using the getResultList() method. If the query results List is empty, it indicates the Catalog instance is not already created. Persist the Catalog instance with the persist(Object) method. Return /createdCatalog.xhtml from the create() method to display a message in the browser. The stateful session bean class CatalogBean is listed below.

package org.jboss.seam.catalog;
import java.util.List;

import javax.ejb.Stateful;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import org.jboss.seam.annotations.In;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Scope;
import org.jboss.seam.ScopeType;
import javax.ejb.Remove;

public class CatalogBean implements CatalogSessionBean

   private Catalog catalog;

   private EntityManager em;

   public String create()
      List catalogList = em.createQuery("select c.title from
         Catalog c where c.title=#{catalog.title}").getResultList();



         return "/createdCatalog.xhtml";
         return null;
   public void remove() {}

The session bean classCatalogBean is shown in the Package Explorer.

Figure 2: The session bean class CatalogBean

Creating a JPA Configuration File

Create a META-INF/persistence.xml configuration file in the catalog-ejb subproject. Specify the persistence provider as the Hibernate persistence provider org.hibernate.ejb.HibernatePersistence to be used for Object/Relational mapping of the entities to the database. Specify the persistence unit name as userDatabase and transaction-type as JTA (also the default). Specify the JTA datasource JNDI as java:jboss/datasources/MySQLDS. Specify the entity class for O/R mapping as org.jboss.seam.catalog.Catalog. Set the DDL generation strategy to create-drop with which the required tables are created and dropped. Set the hibernate.dialect to org.hibernate.dialect.MySQLDialect for a MySQL database. The persistence.xml configuration file is listed below.

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0"
   <persistence-unit name="userDatabase" transaction-type="JTA">
      <!-- If you are running in a production environment, add a managed
           data source, the example data source is just for development
           and testing! -->
            <!-- Properties for Hibernate -->
            <property name="" value="create-drop" />
            <property name="hibernate.show_sql" value="false" />
            <property name="hibernate.dialect"
                      value="org.hibernate.dialect.MySQLDialect" />

The persistence.xml file is shown in the Package Explorer.

Figure 3: The persistence.xml file

Integrating JBoss Seam with EJB Session Beans

In this section, we shall integrate Seam with the EJB container. EJB 3.0 session bean components may be integrated with Seam by using the interceptor class org.jboss.seam.ejb.SeamInterceptor. In the \catalog\catalog-ejb\src\main\resources\META-INF\ejb-jar.xml, configure the interceptor class and add a <assembly-descriptor/> element with interceptor binding to EJB name pattern *. Setting EJB name as * makes the SeamInterceptor as the default interceptor, which implies that all calls to all beans are within the deployment. The ejb-jar.xml is listed below.

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar xmlns=""

Creating a JBoss Seam Component File

Seam components may be configured either using property settings in WEB-INF/web.xml or \catalog\catalog-ejb\src\main\resources\, or the components.xml file. We shall use a components.xml file, which may be added to the WEB-INF folder of a WAR, the META-INF directory of a JAR or a JAR directory containing classes annotated with @Name. Add an empty to the \catalog\catalog-ejb\src\main\resources directory. Seam components catalog and catalogBean get installed when the deployment scanner finds @Name annotated classes in an archive with the file. For Seam to find session beans in JNDI, specify the org.jboss.seam.core.init.jndiPattern property in the WEB-INF/components.xml file.

First, we need to create a components.xml file. Select File|New. In New, select Seam|Seam Component File and click Next.

Figure 4: Creating a components.xml file

The New Seam Components gets started. Select the catalog/catalog-web/src/main/webapp/WEB-INF folder and specify Name as components.xml. Select Version as 2.3 and click Finish.

Figure 5: Starting New Seam Components

The components.xml file gets added to the webapp/WEB-INF directory.

Figure 6: Adding the components.xml file

Right-click components.xml in the Seam Components 2.3 Editor and select New|Component.

Figure 7: Selecting a New Component

In the Add Component wizard, specify Name as org.jboss.seam.core.init and click Finish.

Figure 8: Specifying the Name

The org.jboss.seam.core.init component gets added to components.xml. Next, add the jndiPattern property. Right-click org.jboss.seam.core.init and select Add Simple Property.

Figure 9: Adding a Simple Property

In Add Simple Property, specify Name as jndiPattern and Value as java:app/catalog-ejb/CatalogBean. Click Finish.

Figure 10: Specifying a Name

The org.jboss.seam.core.init.jndiName property gets added to components.xml, which is listed below.

Figure 11: Adding the org.jboss.seam.core.init.jndiName property

<?xml version="1.0" encoding="UTF-8"?>

<components xmlns=""
   <component name="org.jboss.seam.core.init">
      <property name="jndiPattern">java:app/catalog-ejb/CatalogBean</property>

The components.xml is shown in the Package Explorer.

Figure 12: The components.xml file

In the next article, we shall add a Web descriptor for packaging & deploying the application, add a JSF user interface, and deploy and run the MVC application.

Mobile Site | Full Site
Copyright 2017 © QuinStreet Inc. All Rights Reserved