EJB - 查询语言

EJB 查询语言非常方便编写自定义查询，而无需担心底层数据库的细节。它与 HQL（Hibernate 查询语言）非常相似，通常被称为 EJBQL。

为了在 EJB 中演示 EJBQL，我们将执行以下任务：

步骤 1 - 在数据库中创建表。
步骤 2 - 创建一个包含业务方法的无状态 EJB。
步骤 3 - 更新无状态 EJB。添加方法，通过实体管理器从数据库添加和获取记录。
步骤 4 - 一个基于控制台的应用程序客户端将访问无状态 EJB 以将数据持久化到数据库中。

创建表

在默认数据库 postgres 中创建一个名为 books 的表。

CREATE TABLE books (
   id     integer PRIMARY KEY,
   name   varchar(50)
);

创建模型类

public class Book implements Serializable{
    
   private int id;
   private String name;

   public Book() {        
   }
   
   public int getId() {
      return id;
   }
   ...
}

创建无状态 EJB

@Stateless
public class LibraryPersistentBean implements LibraryPersistentBeanRemote {
	
   public void addBook(Book book) {
     //persist book using entity manager
   }    

   public List<Book> getBooks() {        
     //get books using entity manager
   }
   ...
}

构建 EJB 模块后，我们需要一个客户端来访问无状态 Bean，我们将在下一节中创建它。

示例应用程序

让我们创建一个测试 EJB 应用程序来测试 EJB 数据库访问机制。

步骤	描述
1	在 com.tutorialspoint.entity 包下创建一个名为 EjbComponent 的项目，如 EJB - 创建应用程序章节中所述。您也可以使用 EJB - 创建应用程序章节中创建的项目，以便在本节中理解 EJB 数据访问概念。
2	在 com.tutorialspoint.entity 包下创建 Book.java，并按如下所示修改它。
3	创建 LibraryPersistentBean.java 和 LibraryPersistentBeanRemote，如 EJB - 创建应用程序章节中所述，并按如下所示修改它们。
4	清理并构建应用程序，以确保业务逻辑按要求工作。
5	最后，将应用程序以 jar 文件的形式部署到 JBoss 应用服务器上。如果 JBoss 应用服务器尚未启动，它将自动启动。
6	现在创建 EJB 客户端，一个基于控制台的应用程序，方法与 EJB - 创建应用程序章节中“创建访问 EJB 的客户端”主题中所述相同。按如下所示修改它。

EjbComponent（EJB 模块）

Book.java

package com.tutorialspoint.entity;

import java.io.Serializable;

public class Book implements Serializable{
    
   private int id;
   private String name;

   public Book() {        
   }
   
   public int getId() {
      return id;
   }

   public void setId(int id) {
      this.id = id;
   }

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }    
}

LibraryPersistentBeanRemote.java

package com.tutorialspoint.stateless;

import com.tutorialspoint.entity.Book;
import java.util.List;
import javax.ejb.Remote;

@Remote
public interface LibraryPersistentBeanRemote {
   void addBook(Book bookName);
   List<Book> getBooks();
}

LibraryPersistentBean.java

package com.tutorialspoint.stateless;

import com.tutorialspoint.entity.Book;
import java.util.List;
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;

@Stateless
public class LibraryPersistentBean implements LibraryPersistentBeanRemote {
    
   public LibraryPersistentBean() {
   }

   @PersistenceContext(unitName="EntityEjbPU")
   private EntityManager entityManager;         

   public void addBook(Book book) {
      entityManager.persist(book);
   }    

   public List<Book> getBooks() {
      //create an ejbql expression
      String ejbQL = "From Book b where b.name like ?1";
      //create query
      Query query = entityManager.createQuery(ejbQL);
      //substitute parameter.
      query.setParameter(1, "%test%");   
      //execute the query
      return query.getResultList();
   }   
}

在您将 EjbComponent 项目部署到 JBOSS 上后，请注意 jboss 日志。
JBoss 已自动为我们的会话 Bean 创建了一个 JNDI 条目 - LibraryPersistentBean/remote。
我们将使用此查找字符串来获取类型为 com.tutorialspoint.stateless.LibraryPersistentBeanRemote 的远程业务对象。

JBoss 应用服务器日志输出

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

   LibraryPersistentBean/remote - EJB3.x Default Remote Business Interface
   LibraryPersistentBean/remote-com.tutorialspoint.stateless.LibraryPersistentBeanRemote - EJB3.x Remote Business Interface
...

EJBTester（EJB 客户端）

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

这些属性用于初始化 Java 命名服务的 InitialContext 对象。
InitialContext 对象将用于查找无状态会话 Bean。

EJBTester.java

package com.tutorialspoint.test;
   
import com.tutorialspoint.stateless.LibraryPersistentBeanRemote;
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.testEntityEjb();
   }
   
   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 testEntityEjb() {

      try {
         int choice = 1; 

         LibraryPersistentBeanRemote libraryBean =
         LibraryPersistentBeanRemote)
         ctx.lookup("LibraryPersistentBean/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++;
         }           
      } 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 执行以下任务：

从 jndi.properties 加载属性并初始化 InitialContext 对象。
在 testStatefulEjb() 方法中，使用名称“LibraryStatelessSessionBean/remote”进行 jndi 查找以获取远程业务对象（有状态 ejb）。
然后向用户显示一个图书馆商店用户界面，并要求他/她输入选择。
如果用户输入 1，系统将要求输入书名并使用无状态会话 Bean 的 addBook() 方法保存书籍。会话 Bean 通过 EntityManager 调用将书籍持久化到数据库中。
如果用户输入 2，系统将使用无状态会话 Bean 的 getBooks() 方法检索书籍并退出。
然后使用名称“LibraryStatelessSessionBean/remote”再次进行 jndi 查找以获取远程业务对象（有状态 EJB），并完成书籍列表。

运行客户端以访问 EJB

在项目资源管理器中找到 EJBTester.java。右键单击 EJBTester 类并选择“运行文件”。

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

run:
**********************
Welcome to Book Store
**********************
Options 
1. Add Book
2. Exit 
Enter Choice: 1
Enter book name: Learn Testing
**********************
Welcome to Book Store
**********************
Options 
1. Add Book
2. Exit 
Enter Choice: 2
Book(s) entered so far: 1
1. learn Testing
BUILD SUCCESSFUL (total time: 15 seconds)

打印页面