一:JDBC存在哪些问题,所以我们使用mybatis
我之前有篇博客提到JDBC连接数据库,这次我在这总结一下JDBC存在的问题,这也是我们选择其他方式的原因
(1)jdbc的数据库连接在使用的时候创建,不使用的时候释放,就会存在频繁的对数据库链接开启关闭操作,造成数据库资源浪费,影响数据库性能。
(2)sql语句,参数设置,结果遍历均存在硬编码,在有改动的情况下,需重新编译java代码,不利于系统的维护。
针对上述问题,我们想到的可能实现的解决方案:一使用数据库连接池管理数据库连接。二使用配置xml文件对语句及参数进行管理,查询结果映射到java对象中
二:mybatis的基本原理
个人觉得原理先过一遍,不用深究,等把示例看过再回来研究会比较容易理解一些。
(1)mybatis是个持久层的框架,程序员的主要精力放在sql上,通过映射的方式自由灵活的生产满足需求的sql。
(2)mybatis可以对preparedstatement的输入参数进行自动映射,也可以将查询结果映射为java对象。
(3)mybatis的下载地址:https://gist.github.com/mybatis/mybatis-3/releases
框架结构图:
简单解释一下,mybatis框架也是基于jdbc进行改善的,所以其本质也是需要通过连接数据库创建会话执行语句。不同的是,mybatis通过sqlMapConfig.xml配置文件来创建会话工厂SqlSessionFactory,然后通过会话工厂创建会话SqlSession,sqlSession就可以操作数据库了,需要注意的是虽然我们看到的是sqlSession操作数据库了,实际上是其内部的执行器Executor来操作的。
既然有数据库的操作,就免不了输入输出,mybatis便通过一个底层的封装对象来控制。他可以封装sql语句,输入参数,输出结果类型。
三:mybatis的实战
功能实现:根据主键查询记录
环境要求:
Java的环境:jdk1.7、开发环境:eclipse:indigo、mybatis的环境:mybatis-3.2.7(下载地址见上文)
开始搭建项目:
(1)创建一个java工程“mybatisTest”
(2)导jar包:刚刚下载的mybatis中lib下的所有包+mybatis的驱动包+servlet依赖包+mysql的驱动包
包导入后右击buildpath然后add到运行环境中
(3)创建log4j.properties
上述包中可以看见日志包,我们创建一个log4j.properties,内容可以在mybatis里中的pdf中拷贝。
# Global logging configuration
# 在开发环境下中日志级别debug,正式环境用info或error
log4j.rootLogger=DEBUG, stdout
# MyBatis logging configuration...
log4j.logger.org.mybatis.example.BlogMapper=TRACE
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
(4)创建
sqlMapConfig.xml(mybatis最核心的配置文件)
<?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>
<properties resource="db.properties"></properties>
<!-- 跟spring整合后environments的内容都删除 -->
<environments default="development">
<environment id="development">
<!-- 使用JDBC管理事务 -->
<transactionManager type="JDBC"/>
<!-- 数据库连接池-->
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!-- 加载映射文件 -->
<mappers>
<mapper resource="sqlMap/User.xml"/>
<!--<mapper resource="mapper/UserMapper.xml"/>-->
</mappers>
</configuration>
上述的配置文件中关于数据的连接我是放在db.properties中的,这里直接取得是取地址变量
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/cj?useUnicode=true&characterEncoding=UTF-8
jdbc.username=****
jdbc.password=****
这里账号密码我隐去了,你们直接用自己的就好
(5)创建我们的示例文件夹com.test.mybatis.first,基本的结构图如下图。
(6)创建映射文件
创建映射文件之前,我们需要在数据库建一个表,下面示例是用户表user有字段id,name等等,这个太简单自己建一下。
在目录sqlMap里面创建一个user.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="test"> <!-- 在映射文件中配置很多的SQL语句 通过ID查询数据 id:表示映射文件中的sql,将sql语句封装到mapping resultType指定sql输出结果的所映射的java对象 #{}:表示占位符 ${}:表示拼接字符串 --> <select id="findUserById" parameterType="int" resultType="com.test.mybatis.po.User"> select * from user where id=#{id} </select> <select id="findUserByName" parameterType="java.lang.String" resultType="com.test.mybatis.po.User"> select * from user where username like '%${value}%' </select> <!-- 插入用户信息 --> <insert id="insertUser" parameterType="com.test.mybatis.po.User"> <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer"> select LAST_INSERT_ID() </selectKey> insert into user(id,username,password,userId,sex,age,creattime) values( #{id},#{username},#{password},#{userId},#{sex},#{age},#{creattime} ) </insert> <!-- 删除用户信息 --> <delete id="deleteUser" parameterType="java.lang.Integer" > delete from user where id=#{id} </delete>
<update id="updateUser" parameterType="com.test.mybatis.po.User">update user set username=#{username},password=#{password},userId=#{userId},sex=#{sex},age=#{age},creattime=#{creattime} where id=#{id}</update></mapper> 需要注意的mapper的约束条件是:<!-- 更新用户信息 -->
标签<mapper></mapper>里面的内容是根据自己的需要添加的,这里我们主要看里面的第一个select标签。"http://mybatis.org/dtd/mybatis-3-mapper.dtd"
<1>mapper标签有个namespace属性,这是用来对sql分类管理的标识。<2>select标签属性id,前面提到对数据进行存储封装的底层封装对象,这个id就可以看为这个mapperStatement的i
<3>select标签属性parameterType,在我们写的sql语句中有个占位符#{id},用来表示我们将要输入的ID,parameterType便是指定我们输入的参数的类型。
<3>select标签属性resultType,指定sql输出结果所映射的java对象。
(7)创建表映射的java对象。
不管什么项目,我们在进行表数据查询的时候,结果都是存放在一个java对象中,所以我们可以专门建个文件夹放我们的映射对象
如表user的映射对象user.java
(8)在sqlMapConfig中加载我们的映射文件mapper.xmlpackage com.test.mybatis.po; public class User { //属性名要和数据库表字段对应 private int id; private String username; private String password; private int userId; private String sex; private int age; private String creattime; 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 getPassword() { return password; } public void setPassword(String password) { this.password = password; } public int getUserId() { return userId; } public void setUserId(int userId) { this.userId = userId; } public String getSex() { return sex; } public void setSex(String sex) { this.sex = sex; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getCreattime() { return creattime; } public void setCreattime(String creattime) { this.creattime = creattime; } @Override public String toString() { return "User [id=" + id + ", username=" + username + ", password=" + password + ", userId=" + userId + ", sex=" + sex + ", age=" + age + ", creattime=" + creattime + "]"; } }
上面我们的sqlMapConfig.xml已经加载过了,加载语句是:
<mappers>
<mapper resource="sqlMap/User.xml"/>
</mappers>
sqlMapConfig.xml可以加载多个mapper.xml文件
(9)基本设置与框架搭建好了,可以写我们的测试方法了
MybatisFirst.java编写测试方法的时候要把junit的包导入进去。
完成后我们就可以右击我们的方法进行测试了。package com.test.mybatis.first; import java.io.IOException; import java.io.InputStream; import java.util.List; 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 org.junit.Test; import com.test.mybatis.po.User; public class MybatisFirst { //根据id查询用户信息,得到一条记录 @Test public void findUserByIdTest() throws IOException{ //mybatis配置文件 String resource="sqlMapConfig.xml"; //得到配置文件 InputStream inputStream = Resources.getResourceAsStream(resource); //创建会话工厂 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到sqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //通过sqlSession操作数据库 //第一个参数:映射文件中statement的Id,等于namespace+"."+statement id User user = sqlSession.selectOne("test.findUserById", 1); System.out.println(user); //释放会话资源 sqlSession.close(); } @Test public void findUserByNameTest() throws IOException{ //mybatis配置文件 String resource="sqlMapConfig.xml"; //得到配置文件 InputStream inputStream = Resources.getResourceAsStream(resource); //创建会话工厂 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到sqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //通过sqlSession操作数据库 //用户名模糊查询 List<User> user1 = sqlSession.selectList("test.findUserByName", "or where 1=1 or"); System.out.println(user1); //释放会话资源 sqlSession.close(); } @Test public void insertUserTest() throws IOException{ //mybatis配置文件 String resource="sqlMapConfig.xml"; //得到配置文件 InputStream inputStream = Resources.getResourceAsStream(resource); //创建会话工厂 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到sqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //通过sqlSession操作数据库 //插入数据 User iuser = new User(); iuser.setUsername("chenjun"); iuser.setPassword("123456"); int num = sqlSession.insert("test.insertUser",iuser); sqlSession.commit(); System.out.println(num); //释放会话资源 sqlSession.close(); } @Test public void deleteUserTest() throws IOException{ //mybatis配置文件 String resource="sqlMapConfig.xml"; //得到配置文件 InputStream inputStream = Resources.getResourceAsStream(resource); //创建会话工厂 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到sqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //通过sqlSession操作数据库 //第一个参数:映射文件中statement的Id,等于namespace+"."+statement id int num2 = sqlSession.delete("test.deleteUser", 3); sqlSession.commit(); //释放会话资源 sqlSession.close(); } //更新用户信息 @Test public void updateUserTest() throws IOException{ //mybatis配置文件 String resource="sqlMapConfig.xml"; //得到配置文件 InputStream inputStream = Resources.getResourceAsStream(resource); //创建会话工厂 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //通过工厂得到sqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //通过sqlSession操作数据库 //插入数据 User user = new User(); user.setId(4); user.setUsername("jun"); user.setPassword("456"); int num = sqlSession.update("test.updateUser",user); sqlSession.commit(); System.out.println(num); //释放会话资源 sqlSession.close(); } }
(10)测试常见异常原因
<1>数据库服务没起。
<2>sqlMapConfig中的mapper.xml的名字有错。
<3>sqlMapConfig加载的时候是全部加载,一定要保证每一个mapper.xml都是存在且正确的。
<4>mapper.xml中sql语句的属性类型要正确,java实体类与数据表要对应。