mybatis 入门（一）

ORM  工厂模式 构建者模式  代理模式

目录

前言

一、mybatis是什么？

二、使用步骤

1.引相关的XML文件（主要是config.xml & mapper.xml）

2.创建相关 SqlSessionFactory类（util）并返回SqlSession

3. 使用SqlSession进行相应的CRUD

总结

---

配置文件位置

---

前言

刚刚接触使用mybatis，供个人学习使用。连接的数据库一般都是mysql或者Oracle。mysql版本为5.5.27  （select version();）依赖包为  mybatis-3.5.2.jar & mysql-connector-java-5.1.36-bin.jar。

---

 使用Oracle数据库 版本为mybatis-3.4.6.jar，对应oracle数据库为oracle11g，jdbc版本为ojdbc6.jar。

mybatis也支持连接 sqlite。

下面案例仅供参考

一、mybatis是什么？

 mybatis是基于对jdbc的一种封装优化的ORM（Object Relational Mapping）框架。目的是为了简化数据库连接过程中出现的各类复杂的操作。主要是在DAO层进行与数据库的交互。

二、使用步骤 

将jar包引入到项目后配置相关xml文件（config.xml & mapper.xml）。要想实现表和对象一一对应，在实体类下建立一个对应的mapper.xml文件。mapper.xml文件模板可以参考说明中的文件。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
 "D:\Mybatis\mybatis-3-mapper.dtd">
<mapper namespace="ofn.ofnMapper">
 <select id="selectofn"  parameterType="String" resultType="Map">
 select ZRQYXZ,SFSSGS,JYDJWY,YLSGX,SYNDLRZEWY,PGJZRZCZEWY,SZGJHDQ,SZGQBL,ZRQYMC,SSXY,PGJZRJZCZEWY,SRFQYXZ,SFZY from uf_kgqzrqk where id = #{id} 
 </select>
 <!-- ${param} ZRQYXZ,SFSSGS,JYDJWY,YLSGX,SYNDLRZEWY,PGJZRZCZEWY,SZGJHDQ,SZGQBL,ZRQYMC,SSXY,PGJZRJZCZEWY,SRFQYXZ,SFZY -->
 <select id="selectparam"  parameterType="Map" resultType="Map">
 select 
 SFSSGS,JYDJWY,
 YLSGX from
  uf_kgqzrqk where id = #{ID}
 </select>
 <select id="selectTodayData"    resultType="Map">
 select ZRQYXZ,SFSSGS,JYDJWY,YLSGX,SYNDLRZEWY,PGJZRZCZEWY,SZGJHDQ,SZGQBL,ZRQYMC,SSXY,PGJZRJZCZEWY,SRFQYXZ,SFZY 
  from uf_kgqzrqk <!--where uf_kgqzrqk.modedatacreatedate=TO_CHAR(SYSDATE,'YYYY-MM-DD') -->
 </select>
 <select id="selectWithConvert"  parameterType="String" resultType="Map">
 select * from uf_kgqzrqk where id = #{ID}
 </select>
 <update id="updateByIndexid" parameterType="String">
  </update>
</mapper>

注意 XML文件中 的 sql 语句不能有 分号 ";"   。

要在数据库中建立好表后，在项目中建立好对应的实体类。 

1.引相关的XML文件（主要是config.xml & mapper.xml）

 config.xml大约等于JDBC 的一系列配置操作。具体内容如下（示例）：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
 PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 "D:\Mybatis\mybatis-3-config.dtd">
<configuration>
<properties resource="ofn/db.properties"></properties> 
 <environments default="development">
 <environment id="development">
 <transactionManager type="JDBC"/>
 <dataSource type="POOLED">
 <property name="driver" value="${driver}"/>
 <property name="url" value= "${url}"/>
 <property name="username" value="${username}"/>
 <property name="password" value="${password}"/>
 </dataSource>
 
 </environment>
 
 <environment id="0034_008db">
   <transactionManager type="JDBC"/> 
   <dataSource type="POOLED" > 
     <property name="driver" value="org.sqlite.JDBC"/>
     <property name="url" value= "jdbc:sqlite:D:\dbdata\0033gqqktj\0034_008.db"/>
      <!--   property name=" " value=" "-->
   </dataSource>
 </environment>

 </environments>
 <mappers>
 <mapper resource="ofn/ofnMapper.xml"/>
 </mappers>
</configuration>

 <mapper resource="ofn/ofnMapper.xml"/>

在上面的配置 中 ofn/ofnMapper.xml对应相关的包名.文件名，ofnMapper.xml 即是连接到SQL的语句所在XML文件名。

 其中JDBC 的相关配置不再赘述，需要注意的是，如果mysql版本是8.0之后的版本，driver

<property name="driver" value="com.mysql.jdbc.Driver"/>

修改为  value="com.mysql.cj.jdbc.Driver"

由于是初学，也没有做相应的properties文件。由于内网没有办法连接互联网，为了使XML文件有相应提示，需要把相关的dtd文件下到本地。如下：

 PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 "D:\Mybatis\mybatis-3-config.dtd">

向应的配置在eclipse中为Windows-->Preferences-->XML Catelog-->Add,输入PUBLIC的数据和本机文件地址保存即可。

1.2 mapper.xml 负责配置相关的SQL语句，输入参数与输出等。示例如下：

 <?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="priv.practice.orm.UserMapper">
<select id="selectById" resultType="priv.practice.orm.User">
select * from user where id = #{id}
</select>
</mapper>

namespace 就是XML文件的 包名.文件名， 由于config文件就是在resource中，当需要连接到相关的mapper文件时，显然mapper的namespace应该与config中的 mapper resource对应。

 在

<select id="selectById" resultType="priv.practice.orm.User">

中， id="selectById"表示这条查询语句 的“地址”或者可以理解为用以区分其他SQL语句的标识。

 parameterType="String" resultType="Map"分别表示输入与输出的参数类型。显然，mybatis支持Map作为参数，因为mybatis的输入参数只能有一个。但是一般情况下使用与数据库表单同名的class类作为输出参数接收查询结果，输入参数的#{} 内必须是对象中属性的名字。

insert into user(name,pwd) values (#{name},#{pwd});

输入参数传入SQL语句中后，SQL语句有两种写法接收（#{id} 或者${param}），即预编译和字符串拼接。

parameterType 为简单类型和对象类型是，使用 #{} 和 ${} 传参不同

使用 ${}传参，本质上就是字符串的拼接，SQL语句涉及需要使用引号('')包裹时，需要手动添加。 e.g. '${...}'   //适合 动态排序需求 等向SQL语句中传入字段名等非标准参数的需求。

二者均支持传入参数嵌套对象通过使用“.”获取级联属性。

具体见下面两个链接：

预编译与字符串拼接

mybatis中${}与#{}区别

2.创建相关 SqlSessionFactory类（util）并返回SqlSession

代码如下（示例）：

public class MyBatisUtil {

	private static SqlSessionFactory factory = null;

    // 使用static静态代码块，随着类的加载而加载，只执行一次
    static {
        try {
            String resource = "Config.xml";
            // 加载MyBatis的主配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            // 通过构建器（SqlSessionFactoryBuilder）构建一个SqlSessionFactory工厂对象
            factory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static SqlSession getSqlSession() throws IOException {
        return factory.openSession();
    }
	public static void main(String[] args) {
		// TODO Auto-generated method stub

	}

}

使用MyBatisUtil连接数据库（JDBC）,返回SqlSession，再进行相应的CRUD操作。

3. 使用SqlSession进行相应的CRUD

目前只需要进行查询操作（同时包含输入/输出参数）。 可以新建与mapper同名的接口，接口函数名，输入输出参数与mapper中crud语句一一对应。

public interface ofnMapper {

	  Map  selectparam(@Param(value = "param") String param);//

	Map selectofn(  String id)  ;
	  
}

使用时直接使用反射的方式获取接口类，由于接口类与mapper同名，且在一个包下面，就可以巧妙的找到对应的SQL语句。 

Map<String, String> mapParameter = new HashMap<String, String>();
		//读取oracle数据写入map中
		Map<String, String> mapOfn = new HashMap<String, String>();
		SqlSession session = MyBatisUtil.getSqlSession();
		ofnMapper ofnMapper= session.getMapper(ofnMapper.class);
		 mapOfn =ofnMapper.selectofn("4");
		 mapParameter=ofnMapper.selectparam(param);
/*
.....
.....
*/

session.close();

接口类的创建就是 动态代理，其中约定大于配置的原则被很好的贯彻到了这种方式中。

---

总结

这篇文章写的还很不全面，其中对config.xml的理解并不是很到位，里面的相应配置参数，多环境数据库的切换等内容也没有提及。 由于mapper的SQL语句原则上参数无论输入输出都应为单个参数的输入或输出，所以也未提及相关的参数不是简单数据类型时的具体操作。
 以上就是今天要写的内容，本文仅仅简单介绍了简单的mybatis使用，对于其涉及到的设计模式请参考其他方式而mybatis提供的其他形式的功能还要进一步探索。还请留言指正哦。