Mybatis(学习一)--基础入门

什么是 MyBatis ？

　　MyBatis 是一款优秀的持久层ORM框架，它支持定制化 SQL、存储过程以及高级映射。

　　MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

MyBatis优点：

　　1、简单易学。 mybatis本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。

　　2、灵活。 mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql基本上可以实现不使用数据访问框架可以实现的所有功能，或许更多。

　　3、解除sql与程序代码的耦合。 通过提供DAL层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。

　　4、提供映射标签，支持对象与数据库的orm字段关系映射

　　5、提供对象关系映射标签，支持对象关系组建维护

　　6、提供xml标签，支持编写动态sql。

MyBatis缺点

　　1、编写SQL语句时工作量很大，尤其是字段多、关联表多时，更是如此。

　　2、SQL语句依赖于数据库，导致数据库移植性差，不能更换数据库。

　　3、框架还是比较简陋，功能尚有缺失，虽然简化了数据绑定代码，但是整个底层数据库查询实际还是要自己写的，工作量也比较大，而且不太容易适应快速数据库修改。

　　4、二级缓存机制不佳

MyBatis使用场景

适合用于：需求变化频繁， 数据模型不固定的互联网项目

开发步骤

1、引入jar

<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.25</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.44</version>
</dependency>

2、定义Mybatis的核心配置文件，文件名称没有规则。

　　XML 配置文件（configuration XML）中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。可以分为3大部分：数据库连接相关配置、运行时常量和注册映射元文件(xml和annotation)

<!-- 用于定义常量，供配置文件中其它位置进行引用。属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，
亦可通过 propertie
f2e0
s 元素的子元素来传递
properties标签有2个属性，resource用于定义相对于classpath的资源文件,例如datbase.properties（分离配置的思路）;
url用于定义绝对路径的方法,例如file:///d:\abc\database.properties
-->
<properties resource="database.properties">
<!-- properties标签除了可以读取外部的properties文件的方式之外，还需要在这里直接进行定义的方式
系统首先读取property设置，然后读取properties resource配置.
同时系统允许构建SqlSessionFactory对象时编码设置配置信息，new SqlSessionFactoryBuilder().build(is, properties)
最后生效的是编码处的Properties配置
-->
<property name="username" value="dev_user"/>
</properties>
<typeAliases>
<typeAlias alias="Author这是别名，在映射元文件就可以直接使用别名指代后面的全称" type="com.yan.entity.Author类型的全名，直接使用比较麻烦，不建议直接使用，但是可以直接使用"/>
</typeAliases>
<!-- MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，
开发、测试和生产环境需要有不同的配置；或者共享相同 Schema 的多个生产数据库， 想使用相同的 SQL 映射 ，其中default用于定义默认使用的环境配置.
默认的环境 ID（比如:default=”yan”）。
每个 environment 元素定义的环境 ID（比如:id=”yan”）。

-->
<environments default="yan">
<!-- 配置特定名称的环境，id是名称，不允许重复.这里主要配置:
事务管理器的配置（比如:type=”JDBC”）。在 MyBatis 中有两种类型的事务管理器（也就是 type=”[JDBC|MANAGED]”）：
一般针对非分布式应用都使用JDBC.

JDBC – 这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器
的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默
认的关闭行为

数据源的配置（比如:type=”POOLED”）。
dataSource元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。有三种内建的数据源类型（也就是 type=”[
UNPOOLED|POOLED|JNDI]”）：
UNPOOLED– 这个数据源的实现只是每次被请求时打开和关闭连接。一般只用于环境测试.
POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。 这
是一种使得并发 Web 应用快速响应请求的流行处理方式。
JNDI– 这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上
下文的引用。一般只用于生产环境
-->
<environment id="yan">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<!-- 最基本的配置信息
driver – 这是 JDBC 驱动的 Java 类的完全限定名（并不是JDBC驱动中可能包含的数据源类）。
url – 这是数据库的 JDBC URL 地址。
username – 登录数据库的用户名。
password – 登录数据库的密码。

${key}使用的是OGNL，表示从properties获取的配置值
-->
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<!-->注册映射元文件-->
<mappers>
<mapper resource="com/yan/entity/AuthorMapper.xml"/>使用相对大于classpath的设置方式
<mapper url="file:///var/mappers/AuthorMapper.xml"/>使用绝对路径的方式,不建议使用
<mapper class="com.yan.dao.AuthorMapper"/>一般用于通过annotation定义映射时使用, AuthorMapper是一个对应的映射接口
<package name="com.yan.entity"/>自动扫描包中的所有映射信息
</mappers>

测试连接是否成功

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
Properties ps=new Properties();
ps.setProperty("username","zhangsan");
SqlSessionFactory fac = new SqlSessionFactoryBuilder().build(is, ps);
SqlSession session=fac.openSession();
System.out.println(session.getConnection());
session.close();

3、定义数据库表结构

Create table t_users(
Id bigint primary key auto_increment,
Username varchar(20) not null unique,
Password varchar(20) not null,
Birth timestamp default current_timestamp,
Sex boolean default 1,
Salary numeric(8,2)
)engine=innodb default charset utf8;

4、定义映射元文件—xml

　　SQL 映射文件有很少的几个顶级元素（按照它们应该被定义的顺序）：

cache – 给定命名空间的缓存配置。

cache-ref – 其他命名空间缓存配置的引用。

resultMap – 是最复杂也是最强大的元素，用来描述如何从据库结果集中来加载对象。

parameterMap – 已废弃！老式风格的参数映射。内联参数是首选,这个元素可能在将来被移除，这里不会记录。

sql – 可被其他语句引用的可重用语句块。

insert – 映射插入语句

update – 映射更新语句

delete – 映射删除语句

select – 映射查询语句

insert, update 和 delete基本相同

<mapper namespace="com.yan.entity.UserBean名空间设置">
<insert id="insert对应statement名称" parameterType="UserBean参数类型，使用简称的前提是在mybatis-config.xml中定义了别名">
insert into t_users(username,password) values(#{username},#{password})定义对应的SQL语句，这里使用#{}方式的OGNL表达式从参数中获取对应的值
</insert>
<insert id="insert" parameterType="UserBean" useGeneratedKeys="true"
keyProperty="id" keyColumn="id">
insert into
t_users(username,password)
values(#{username},#{password})
</insert>
</mapper>

测试insert()

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory fac = new SqlSessionFactoryBuilder().build(is);
SqlSession session=fac.openSession();

UserBean user=new UserBean();
user.setUsername("yan11");
user.setPassword("123456");
int len=session.insert(user.getClass().getName()+".insert",user);
session.commit();
if(len>0)
System.out.println(user.getId());
session.close();

Select用于定义对应的查询操作

<select id="selectPerson" parameterType="int参数类型，使用的是别名，表示参数为java.lang.Integer" resultType="hashmap返回结果对应的一行数据的类型，可以返回java.util.HashMap，也可能是List<HashMap>类型">
SELECT * FROM PERSON WHERE ID = #{id}
</select>

具体返回的是一个对象还是一组对象取决于调用方法时selectOne还是selectList
<select id="selectById" parameterType="long" resultType="UserBean">
select * from t_users where id=#{id}
</select>
这里是按照主键进行查询，所以应该是返回一个数据，所以调用时采用的是selectOne
UserBean user=session.selectOne("com.yan.entity.UserBean.selectById", 1L);

<select id="selectAll" resultType="UserBean">
select * from t_users
</select>
这里的查询返回应该是多行数据，所以调用时采用的是selectList返回一个List，每个元素都是UserBean类型的
List<UserBean> ulist = session.selectList("com.yan.entity.UserBean.selectAll");
if(ulist!=null && ulist.size()>0)
for(UserBean temp:ulist){
System.out.println(temp);
}

<select id="selectAllRowsNum" resultType="int">
select count(*) from t_users
</select>
int len = session.selectOne("com.yan.entity.UserBean.selectAllRowsNum");

id 在命名空间中唯一的标识符，可以被用来引用这条语句。

parameterType 将会传入这条语句的参数类的完全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。

parameterMap 这是引用外部 parameterMap 的已经被废弃的方法。使用内联参数映射和 parameterType 属性

resultType从这条语句中返回的期望类型的类的完全限定名或别名。注意如果是集合情形，那应该是集合可以包含的类型，而不能是集合本身。使用 resultType 或 resultMap，但不能同时使用。如果返回的是复杂对象类型数据则要求列名称必须和属性名称一致

resultMap外部 resultMap 的命名引用。结果集的映射是MyBatis最强大的特性，对其有一个很好的理解的话，许多复杂映射的情形都能迎刃而解。使用resultMap或resultType，但不能同时使用。

flushCache将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：false。

useCache将其设置为 true，将会导致本条语句的结果被二级缓存，默认值：对 select 元素为 true。

timeout这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。

fetchSize 这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。

statementType可以选用的是STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。

resultSetType可以使用FORWARD_ONLY(表示采用单向滚动的结果集)，SCROLL_SENSITIVE(表示采用可滚动的敏感的结果集) 或 SCROLL_INSENSITIVE(表示采用可滚动的不敏感的结果集) 中的一个，默认值为 unset （依赖驱动）。

databaseId 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。

resultOrdered这个设置仅针对嵌套结果 select 语句适用：如果为 true，就是假设包含了嵌套结果集或是分组了，这样的话当返回一个主结果行的时候，就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至于导致内存不够用。默认值：false。

resultSets这个设置仅对多结果集的情况适用，它将列出语句执行后返回的结果集并每个结果集给一个名称，名称是逗号分隔的。

参数Parameters

<select id="selectUsers" resultType="User参数类型，这是一个复杂类型">
select id, username, password from users where id = #{id}这里的#{id}是一个OGNL表达式，表示从参数中获取id属性的值
</select>
<select id="selectById" parameterType="long设置一个简单类型的参数【不是java的概念,这里表示是一个单一值,不是多个属性值的样式，例如整数、日期、字串等】" resultType="UserBean">
select <include refid="sql1"/> from t_users where id=#{id}这里的#{id}用于表示引用这个单一值，不是获取属性。这个名称可以随意编写
</select>
<!--定义参数时经常会指定参数的具体数据类型,注意如果不设置框架会自动识别
#{middleInitial,jdbcType=VARCHAR}表示引用参数中的middleInitial属性值，这个值针对数据库中的varchar类型，jdbcType实际上是java.sql.Types类中所定义的常量
注意：指定jdbcType一般用于的是针对单一值类型-->

Result Maps用于实现结果集到对象类型数据的映射，主要说明哪个列对应的是哪个属性

<resultMap type="UserBean" id="userMapper">
<id property="id" column="id" jdbcType="BIGINT"/>
<result property="uname" column="username" jdbcType="VARCHAR"/>用于说明属性名uname对应的列名称为username
<result property="upwd" column="password" javaType="string"/>
<result property="birth" column="birth" jdbcType="DATE"/>这里设置数据类型为DATE，表示只获取年月日，没有对应的时间
</resultMap>

<select id="selectById" parameterType="long" resultMap="userMapper">
select <include refid="sql1"/> from t_users where id=#{id}
</select>
<!--这里需要注意的是如果列名和属性名称一致，系统可以自动识别不需要进行说明-->

具体配置参照案例:

http://blog.csdn.net/Uponz/article/details/79275823