mybatis的JAVA API.docx

Java API既然你已经知道如何配置 MyBatis 和创建映射文件,你就已经准备好来提升技能了。 MyBatis 的 Java API 就是你收获你所做的努力的地方。正如你即将看到的,和 JDBC 相比, MyBatis 很大程度简化了你的代码而且保持简洁,很容易理解和维护。MyBatis 3 已经引入了很多重要的改进来使得 SQL 映射更加优秀。应用目录结构在我们深入 Java API 之前,理解关于目录结构的最佳实践是很重要的。MyBatis 非常灵活, 你可以用你自己的文件来做几乎所有的事情。但是对于任一框架, 都有一些最佳的方式。让我们看一下典型应用的目录结构:/my_application /bin /devlib/lib -- MyBatis *.jar文件在这里。 /src /org/myapp/ /action/data -- MyBatis配置文件在这里, 包括映射器类, XML配置, XML映射文件。 /mybatis-config.xml /BlogMapper.java /BlogMapper.xml /model /service /view/properties -- 在你XML中配置的属性文件在这里。 /test /org/myapp/ /action /data /model /service /view /properties /web /WEB-INF /web.xml当然这是推荐的目录结构，并非强制要求，但是使用一个通用的目录结构将更利于大家沟通。这部分内容剩余的示例将假设你使用了这种目录结构。SqlSessions使用 MyBatis 的主要 Java 接口就是 SqlSession。尽管你可以使用这个接口执行命令,获取映射器和管理事务。我们会讨论 SqlSession 本身更多,但是首先我们还是要了解如何获取一个 SqlSession 实例。SqlSessions 是由 SqlSessionFactory 实例创建的。SqlSessionFactory 对象包含创建 SqlSession 实例的所有方法。而 SqlSessionFactory 本身是由 SqlSessionFactoryBuilder 创建的,它可以从 XML 配置,注解或手动配置 Java 来创建 SqlSessionFactory。注意?当Mybatis与一些依赖注入框架（如Spring或者Guice）同时使用时，SqlSessions将被依赖注入框架所创建，所以你不需要使用SqlSessionFactoryBuilder或者SqlSessionFactory，可以直接看SqlSession这一节。请参考Mybatis-Spring或者Mybatis-Guice手册了解更多信息。SqlSessionFactoryBuilderSqlSessionFactoryBuilder 有五个 build()方法,每一种都允许你从不同的资源中创建一个 SqlSession 实例。SqlSessionFactory build(InputStream inputStream)SqlSessionFactory build(InputStream inputStream,String environment)SqlSessionFactory build(InputStream inputStream,Properties properties)SqlSessionFactory build(InputStream inputStream,String env,Properties props)SqlSessionFactory build(Configuration config)第一种方法是最常用的,它使用了一个参照了 XML 文档或上面讨论过的更特定的 mybatis-config.xml 文件的 Reader 实例。可选的参数是 environment 和 properties。 Environment 决定加载哪种环境,包括数据源和事务管理器。比如:environmentsdefault=developmentenvironmentid=developmenttransactionManagertype=JDBC ...dataSourcetype=POOLED .../environmentenvironmentid=productiontransact