一、Mybatis介绍
MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。mybatis提供一种“半自动化”的ORM实现。这里的“半自动化”,是相对Hibernate等提供了全面的数据库封装机制的“全自动化”ORM实现而言,“全自动”ORM实现了POJO和数据库表之间的映射,以及 SQL 的自动生成和执行。mybatis的重点是在于POJO与SQL之间的映射关系。
MyBatis官方网址: http://www.mybatis.org
MyBatis官网的简体中文地址,有兴趣的小伙伴去逛逛吧。
MyBatista api 地址:http://tool.oschina.net/apidocs/apidoc?api=mybatis-3.1.1
MyBatis在github上的网址: https://github.com/mybatis/mybatis-3
MyBatis参考PPT: https://wenku.baidu.com/view/86e643d055270722182ef7ae.html
二、mybatis快速入门
1 准备开发环境
1 首先建立项目java web
使用Eclipse创建测试项目,创建的测试项目是Java项目或JavaWeb项目都可以。
使用Eclipse创建JavaWeb项目步骤, File -> New -> Dynamic Web Project 新建一个Java Web项目,项目名字为: MyBatis01
2 添加mybatis所需的jar包
mybatis需要jar包:mybatis-3.4.5.jar
mysql驱动jar包:mysql-connector-java-5.1.6n.jar
日志记录jar包:log4j-1.2.17.jar
3 创建数据库和表
针对mysql数据库。创建数据库和表的脚本。
DROP TABLE IF EXISTS `myDb`; create database myDb; use myDb
CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(20), age INT);
INSERT INTO users( username , age ) VALUES ( ‘zhangsan‘ , ‘21‘);
INSERT INTO users( username , age ) VALUES ( ‘lisi‘ , ‘22‘);
至此,前期的开发环境准备工作全部完成。还可以使用以下脚本创建一个与users表同样结构的测试表 user1
create table user1 as select * from users;
2 使用myBatist查询表中的数据
1 添加mybatis的配置文件 mybatis.cfg.xml
<?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> <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/myDb?useUnicode=true&characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="123456" /> </dataSource> </environment> </environments> </configuration>
2 定义表对应的实体类,如下图所示
User类的代码如下:
package com.mybatis.pojo; /** * * users表所对应的实体类 * * */ public class User { //实体类的属性和表的字段名称一一对应 private int id; private String username ; private int age; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } @Override public String toString() { return "User [id=" + id + ", username=" + username + ", age=" + age + "]"; } }
3 定义操作users表的sql映射文件userMapper.xml
创建一个com.mybatis.mapping包,专门用于存放sql映射文件,在包中创建一个userMapper.xml文件,如下图所示:
userMapper.xml文件的内容如下:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <!-- 为这个mapper指定一个唯一的namespace,namespace的值习惯上设置成包名+sql映射文件名,这样就能够保证namespace的值是唯一的 例如namespace="com.mybatis.mapping.userMapper"就是com.mybatis.mapping(包名)+userMapper(userMapper.xml文件去除后缀) --> <mapper namespace="com.mybatis.mapping.userMapper"> <!-- 在select标签中编写查询的SQL语句, 设置select标签的id属性为getUser,id属性值必须是唯一的,不能够重复 使用parameterType属性指明查询时使用的参数类型,resultType属性指明查询返回的结果集类型 resultType="com.mybatis.pojo.User"就表示将查询结果封装成一个User类的对象返回 User类就是users表所对应的实体类 --> <!-- 根据id查询得到一个user对象 --> <select id="getUser" parameterType="int" resultType="com.mybatis.pojo.User"> select * from users where id=#{id} </select> </mapper>
通过 <select>节点映射数据库中的表与java中的实体类User。尝试 把查询语句改为以下内容,是否还会有相同内容呢。
select * from user1 where id=#{id}
4 在 mybatis.conf.xml文件中注册 userMapper.xml 文件
<?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> <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/myDb?useUnicode=true&characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="123456" /> </dataSource> </environment> </environments> <mappers> <!-- 注册userMapper.xml文件, userMapper.xml位于com.mybatis.mapping这个包下,所以resource写成com/mybatis/mapping/userMapper.xml --> <mapper resource="com/mybatis/mapping/userMapper.xml"/> </mappers> </configuration>
连接数据库配置的url地址,可以指定字符串的编码格式为UTF8, 其中 &代表转义字符,可以参考网友的这篇文章。
5 编写测试代码:执行定义的select语句
创建一个TestMyBatis1类,编写如下的测试代码:
package com.mybatis.test; import java.io.InputStream; import java.io.Reader; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import com.mybatis.pojo.User; public class TestMyBatis1 { public void testSel1(){ try{ //mybatis的配置文件 String resource = "mybatis.cfg.xml"; //使用类加载器加载mybatis的配置文件(它也加载关联的映射文件) InputStream is = TestMyBatis1.class.getClassLoader().getResourceAsStream(resource); //构建sqlSession的工厂 SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is); //使用MyBatis提供的Resources类加载mybatis的配置文件(它也加载关联的映射文件) //Reader reader = Resources.getResourceAsReader(resource); //构建sqlSession的工厂 //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader); //创建能执行映射文件中sql的sqlSession SqlSession session = sessionFactory.openSession(); /** * 映射sql的标识字符串, * com.mybatis.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值, * getUser是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL */ String statement = "com.mybatis.mapping.userMapper.getUser";//映射sql的标识字符串 //执行查询返回一个唯一user对象的sql User user = session.selectOne(statement, 1); System.out.println(user); }catch(Exception e){ e.printStackTrace(); } } public void testSel2(){ try{ //mybatis的配置文件 String resource = "mybatis.cfg.xml"; //使用MyBatis提供的Resources类加载mybatis的配置文件(它也加载关联的映射文件) Reader reader = Resources.getResourceAsReader(resource); //构建sqlSession的工厂 SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader); //创建能执行映射文件中sql的sqlSession SqlSession session = sessionFactory.openSession(); /** * 映射sql的标识字符串, * com.mybatis.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值, * getUser是select标签的id属性值,通过select标签的id属性值就可以找到要执行的SQL */ String statement = "com.mybatis.mapping.userMapper.getUser";//执行查询返回一个唯一user对象的sql User user = session.selectOne(statement, 1); System.out.println(user); }catch(Exception e){ e.printStackTrace(); } } public static void main(String[] args) { TestMyBatis1 demo = new TestMyBatis1(); //demo.testSel1(); demo.testSel2(); } }
执行结果如下:
可以看到,数据库中的记录已经成功查询出来了。
6 本节完整例子下载地址为: http://onl5wa4sd.bkt.clouddn.com/MyBatis01.rar
7 使用Maven工程创建以上实验。
pom.xml参考内容:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.bank</groupId> <artifactId>MyBatis04</artifactId> <version>0.0.1</version> <packaging>jar</packaging> <name>MyBatis04</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.4.5</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.6</version> </dependency> </dependencies> </project>
测试完整例子可以从以下地址下载 : http://ovy7j2mnc.bkt.clouddn.com/MavenMyBatis01.rar