一、什么是mybatis
MyBatis 是支持普通SQL 查询,存储过程和高级映射的优秀持久层框架。
MyBatis 消除 了几乎所有的JDBC 代码和参数的手工设置以及结果集的检索。
MyBatis 使用简单的XML 或注解用于配置和原始映射,将接口和Java 的POJOs (Plan Old Java Objects ,普通的Java 对象)映射成数据库中的记录。
MyBatis 的简化并且规范了JDBC的持久化方式,同时又相对与hibernate更加灵活,可以说是介于JDBC和HIBERNATE之间的优秀持久化框架。
MyBatis的前身就是IBATIS,只是版本更新后由于某些事情进行了更名。
二、入门
1》使用顺序:
1、通过XML,或从Configuration 类的习惯准备的实例中构建的方式,创建SqlSessionFactoryBuilder 对象。
2、通过SqlSessionFactoryBuilder获取SqlSessionFactory。
1-1》XML方式示例获取SqlSessionFactoryBuilder
String resource = "org/mybatis/example/Configuration.xml"; Reader reader = Resources.getResourceAsReader(resource); sqlMapper = new SqlSessionFactoryBuilder().build(reader);XML
<?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> <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> </environments> <mappers> <mapper resource="org/mybatis/example/BlogMapper.xml"/> </mappers> </configuration>当然,在XML配置文件中还有很多可以配置的,上面的示例指出的则是最关键的部分。
要注意 XML 头部的声明,需要用来验证 XML文档正确性。environment 元素体中包含对事
务管理和连接池的环境配置。 mappers 元素是包含所有 mapper (映射器) 的列表,这些 mapper
的 XML文件包含 SQL代码和映射定义信息。
1-2》不使用XML获取SqlSessionFactoryBuilder
DataSource dataSource = BlogDataSourceFactory.getBlogDataSource(); TransactionFactory transactionFactory = new JdbcTransactionFactory(); Environment environment = new Environment("development", transactionFactory, dataSource); Configuration configuration = new Configuration(environment); configuration.addMapper(BlogMapper.class); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);
注意这种情况下配置是添加映射类。映射类是 Java 类,这些类包含 SQL 映射语句的注
解从而避免了 XML文件的依赖, XML映射仍然在大多数高级映射(比如:嵌套 Join 映射)
时需要。出于这样的原因,如果存在 XML配置文件的话,MyBatis 将会自动查找和加载一
个对等的 XML 文件(这种情况下,基于类路径下的 BlogMapper.class 类的类名,那么
BlogMapper.xml将会被加载)。
2-1》从 SqlSessionFactory中获取 SqlSession
方法1:
SqlSession session = sqlMapper.openSession(); try { Blog blog = (Blog) session.selectOne( "org.mybatis.example.BlogMapper.selectBlog", 101); } finally { session.close(); }方法2:
例如: SqlSession session = sqlSessionFactory.openSession(); try { BlogMapper mapper = session.getMapper(BlogMapper.class); Blog blog = mapper.selectBlog(101); } finally { session.close(); }
3-1》我们还需要一个映射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="org.mybatis.example.BlogMapper"> <select id="selectBlog" parameterType="int" resultType="Blog"> select * from Blog where id = #{id} </select> </mapper>上面代码的BlogMapper(相当于一个对象),ID=“selectBlog” 相当于表明一个SQL的ID值(方法),用于调用SQL。
上文就可以“Blog blog = (Blog) session.selectOne( "org.mybatis.example.BlogMapper.selectBlog", 101); ” 这样来调用了。
基本上可以用JAVA的对象和方法来理解。
最后:
1、如 BlogMapper 这样的映射器类来说,还有一个妙招。它们中间映射的语句可以不需要
在 XML中来写,而可以使用 Java 注解来替换。比如,上面的 XML示例可以如下来替换:
package org.mybatis.example;public interface BlogMapper {@Select("SELECT * FROM blog WHERE id = #{id}")Blog selectBlog(int id);}对于简单语句来说,使用注解代码会更加清晰,然而 Java 注解对于复杂语句来说就会
混乱,应该限制使用。因此,如果你不得不做复杂的事情,那么最好使用 XML来映射语句。
当然这也取决于你和你的项目团队的决定,看哪种更适合你来使用,还有以长久方式来
使用映射语句的重要性。也就是说,不要将自己局限在一种方式中。你可以轻松地将注解换
成 XML映射语句,反之亦然。
2、命名解析:为了减少输入量,MyBat is 对所有的命名配置元素使用如下的命名解析规则,包括语句,结果映射,缓存等。
》直接查找完全限定名(比如“com.mypackage.MyMapper.selectAllThings”),如果发现就使用。
》短名称(比如“selectAllThings”)可以用来引用任意含糊的对象。而如果有两个或两个以上的(比如“com.foo.selectAllThings”和“com.bar.selectAllThings”),那么就会得到错误报告,说短名称是含糊的,因此就必须使用完全限定名。