什么是mybatis?
- MyBatis是支持普通SQL查询,存储过程和高级映射的优秀持久层框架。
- MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。
- MyBatis使用简单的XML或注解用于配置和原始映射,
将接口和Java的POJOs(Plan Old Java Objects,普通的Java对象)映射成数据库中的记录.
orm工具的基本思想
无论是用过的hibernate,mybatis,你都可以法相他们有一个共同点:
- 从配置文件(通常是XML配置文件中)得到 sessionfactory.
- 由sessionfactory 产生 session
- 在session 中完成对数据的增删改查和事务提交等.
- 在用完之后关闭session 。
- 在java 对象和 数据库之间有做mapping 的配置文件,也通常是xml 文件。
环境搭建
-
相应的jar包的下载地址:https://code.google.com/p/mybatis/downloads/list?can=1,这里使用的3.2版,我们要下载的是mybatis-jpetstore-6.0.1-bundle.zip(下面有例子文件)和mybatis-3.2.0-bundle.zip(包含相应的jar)
-
现阶段,你可以直接建立java 工程,但一般都是开发web项目,这个系列教程最后也是web的,
所以一开始就建立web工程。 -
将 mybatis-3.2.0.jar,mysql-connector-java-5.1.13-bin 和lib下的jar包,拷贝到 web工程的lib目录.并去
mybatis-jpetstore-6.0.1-bundle拷贝一个log4j.properties文件到src目录下 -
创建mysql 测试数据库和用户表,注意,这里采用的是 utf-8 编码
CREATE DATABASE `mybatis` CHARACTER SET 'utf8' COLLATE 'utf8_general_ci'; 创建用户表,并插入一条测试数据 Create TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `userName` varchar(50) DEFAULT NULL, `userAge` int(11) DEFAULT NULL, `userAddress` varchar(200) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8; Insert INTO `user` VALUES ('1', 'fjh', '100', '深圳,罗湖');
到此为止,前期准备工作就完成了。下面开始真正配置mybatis项目了。
5. 设置mybatis配置文件:Configuration.xml, 文件建立在项目的src路径下面,可以在MyBatis-3-User-Guide-Simplified-Chinese.pdf中找到配置文件的格式;内容如下
<?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="User" type="com.fjh.bean.User"/>
</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://127.0.0.1:3306/mybatis" />
<property name="username" value="root"/>
<property name="password" value="123"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/fjh/bean/User.xml"/>
</mappers>
</configuration>
6、 建立与数据库对应的 java class,以及映射文件.
在src_user下建立package:com.fjh.bean ,并在这个 package 下建立 User 类
public class User {
private int id;
private String userName;
private String userAge;
private String userAddress;
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 String getUserAge() {
return userAge;
}
public void setUserAge(String userAge) {
this.userAge = userAge;
}
public String getUserAddress() {
return userAddress;
}
public void setUserAddress(String userAddress) {
this.userAddress = userAddress;
}
}
7、在源文件的同目录建立User.xml文件,文件的格式可以在
mybatis-jpetstore-6.0.1-bundle\mybatis-jpetstore-6.0.1\mybatis-jpetstore-6.0.1.war\WEB-INF\classes\org\mybatis\jpetstore\persistence\找到相应的格式,也可以在MyBatis-3-User-Guide-Simplified-Chinese.pdf找到相应的模板内容如下:
<?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="com.fjh.bean.User">
<select id="selectUserByID" parameterType="int" resultType="User">
select * from `user` where id = #{id}
</select>
</mapper>
8、下面对这几个配置文件解释下:
1.Configuration.xml 是 mybatis 用来建立 sessionFactory 用的,里面主要包含了数据库连接相关东西,
还有 java 类所对应的别名,比如
这个别名非常重要,你在 具体的类的映射中,比如User.xml 中 resultType 就是对应这里的。
要保持一致,当然这里的 resultType 还有另外单独的定义方式,后面再说。
2. Configuration.xml 里面 的是包含要映射的类的xml配置文件。
3. 在User.xml 文件里面 主要是定义各种SQL 语句,以及这些语句的参数,以及要返回的类型等.
9、开始测试源码目录下建立com.fjh.test这个package,并建立测试类Test,然后运行要看到从数据库查询的结果
package com.fjh.test;
import java.io.IOException;
import java.io.InputStream;
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.fjh.bean.User;
public class Test {
private static SqlSessionFactory sqlSessionFactory;
//根据配置文件初始化SqlSessionFactory
static {
try {
//读取src目录下的配置文件
InputStream in = Resources.getResourceAsStream("Configuration.xml");
//初始化sqlSessionFactory 报错可能没有拷贝相应的jar包
sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
/**
* @param args
*/
public static void main(String[] args) {
//获取一个session
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
//根据配置文件User.xml中的id去获取相应的sql语句
User user = (User)sqlSession.selectOne("com.fjh.bean.User.selectUserByID",new Integer(1));
System.out.println(user.getUserName() + " " + user.getUserAddress());
} catch (Exception e) {
// TODO: handle exception
}
}
}
10、实现以接口的形式编程。
其实还有更简单的方法,而且是更好的方法,使用合理描述参数和SQL语句返回值的接口
(比如UserMap.class),这样现在就可以至此那个更简单,
更安全的代码,没有容易发生的字符串文字和转换的错误.下面是详细过程
package com.fjh.inter;
import com.fjh.bean.User;
public interface UserMap {
/**
* selectUserByID 名字是配置文件中<select id="selectUserByID"
* @return
*/
public User selectUserByID(int id);
}
接口和原来的User.xml不在同一包下所以要修改配置文件
<!--<mapper namespace="com.fjh.bean.User">-->
<mapper namespace="com.fjh.inter.UserMap">
<select id="selectUserByID" parameterType="int" resultType="User">
select * from `user` where id = #{id}
</select>
</mapper>
测试的调用说明:
SqlSession sqlSession = sqlSessionFactory.openSession();
try {
//根据配置文件User.xml中的id去获取相应的sql语句
//User user = (User)sqlSession.selectOne("com.fjh.bean.User.selectUserByID",new Integer(1));
//以接口的形式编程 在配置文件中要修改<mapper namespace="com.fjh.inter.UserMap">
UserMap userManager = (UserMap)sqlSession.getMapper(UserMap.class);
User user = userManager.selectUserByID(1);
System.out.println(user);
System.out.println(user.getUserName() + " : " + user.getUserAddress());
} catch (Exception e) {
e.printStackTrace();
}
//如果配置User.xml和接口不在同一个包中,则需要在定义namespace的时候给定接口的全名