Hibernate - Interceptores

Como você aprendeu no Hibernate, um objeto será criado e persistido. Uma vez que o objeto foi alterado, ele deve ser salvo de volta no banco de dados. Esse processo continua até a próxima vez que o objeto for necessário e ele será carregado do armazenamento persistente.

Assim, um objeto passa por diferentes estágios em seu ciclo de vida e Interceptor Interfacefornece métodos, que podem ser chamados em diferentes estágios para realizar algumas tarefas necessárias. Esses métodos são retornos de chamada da sessão para o aplicativo, permitindo que o aplicativo inspecione e / ou manipule propriedades de um objeto persistente antes de ser salvo, atualizado, excluído ou carregado. A seguir está a lista de todos os métodos disponíveis na interface do Interceptor -

Sr. Não. Método e Descrição
1

findDirty()

Este método é chamado quando o flush() método é chamado em um objeto de Sessão.

2

instantiate()

Este método é chamado quando uma classe persistente é instanciada.

3

isUnsaved()

Este método é chamado quando um objeto é passado para o saveOrUpdate() método/

4

onDelete()

Este método é chamado antes de um objeto ser excluído.

5

onFlushDirty()

Este método é chamado quando o Hibernate detecta que um objeto está sujo (ou seja, foi alterado) durante uma operação de limpeza ou atualização.

6

onLoad()

Este método é chamado antes de um objeto ser inicializado.

7

onSave()

Este método é chamado antes que um objeto seja salvo.

8

postFlush()

Este método é chamado depois que um flush ocorreu e um objeto foi atualizado na memória.

9

preFlush()

Este método é chamado antes de um flush.

O Hibernate Interceptor nos dá controle total sobre a aparência de um objeto tanto para o aplicativo quanto para o banco de dados.

Como usar interceptores?

Para construir um interceptor, você pode implementar Interceptor classe diretamente ou estender EmptyInterceptorclasse. A seguir estão as etapas simples para usar a funcionalidade do Hibernate Interceptor.

Criar Interceptores

Vamos estender o EmptyInterceptor em nosso exemplo, onde o método do Interceptor será chamado automaticamente quando Employeeobjeto é criado e atualizado. Você pode implementar mais métodos de acordo com seus requisitos.

import java.io.Serializable;
import java.util.Date;
import java.util.Iterator;

import org.hibernate.EmptyInterceptor;
import org.hibernate.Transaction;
import org.hibernate.type.Type;

public class MyInterceptor extends EmptyInterceptor {
   private int updates;
   private int creates;
   private int loads;

   public void onDelete(Object entity, Serializable id,
      Object[] state, String[] propertyNames, Type[] types) {
       // do nothing
   }

   // This method is called when Employee object gets updated.
   public boolean onFlushDirty(Object entity, Serializable id,
      Object[] currentState, Object[] previousState, String[] propertyNames,
      Type[] types) {
         if ( entity instanceof Employee ) {
            System.out.println("Update Operation");
            return true; 
         }
         return false;
   }
	
   public boolean onLoad(Object entity, Serializable id,
      Object[] state, String[] propertyNames, Type[] types) {
         // do nothing
         return true;
   }
   
   // This method is called when Employee object gets created.
   public boolean onSave(Object entity, Serializable id,
      Object[] state, String[] propertyNames, Type[] types) {
         if ( entity instanceof Employee ) {
            System.out.println("Create Operation");
            return true; 
         }
         return false;
   }
   
   //called before commit into database
   public void preFlush(Iterator iterator) {
      System.out.println("preFlush");
   }
   
   //called after committed into database
   public void postFlush(Iterator iterator) {
      System.out.println("postFlush");
   }
}

Criar classes POJO

Agora, vamos modificar um pouco nosso primeiro exemplo, onde usamos a tabela EMPLOYEE e a classe Employee para brincar -

public class Employee {
   private int id;
   private String firstName; 
   private String lastName;   
   private int salary;  

   public Employee() {}
   
   public Employee(String fname, String lname, int salary) {
      this.firstName = fname;
      this.lastName = lname;
      this.salary = salary;
   }
   
   public int getId() {
      return id;
   }
   
   public void setId( int id ) {
      this.id = id;
   }
   
   public String getFirstName() {
      return firstName;
   }
   
   public void setFirstName( String first_name ) {
      this.firstName = first_name;
   }
   
   public String getLastName() {
      return lastName;
   }
   
   public void setLastName( String last_name ) {
      this.lastName = last_name;
   }
   
   public int getSalary() {
      return salary;
   }
   
   public void setSalary( int salary ) {
      this.salary = salary;
   }
}

Criar tabelas de banco de dados

O segundo passo seria criar tabelas em seu banco de dados. Haveria uma tabela correspondente a cada objeto, você está disposto a fornecer persistência. Considere os objetos explicados acima, precisam ser armazenados e recuperados na seguinte tabela RDBMS -

create table EMPLOYEE (
   id INT NOT NULL auto_increment,
   first_name VARCHAR(20) default NULL,
   last_name  VARCHAR(20) default NULL,
   salary     INT  default NULL,
   PRIMARY KEY (id)
);

Criar arquivo de configuração de mapeamento

Este passo é criar um arquivo de mapeamento que instrui o Hibernate - como mapear a classe ou classes definidas para as tabelas do banco de dados.

<?xml version = "1.0" encoding = "utf-8"?>
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 

<hibernate-mapping>
   <class name = "Employee" table = "EMPLOYEE">
      
      <meta attribute = "class-description">
         This class contains the employee detail. 
      </meta>
      
      <id name = "id" type = "int" column = "id">
         <generator class="native"/>
      </id>
      
      <property name = "firstName" column = "first_name" type = "string"/>
      <property name = "lastName" column = "last_name" type = "string"/>
      <property name = "salary" column = "salary" type = "int"/>
      
   </class>
</hibernate-mapping>

Criar classe de aplicativo

Por fim, criaremos nossa classe de aplicativo com o método main () para executar o aplicativo. Aqui, deve-se notar que ao criar o objeto de sessão, usamos nossa classe Interceptor como um argumento.

import java.util.List; 
import java.util.Date;
import java.util.Iterator; 
 
import org.hibernate.HibernateException; 
import org.hibernate.Session; 
import org.hibernate.Transaction;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

public class ManageEmployee {
   private static SessionFactory factory; 
   public static void main(String[] args) {
      
      try {
         factory = new Configuration().configure().buildSessionFactory();
      } catch (Throwable ex) { 
         System.err.println("Failed to create sessionFactory object." + ex);
         throw new ExceptionInInitializerError(ex); 
      }

      ManageEmployee ME = new ManageEmployee();

      /* Add few employee records in database */
      Integer empID1 = ME.addEmployee("Zara", "Ali", 1000);
      Integer empID2 = ME.addEmployee("Daisy", "Das", 5000);
      Integer empID3 = ME.addEmployee("John", "Paul", 10000);

      /* List down all the employees */
      ME.listEmployees();

      /* Update employee's records */
      ME.updateEmployee(empID1, 5000);

      /* Delete an employee from the database */
      ME.deleteEmployee(empID2);

      /* List down new list of the employees */
      ME.listEmployees();
   }
   
   /* Method to CREATE an employee in the database */
   public Integer addEmployee(String fname, String lname, int salary){
      Session session = factory.openSession( new MyInterceptor() );
      Transaction tx = null;
      Integer employeeID = null;
      
      try {
         tx = session.beginTransaction();
         Employee employee = new Employee(fname, lname, salary);
         employeeID = (Integer) session.save(employee); 
         tx.commit();
      } catch (HibernateException e) {
         if (tx!=null) tx.rollback();
         e.printStackTrace(); 
      } finally {
         session.close(); 
      }
      return employeeID;
   }
   
   /* Method to  READ all the employees */
   public void listEmployees( ){
      Session session = factory.openSession( new MyInterceptor() );
      Transaction tx = null;
      
      try {
         tx = session.beginTransaction();
         List employees = session.createQuery("FROM Employee").list(); 
         for (Iterator iterator = employees.iterator(); iterator.hasNext();){
            Employee employee = (Employee) iterator.next(); 
            System.out.print("First Name: " + employee.getFirstName()); 
            System.out.print("  Last Name: " + employee.getLastName()); 
            System.out.println("  Salary: " + employee.getSalary()); 
         }
         tx.commit();
      } catch (HibernateException e) {
         if (tx!=null) tx.rollback();
         e.printStackTrace(); 
      } finally {
         session.close(); 
      }
   }
   
   /* Method to UPDATE salary for an employee */
   public void updateEmployee(Integer EmployeeID, int salary ){
      Session session = factory.openSession( new MyInterceptor() );
      Transaction tx = null;
      
      try {
         tx = session.beginTransaction();
         Employee employee = (Employee)session.get(Employee.class, EmployeeID); 
         employee.setSalary( salary );
		 session.update(employee); 
         tx.commit();
      } catch (HibernateException e) {
         if (tx!=null) tx.rollback();
         e.printStackTrace(); 
      } finally {
         session.close(); 
      }
   }
   
   /* Method to DELETE an employee from the records */
   public void deleteEmployee(Integer EmployeeID){
      Session session = factory.openSession( new MyInterceptor() );
      Transaction tx = null;
      
      try {
         tx = session.beginTransaction();
         Employee employee = (Employee)session.get(Employee.class, EmployeeID); 
         session.delete(employee); 
         tx.commit();
      } catch (HibernateException e) {
         if (tx!=null) tx.rollback();
         e.printStackTrace(); 
      } finally {
         session.close(); 
      }
   }
}

Compilação e execução

Aqui estão as etapas para compilar e executar o aplicativo mencionado acima. Certifique-se de ter definido PATH e CLASSPATH apropriadamente antes de prosseguir para a compilação e execução.

  • Crie o arquivo de configuração hibernate.cfg.xml conforme explicado no capítulo de configuração.

  • Crie o arquivo de mapeamento Employee.hbm.xml conforme mostrado acima.

  • Crie o arquivo de origem Employee.java conforme mostrado acima e compile-o.

  • Crie o arquivo fonte MyInterceptor.java conforme mostrado acima e compile-o.

  • Crie o arquivo de origem ManageEmployee.java conforme mostrado acima e compile-o.

  • Execute o binário ManageEmployee para executar o programa.

Você obteria o seguinte resultado e os registros seriam criados na tabela EMPLOYEE.

$java ManageEmployee
.......VARIOUS LOG MESSAGES WILL DISPLAY HERE........

Create Operation
preFlush
postFlush
Create Operation
preFlush
postFlush
Create Operation
preFlush
postFlush
First Name: Zara  Last Name: Ali  Salary: 1000
First Name: Daisy  Last Name: Das  Salary: 5000
First Name: John  Last Name: Paul  Salary: 10000
preFlush
postFlush
preFlush
Update Operation
postFlush
preFlush
postFlush
First Name: Zara  Last Name: Ali  Salary: 5000
First Name: John  Last Name: Paul  Salary: 10000
preFlush
postFlush

Se você verificar sua tabela EMPLOYEE, ela deve ter os seguintes registros -

mysql> select * from EMPLOYEE;
+----+------------+-----------+--------+
| id | first_name | last_name | salary |
+----+------------+-----------+--------+
| 29 | Zara       | Ali       |   5000 |
| 31 | John       | Paul      |  10000 |
+----+------------+-----------+--------+
2 rows in set (0.00 sec
mysql>