标签：
今天总结的是mybatis，首先说mybatis是什么？
MyBatis 是一个简化和实现了 Java 数据持久化层(persistence layer)的开源框架，它抽象了大量的 JDBC 冗余代 码，并提供了一个简单易用的 API 和数据库交互。 MyBatis 的前身是 iBATIS，iBATIS 于 2002 年由 Clinton Begin 创建。MyBatis 3 是 iBATIS 的全新设计，支持 注解和 Mapper。
而 MyBatis 流行起来有以下原因：
? 它消除了大量的 JDBC 冗余代码
? 它有低的学习曲线
? 它能很好地与传统数据库协同工作
? 它可以接受 SQL 语句
? 它提供了与 Spring 和 Guice 框架的集成支持
? 它提供了与第三方缓存类库的集成支持
? 它引入了更好的性能
下面介绍一个mybatis的小例子：
使用 MyBatis 开发一个简单的 Java 项目：大致步骤如下
? 新建表 STUDENTS，插入样本数据
? 新建一个 Java 项目，将 MyBatis-3.2.2.jar 添加到 classpath 中
? 新建建 MyBatisSqlSessionFactory 单例模式类
? 新建映射器 StudentMapper 接口和 StudentService 类
? 新建一个 JUnit 测试类来测试 StudentService
①我使用的是mysql，首先新建一个数据库mybatis1，再新建表STUDENTS
CREATE TABLE STUDENTS ( stud_id int(11) NOT NULL AUTO_INCREMENT, name varchar(50) NOT NULL, email varchar(50) NOT NULL, dob date DEFAULT NULL, PRIMARY KEY (stud_id) ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=latin1; /*Sample Data for the students table */ insert into students(stud_id,name,email,dob) values (1,‘Student1‘,‘student1@gmail.com‘,‘1983-06-25‘); insert into students(stud_id,name,email,dob) values (2,‘Student2‘,‘student2@gmail.com‘,‘1983-06-25‘);
②我新建的是maven项目，导入jar包在pom.xml中进行了配置
1 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 2 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 3 <modelVersion>4.0.0</modelVersion> 4 <groupId>com.bai</groupId> 5 <artifactId>bai</artifactId> 6 <packaging>war</packaging> 7 <version>1.0-SNAPSHOT</version> 8 <name>bai Maven Webapp</name> 9 <url>http://maven.apache.org</url> 10 <dependencies> 11 <dependency> 12 <groupId>junit</groupId> 13 <artifactId>junit</artifactId> 14 <version>3.8.1</version> 15 <scope>test</scope> 16 </dependency> 17 18 <dependency> 19 <groupId>org.mybatis</groupId> 20 <artifactId>mybatis</artifactId> 21 <version>3.2.2</version> 22 <scope>test</scope> 23 </dependency> 24 <dependency> 25 <groupId>mysql</groupId> 26 <artifactId>mysql-connector-java</artifactId> 27 <version>5.1.22</version> 28 <scope>runtime</scope> 29 </dependency> 30 31 <dependency> 32 <groupId>org.slf4j</groupId> 33 <artifactId>slf4j-api</artifactId> 34 <version>1.7.5</version> 35 <scope>test</scope> 36 </dependency> 37 <dependency> 38 <groupId>org.slf4j</groupId> 39 <artifactId>slf4j-log4j12</artifactId> 40 <version>1.7.5</version> 41 <scope>runtime</scope> 42 </dependency> 43 <dependency> 44 <groupId>log4j</groupId> 45 <artifactId>log4j</artifactId> 46 <version>1.2.17</version> 47 <scope>runtime</scope> 48 </dependency> 49 </dependencies> 50 <build> 51 <finalName>bai</finalName> 52 </build> 53 </project>
③ 新建 log4j.properties 文件，添加到 classpath 中.
log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d [%-5p] %c - %m%n
④ 创建 MyBatis 的主要配置文件 mybatis-config.xml，其中包括数据库连接信息，类型别名等等，然后将其加 到 classpath 中；
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <typeAliases> <typeAlias alias="Student" type="com.mybatis3.domain.Student" /> </typeAliases> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://localhost:3306/mybatis1" /> <property name="username" value="root" /> <property name="password" value="" /> </dataSource> </environment> </environments> <mappers> <mapper resource="com/mybatis3/mappers/StudentMapper.xml" /> </mappers> </configuration>
⑤创建 SQL 映射器 XML 配置文件 StudentMapper.xml 并且将它放在 com.mybatis3.mappers 包中，注意这个包要在resource下面，如果在main下面的话，会遇到读取不到这个配置文件的问题
1 <?xml version="1.0" encoding="utf-8"?> 2 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 3 "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 4 <mapper namespace="com.mybatis3.mappers.StudentMapper"> 5 <resultMap type="Student" id="StudentResult"> 6 <id property="studId" column="stud_id" /> 7 <result property="name" column="name" /> 8 <result property="email" column="email" /> 9 <result property="dob" column="dob" /> 10 </resultMap> 11 <select id="findAllStudents" resultMap="StudentResult"> 12 SELECT * FROM STUDENTS 13 </select> 14 <select id="findStudentById" parameterType="int" resultType="Student"> 15 SELECT STUD_ID AS STUDID, NAME, EMAIL, DOB 16 FROM STUDENTS WHERE STUD_ID=#{Id} 17 </select> 18 <insert id="insertStudent" parameterType="Student"> 19 INSERT INTO STUDENTS(STUD_ID,NAME,EMAIL,DOB) 20 VALUES(#{studId },#{name},#{email},#{dob}) 21 </insert> 22 </mapper>
⑥ 新建 MyBatisSqlSessionFactory 单例类
1 package com.mybatis3.util; 2 3 import org.apache.ibatis.io.Resources; 4 import org.apache.ibatis.session.SqlSession; 5 import org.apache.ibatis.session.SqlSessionFactory; 6 import org.apache.ibatis.session.SqlSessionFactoryBuilder; 7 8 import java.io.*; 9 import java.io.IOException; 10 import java.io.InputStream; 11 12 /** 13 * Created by peng on 2016/8/4. 14 */ 15 public class MyBatisSqlSessionFactory { 16 private static SqlSessionFactory sqlSessionFactory; 17 public static SqlSessionFactory getSqlSessionFactory(){ 18 if(sqlSessionFactory==null){ 19 InputStream inputStream; 20 try { 21 inputStream = Resources.getResourceAsStream("mybatis-config.xml"); 22 sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); 23 } 24 catch(IOException e){ 25 System.out.println("aaa"); 26 System.out.println(e.getMessage()); 27 throw new RuntimeException(e.getCause()); 28 } 29 } 30 return sqlSessionFactory; 31 } 32 public static SqlSession openSession(){ 33 return getSqlSessionFactory().openSession(); 34 } 35 }
上述的代码段中，我们创建了一个 SqlSessionFactory 对象，我们将使用它来获得 SqlSession 对象和执行映射的SQL 语句。
⑦ 新建 StudentMapper 接口和 StudentService 类
1. 首先, 创建 JavaBean Student.java
1 package com.mybatis3.domain; 2 3 import java.util.Date; 4 5 /** 6 * Created by peng on 2016/8/4. 7 */ 8 public class Student { 9 private Integer studId; 10 private String name; 11 private String email; 12 private Date dob; 13 public String getName() { 14 return name; 15 } 16 17 public Integer getStudId() { 18 return studId; 19 } 20 21 public String getEmail() { 22 return email; 23 } 24 25 public Date getDob() { 26 return dob; 27 } 28 29 30 public void setStudId(Integer studId) { 31 this.studId = studId; 32 } 33 34 public void setName(String name) { 35 this.name = name; 36 } 37 38 public void setEmail(String email) { 39 this.email = email; 40 } 41 42 public void setDob(Date dob) { 43 this.dob = dob; 44 } 45 46 47 48 }
2. 创建映射器 Mapper 接口 StudentMapper.java 其方法签名和 StudentMapper.xml 中定义的 SQL 映射定义名 相同
1 package com.mybatis3.mappers; 2 3 import com.mybatis3.domain.Student; 4 5 import java.util.List; 6 7 /** 8 * Created by peng on 2016/8/4. 9 */ 10 public interface StudentMapper { 11 List<Student>findAllStudents(); 12 Student findStudentById(Integer id); 13 void insertStudent(Student student); 14 15 }
3. 现在创建 StudentService.java 实现对表 STUDENTS 的数据库操
1 package com.mybatis3.services; 2 3 import com.mybatis3.domain.Student; 4 import com.mybatis3.mappers.StudentMapper; 5 import com.mybatis3.util.MyBatisSqlSessionFactory; 6 import org.apache.ibatis.session.SqlSession; 7 import org.slf4j.LoggerFactory; 8 9 import java.util.List; 10 11 /** 12 * Created by peng on 2016/8/4. 13 */ 14 public class StudentService { 15 private org.slf4j.Logger logger= LoggerFactory.getLogger(getClass()); 16 public List<Student>findAllStudents() 17 { 18 SqlSession sqlSession= MyBatisSqlSessionFactory.openSession(); 19 try { 20 StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class); 21 return studentMapper.findAllStudents(); 22 } 23 finally { 24 sqlSession.close(); 25 } 26 } 27 public Student findStudentById(Integer studId) 28 { 29 logger.debug("Select Student By ID:{}",studId); 30 SqlSession sqlSession=MyBatisSqlSessionFactory.openSession(); 31 try{ 32 StudentMapper studentMapper=sqlSession.getMapper(StudentMapper.class); 33 return studentMapper.findStudentById(studId); 34 } 35 finally { 36 sqlSession.close(); 37 } 38 } 39 public void createStudent(Student student) 40 { 41 SqlSession sqlSession=MyBatisSqlSessionFactory.openSession(); 42 try{ 43 StudentMapper studentMapper=sqlSession.getMapper(StudentMapper.class); 44 studentMapper.insertStudent(student); 45 sqlSession.commit(); 46 } 47 finally { 48 sqlSession.close(); 49 } 50 } 51 }
⑨ 新建一个 JUnit 测试类来测试 StudentService
1 package com.mybatis3.services; 2 3 import com.mybatis3.domain.Student; 4 import org.junit.AfterClass; 5 import org.junit.Assert; 6 import org.junit.BeforeClass; 7 import org.junit.Test; 8 9 import java.util.Date; 10 import java.util.List; 11 12 /** 13 * Created by peng on 2016/8/4. 14 */ 15 public class StudentServiceTest { 16 private static StudentService studentService; 17 @BeforeClass 18 public static void setup(){ 19 studentService=new StudentService(); 20 } 21 @AfterClass 22 public static void teardown(){ 23 studentService=null; 24 } 25 @Test 26 public void testFindAllStudents() 27 { 28 List<Student>students=studentService.findAllStudents(); 29 Assert.assertNotNull(students); 30 for(Student student:students) 31 { 32 System.out.println(student); 33 } 34 } 35 @Test 36 public void testFindStudentById() 37 { 38 Student student=studentService.findStudentById(1); 39 Assert.assertNotNull(student); 40 System.out.println(student); 41 } 42 @Test 43 public void testCCeateStudent() 44 { 45 Student student=new Student(); 46 int id=3; 47 student.setStudId(id); 48 student.setName("student_"+id); 49 student.setEmail("student_"+id+"gmail.com"); 50 student.setDob(new Date()); 51 studentService.createStudent(student); 52 Student newStudent=studentService.findStudentById(id); 53 Assert.assertNotNull(newStudent); 54 } 55 }
⑩ 它是怎么工作的
首先，我们配置了 MyBatis 最主要的配置文件-mybatis-config.xml,里面包含了 JDBC 连接参数；配置了映射器 Mapper XML 配置文件文件，里面包含了 SQL 语句的映射。
我们使用 mybatis-config.xml 内的信息创建了 SqlSessionFactory 对象。每个数据库环境应该就一个 SqlSessionFactory 对象实例，所以我们使用了单例模式只创建一个 SqlSessionFactory 实例。
我们创建了一个映射器 Mapper 接口-StudentMapper，其定义的方法签名和在 StudentMapper.xml 中定义的完全 一样（即映射器 Mapper 接口中的方法名跟 StudentMapper.xml 中的 id 的值相同）。注意 StudentMapper.xml 中 namespace 的值被设置成 com.mybatis3.mappers.StudentMapper，是 StudentMapper 接口的完全限定名。这使我们 可以使用接口来调用映射的 SQL 语句。
在 StudentService.java 中，我们在每一个方法中创建了一个新的 SqlSession，并在方法功能完成后关闭 SqlSession。每一个线程应该有它自己的 SqlSession 实例。SqlSession 对象实例不是线程安全的，并且不被共享。所 以 SqlSession 的作用域最好就是其所在方法的作用域。从 Web 应用程序角度上看，SqlSession 应该存在于 request 级 别作用域上。
注意：
在看书学习的时候，遇到了几个概念性的问题：
classpath概念：设置Classpath的目的，在于告诉Java执行环境，在哪些目录下可以找到您所要执行的Java程序所需要的类或者包。Java执行环境本身就是一个平台，执行于这个平台上的程序是已编译完成的Java程序(后面会介绍到Java程序编译完成之后，会以.class文件存在)。如果将Java执行环境比喻为操作系统，如果设置Path变量是为了让操作系统找到指定的工具程序(以Windows来说就是找到.exe文件)，则设置Classpath的目的就是让Java执行环境找到指定的Java程序(也就是.class文件)。
本书中有时候提到新建了某文件加入到classpath中，放到webapp下面的WEB-INF下面即可。
resource想新建package却新建不了？
这两个文件夹的类型都是Sources的时候才能新建package，由于博主学习maven有限，原理不太明白，有懂的读者欢迎指明。
最后运行了测试类，运行成功。
标签：
原文地址：http://www.cnblogs.com/baipeng/p/5743501.html
