EJB - wytrwałość

EJB 3.0, fasola encji używana w EJB 2.0, została w dużej mierze zastąpiona przez mechanizm trwałości. Fasola encji jest teraz prostym POJO z mapowaniem z tabelą.

Poniżej znajdują się kluczowi aktorzy w trwałym API -

• Entity- Trwały obiekt reprezentujący rekord magazynu danych. Dobrze jest mieć możliwość serializacji.

• EntityManager- Interfejs trwałości do wykonywania operacji na danych, takich jak dodawanie / usuwanie / aktualizowanie / znajdowanie na trwałym obiekcie (encji). Pomaga również w wykonywaniu zapytań za pomocąQuery berło.

• Persistence unit (persistence.xml) - Jednostka trwałości opisuje właściwości mechanizmu trwałości.

• Data Source (*ds.xml)- Źródło danych opisuje właściwości związane z magazynem danych, takie jak adres URL połączenia. nazwa użytkownika, hasło itp.

Aby zademonstrować mechanizm trwałości EJB, musimy wykonać następujące zadania -

• Step 1 - Utwórz tabelę w bazie danych.

• Step 2 - Utwórz klasę Entity odpowiadającą tabeli.

• Step 3 - Utwórz źródło danych i jednostkę trwałości.

• Step 4 - Utwórz bezstanowy komponent EJB z instancją EntityManager.

• Step 5- Zaktualizuj bezstanowy EJB. Dodaj metody, aby dodać rekordy i pobrać rekordy z bazy danych za pośrednictwem menedżera encji.

• Step 6 - Klient aplikacji oparty na konsoli uzyska dostęp do bezstanowego komponentu EJB w celu utrwalenia danych w bazie danych.

Utwórz tabelę

Utwórz tabelę books w domyślnej bazie danych postgres.

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

Utwórz klasę Entity

//mark it entity using Entity annotation 
//map table name using Table annotation
@Entity
@Table(name="books")
public class Book implements Serializable{
    
   private int id;
   private String name;

   public Book() {        
   }

   //mark id as primary key with autogenerated value
   //map database column id with id field
   @Id
   @GeneratedValue(strategy= GenerationType.IDENTITY)
   @Column(name="id")
   public int getId() {
      return id;
   }
   ...
}

Utwórz DataSource and Persistence Unit

DataSource (jboss-ds.xml)

<?xml version = "1.0" encoding = "UTF-8"?>
<datasources>
   <local-tx-datasource>
      <jndi-name>PostgresDS</jndi-name>
      <connection-url>jdbc:postgresql://localhost:5432/postgres</connection-url>
      <driver-class>org.postgresql.driver</driver-class>
      <user-name>sa</user-name>
      <password>sa</password>
      <min-pool-size>5</min-pool-size>
      <max-pool-size>20</max-pool-size>
      <idle-timeout-minutes>5</idle-timeout-minutes>
   </local-tx-datasource>
</datasources>

Jednostka trwałości (persistence.xml)

<persistence version = "1.0" xmlns = "http://java.sun.com/xml/ns/persistence" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">

   <persistence-unit name = "EjbComponentPU" transaction-type = "JTA">
      <jta-data-source>java:/PostgresDS</jta-data-source>
      <exclude-unlisted-classes>false</exclude-unlisted-classes>
      <properties/>
   </persistence-unit>
   
   <persistence-unit name = "EjbComponentPU2" transaction-type = "JTA">
      <provider>org.hibernate.ejb.HibernatePersistence</provider>
      <jta-data-source>java:/PostgresDS</jta-data-source>
      <exclude-unlisted-classes>false</exclude-unlisted-classes>
	  
      <properties>
         <property name="hibernate.hbm2ddl.auto" value="update"/>
      </properties>
   </persistence-unit>
   
</persistence>

Utwórz bezstanowy komponent EJB z instancją EntityManager

@Stateless
public class LibraryPersistentBean implements LibraryPersistentBeanRemote {
	
   //pass persistence unit to entityManager.
   @PersistenceContext(unitName="EjbComponentPU")
   private EntityManager entityManager;         

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

   public List<Book> getBooks() {        
      return entityManager.createQuery("From Books").getResultList();
   }
   ...
}

Po zbudowaniu modułu EJB potrzebujemy klienta, aby uzyskać dostęp do bezstanowego komponentu bean, który będziemy tworzyć w następnej sekcji.

Przykładowa aplikacja

Utwórzmy testową aplikację EJB, aby przetestować mechanizm trwałości EJB.

Krok	Opis
1	Utwórz projekt o nazwie EjbComponent w pakiecie com.tutorialspoint.entity, jak wyjaśniono w rozdziale EJB - Tworzenie aplikacji . Możesz również użyć projektu utworzonego w rozdziale EJB - Tworzenie aplikacji jako takiego w tym rozdziale, aby zrozumieć koncepcje trwałości EJB.
2	Utwórz Book.java w pakiecie com.tutorialspoint.entity i zmodyfikuj go, jak pokazano poniżej.
3	Utwórz LibraryPersistentBean.java i LibraryPersistentBeanRemote, jak wyjaśniono w rozdziałach EJB - Tworzenie aplikacji, i zmodyfikuj je, jak pokazano poniżej.
4	Utwórz plik jboss-ds.xml w formacieEjbComponent > setup folder i persistence.xml wEjbComponent > src > conf teczka. Te foldery można zobaczyć na karcie plików w Netbeans. Zmodyfikuj te pliki, jak pokazano powyżej.
5	Wyczyść i skompiluj aplikację, aby upewnić się, że logika biznesowa działa zgodnie z wymaganiami.
6	Na koniec wdróż aplikację w postaci pliku jar na JBoss Application Server. Serwer aplikacji JBoss zostanie uruchomiony automatycznie, jeśli nie został jeszcze uruchomiony.
7	Teraz utwórz klienta EJB, aplikację opartą na konsoli w taki sam sposób, jak wyjaśniono w rozdziale EJB - Tworzenie aplikacji w temacieCreate Client to access EJB. Zmodyfikuj go, jak pokazano poniżej.

EJBComponent (moduł EJB)

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

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;

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

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

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

   public List<Book> getBooks() {
      return entityManager.createQuery("From Book").getResultList();
   }
}

• Zaraz po wdrożeniu projektu EjbComponent w JBOSS zwróć uwagę na dziennik jboss.

• JBoss automatycznie utworzył wpis JNDI dla naszego komponentu bean sesji - LibraryPersistentBean/remote.

• Będziemy używać tego ciągu wyszukiwania, aby uzyskać zdalny obiekt biznesowy typu - com.tutorialspoint.stateless.LibraryPersistentBeanRemote

Dane wyjściowe dziennika serwera aplikacji 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 (klient 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

• Te właściwości są używane do inicjowania obiektu InitialContext usługi nazewnictwa Java.

• Obiekt InitialContext będzie używany do wyszukiwania bezstanowego komponentu bean sesji.

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 wykonuje następujące zadania.

• Załaduj właściwości z jndi.properties i zainicjuj obiekt InitialContext.

• W metodzie testStatefulEjb () wyszukiwanie jndi jest wykonywane z nazwą - „LibraryStatefulSessionBean / remote” w celu uzyskania zdalnego obiektu biznesowego (stanowy ejb).

• Następnie użytkownik widzi interfejs użytkownika sklepu biblioteki i jest proszony o wpisanie wyboru.

• Jeśli użytkownik wprowadzi 1, system zapyta o nazwę książki i zapisze książkę przy użyciu metody addBook () bezstanowej sesji bean bean. Session Bean utrwala książkę w bazie danych za pośrednictwem wywołania EntityManager.

• Jeśli użytkownik wprowadzi 2, system pobiera książki za pomocą metody getBooks () z fasolą stanową sesji i kończy pracę.

• Następnie wykonywane jest kolejne wyszukiwanie jndi z nazwą - „LibraryStatelessSessionBean / remote”, aby ponownie uzyskać zdalny obiekt biznesowy (bezstanowy komponent EJB) i lista książek jest zakończona.

Uruchom klienta, aby uzyskać dostęp do EJB

Znajdź EJBTester.java w eksploratorze projektów. Kliknij prawym przyciskiem myszy klasę EJBTester i wybierzrun file.

Sprawdź następujące dane wyjściowe w konsoli 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: 15 seconds)

Uruchom klienta ponownie, aby uzyskać dostęp do EJB

Uruchom ponownie JBoss przed uzyskaniem dostępu do EJB.

Znajdź EJBTester.java w eksploratorze projektów. Kliknij prawym przyciskiem myszy klasę EJBTester i wybierzrun file.

Sprawdź następujące dane wyjściowe w konsoli Netbeans.

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

Przedstawione powyżej dane wyjściowe wskazują, że książki są przechowywane w pamięci trwałej i pobierane z bazy danych.