1. MyBatis介绍
MyBaits是一个支持普通sql查询、存储工程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO映射成数据库中的记录。
2. 快速入门
2.1 准备开发环境
(本人使用IDE:Intellij idea)
- 创建测试项目,普通java项目或者是JavaWeb项目均可(这里采用的是java普通项目),如下图:
- 添加相应的jar包
【mybatis】
mybatis-3.1.1.jar
【MySQL驱动包】
mysql-connector-java-5.1.37-bin.jar
(使用Intellij idea的话,别忘了把jar包加到依赖项里面:
) - 创建数据库和表,针对MySQL数据库
SQL脚本如下:
create database mybatis;
use mybatis;
CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, NAME VARCHAR(20), age INT);
INSERT INTO users(NAME, age) VALUES('孤傲苍狼', 27);
INSERT INTO users(NAME, age) VALUES('白虎神皇', 27);
到此,前期的开发环境准备工作全部完成。
2.2 使用MyBatis查询表中的数据
添加Mybatis的配置文件conf.xml
在src目录下创建一个conf.xml文件,如下图所示:
comf.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://127.0.0.1:3306/mybatis" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments> </configuration>
定义表所对应的实体类,如下图所示:
User类的代码如下:package com.freedom.farbox.model; /** * users表对应的实体类 */ public class User { // 实体类的属性和表的字段名称一一对应 private int id ; private String name ; private int age ; public int getId() { return id; } public String getName() { return name; } public int getAge() { return age; } public void setId(int id) { this.id = id; } public void setName(String name) { this.name = name; } public void setAge(int age) { this.age = age; } @Override public String toString() { return "User [id = " + id + ", name = " + name + ", age = " + age + "]" ; } }
定义操作users表的sql映射文件userMapper.xml
创建一个com.freedom.farbox.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.freedom.farbox.mapping.userMapper" --> <mapper namespace="com.freedom.farbox.mapping.userMapper"> <!-- 在select标签中编写查询sql语句,设置select标签的id属性为getUser,id属性值必须唯一。使用parameterType属性指明查询时 使用的参数类型,resultType属性指明查询返回的结果集类型,resultType="com.freedom.farbox.model.User"就表示将查询结果 封装成一个User类的对象返回,User类就是users表对应的实体类 --> <!-- 根据id查询得到一个user对象 --> <select id="getUser" parameterType="int" resultType="User"> select * from users where id = #{id} </select> </mapper>
在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> <!-- development: 开发模式 work: 工作模式 --> <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://127.0.0.1:3306/mybatis" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments> <mappers> <!-- 注册userMapper.xml文件 --> <mapper resource="com/freedom/farbox/mapping/userMapper.xml" /> </mappers> </configuration>
编写测试代码:执行定义的select语句
创建一个Test1类,编写如下的测试代码:package com.freedom.farbox.test; import com.freedom.farbox.model.User; 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 java.io.IOException; import java.io.InputStream; import java.io.Reader; /** * Created by 23782 on 2016/5/10. */ public class Test1 { public static void main(String[] args) throws IOException { //mybatis的配置文件 String resource = "conf.xml" ; // 使用类加载器加载mybatis的配置文件(它也加载关联的映射文件) InputStream is = Test1.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.freedom.farbox.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值, * getUser是select标签的id属性值,通过select标签的id属性值就可以找到要执行的sql * */ String statement = "com.freedom.farbox.mapping.userMapper.getUser" ; // 映射sql的标识字符串 // 执行查询返回一个唯一user对象的sql User user = session.selectOne(statement, 2) ; System.out.println(user) ; } }
执行结果如下:
可以看到,数据库中的记录已经成功查询出来了。