MyBatis官方中文文档.pdf

入门 安装 要使用 MyBatis ， 只需将 mybatis-x.x.x.jar (/mybatis/mybatis-3/releases) 文件置于 classpath 中即可。 如果使用 Maven 来构建项目，则需将下面的 dependency 代码置于 pom.xml 文件中： dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId versionx.x.x/version /dependency 从 XML 中构建 SqlSessionFactory 每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为中心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。 从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。但是也可以使 用任意的输入流(InputStream)实例，包括字符串形式的文件路径或者 file:// 的 URL 形式的文件路径来配置。 MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，可使从 classpath 或其他位置加载资源文件更 加容易。 String resource = org/mybatis/example/mybatis-config.xml; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); XML 配置文件（configuration XML）中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源 （DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。XML 配置文件的详细内容 后面再探讨，这里先给出一个简单的示例： ?xml version=1.0 encoding=UTF-8 ? !DOCTYPE configuration PUBLIC -////DTD Config 3.0//EN /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 代码和映射定义信息）。 不使用 XML 构建 SqlSessionFactory 如果你更愿意直接从 Java 程序而不是 XML 文件中创建 configuration ，或者创建你自己的 configuration 构建器， MyBa