EJB - Callbacks
Callback é um mecanismo pelo qual o ciclo de vida de um enterprise bean pode ser interceptado. A especificação EJB 3.0 especificou retornos de chamada para os quais os métodos do manipulador de retorno de chamada são criados. O contêiner EJB chama esses retornos de chamada. Podemos definir métodos de retorno de chamada na própria classe EJB ou em uma classe separada. O EJB 3.0 forneceu muitas anotações para callbacks.
A seguir está a lista de anotações de retorno de chamada para bean sem estado -
| Anotação | Descrição |
|---|---|
| @PostConstruct | Chamado quando um bean é criado pela primeira vez. |
| @PreDestroy | Chamado quando um bean é removido do pool de bean ou destruído. |
A seguir está a lista de anotações de retorno de chamada para bean com estado -
| Anotação | Descrição |
|---|---|
| @PostConstruct | Chamado quando um bean é criado pela primeira vez. |
| @PreDestroy | Chamado quando um bean é removido do pool de bean ou destruído. |
| @PostActivate | Chamado quando um bean é carregado para ser usado. |
| @PrePassivate | Chamado quando um bean é colocado de volta no pool de bean. |
A seguir está a lista de anotações de retorno de chamada para bean acionado por mensagem -
| Anotação | Descrição |
|---|---|
| @PostConstruct | Chamado quando um bean é criado pela primeira vez. |
| @PreDestroy | Chamado quando um bean é removido do pool de bean ou destruído. |
A seguir está a lista de anotações de retorno de chamada para bean de entidade -
| Anotação | Descrição |
|---|---|
| @PrePersist | Chamado quando uma entidade é criada no banco de dados. |
| @PostPersist | Chamado depois que uma entidade é criada no banco de dados. |
| @PreRemove | Chamado quando uma entidade é excluída do banco de dados. |
| @PostRemove | Chamado depois que uma entidade é excluída do banco de dados. |
| @PreUpdate | Chamado antes de uma entidade ser atualizada no banco de dados. |
| @PostLoad | Chamado quando um registro é obtido do banco de dados e carregado na entidade. |
Aplicação de exemplo
Vamos criar um aplicativo de teste EJB para testar vários retornos de chamada no EJB.
| Degrau | Descrição |
|---|---|
| 1 | Crie um projeto com um nome EjbComponent sob um pacote com.tutorialspoint.stateless conforme explicado no capítulo EJB - Criar Aplicativo . Você também pode usar o projeto criado no capítulo EJB - Persistência como tal para este capítulo para adicionar vários callbacks ao EJB. |
| 2 | Crie LibrarySessionBean.java e LibrarySessionBeanRemote conforme explicado no capítulo EJB - Criar aplicativo . Mantenha o resto dos arquivos inalterados. |
| 3 | Use os Beans criados no capítulo EJB - Persistência . Adicione métodos de retorno de chamada conforme mostrado abaixo. Mantenha o resto dos arquivos inalterados. |
| 4 | Crie uma classe java BookCallbackListener no pacote com.tutorialspoint.callback . Esta classe irá demonstrar a separação dos métodos de retorno de chamada. |
| 5 | Limpe e construa o aplicativo para garantir que a lógica de negócios esteja funcionando de acordo com os requisitos. |
| 6 | Finalmente, implante o aplicativo na forma de arquivo jar no JBoss Application Server. O servidor de aplicativos JBoss será iniciado automaticamente se ainda não tiver sido iniciado. |
| 7 | Agora crie o cliente EJB, um aplicativo baseado em console da mesma maneira explicada no capítulo EJB - Criar Aplicativo no tópicoCreate Client to access EJB. |
EJBComponent (Módulo 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();
}Assim que você implantar o projeto EjbComponent no JBOSS, observe o log do jboss.
JBoss criou automaticamente uma entrada JNDI para nosso bean de sessão - LibraryPersistentBean/remote.
Estaremos usando esta string de pesquisa para obter objeto de negócios remoto do tipo - com.tutorialspoint.stateless.LibraryPersistentBeanRemote
Saída de log do servidor de aplicativos 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=LibraryPersistentBean,service=EJB3
16:30:02,723 INFO [EJBContainer] STARTED EJB: com.tutorialspoint.stateless.LibrarySessionBeanRemote ejbName: LibraryPersistentBean
...Testador EJB (Cliente 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=localhostEssas propriedades são usadas para inicializar o objeto InitialContext do serviço de nomenclatura java.
O objeto InitialContext será usado para pesquisar o bean de sessão sem estado.
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());
}
}
}
}O EJBTester executa as seguintes tarefas -
Carregue as propriedades de jndi.properties e inicialize o objeto InitialContext.
No método testStatelessEjb (), a consulta jndi é feita com o nome - "LibrarySessionBean / remote" para obter o objeto de negócios remoto (EJB sem estado).
Em seguida, o usuário vê uma interface do usuário da loja da biblioteca e ele / ela é solicitado a inserir uma escolha.
Se o usuário inserir 1, o sistema solicitará o nome do livro e salvará o livro usando o método addBook () do bean de sessão sem estado. O Session Bean está armazenando o livro no banco de dados.
Se o usuário inserir 2, o sistema recupera os livros usando o método getBooks () do bean de sessão sem estado e sai.
Execute o cliente para acessar o EJB
Localize EJBTester.java no explorador de projetos. Clique com o botão direito na classe EJBTester e selecionerun file.
Verifique a seguinte saída no console do 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)Saída de log do servidor de aplicativos JBoss
Você pode encontrar as seguintes entradas de retorno de chamada no log do 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
...