搭建一个简单的Mybatis框架

直接进入正题，如何搭建一个纯Mybatis框架？过程中间可能会遇到各种各样的问题，简单整理在此。

准备工作

搭建Mybatis，需要的两个核心jar包，一个是任意Mybatis版本的包，另一个是数据库驱动包。这里的环境如下：

• mybatis-3.4.6.jar
• mysql-connector-java-8.0.13.jar

二者的pom依赖可去https://mvnrepository.com/查找，然后创建一个简单的java项目，这里以Maven项目为例。

相关配置

1、pom.xml文件

	4.0.0
	com.szh.Mybatis_test
	Mybatis_test
	war
	0.0.1-SNAPSHOT
	mybatis Maven Webapp
	http://maven.apache.org
	
	
		UTF-8
		com.szh
	
	
	
		
		    mysql
		    mysql-connector-java
		    8.0.13
		
		
		    org.mybatis
		    mybatis
		    3.4.6
		
	
	
		Mybatis_test
	

2、 Mybatis核心配置文件conf.xml

当然，dataSource的四个属性也可以写在一个单独的配置文件里，然后在conf.xml中使用引用即可。

conf.xml是Mybatis的核心配置文件，放在下面一级目录：

3、Mybatis接口映射文件personMapper.xml

	
	
	
		select * from person where id=#{id}
	

 personMapper.xml文件是Mybatis每个实体类对应的接口映射文件，一般统一放在如下目录：

4、测试主类Test.java

package com.szh;

import java.io.InputStream;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.szh.po.PersonPo;

public class Test {

	public static void main(String[] args) {
		//mybatis的配置文件
        String resource = "conf.xml";
        //使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）
        InputStream is = Test.class.getClassLoader().getResourceAsStream(resource);
        System.out.println(Test.class.getClassLoader().getResource(resource).getFile());
        //构建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的标识字符串，
         * me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，
         * getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
         */
        //在命名空间“com.szh.mapper.personMapper”中定义了一个名为“getPerson”的映射语句，
        //这样它就允许你使用指定的完全限定名“com.szh.mapper.personMapper.getPerson”来调用映射语句，
        //格式：命名空间名(namespace)+映射语句名(id)

        String statement = "com.szh.mapper.personMapper.getPerson";//映射sql的标识字符串
        //执行查询返回一个唯一user对象的sql
        PersonPo p = session.selectOne(statement, 1);
        System.out.println(p.getId());
        System.out.println(p.getName());
        System.out.println(p.getAddress());
	}
}

以上就是主要配置步骤，接下来run一下工程，看看结果，看看可能出现什么样的问题。

疑难杂症

1、personMapper.xml文件找不到，具体日志如下：

Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: 
### Error building SqlSession.
### The error may exist in com.szh.mapper.personMapper.xml
### Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com.szh.mapper.personMapper.xml
	at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
	at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:80)
	at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:64)
	at com.szh.Test.main(Test.java:20)

 com.szh.mapper.personMapper.xml文件明明存在，目录也正确，却报这个异常，这时我们需要确认conf.xml中是否正确定义了每一个mapper，注意mapper接口文件路径要以正斜杠分隔开，正确的写法如下：

2、数据库时区问题，具体日志如下：

Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database.  Cause: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.
### The error may exist in com/szh/mapper/personMapper.xml
### The error may involve com.szh.mapper.personMapper.getPerson
### The error occurred while executing a query
### Cause: java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.
	at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:150)
	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:141)
	at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:77)
	at com.szh.Test.main(Test.java:38)

那么，我们需要给数据库连接url添加以下参数：

3、查询到的某些属性为null，如下：

1
马二
null

去数据库直接查看id为1的person，地址不为null才对。这种情况有可能是mapper接口文件里select标签的resultType属性直接写了实体类的路径，而此实体类的address属性名与表person的列名不对应。例如，列名为addr，而属性名为address。其实熟悉Mybatis，可以使用resultMap来手动映射列与属性名之间的关系，以及级联等等，这里不多赘述。