java项目集成Mybatis——命令行程序

引言

在上节示例中使用JDBC完成数据库的增删高差（CURD），需要程序独立完成数据库连接、将ResultSet中结构化记录转换实体对象等繁琐功能，需要增强性能时，还要写数据库连接池、缓存技术的利用等。我们如果使用Mybatis框架时，以上内容均可以由mybatis完成，程序员只需要关注数据的存取逻辑（即SQL语句）。接下来我们看如何在命令行程序中集成myBatis

mybtais配置项目

mybtais是一个半自动持久层框架，使用此框架我们只需要根据框架的约定格式，将我们操作数据的SQL语句写到指定位置，数据库的连接、SQL的执行、ORM、池技术、缓存的使用均交给框架完成，使用myBatis框架首先必须将其依赖的jar导入项目，具体过程如下：

下载mybaits.jar包：可以有myBatis官网直接下载；下载地址：http://www.mybatis.cn/82.html，下载完成解压，解压后如下图所示

jar包导入：按ctrl+alt+shift+s，弹出对话框，点右侧+，将mybatis-3.5.2.jar和lib目录下的jar包全部导入，如下图所示

**配置myBatis：**在SRC目录下创建XML文件，文件名可以自定义，示例中的文件名为myBatisConfig.xml。点击菜单 File—>new—>file，弹出对话框，输入文件名

文件创建好后输入配置信息，内容如下

<?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>
    <!-- Setting为高级设置，初学者可以先忽略 -->
    <settings>
        <!-- 打印查询语句 -->
        <setting name="logImpl" value="STDOUT_LOGGING" />
        <!-- 控制全局缓存（二级缓存）-->
        <setting name="cacheEnabled" value="true"/>
        <!-- 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。默认 false  -->
        <setting name="lazyLoadingEnabled" value="true"/>
        <!-- 当开启时，任何方法的调用都会加载该对象的所有属性。默认 false，可通过select标签的 fetchType来覆盖-->
        <setting name="aggressiveLazyLoading" value="false"/>
        <!--  Mybatis 创建具有延迟加载能力的对象所用到的代理工具，默认JAVASSIST -->
        <!--<setting name="proxyFactory" value="CGLIB" />-->
        <!-- STATEMENT级别的缓存，使一级缓存，只针对当前执行的这一statement有效 -->
        <setting name="localCacheScope" value="SESSION"/>
    </settings>
     <!-- 环境配置时主体内容 -->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/><!-- 单独使用时配置成MANAGED没有事务 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/sl?serverTimezone=GMT%2b8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    
    <mappers>
        <!--加载映射文件，注意这个是XML文件，路径使用“/”,而不是包使用com.bjwl.mapper-->
        <mapper resource="com/bjwl/mapper/StudentDAO.XML"/>
    </mappers>
</configuration>

注意：MyBatis 全局配置文件顺序是固定的，否则启动的时候会报错。
在配置文件中有一个 ，需要创建一个名db.properties的文件，properties类文件的创建与使用参考：https://blog.csdn.net/guoyp2126/article/details/110267137
这些步骤完成后，myBatis使用已经配置完成。

创建示例程序

创建示例程序时，我们遵循一般企业开发时使用的分层结构完成包的划分。我们创建pojo、dao、services、util、mapper等包。
创建pojo包存放实体类，这里为学生实体（StudentEntity），代码如下：

public class StudentEntity implements Serializable {
    private String sno;
    private String sName;
    private String sSex;
    private int sAge;
    private String sDept;

    public StudentEntity() {
    }

    public StudentEntity(String sno, String sName, String sSex, int sAge, String sDept) {
        this.sno = sno;
        this.sName = sName;
        this.sSex = sSex;
        this.sAge = sAge;
        this.sDept = sDept;
    }

    public String getSno() {
        return sno;
    }

    public void setSno(String sno) {
        this.sno = sno;
    }

    public String getsName() {
        return sName;
    }

    public void setsName(String sName) {
        this.sName = sName;
    }

    public String getsSex() {
        return sSex;
    }

    public void setsSex(String sSex) {
        this.sSex = sSex;
    }

    public int getsAge() {
        return sAge;
    }

    public void setsAge(int sAge) {
        this.sAge = sAge;
    }

    public String getsDept() {
        return sDept;
    }

    public void setsDept(String sDept) {
        this.sDept = sDept;
    }

    public String toString(){
        return "学号："+sno +"姓名："+sName+"性别："+sSex+"年龄："+"院系："+sDept;
    }
}

这里实体的属性尽量和数据库的属性保持一致，当然如果数据库表中属性带下划线尽量转换为驼峰式命名。

创建dao包存放数据库持久化操作接口（StudentDAO），再这里我们仅定义其接口，实现类通过框架自动生成。代码如下

public interface StudentDAO {
    List<StudentEntity> getList();
}

其中最重要业务中的sql语句，可以写到接口方法上方通过注解的形式使用，但实际项目开发中，则需要些单独的mapper文件和其建立对应关系。

创建mapper目录存放mapper.xml文件，在src目录下创建resources目录，在其下创建mapper目录，在此目录下存放对应dao层StudentDAO接口的StudentDAO.xml文件，这是要注意mapper中的xml文件名要和dao层的接口名完全一致，如：dao层的StudentDAO和mapper的StudentDAO.xml名字是一样的。代码如下

这里要注意红色字体的对应关系，这里代码除SQL语句需要自己写外，其余的都可以使用工具或idea工具快捷方式自动生成，对于初学者最好自己动手写一下，此文件完成后，还需要在myBatisConfig.xml文件中mapper中做以说明，如下图

到此为止mybatis的持久化操作代码均已写完。接下来我们需要做相关的调用。

测试调用

创建util包，将mybatis的持久化通用方法调用封装到一个单独的类中，代码如下

创建Services包，写StudentServiceImpl实现类（这里省略了接口），代码如下：

public class StudentServiceImpl {
    public List<StudentEntity> getList(){
        List<StudentEntity> students=null;
        SqlSession session = BatisUtils.getsqlsession();
        StudentDAO dao = session.getMapper(StudentDAO.class);
        students= dao.getList();
        return  students;
    }
}

使用命令行程序调用

public class Main {
    public static void main(String[] args) {
	// myBatis使用测试
        StudentServiceImpl impl = new StudentServiceImpl();

        List<StudentEntity> students = impl.getList();
        if(students !=null){
            for (int i=0;i<students.size();i++) {
               System.out.println(students.get(i).toString());
            }
        }
    }
}

执行结果如下：

结论与问题

使用mybatis框架后，我只需要关心我们的sql语句即可，其余的工作交给框架去完成，实体类以及mapper中xml文件都可以由工具自动生成，非常方便。还有两个问题需要我们思考，问题一，需要下载很多jar依赖包，如果这些依赖包更新，我们还需手动的更新，解决办法我们可以使用maven，只需要告诉我们需要什么包，版本号是多少，maven会自动下载和更新。问题二，数据库的单表增删改查功能基本类似，能不能由框架解决，我们再使用myBatis-puls插件就可以解决问题。