EJB - Stateful Bean

Um bean de sessão com estado é um tipo de bean corporativo, que preserva o estado de conversação com o cliente. Um bean de sessão com estado de acordo com seu nome mantém o estado do cliente associado em suas variáveis ​​de instância. O contêiner EJB cria um bean de sessão com estado separado para processar cada solicitação do cliente. Assim que o escopo da solicitação termina, o bean de sessão statelful é destruído.

Etapas para criar EJB com estado

A seguir estão as etapas necessárias para criar um EJB com estado -

• Crie uma interface remota / local expondo os métodos de negócios.

• Essa interface será usada pelo aplicativo cliente EJB.

• Use a anotação @Local se o cliente EJB estiver no mesmo ambiente em que o bean de sessão EJB precisa ser implementado.

• Use a anotação @Remote se o cliente EJB estiver em um ambiente diferente onde o bean de sessão EJB precisa ser implementado.

• Crie um bean de sessão com estado, implementando a interface acima.

• Use a anotação @Stateful para significar um bean com estado. O contêiner EJB cria automaticamente as configurações relevantes ou interfaces exigidas lendo esta anotação durante a implantação.

Interface Remota

import javax.ejb.Remote;
 
@Remote
public interface LibraryStatefulSessionBeanRemote {
   //add business method declarations
}

EJB com estado

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

Aplicação de exemplo

Vamos criar um aplicativo de teste EJB para testar EJB com estado.

Degrau	Descrição
1	Crie um projeto com um nome EjbComponent sob um pacote com.tutorialspoint.stateful conforme explicado no capítulo EJB - Criar Aplicativo . Você também pode usar o projeto criado no capítulo EJB - Criar aplicativo como tal para este capítulo para entender os conceitos de EJB com estado.
2	Crie LibraryStatefulSessionBean.java e LibraryStatefulSessionBeanRemote conforme explicado no capítulo EJB - Criar aplicativo . Mantenha o resto dos arquivos inalterados.
3	Limpe e construa o aplicativo para garantir que a lógica de negócios esteja funcionando de acordo com os requisitos.
4	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.
5	Agora crie o cliente EJB, um aplicativo baseado em console da mesma maneira que explicado no capítulo EJB - Criar Aplicativo no tópicoCreate Client to access EJB.

EJBComponent (Módulo EJB)

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;
   }
}

• 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 - LibraryStatefulSessionBean/remote.

• Estaremos usando esta string de pesquisa para obter objeto de negócios remoto do tipo - com.tutorialspoint.stateful.LibraryStatefulSessionBeanRemote

Saída de log do servidor de aplicativos JBoss

...
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
...

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 = localhost

• Essas 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 com preservação de estado.

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());
         }
      }
   }
}

O EJBTester executa as seguintes tarefas -

• Carregue as propriedades de jndi.properties e inicialize o objeto InitialContext.

• No método testStatefulEjb (), a consulta jndi é feita com o nome - "LibraryStatefulSessionBean / remote" para obter o objeto de negócios remoto (ejb stateful).

• Em seguida, o usuário vê uma interface de usuário da loja da biblioteca e é solicitado que ele insira 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 com preservação de estado. O Session Bean está armazenando o livro em sua variável de instância.

• Se o usuário inserir 2, o sistema recupera os livros usando o método getBooks () do bean de sessão com preservação de estado e sai.

• Em seguida, outra pesquisa jndi é feita com o nome - "LibraryStatefulSessionBean / remote" para obter o objeto de negócios remoto (EJB com estado) novamente e a listagem de livros é feita.

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 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)

Execute o cliente novamente 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: 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)

• A saída mostrada acima indica que, para cada consulta, uma instância EJB com estado diferente é retornada.

• O objeto EJB stateful está mantendo o valor apenas para uma única sessão. Como na segunda execução, não estamos obtendo nenhum valor de livros.