Ejb 简明教程

EJB - Stateful Bean

有状态会话 bean 是企业 bean 的一种类型，它与客户端保持会话状态。有状态会话 bean 根据其名称将关联客户端状态保留在其实例变量中。EJB 容器创建独立的有状态会话 bean 来处理客户端的每个请求。请求范围结束时，有状态会话 bean 将被销毁。

Steps to Create Stateful EJB

以下是有状态 EJB 的创建步骤：

  1. 创建一个公开业务方法的远程/本地接口。

  2. 该接口将由 EJB 客户端应用程序使用。

  3. 如果 EJB 客户端与 EJB 会话 bean 需要部署的 EJB 客户端处于同一环境，则使用 @Local 注释。

  4. 如果 EJB 客户端与 EJB 会话 bean 需要部署的 EJB 客户端属于不同的环境，则使用 @Remote 注释。

  5. 创建实现上述接口的有状态会话 bean。

  6. 使用 @Stateful 注释表示有状态 bean。EJB 容器在部署期间通过读取此注释自动创建所需的配置或接口。

Remote Interface

import javax.ejb.Remote;

@Remote
public interface LibraryStatefulSessionBeanRemote {
   //add business method declarations
}

Stateful EJB

@Stateful
public class LibraryStatefulSessionBean implements LibraryStatefulSessionBeanRemote {
   //implement business method
}

Example Application

让我们创建一个测试 EJB 应用程序来测试有状态 EJB。

Step

Description

1

在包 com.tutorialspoint.stateful 下，创建一个名为 EjbComponent 的项目，如 EJB 中所述 - 创建应用程序章节。您还可以使用在 EJB - 创建应用程序章节中创建的项目来了解有状态 EJB 概念。

2

创建 LibraryStatefulSessionBean.java 和 LibraryStatefulSessionBeanRemote，如 EJB 中所述 - 创建应用程序章节。保持其他文件不变。

3

清理并构建应用程序以确保业务逻辑按需求工作。

4

最后，以 jar 文件的形式将应用程序部署在 JBoss 应用程序服务器上。如果 JBoss 应用程序服务器尚未启动，它会自动启动。

5

现在创建 EJB 客户端，这是一个控制台应用程序，创建方法与 EJB - 章节中主题 Create Client to access EJB 下所述相同。

EJBComponent (EJB Module)

LibraryStatefulSessionBeanRemote.java

package com.tutorialspoint.stateful;

import java.util.List;
import javax.ejb.Remote;

@Remote
public interface LibraryStatefulSessionBeanRemote {
   void addBook(String bookName);
   List getBooks();
}

LibraryStatefulSessionBean.java

package com.tutorialspoint.stateful;

import java.util.ArrayList;
import java.util.List;
import javax.ejb.Stateful;

@Stateful
public class LibraryStatefulSessionBean implements LibraryStatefulSessionBeanRemote {

   List<String> bookShelf;

   public LibraryStatefulSessionBean() {
      bookShelf = new ArrayList<String>();
   }

   public void addBook(String bookName) {
      bookShelf.add(bookName);
   }

   public List<String> getBooks() {
      return bookShelf;
   }
}

  1. 在 JBOSS 上部署 EjbComponent 项目后，请注意 jboss 日志。

  2. JBoss 已自动为我们的会话 bean 创建了一个 JNDI 条目： LibraryStatefulSessionBean/remote 。

  3. 我们将使用此查找字符串来获取类型为 * com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote * 的远程业务对象。

JBoss Application Server Log Output

...
16:30:01,401 INFO  [JndiSessionRegistrarBase] Binding the following Entries in Global JNDI:
   LibraryStatefulSessionBean/remote - EJB3.x Default Remote Business Interface
   LibraryStatefulSessionBean/remote-com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote - EJB3.x Remote Business Interface
16:30:02,723 INFO  [SessionSpecContainer] Starting jboss.j2ee:jar=EjbComponent.jar,name=LibraryStatefulSessionBean,service=EJB3
16:30:02,723 INFO  [EJBContainer] STARTED EJB: com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote ejbName: LibraryStatefulSessionBean
16:30:02,731 INFO  [JndiSessionRegistrarBase] Binding the following Entries in Global JNDI:

   LibraryStatefulSessionBean/remote - EJB3.x Default Remote Business Interface
   LibraryStatefulSessionBean/remote-com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote - EJB3.x Remote Business Interface
...

EJBTester (EJB Client)

jndi.properties

java.naming.factory.initial = org.jnp.interfaces.NamingContextFactory
java.naming.factory.url.pkgs = org.jboss.naming:org.jnp.interfaces
java.naming.provider.url = localhost

  1. 这些属性被用于初始化java命名服务的InitialContext对象。

  2. InitialContext 对象用于查找有状态会话 bean。

EJBTester.java

package com.tutorialspoint.test;

import com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote;
import java.io.BufferedReader;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.List;
import java.util.Properties;
import javax.naming.InitialContext;
import javax.naming.NamingException;

public class EJBTester {

   BufferedReader brConsoleReader = null;
   Properties props;
   InitialContext ctx;
   {
      props = new Properties();
      try {
         props.load(new FileInputStream("jndi.properties"));
      } catch (IOException ex) {
         ex.printStackTrace();
      }
      try {
         ctx = new InitialContext(props);
      } catch (NamingException ex) {
         ex.printStackTrace();
      }
      brConsoleReader =
      new BufferedReader(new InputStreamReader(System.in));
   }

   public static void main(String[] args) {

      EJBTester ejbTester = new EJBTester();

      ejbTester.testStatelessEjb();
   }

   private void showGUI() {
      System.out.println("**********************");
      System.out.println("Welcome to Book Store");
      System.out.println("**********************");
      System.out.print("Options \n1. Add Book\n2. Exit \nEnter Choice: ");
   }

   private void testStatelessEjb() {

      try {
         int choice = 1;

         LibraryStatefulSessionBeanRemote libraryBean =
         LibraryStatefulSessionBeanRemote)ctx.lookup("LibraryStatefulSessionBean/remote");

         while (choice != 2) {
            String bookName;
            showGUI();
            String strChoice = brConsoleReader.readLine();
            choice = Integer.parseInt(strChoice);
            if (choice == 1) {
               System.out.print("Enter book name: ");
               bookName = brConsoleReader.readLine();
               Book book = new Book();
               book.setName(bookName);
               libraryBean.addBook(book);
            } else if (choice == 2) {
               break;
            }
         }

         List<Book> booksList = libraryBean.getBooks();

         System.out.println("Book(s) entered so far: " + booksList.size());
         int i = 0;
         for (Book book:booksList) {
            System.out.println((i+1)+". " + book.getName());
            i++;
         }
         LibraryStatefulSessionBeanRemote libraryBean1 =
            (LibraryStatefulSessionBeanRemote)ctx.lookup("LibraryStatefulSessionBean/remote");
         List<String> booksList1 = libraryBean1.getBooks();
         System.out.println(
            "***Using second lookup to get library stateful object***");
         System.out.println(
            "Book(s) entered so far: " + booksList1.size());
         for (int i = 0; i < booksList1.size(); ++i) {
            System.out.println((i+1)+". " + booksList1.get(i));
         }
      } catch (Exception e) {
         System.out.println(e.getMessage());
         e.printStackTrace();
      }finally {
         try {
            if(brConsoleReader !=null) {
               brConsoleReader.close();
            }
         } catch (IOException ex) {
            System.out.println(ex.getMessage());
         }
      }
   }
}

EJBTester执行以下任务-

  1. 从jndi.properties加载属性并初始化InitialContext对象。

  2. 在 testStatefulEjb() 方法中，使用名称“LibraryStatefulSessionBean/remote”进行 jndi 查找，以获取远程业务对象（状态会话 bean）。

  3. 然后向用户显示一个图书库用户界面，并询问他/她输入一个选择。

  4. 如果用户输入 1，系统询问书籍名称并使用状态会话 bean addBook() 方法保存书籍。会话 bean 正在其实例变量中存储书籍。

  5. 如果用户输入 2，系统使用状态会话 bean getBooks() 方法检索书籍并退出。

  6. 然后再次使用名称“LibraryStatefulSessionBean/remote”执行另一个 jndi 查找，以获取远程业务对象（状态 EJB）和书籍列表。

Run Client to Access EJB

在项目浏览器中找到EJBTester.java。右键单击EJBTester类并选择 run file 。

在 Netbeans 控制台中验证以下输出 −

run:
**********************
Welcome to Book Store
**********************
Options
1. Add Book
2. Exit
Enter Choice: 1
Enter book name: Learn Java
**********************
Welcome to Book Store
**********************
Options
1. Add Book
2. Exit
Enter Choice: 2
Book(s) entered so far: 1
1. Learn Java
***Using second lookup to get library stateful object***
Book(s) entered so far: 0
BUILD SUCCESSFUL (total time: 13 seconds)

Run Client Again to Access EJB

在项目浏览器中找到EJBTester.java。右键单击EJBTester类并选择 run file 。

在Netbeans控制台中验证以下输出。

run:
**********************
Welcome to Book Store
**********************
Options
1. Add Book
2. Exit
Enter Choice: 2
Book(s) entered so far: 0
***Using second lookup to get library stateful object***
Book(s) entered so far: 0
BUILD SUCCESSFUL (total time: 12 seconds)

  1. 上面显示的输出说明对于每个查找，都将返回一个不同的状态 EJB 实例。

  2. Stateful EJB 对象仅为单个会话保留值。正如在第二次运行中，我们没有获得任何书籍值。