EJB-コールバック

コールバックは、エンタープライズBeanのライフサイクルを傍受できるメカニズムです。EJB 3.0仕様では、コールバックハンドラメソッドが作成されるコールバックが指定されています。EJBコンテナはこれらのコールバックを呼び出します。コールバックメソッドは、EJBクラス自体または別のクラスで定義できます。EJB 3.0は、コールバックに多くの注釈を提供しています。

以下は、ステートレスBeanのコールバックアノテーションのリストです。

注釈 説明
@PostConstruct Beanが初めて作成されたときに呼び出されます。
@PreDestroy BeanがBeanプールから削除されたとき、または破棄されたときに呼び出されます。

以下は、ステートフルBeanのコールバックアノテーションのリストです。

注釈 説明
@PostConstruct Beanが初めて作成されたときに呼び出されます。
@PreDestroy BeanがBeanプールから削除されたとき、または破棄されたときに呼び出されます。
@PostActivate 使用するBeanがロードされたときに呼び出されます。
@PrePassivate BeanがBeanプールに戻されたときに呼び出されます。

以下は、メッセージ駆動型Beanのコールバックアノテーションのリストです。

注釈 説明
@PostConstruct Beanが初めて作成されたときに呼び出されます。
@PreDestroy BeanがBeanプールから削除されたとき、または破棄されたときに呼び出されます。

以下は、エンティティBeanのコールバックアノテーションのリストです。

注釈 説明
@PrePersist エンティティがデータベースに作成されたときに呼び出されます。
@PostPersist エンティティがデータベースに作成された後に呼び出されます。
@PreRemove エンティティがデータベースから削除されたときに呼び出されます。
@PostRemove エンティティがデータベースから削除された後に呼び出されます。
@PreUpdate エンティティがデータベースで更新される前に呼び出されます。
@PostLoad レコードがデータベースからフェッチされ、エンティティにロードされるときに呼び出されます。

アプリケーション例

テストEJBアプリケーションを作成して、EJBのさまざまなコールバックをテストしてみましょう。

ステップ 説明
1

EJB-アプリケーションの作成」の章で説明されているように、com.tutorialspoint.statelessパッケージの下にEjbComponentという名前のプロジェクトを作成します。この章では、EJB-永続性の章で作成されたプロジェクトを使用して、EJBにさまざまなコールバックを追加することもできます。

2

作成LibrarySessionBean.javaLibrarySessionBeanRemoteをで説明したようにEJB -アプリケーション作成の章を。残りのファイルは変更しないでください。

3

EJB-永続性の章で作成されたBeanを使用します。以下に示すように、コールバックメソッドを追加します。残りのファイルは変更しないでください。

4

パッケージcom.tutorialspoint.callbackの下にJavaクラスBookCallbackListenerを作成します。このクラスは、コールバックメソッドの分離を示します。

5

アプリケーションをクリーンアップしてビルドし、ビジネスロジックが要件に従って機能していることを確認します。

6

最後に、アプリケーションをjarファイルの形式でJBoss ApplicationServerにデプロイします。JBoss Application Serverは、まだ起動されていない場合、自動的に起動されます。

7

次に、トピックの「EJB-アプリケーションの作成」の章で説明したのと同じ方法で、コンソールベースのアプリケーションであるEJBクライアントを作成します。Create Client to access EJB

EJBComponent(EJBモジュール)

BookCallbackListener.java

package com.tutorialspoint.callback;

import javax.persistence.PrePersist;
import javax.persistence.PostLoad;
import javax.persistence.PostPersist;
import javax.persistence.PostRemove;
import javax.persistence.PostUpdate;
import javax.persistence.PreRemove;
import javax.persistence.PreUpdate;

import com.tutorialspoint.entity.Book;

public class BookCallbackListener {
    
   @PrePersist
   public void prePersist(Book book) {
      System.out.println("BookCallbackListener.prePersist:" 
         + "Book to be created with book id: "+book.getId());
   }

   @PostPersist
   public void postPersist(Object book) {
      System.out.println("BookCallbackListener.postPersist::"
         + "Book created with book id: "+((Book)book).getId());
   }

   @PreRemove
   public void preRemove(Book book) {
      System.out.println("BookCallbackListener.preRemove:"
         + " About to delete Book: " + book.getId());
   }

   @PostRemove
   public void postRemove(Book book) {
      System.out.println("BookCallbackListener.postRemove::"
         + " Deleted Book: " + book.getId());
   }

   @PreUpdate
   public void preUpdate(Book book) {
      System.out.println("BookCallbackListener.preUpdate::"
         + " About to update Book: " + book.getId());
   }

   @PostUpdate
   public void postUpdate(Book book) {
      System.out.println("BookCallbackListener.postUpdate::"
         + " Updated Book: " + book.getId());
   }

   @PostLoad
   public void postLoad(Book book) {
      System.out.println("BookCallbackListener.postLoad::"
         + " Loaded Book: " + book.getId());
   }
}

Book.java

package com.tutorialspoint.entity;
 
import java.io.Serializable;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.EntityListeners;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
 
@Entity
@Table(name="books")
public class Book implements Serializable{
    
   private int id;
   private String name;
 
   public Book() {        
   }
 
   @Id
   @GeneratedValue(strategy= GenerationType.IDENTITY)
   @Column(name="id")
   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;
   }    
}

LibraryStatefulSessionBean.java

package com.tutorialspoint.stateful;

import java.util.ArrayList;
import java.util.List;

import javax.annotation.PostConstruct;
import javax.annotation.PreDestroy;

import javax.ejb.PostActivate;
import javax.ejb.PrePassivate;
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;
   }

   @PostConstruct
   public void postConstruct() {
      System.out.println("LibraryStatefulSessionBean.postConstruct::"
         + " bean created.");
   }

   @PreDestroy
   public void preDestroy() {
      System.out.println("LibraryStatefulSessionBean.preDestroy:"
         + " bean removed.");
   }

   @PostActivate
   public void postActivate() {
      System.out.println("LibraryStatefulSessionBean.postActivate:"
         + " bean activated.");
   }

   @PrePassivate
   public void prePassivate() {
      System.out.println("LibraryStatefulSessionBean.prePassivate:"
         + " bean passivated.");
   }    
}

LibraryStatefulSessionBeanRemote.java

package com.tutorialspoint.stateful;

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

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

LibraryPersistentBean.java

package com.tutorialspoint.stateless;

import com.tutorialspoint.entity.Book;
import java.util.List;

import javax.annotation.PostConstruct;
import javax.annotation.PreDestroy;

import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

@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() {     
      return entityManager.createQuery("From Book")
         .getResultList();
   }

   @PostConstruct
   public void postConstruct() {
      System.out.println("postConstruct:: LibraryPersistentBean session bean"
         + " created with entity Manager object: ");
   }

   @PreDestroy
   public void preDestroy() {
      System.out.println("preDestroy: LibraryPersistentBean session"
      + " bean is removed ");
   }
}

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();
    
}
  • EjbComponentプロジェクトをJBOSSにデプロイするとすぐに、jbossログに注目してください。

  • JBossはセッションBeanのJNDIエントリを自動的に作成しました- LibraryPersistentBean/remote

  • このルックアップ文字列を使用して、タイプ-のリモートビジネスオブジェクトを取得します。 com.tutorialspoint.stateless.LibraryPersistentBeanRemote

JBoss ApplicationServerのログ出力

...
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=LibraryPersistentBean,service=EJB3
16:30:02,723 INFO  [EJBContainer] STARTED EJB: com.tutorialspoint.stateless.LibrarySessionBeanRemote ejbName: LibraryPersistentBean
...

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.stateful.LibrarySessionBeanRemote;

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オブジェクトを初期化します。

  • testStatelessEjb()メソッドでは、jndiルックアップは「LibrarySessionBean / remote」という名前で実行され、リモートビジネスオブジェクト(ステートレスEJB)を取得します。

  • 次に、ユーザーにライブラリストアのユーザーインターフェイスが表示され、選択肢を入力するように求められます。

  • ユーザーが1を入力すると、システムは本の名前を要求し、ステートレスセッションBeanのaddBook()メソッドを使用して本を保存します。SessionBeanは本をデータベースに保存しています。

  • ユーザーが2を入力すると、システムはステートレスセッションBeanのgetBooks()メソッドを使用して本を取得し、終了します。

クライアントを実行して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
BUILD SUCCESSFUL (total time: 13 seconds)

JBoss ApplicationServerのログ出力

JBossログで次のコールバックエントリを見つけることができます

14:08:34,293 INFO  [STDOUT] postConstruct:: LibraryPersistentBean session bean created with entity Manager object
...
16:39:09,484 INFO  [STDOUT] BookCallbackListener.prePersist:: Book to be created with book id: 0
16:39:09,531 INFO  [STDOUT] BookCallbackListener.postPersist:: Book created with book id: 1
16:39:09,900 INFO  [STDOUT] BookCallbackListener.postLoad:: Loaded Book: 1
...