MyBatis学习(一):一个简单的演示
上面就是一个很简单的MyBatis的应用实例,可以看看,对于如何如此做可能就不是很清楚了。
首先每一个MyBatis的应用程序都是以一个SqlSessionFactory对象的实例为核心。SqlSessionFactory对象的实例可以通过SqlSessionFactoryBuilder对象来获得。SqlSessionFactoryBuilder对象可以从XML配置文件或是从configuration类的准备的实例中构建相应的SqlSessionFactory对象。下面是通过XML配置文件来构建SqlSessionFactory对象。由于conf.xml是直接放在src下,因此文件路径可以省,但是如果xml文件是放在包下面还要把包名称写上。
String resource="conf.xml";
InputStream inputStream=Resources.getResourceAsStream(resource);
SqlSessionFactory sessionFactory =new SqlSessionFactoryBuilder().build(inputStream);
SqlSessionFactoryBuilder:
这个类可以被实例化,使用和丢弃。一旦你创建了 SqlSessionFactory 后,这个类就不需要存在了。因此 SqlSessionFactoryBuilder 实例的最佳范围是方法范围(也就是本地方法变量)。
你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例,但是最好的方式是
不需要保持它一直存在来保证所有 XML 解析资源,因为还有更重要的事情要做。
SqlSessionFactory:
一旦被创建,SqlSessionFactory 应该在你的应用执行期间都存在。没有理由来处理或重
新创建它。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次。这样的
操作将被视为是非常糟糕的。因此 SqlSessionFactory 的最佳范围是应用范围。有很多方法可
以做到,最简单的就是使用单例模式或者静态单例模式。然而这两种方法都不认为是最佳实
践。这样的话,你可以考虑依赖注入容器,比如 Google Guice 或 Spring。这样的框架允许你
创建支持程序来管理单例 SqlSessionFactory 的生命周期。
SqlSession:
每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不能被共享,也是线程
不安全的。因此最佳的范围是请求或方法范围。绝对不能将 SqlSession 实例的引用放在一个
类的静态字段甚至是实例字段中。也绝不能将 SqlSession 实例的引用放在任何类型的管理范
围中,比如 Serlvet 架构中的 HttpSession。如果你现在正用任意的 Web 框架,要考虑 SqlSession
放在一个和 HTTP 请求对象相似的范围内。换句话说,基于收到的 HTTP 请求,你可以打开
了一个 SqlSession,然后返回响应,就可以关闭它了。关闭 Session 很重要,你应该确保使
用 finally 块来关闭它。
1.properties
其实这个使用的很多,我们经常会将连接数据库的信息,放在一个配置文件中,这样就可以使用这个来加载配置文件。有一个db.properties文件中的内容如下:
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis001
username=root
password=wang314159
在conf.xml中需要使用properties加载这个配置文件:
当然在properties中也可以添加
后面的property如果与db.properties中相同名字,那么将会覆盖db.properties中的。
在下面
2.setting
这个一个很需要注意的,里面的配置会改变MyBatis的行为方式,下面的表格描述了设置信息,含义和默认值。
3.typeAliases
类型别名是为java类型命名一个短的名字,这个设置后,在sql映射的xml文件中很有使用的价值,他只是用来减少类完全限定名的多余部分。其实简单的说就是给需要的起一个别名,在sql映射文件中,需要使用到java bean,类完全限定名可能要包括包名会很长,使用起来不是很方便
上面设置,需要使用com.wpl.demo.User这个类完全限定名时候就可以使用_User来代替,这个使用起来很方便,用的也比较多。
4.typeHandlers
无论是MyBatis在预处理语句中设置一个参数,还是从结果集中取出一个值时候,类型处理器被用来将获取的值以合适的方式转化为java类型。下面的表格描述了默认类型的处理器。
当然我们也可以自己根据自己需要重写类型处理器或创建自己的类型处理器来处理不支持的或非标准的类型。这时候需要实现TypeHandler接口(org.mybatis.tye),然后映射新的类型处理器到java类型,还有可选的一个JDBC类型。但是很多情况下,我们不会自己做,因此默认已经做的很好了。
5.objectFactory
MyBatis每次创建结果对象新的实例时候,它使用一个ObjectFactory实例来完成。如果参数映射存在,默认的ObjectFactory不比使用默认构造方法或是带参数的构造方法实例化目标类做的工作多。如果你想重写默认的ObjectFactory,你可以创建你自己的。
6.plugins
MyBatis允许你在某一点拦截已映射语句执行的调用。在默认情况下,MyBatis允许使用插件来拦截方法调用。
这个用到的很少,如果你确实有使用到相关的操作,可以自己更加深入的学习。
7.environments
MyBatis可以配置多种环境。这会帮助你将SQL映射应用到多种数据库之中。例如,你也许为开发设置不同的配置,测试和生产环境。或者你可能有多种生产数据库但是共享相同的模式,所以你会想对不同数据库使用相同的SQL映射。
一个很重要的问题需要记住:你可以配置多种环境,但是你只能为每个SqlSessionFactory实例选择一个。所以如果你想连接两个数据库,那么你需要创建两个SqlSessionFactory实例,每一个数据库对应一个。如果是三个数据库,你需要三个实例,以此类推。
每一个数据库对应一个SqlSessionFactory,为了明确创建哪种环境,你可以选择将他作为参数传递给SqlSessionFactoryBuilder。
SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment);
SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader,
environment,properties);
如果环境被忽略,没那么环境将会被加载,如下运行
SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader);
SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader,properties);
8.transactionManager
在mybatis中有两个事务管理器类型(type=[JDBC|MANAGED])
(1).JDBC:这个配置直接简单使用了JDBC的提交和回滚设置。它依赖于从数据源得到连接来管理事务范围。
(2).MANAGED:这个配置几乎没有做什么。他从来不提交或是回滚一个连接。而他会让容器来管理事务的整个周期。默认情况下他会关闭连接。然而一些容器并不希望这样,因此如果你需要从连接中停止他,将closeConnection属性设置为false。
9.dataSource
dataSource 元素使用基本的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
Ø 许多 MyBatis 的应用程序将会按示例中的例子来配置数据源。然而它并不是必须的。
要知道为了方便使用延迟加载,数据源才是必须的。
有三种内建的数据源类型(也就是 type=”???”):
(1)UNPOOLED – 这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢,
这是对简单应用程序的一个很好的选择,因为它不需要及时的可用连接。不同的数据库对这
个的表现也是不一样的,所以对某些数据库来说配置数据源并不重要,这个配置也是闲置的。
UNPOOLED 类型的数据源仅仅用来配置以下 4 种属性:
driver – 这是 JDBC 驱动的 Java 类的完全限定名(如果你的驱动包含,它也不是
数据源类)。
url – 这是数据库的 JDBC URL 地址。
username – 登录数据库的用户名。
password – 登录数据库的密码。
defaultTransactionIsolationLevel – 默认的连接事务隔离级别。
作为可选项,你可以传递数据库驱动的属性。要这样做,属性的前缀是以“driver.”开
头的,例如:
driver.encoding=UTF8
这 样 就 会 传 递 以 值 “ UTF8 ” 来 传 递 属 性 “ encoding ”, 它 是 通 过
DriverManager.getConnection(url,driverProperties)方法传递给数据库驱动。
(2)POOLED – 这是 JDBC 连接对象的数据源连接池的实现,用来避免创建新的连接实例
时必要的初始连接和认证时间。这是一种当前 Web 应用程序用来快速响应请求很流行的方
法。
除了上述(UNPOOLED)的属性之外,还有很多属性可以用来配置 POOLED 数据源:
poolMaximumActiveConnections – 在任意时间存在的活动(也就是正在使用)连
接的数量。默认值:10
poolMaximumIdleConnections – 任意时间存在的空闲连接数。
poolMaximumCheckoutTime – 在被强制返回之前,池中连接被检查的时间。默认
值:20000 毫秒(也就是 20 秒)
poolTimeToWait – 这是给连接池一个打印日志状态机会的低层次设置,还有重新
尝试获得连接,这些情况下往往需要很长时间(为了避免连接池没有配置时静默失
败)。默认值:20000 毫秒(也就是 20 秒)
poolPingQuery – 发送到数据的侦测查询,用来验证连接是否正常工作,并且准备
接受请求。默认是“NO PING QUERY SET”,这会引起许多数据库驱动连接由一
个错误信息而导致失败。
poolPingEnabled – 这是开启或禁用侦测查询。如果开启,你必须用一个合法的
SQL 语句(最好是很快速的)设置 poolPingQuery 属性。默认值:false。
poolPingConnectionsNotUsedFor – 这是用来配置 poolPingQuery 多次时间被用一
次。这可以被设置匹配标准的数据库连接超时时间,来避免不必要的侦测。默认值:
0(也就是所有连接每一时刻都被侦测-但仅仅当 poolPingEnabled 为 true 时适用)。
(3)JNDI – 这个数据源的实现是为了使用如 Spring 或应用服务器这类的容器,容器可以集
中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。这个数据源配置只需要两个属
性:
initial_context – 这 个 属 性 用 来 从 初 始 上 下 文 中 寻 找 环 境 ( 也 就 是
initialContext.lookup(initial——context))。这是个可选属性,如果被忽略,那么
data_source 属性将会直接以 initialContext 为背景再次寻找。
data_source – 这是引用数据源实例位置的上下文的路径。它会以由 initial_context
查询返回的环境为背景来查找,如果 initial_context 没有返回结果时,直接以初始
上下文为环境来查找。
和其他数据源配置相似,它也可以通过名为“env.”的前缀直接向初始上下文发送属性。
比如:
env.encoding=UTF8
在初始化之后,这就会以值“UTF8”向初始上下文的构造方法传递名为“encoding”
的属性。
10.mapper
这个就是SQl映射文件在这里加载。