iBATIS - Cartes des résultats

L'élément resultMap est l'élément le plus important et le plus puissant d'iBATIS. Vous pouvez réduire jusqu'à 90% le codage JDBC en utilisant iBATIS ResultMap et, dans certains cas, cela vous permet de faire des choses que JDBC ne prend même pas en charge.

La conception de ResultMaps est telle que les instructions simples ne nécessitent pas du tout de mappages de résultats explicites, et les instructions plus complexes ne nécessitent pas plus que ce qui est absolument nécessaire pour décrire les relations.

Ce chapitre n'est qu'une simple introduction à iBATIS ResultMaps.

Nous avons la table EMPLOYEE suivante dans MySQL -

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

Cette table a deux enregistrements comme suit -

mysql> select * from EMPLOYEE;
+----+------------+-----------+--------+
| id | first_name | last_name | salary |
+----+------------+-----------+--------+
|  1 | Zara       | Ali       |   5000 |
|  2 | Roma       | Ali       |   3000 |
+----+------------+-----------+--------+
2 row in set (0.00 sec)

Classe POJO des employés

Pour utiliser iBATIS ResultMap, vous n'avez pas besoin de modifier le fichier Employee.java. Gardons-le tel qu'il était dans le dernier chapitre.

public class Employee {
   private int id;
   private String first_name; 
   private String last_name;   
   private int salary;  

   /* Define constructors for the Employee class. */
   public Employee() {}
  
   public Employee(String fname, String lname, int salary) {
      this.first_name = fname;
      this.last_name = lname;
      this.salary = salary;
   }

   /* Here are the required method definitions */
   public int getId() {
      return id;
   }
	
   public void setId(int id) {
      this.id = id;
   }
	
   public String getFirstName() {
      return first_name;
   }
	
   public void setFirstName(String fname) {
      this.first_name = fname;
   }
	
   public String getLastName() {
      return last_name;
   }
	
   public void setlastName(String lname) {
      this.last_name = lname;
   }
	
   public int getSalary() {
      return salary;
   }
	
   public void setSalary(int salary) {
      this.salary = salary;
   }

} /* End of Employee */

Fichier Employee.xml

Ici, nous modifierions Employee.xml pour introduire la balise <resultMap> </resultMap>. Cette balise aurait un identifiant qui est requis pour exécuter ce resultMap dans l'attribut resultMap de notre balise <select>.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMap PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" "http://ibatis.apache.org/dtd/sql-map-2.dtd">

<sqlMap namespace="Employee">

   <!-- Perform Insert Operation -->
	
   <insert id="insert" parameterClass="Employee">
      INSERT INTO EMPLOYEE(first_name, last_name, salary)
      values (#first_name#, #last_name#, #salary#)

      <selectKey resultClass="int" keyProperty="id">
         select last_insert_id() as id
      </selectKey>
   </insert>

   <!-- Perform Read Operation -->
   <select id="getAll" resultClass="Employee">
      SELECT * FROM EMPLOYEE
   </select>

   <!-- Perform Update Operation -->
   <update id="update" parameterClass="Employee">
      UPDATE EMPLOYEE
      SET    first_name = #first_name#
      WHERE  id = #id#
    </update>

   <!-- Perform Delete Operation -->
   <delete id="delete" parameterClass="int">
      DELETE FROM EMPLOYEE
      WHERE  id = #id#
   </delete>

   <!-- Using ResultMap -->
   <resultMap id="result" class="Employee">
      <result property="id" column="id"/>
      <result property="first_name" column="first_name"/>
      <result property="last_name" column="last_name"/>
      <result property="salary" column="salary"/>
   </resultMap> 
	
   <select id="useResultMap" resultMap="result">
      SELECT * FROM EMPLOYEE
      WHERE id=#id#
   </select>

</sqlMap>

Fichier IbatisResultMap.java

Ce fichier a une logique au niveau de l'application pour lire les enregistrements de la table Employee à l'aide de ResultMap -

import com.ibatis.common.resources.Resources;
import com.ibatis.sqlmap.client.SqlMapClient;
import com.ibatis.sqlmap.client.SqlMapClientBuilder;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class IbatisResultMap{
   public static void main(String[] args)
   throws IOException,SQLException{
      Reader rd = Resources.getResourceAsReader("SqlMapConfig.xml");
      SqlMapClient smc = SqlMapClientBuilder.buildSqlMapClient(rd);

      int id = 1;
      System.out.println("Going to read record.....");
      Employee e = (Employee)smc.queryForObject ("Employee.useResultMap", id);

      System.out.println("ID:  " + e.getId());
      System.out.println("First Name:  " + e.getFirstName());
      System.out.println("Last Name:  " + e.getLastName());
      System.out.println("Salary:  " + e.getSalary());
      System.out.println("Record read Successfully ");
   }
}

Compilation et exécution

Voici les étapes pour compiler et exécuter le logiciel mentionné ci-dessus. Assurez-vous d'avoir correctement défini PATH et CLASSPATH avant de procéder à la compilation et à l'exécution.

  • Créez Employee.xml comme indiqué ci-dessus.
  • Créez Employee.java comme indiqué ci-dessus et compilez-le.
  • Créez IbatisResultMap.java comme indiqué ci-dessus et compilez-le.
  • Exécutez le binaire IbatisResultMap pour exécuter le programme.

Vous obtiendrez le résultat suivant qui est une opération de lecture sur la table EMPLOYEE.

Going to read record.....
ID:  1
First Name:  Zara
Last Name:  Ali
Salary:  5000
Record read Successfully