<?xml version="1.0" encoding="UTF-8"?>
<!--

    Copyright ${license.git.copyrightYears} the original author or authors.

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

-->
<document xmlns="http://maven.apache.org/XDOC/2.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">

  <properties>
    <title>MyBatis-Spring | 简介</title>
    <author email="hpresnall@gmail.com">Hunter Presnall</author>
    <author email="eduardo.macarron@gmail.com">Eduardo Macarron</author>
    <author email="nanlei1987@gmail.com">Nan Lei</author>
  </properties>

 <body>
 <section name="简介">
  <subsection name="什么是 MyBatis-Spring？">
      <p>
        MyBatis-Spring 会帮助你将 MyBatis 代码无缝地整合到 Spring 中。它将允许 MyBatis 参与到 Spring 的事务管理之中，创建映射器 mapper 和 <code>SqlSession</code> 并注入到 bean 中，以及将 Mybatis 的异常转换为 Spring 的 <code>DataAccessException</code>。最终，可以做到应用代码不依赖于 MyBatis，Spring 或 MyBatis-Spring。
      </p>
  </subsection>

  <subsection name="动机">
      <p>
        Spring 2.0 只支持 iBatis 2.0。那么，我们就想将 MyBatis3 的支持添加到 Spring 3.0 中（参见 Spring Jira 中的<a href="https://jira.springsource.org/browse/SPR-5991">问题</a>）。不幸的是，Spring 3.0 的开发在 MyBatis 3.0 官方发布前就结束了。由于 Spring 开发团队不想发布一个基于未发布版的 MyBatis 的整合支持，如果要获得 Spring 官方的支持，只能等待下一次的发布了。基于在 Spring 中对 MyBatis 提供支持的兴趣，MyBatis 社区认为，应该开始召集有兴趣参与其中的贡献者们，将对 Spring 的集成作为 MyBatis 的一个社区子项目。
      </p>
  </subsection>

  <subsection name="知识基础">
    <p>
      在开始使用 MyBatis-Spring 之前，你需要先熟悉 Spring 和 MyBatis 这两个框架和有关它们的术语。这很重要——因为本手册中不会提供二者的基本内容，安装和配置教程。
    </p>
    <p>
      MyBatis-Spring 需要以下版本：
    </p>
    <table>
      <thead>
        <tr>
          <th>
            MyBatis-Spring
          </th>
          <th>
            MyBatis
          </th>
          <th>
            Spring 框架
          </th>
          <th>
            Spring Batch
          </th>
          <th>
            Java
          </th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>
            2.0
          </td>
          <td>
            3.5+
          </td>
          <td>
            5.0+
          </td>
          <td>
            4.0+
          </td>
          <td>
            Java 8+
          </td>
        </tr>
        <tr>
          <td>
            1.3
          </td>
          <td>
            3.4+
          </td>
          <td>
            3.2.2+
          </td>
          <td>
            2.1+
          </td>
          <td>
            Java 6+
          </td>
        </tr>
      </tbody>
    </table>
  </subsection>

  <subsection name="致谢">
    <p>
      特别感谢那些使本项目变为现实的人们（按字母顺序排序）： Eduardo Macarron, Hunter Presnall 和 Putthiphong Boonphong 负责本项目的代码实现，测试和编写文档工作；Andrius Juozapaitis, Giovanni Cuccu, Raj Nagappan 和 Tomas Pinos 的贡献；而 Simone Tripodi 发现了这些人并邀请他们参与到这一个 MyBatis 子项目之中。没有他们的努力，这个项目只能沦为空谈。
    </p>
  </subsection>
  
	<subsection name="帮助改进文档...">
		<p>
			如果你发现文档有任何的缺失，或者缺少某一个功能点的说明，最好的解决办法是先自己学习，并且为缺失的部份补上相应的文档。
		</p>
		<p>
      手册的 xdoc 出自<a href="https://github.com/mybatis/spring/tree/master/src/site">项目的 Git 仓库</a>。Fork 仓库，更新它并提交 Pull Request 吧。
		</p>
		<p>
			还有其它像你一样的人都需要阅读这份文档，而你，就是这份文档最好的作者。
		</p>
	</subsection>
   <subsection name="文档的翻译版本">
     <p>可以阅读以下 MyBatis-Spring 文档的翻译版本：</p>
     <ul class="i18n">
       <li class="en"><a href="./../index.html">English</a></li>
       <li class="es"><a href="./../es/index.html">Español</a></li>
       <li class="ja"><a href="./../ja/index.html">日本語</a></li>
       <li class="ko"><a href="./../ko/index.html">한국어</a></li>
       <li class="zh"><a href="./../zh/getting-started.html">简体中文</a></li>
     </ul>
     <p>想用自己的母语阅读这篇文档吗？那就用你的母语翻译它吧！</p>
   </subsection>

 </section>
  </body>

</document>
