11

.gitattributes

+# Set default behaviour, in case users don't have core.autocrlf set.
+* text=auto
\ No newline at end of file

.gitignore

+/*.iml
+/*.ipr
+/*.iws
+/.classpath
+/.idea
+/.project
+/.settings
+/ibderby
+/nb*
+/release.properties
+/target
+/test.db.lck
+/test.db.log
+/test.db.properties
+/test.db.script
+/test.db.tmp
+/src/docbkx
+velocity.log
+/bin
+/derby.log

.travis.yml

+language: java
+jdk:
+  - oraclejdk8
+  - oraclejdk7
+  - openjdk7
+  - openjdk6
+after_success:
+  - "mvn clean"
+  - "git clone -b travis `git config --get remote.origin.url` target/travis"
+  - "mvn deploy -Dmaven.test.skip=true --settings target/travis/settings.xml"
+
+branches:
+  except:
+    - travis
+
+env:
+  global:
+    - secure: "jWLfOryabB89R5v7nD3V/8ke6+B26UW8E5wjwKj7dDhjfmGUg+KbOShqWrq4\nEAnyE4GltwDLxKErZ5aAPWcT47C3GJYocKtmTcec2sblqMdVVUd3udylrM1d\n66Yb0XZoqri9JJ9pb8ObDp5XRV+ZQ5xP0w1gboNY6SynJg/1FKk="
+    - secure: "UV14rAITDqou5jObPInlIS3IYdf45LihGal9/+C4TLyhXLaVktbT/arFAAIF\ndpv9OM+YgeA7ZeRZLJ8vbgipO+rxizPNL1DqK1rp9s5B2F2y9+ir47nTwayL\n0RN7TgdswjzZZKOukWF2CVK1hjk+n8iFkCrorU22trmXlHc0aoE="

CONTRIBUTING.md

+## If you have a question or need any help...
+
+Please use [the mailing list](http://groups.google.com/group/mybatis-user) instead of creating issues on the tracker. Thank you!
+
+## Reporting a bug
+
+- Create a new issue on [the tracker](https://github.com/mybatis/mybatis-3/issues).
+- The best way to report a bug is to create a failing test case. Please see the [Contributing code](CONTRIBUTING.md#contributing-code) section.
+
+## Proposing a new feature
+
+- It is a good idea to discuss your changes on [the mailing list](http://groups.google.com/group/mybatis-user) to get feedback from the community.
+- If you have a patch with unit tests, send a pull request. Please see the [Contributing code](CONTRIBUTING.md#contributing-code) section.
+
+
+## Improving documentation
+
+- Documentations are placed under [src/site](https://github.com/mybatis/mybatis-3/tree/master/src/site) directory in [the xdoc format](http://maven.apache.org/doxia/references/xdoc-format.html), so it is basically the same as creating a patch to contribute documentation changes. Please see the [Contributing code](CONTRIBUTING.md#contributing-code) section.
+
+## Contributing code
+
+### Copyright and License
+
+- You are the author of your contributions and will always be.
+- Everything you can find it this project is licensed under the Apache Software License 2.0
+- Every contribution you do must be licensed under the Apache Software License 2.0. Otherwise we will not be able to accept it.
+- Please make sure that all the new files you create hold the following header:
+
+```
+/*
+ *    Copyright [year] 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.
+ */
+```
+
+### How to send your modifications as a pull request
+
+The best way to submit a patch is to send a pull request.  
+Here are the steps of a typical workflow.
+
+1. Fork the repository on GitHub.
+2. Clone your fork to your local machine.
+3. Create a topic branch with a descriptive name.
+4. Make changes with unit tests in the topic branch.
+5. Push commits to your fork on GitHub.
+6. Send a [pull request](https://help.github.com/articles/using-pull-requests).
+
+For steps 1 to 3, please read [this GitHub help](https://help.github.com/articles/fork-a-repo) if you are not familiar with these operations.  
+Step 4 and 5 are basic [git](http://git-scm.com/) operations. Please see the [online documentation](http://git-scm.com/documentation) for its usage.
+
+For how to write a unit test, please see the [unit test](Unit-Test) page.

ICLA

+                             MyBatis
+     Individual Contributor License Agreement ("Agreement") V2.0
+           https://mybatis.googlecode.com/svn/trunk/ICLA
+
+Thank you for your interest in MyBatis (the
+"Project"). In order to clarify the intellectual property license
+granted with Contributions from any person or entity, the Project
+must have a Contributor License Agreement ("CLA") on file that has
+been signed by each Contributor, indicating agreement to the license
+terms below. This license is for your protection as a Contributor as
+well as the protection of the Project and its users; it does not
+change your rights to use your own Contributions for any other purpose.
+If you have not already done so, please complete and sign, then scan
+and email a PDF file of this Agreement to an existing member of the 
+Project (preferrably the person who invited you)for filing. Please 
+read this document carefully before signing and keep a copy for your 
+records.
+
+  Full name: ______________________________________________________
+
+  (optional) Public name: _________________________________________
+
+  Mailing Address: ________________________________________________
+
+                   ________________________________________________
+
+  Country:   ______________________________________________________
+
+  Telephone: ______________________________________________________
+
+  E-Mail:    ______________________________________________________
+
+
+You accept and agree to the following terms and conditions for Your
+previous, present and future Contributions submitted to the Project. 
+In return, the Project shall not use Your Contributions in a way that
+is contrary to the public benefit or inconsistent with its nonprofit
+status and bylaws in effect at the time of the Contribution. Except
+for the license granted herein to the Project and recipients of
+software distributed by the Project, You reserve all right, title,
+and interest in and to Your Contributions.
+
+1. Definitions.
+
+   "You" (or "Your") shall mean the copyright owner or legal entity
+   authorized by the copyright owner that is making this Agreement
+   with the Project. For legal entities, the entity making a
+   Contribution and all other entities that control, are controlled
+   by, or are under common control with that entity are considered to
+   be a single Contributor. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "Contribution" shall mean any original work of authorship,
+   including any modifications or additions to an existing work, that
+   is intentionally submitted by You to the Project for inclusion
+   in, or documentation of, any of the products owned or managed by
+   the Project (the "Work"). For the purposes of this definition,
+   "submitted" means any form of electronic, verbal, or written
+   communication sent to the Project or its representatives,
+   including but not limited to communication on electronic mailing
+   lists, source code control systems, and issue tracking systems that
+   are managed by, or on behalf of, the Project for the purpose of
+   discussing and improving the Work, but excluding communication that
+   is conspicuously marked or otherwise designated in writing by You
+   as "Not a Contribution."
+   
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this Agreement, You hereby grant to the Project and to
+   recipients of software distributed by the Project a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare derivative works of,
+   publicly display, publicly perform, sublicense, and distribute Your
+   Contributions and such derivative works.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this Agreement, You hereby grant to the Project and to
+   recipients of software distributed by the Project a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have
+   made, use, offer to sell, sell, import, and otherwise transfer the
+   Work, where such license applies only to those patent claims
+   licensable by You that are necessarily infringed by Your
+   Contribution(s) alone or by combination of Your Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If any
+   entity institutes patent litigation against You or any other entity
+   (including a cross-claim or counterclaim in a lawsuit) alleging
+   that your Contribution, or the Work to which you have contributed,
+   constitutes direct or contributory patent infringement, then any
+   patent licenses granted to that entity under this Agreement for
+   that Contribution or Work shall terminate as of the date such
+   litigation is filed.
+
+4. You represent that you are legally entitled to grant the above
+   license. If your employer(s) has rights to intellectual property
+   that you create that includes your Contributions, you represent
+   that you have received permission to make Contributions on behalf
+   of that employer, that your employer has waived such rights for
+   your Contributions to the Project, or that your employer has
+   executed a separate Corporate CLA with the Project.
+
+5. You represent that each of Your Contributions is Your original
+   creation (see section 7 for submissions on behalf of others).  You
+   represent that Your Contribution submissions include complete
+   details of any third-party license or other restriction (including,
+   but not limited to, related patents and trademarks) of which you
+   are personally aware and which are associated with any part of Your
+   Contributions.
+
+6. You are not expected to provide support for Your Contributions,
+   except to the extent You desire to provide support. You may provide
+   support for free, for a fee, or not at all. Unless required by
+   applicable law or agreed to in writing, You provide Your
+   Contributions on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+   OF ANY KIND, either express or implied, including, without
+   limitation, any warranties or conditions of TITLE, NON-
+   INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+7. Should You wish to submit work that is not Your original creation,
+   You may submit it to the Project separately from any
+   Contribution, identifying the complete details of its source and of
+   any license or other restriction (including, but not limited to,
+   related patents, trademarks, and license agreements) of which you
+   are personally aware, and conspicuously marking the work as
+   "Submitted on behalf of a third-party: [named here]".
+
+8. You agree to notify the Project of any facts or circumstances of
+   which you become aware that would make these representations
+   inaccurate in any respect.
+
+Please sign: __________________________________ Date: ________________

NOTICE

+iBATIS
+   This product includes software developed by
+   The Apache Software Foundation (http://www.apache.org/).
+
+   Copyright 2010 The Apache Software Foundation
+
+   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.
+
+OGNL
+//--------------------------------------------------------------------------
+//  Copyright (c) 2004, Drew Davidson and Luke Blanshard
+//  All rights reserved.
+//
+//  Redistribution and use in source and binary forms, with or without
+//  modification, are permitted provided that the following conditions are
+//  met:
+//
+//  Redistributions of source code must retain the above copyright notice,
+//  this list of conditions and the following disclaimer.
+//  Redistributions in binary form must reproduce the above copyright
+//  notice, this list of conditions and the following disclaimer in the
+//  documentation and/or other materials provided with the distribution.
+//  Neither the name of the Drew Davidson nor the names of its contributors
+//  may be used to endorse or promote products derived from this software
+//  without specific prior written permission.
+//
+//  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+//  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+//  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+//  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+//  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+//  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+//  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+//  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+//  AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+//  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+//  THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+//  DAMAGE.
+//--------------------------------------------------------------------------
+
+Refactored SqlBuilder class (SQL, AbstractSQL)
+
+   This product includes software developed by
+   Adam Gent (https://gist.github.com/3650165)
+
+   Copyright 2010 Adam Gent
+
+   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.

README

+mybatis源码中文注释版
+
+阅读准备参考：https://www.jianshu.com/p/e739afb8fe31
+需要导入模块：需要将mybatis-parent模块导入。mybatis-parent模块链接 https://github.com/mybatis/parent
+
+1.兵马未动，日志先行
+org.apache.ibatis.logging
+org.apache.ibatis.logging.commons
+org.apache.ibatis.logging.jdbc
+org.apache.ibatis.logging.jdk14
+org.apache.ibatis.logging.log4j
+org.apache.ibatis.logging.log4j2
+org.apache.ibatis.logging.nologging
+org.apache.ibatis.logging.slf4j
+org.apache.ibatis.logging.stdout
+对象适配器设计模式
+设计模式可参考http://www.cnblogs.com/liuling/archive/2013/04/12/adapter.html
+
+2.异常
+org.apache.ibatis.exceptions
+
+3.缓存
+org.apache.ibatis.cache
+org.apache.ibatis.cache.decorators
+org.apache.ibatis.cache.impl
+
+4.解析
+org.apache.ibatis.parsing
+xml解析，${} 格式的字符串解析
+源码分析可以参考http://www.cnblogs.com/sunzhenchao/p/3161093.html
+
+5.类型处理器
+org.apache.ibatis.type
+实现java和jdbc中的类型之间转换
+源码分析可以参考http://www.cnblogs.com/sunzhenchao/archive/2013/04/09/3009431.html
+
+6.IO
+org.apache.ibatis.io
+通过类加载器在jar包中寻找一个package下满足条件(比如某个接口的子类)的所有类
+
+7.反射
+org.apache.ibatis.reflection
+org.apache.ibatis.reflection.factory
+org.apache.ibatis.reflection.invoker
+org.apache.ibatis.reflection.property
+org.apache.ibatis.reflection.wrapper
+可以参考MetaObjectTest来跟踪调试，基本上用到了reflection包下所有的类
+
+8.数据源
+org.apache.ibatis.datasource
+org.apache.ibatis.datasource.jndi
+org.apache.ibatis.datasource.pooled
+org.apache.ibatis.datasource.unpooled
+
+9.事务
+org.apache.ibatis.transaction
+org.apache.ibatis.transaction.jdbc
+org.apache.ibatis.transaction.managed
+
+10.会话
+org.apache.ibatis.session
+org.apache.ibatis.session.defaults
+
+11.jdbc单元测试工具
+org.apache.ibatis.jdbc
+
+12.构建
+org.apache.ibatis.builder
+org.apache.ibatis.builder.annotation
+org.apache.ibatis.builder.xml
+
+13.映射
+org.apache.ibatis.mapping
+
+14.脚本
+org.apache.ibatis.scripting
+org.apache.ibatis.scripting.defaults
+org.apache.ibatis.scripting.xmltags
+
+15.注解
+org.apache.ibatis.annotations
+
+16.绑定
+org.apache.ibatis.binding
+
+17.执行器
+org.apache.ibatis.executor
+org.apache.ibatis.executor.keygen
+org.apache.ibatis.executor.loader
+org.apache.ibatis.executor.loader.cglib
+org.apache.ibatis.executor.loader.javassist
+org.apache.ibatis.executor.parameter
+org.apache.ibatis.executor.result
+org.apache.ibatis.executor.resultset
+org.apache.ibatis.executor.statement
+
+18.插件
+org.apache.ibatis.plugin
+
+

src/main/java/org/apache/ibatis/annotations/Arg.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.TypeHandler;
+import org.apache.ibatis.type.UnknownTypeHandler;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Arg {
+  boolean id() default false;
+
+  String column() default "";
+
+  Class<?> javaType() default void.class;
+
+  JdbcType jdbcType() default JdbcType.UNDEFINED;
+
+  Class<? extends TypeHandler<?>> typeHandler() default UnknownTypeHandler.class;
+
+  String select() default "";
+
+  String resultMap() default "";
+}

src/main/java/org/apache/ibatis/annotations/CacheNamespace.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.cache.decorators.LruCache;
+import org.apache.ibatis.cache.impl.PerpetualCache;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.TYPE)
+public @interface CacheNamespace {
+  Class<? extends org.apache.ibatis.cache.Cache> implementation() default PerpetualCache.class;
+
+  Class<? extends org.apache.ibatis.cache.Cache> eviction() default LruCache.class;
+
+  long flushInterval() default 0;
+
+  int size() default 1024;
+
+  boolean readWrite() default true;
+  
+  boolean blocking() default false;
+  
+}

src/main/java/org/apache/ibatis/annotations/CacheNamespaceRef.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.TYPE)
+public @interface CacheNamespaceRef {
+  Class<?> value();
+}

src/main/java/org/apache/ibatis/annotations/Case.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Case {
+  String value();
+
+  Class<?> type();
+
+  Result[] results() default {};
+
+  Arg[] constructArgs() default {};
+}

src/main/java/org/apache/ibatis/annotations/ConstructorArgs.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ConstructorArgs {
+  Arg[] value() default {};
+}

src/main/java/org/apache/ibatis/annotations/Delete.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Delete {
+  String[] value();
+}

src/main/java/org/apache/ibatis/annotations/DeleteProvider.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface DeleteProvider {
+  Class<?> type();
+
+  String method();
+}

src/main/java/org/apache/ibatis/annotations/Insert.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Insert {
+  String[] value();
+}

src/main/java/org/apache/ibatis/annotations/InsertProvider.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface InsertProvider {
+  Class<?> type();
+
+  String method();
+}

src/main/java/org/apache/ibatis/annotations/Lang.java

+/*
+ *    Copyright 2012 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Lang {
+  Class<?> value();
+}

src/main/java/org/apache/ibatis/annotations/Many.java

+/*
+ *    Copyright 2009-2014 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.mapping.FetchType;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Many {
+  String select() default "";
+
+  FetchType fetchType() default FetchType.DEFAULT;
+
+}

src/main/java/org/apache/ibatis/annotations/MapKey.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface MapKey {
+  String value();
+}

src/main/java/org/apache/ibatis/annotations/One.java

+/*
+ *    Copyright 2009-2014 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.mapping.FetchType;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface One {
+  String select() default "";
+
+  FetchType fetchType() default FetchType.DEFAULT;
+
+}

src/main/java/org/apache/ibatis/annotations/Options.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.mapping.ResultSetType;
+import org.apache.ibatis.mapping.StatementType;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Options {
+  boolean useCache() default true;
+
+  boolean flushCache() default false;
+
+  ResultSetType resultSetType() default ResultSetType.FORWARD_ONLY;
+
+  StatementType statementType() default StatementType.PREPARED;
+
+  int fetchSize() default -1;
+
+  int timeout() default -1;
+
+  boolean useGeneratedKeys() default false;
+
+  String keyProperty() default "id";
+
+  String keyColumn() default "";
+}

src/main/java/org/apache/ibatis/annotations/Param.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.PARAMETER)
+public @interface Param {
+  String value();
+}

src/main/java/org/apache/ibatis/annotations/Result.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.TypeHandler;
+import org.apache.ibatis.type.UnknownTypeHandler;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Result {
+  boolean id() default false;
+
+  String column() default "";
+
+  String property() default "";
+
+  Class<?> javaType() default void.class;
+
+  JdbcType jdbcType() default JdbcType.UNDEFINED;
+
+  Class<? extends TypeHandler<?>> typeHandler() default UnknownTypeHandler.class;
+
+  One one() default @One;
+
+  Many many() default @Many;
+}

src/main/java/org/apache/ibatis/annotations/ResultMap.java

+/*
+ *    Copyright 2009-2013 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Jeff Butler
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ResultMap {
+  String[] value();
+}

src/main/java/org/apache/ibatis/annotations/ResultType.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This annotation can be used when a @Select method is using a
+ * ResultHandler.  Those methods must have void return type, so
+ * this annotation can be used to tell MyBatis what kind of object
+ * it should build for each row.
+ * 
+ * @since 3.2.0
+ * @author Jeff Butler
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ResultType {
+  Class<?> value();
+}

src/main/java/org/apache/ibatis/annotations/Results.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Results {
+  Result[] value() default {};
+}

src/main/java/org/apache/ibatis/annotations/Select.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Select {
+  String[] value();
+}

src/main/java/org/apache/ibatis/annotations/SelectKey.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.mapping.StatementType;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface SelectKey {
+  String[] statement();
+
+  String keyProperty();
+
+  String keyColumn() default "";
+
+  boolean before();
+
+  Class<?> resultType();
+
+  StatementType statementType() default StatementType.PREPARED;
+}

src/main/java/org/apache/ibatis/annotations/SelectProvider.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface SelectProvider {
+  Class<?> type();
+
+  String method();
+}

src/main/java/org/apache/ibatis/annotations/TypeDiscriminator.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.TypeHandler;
+import org.apache.ibatis.type.UnknownTypeHandler;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface TypeDiscriminator {
+  String column();
+
+  Class<?> javaType() default void.class;
+
+  JdbcType jdbcType() default JdbcType.UNDEFINED;
+
+  Class<? extends TypeHandler<?>> typeHandler() default UnknownTypeHandler.class;
+
+  Case[] cases();
+}

src/main/java/org/apache/ibatis/annotations/Update.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface Update {
+  String[] value();
+}

src/main/java/org/apache/ibatis/annotations/UpdateProvider.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author Clinton Begin
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface UpdateProvider {
+  Class<?> type();
+
+  String method();
+}

src/main/java/org/apache/ibatis/annotations/package-info.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+
+/**
+ * Contains all the annotation that are used in mapper interfaces
+ */
+package org.apache.ibatis.annotations;
+

src/main/java/org/apache/ibatis/binding/BindingException.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.binding;
+
+import org.apache.ibatis.exceptions.PersistenceException;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 绑定例外，当Map中查不到对应的key时，抛此异常
+ * 当重复添加映射时，也抛此异常
+ * 当绑定Mapper中某个方法出错，也抛此异常
+ */
+public class BindingException extends PersistenceException {
+
+  private static final long serialVersionUID = 4300802238789381562L;
+
+  public BindingException() {
+    super();
+  }
+
+  public BindingException(String message) {
+    super(message);
+  }
+
+  public BindingException(String message, Throwable cause) {
+    super(message, cause);
+  }
+
+  public BindingException(Throwable cause) {
+    super(cause);
+  }
+}

src/main/java/org/apache/ibatis/binding/MapperProxy.java

+/*
+ *    Copyright 2009-2014 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.
+ */
+package org.apache.ibatis.binding;
+
+import java.io.Serializable;
+import java.lang.reflect.InvocationHandler;
+import java.lang.reflect.Method;
+import java.util.Map;
+
+import org.apache.ibatis.reflection.ExceptionUtil;
+import org.apache.ibatis.session.SqlSession;
+
+/**
+ * @author Clinton Begin
+ * @author Eduardo Macarron
+ */
+/**
+ * 映射器代理，代理模式
+ *
+ */
+public class MapperProxy<T> implements InvocationHandler, Serializable {
+
+  private static final long serialVersionUID = -6424540398559729838L;
+  private final SqlSession sqlSession;
+  private final Class<T> mapperInterface;
+  private final Map<Method, MapperMethod> methodCache;
+
+  public MapperProxy(SqlSession sqlSession, Class<T> mapperInterface, Map<Method, MapperMethod> methodCache) {
+    this.sqlSession = sqlSession;
+    this.mapperInterface = mapperInterface;
+    this.methodCache = methodCache;
+  }
+
+  @Override
+  public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
+    //代理以后，所有Mapper的方法调用时，都会调用这个invoke方法
+    //并不是任何一个方法都需要执行调用代理对象进行执行，如果这个方法是Object中通用的方法（toString、hashCode等）无需执行
+    if (Object.class.equals(method.getDeclaringClass())) {
+      try {
+        return method.invoke(this, args);
+      } catch (Throwable t) {
+        throw ExceptionUtil.unwrapThrowable(t);
+      }
+    }
+    //这里优化了，去缓存中找MapperMethod
+    final MapperMethod mapperMethod = cachedMapperMethod(method);
+    //执行
+    return mapperMethod.execute(sqlSession, args);
+  }
+
+  //去缓存中找MapperMethod
+  private MapperMethod cachedMapperMethod(Method method) {
+    MapperMethod mapperMethod = methodCache.get(method);
+    if (mapperMethod == null) {
+      //找不到才去new
+      mapperMethod = new MapperMethod(mapperInterface, method, sqlSession.getConfiguration());
+      methodCache.put(method, mapperMethod);
+    }
+    return mapperMethod;
+  }
+
+}

src/main/java/org/apache/ibatis/binding/MapperProxyFactory.java

+/*
+ *    Copyright 2009-2013 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.
+ */
+package org.apache.ibatis.binding;
+
+import java.lang.reflect.Method;
+import java.lang.reflect.Proxy;
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+import org.apache.ibatis.session.SqlSession;
+
+/**
+ * @author Lasse Voss
+ */
+/**
+ * 映射器代理工厂
+ */
+public class MapperProxyFactory<T> {
+
+  private final Class<T> mapperInterface;
+  private Map<Method, MapperMethod> methodCache = new ConcurrentHashMap<Method, MapperMethod>();
+
+  public MapperProxyFactory(Class<T> mapperInterface) {
+    this.mapperInterface = mapperInterface;
+  }
+
+  public Class<T> getMapperInterface() {
+    return mapperInterface;
+  }
+
+  public Map<Method, MapperMethod> getMethodCache() {
+    return methodCache;
+  }
+
+  @SuppressWarnings("unchecked")
+  protected T newInstance(MapperProxy<T> mapperProxy) {
+    //用JDK自带的动态代理生成映射器
+    return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[] { mapperInterface }, mapperProxy);
+  }
+
+  public T newInstance(SqlSession sqlSession) {
+    final MapperProxy<T> mapperProxy = new MapperProxy<T>(sqlSession, mapperInterface, methodCache);
+    return newInstance(mapperProxy);
+  }
+
+}

src/main/java/org/apache/ibatis/binding/MapperRegistry.java

+/*
+ *    Copyright 2009-2013 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.
+ */
+package org.apache.ibatis.binding;
+
+import org.apache.ibatis.builder.annotation.MapperAnnotationBuilder;
+import org.apache.ibatis.io.ResolverUtil;
+import org.apache.ibatis.session.Configuration;
+import org.apache.ibatis.session.SqlSession;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * @author Clinton Begin
+ * @author Eduardo Macarron
+ * @author Lasse Voss
+ */
+/**
+ * 映射器注册机
+ *
+ */
+public class MapperRegistry {
+
+  private Configuration config;
+  //将已经添加的映射都放入HashMap
+  private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new HashMap<Class<?>, MapperProxyFactory<?>>();
+
+  public MapperRegistry(Configuration config) {
+    this.config = config;
+  }
+
+  @SuppressWarnings("unchecked")
+  //返回代理类
+  public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
+    final MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory<T>) knownMappers.get(type);
+    if (mapperProxyFactory == null) {
+      throw new BindingException("Type " + type + " is not known to the MapperRegistry.");
+    }
+    try {
+      return mapperProxyFactory.newInstance(sqlSession);
+    } catch (Exception e) {
+      throw new BindingException("Error getting mapper instance. Cause: " + e, e);
+    }
+  }
+  
+  public <T> boolean hasMapper(Class<T> type) {
+    return knownMappers.containsKey(type);
+  }
+
+  //看一下如何添加一个映射
+  public <T> void addMapper(Class<T> type) {
+    //mapper必须是接口！才会添加
+    if (type.isInterface()) {
+      if (hasMapper(type)) {
+        //如果重复添加了，报错
+        throw new BindingException("Type " + type + " is already known to the MapperRegistry.");
+      }
+      boolean loadCompleted = false;
+      try {
+        knownMappers.put(type, new MapperProxyFactory<T>(type));
+        // It's important that the type is added before the parser is run
+        // otherwise the binding may automatically be attempted by the
+        // mapper parser. If the type is already known, it won't try.
+        MapperAnnotationBuilder parser = new MapperAnnotationBuilder(config, type);
+        parser.parse();
+        loadCompleted = true;
+      } finally {
+        //如果加载过程中出现异常需要再将这个mapper从mybatis中删除,这种方式比较丑陋吧，难道是不得已而为之？
+        if (!loadCompleted) {
+          knownMappers.remove(type);
+        }
+      }
+    }
+  }
+
+  /**
+   * @since 3.2.2
+   */
+  public Collection<Class<?>> getMappers() {
+    return Collections.unmodifiableCollection(knownMappers.keySet());
+  }
+
+  /**
+   * @since 3.2.2
+   */
+  public void addMappers(String packageName, Class<?> superType) {
+    //查找包下所有是superType的类
+    ResolverUtil<Class<?>> resolverUtil = new ResolverUtil<Class<?>>();
+    resolverUtil.find(new ResolverUtil.IsA(superType), packageName);
+    Set<Class<? extends Class<?>>> mapperSet = resolverUtil.getClasses();
+    for (Class<?> mapperClass : mapperSet) {
+      addMapper(mapperClass);
+    }
+  }
+
+  /**
+   * @since 3.2.2
+   */
+  //查找包下所有类
+  public void addMappers(String packageName) {
+    addMappers(packageName, Object.class);
+  }
+  
+}

src/main/java/org/apache/ibatis/binding/package-info.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+
+/**
+ * Bings mapper interfaces with mapped statements
+ */
+package org.apache.ibatis.binding;

src/main/java/org/apache/ibatis/builder/BaseBuilder.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.Set;
+import java.util.regex.Pattern;
+
+import org.apache.ibatis.mapping.ParameterMode;
+import org.apache.ibatis.mapping.ResultSetType;
+import org.apache.ibatis.session.Configuration;
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.TypeAliasRegistry;
+import org.apache.ibatis.type.TypeHandler;
+import org.apache.ibatis.type.TypeHandlerRegistry;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 构建器的基类，建造者模式
+ *
+ */
+public abstract class BaseBuilder {
+  //需要配置，类型别名注册，类型处理器注册3个东西
+  protected final Configuration configuration;
+  protected final TypeAliasRegistry typeAliasRegistry;
+  protected final TypeHandlerRegistry typeHandlerRegistry;
+
+  public BaseBuilder(Configuration configuration) {
+    this.configuration = configuration;
+    this.typeAliasRegistry = this.configuration.getTypeAliasRegistry();
+    this.typeHandlerRegistry = this.configuration.getTypeHandlerRegistry();
+  }
+
+  public Configuration getConfiguration() {
+    return configuration;
+  }
+
+  protected Pattern parseExpression(String regex, String defaultValue) {
+    return Pattern.compile(regex == null ? defaultValue : regex);
+  }
+
+  protected Boolean booleanValueOf(String value, Boolean defaultValue) {
+    return value == null ? defaultValue : Boolean.valueOf(value);
+  }
+
+  protected Integer integerValueOf(String value, Integer defaultValue) {
+    return value == null ? defaultValue : Integer.valueOf(value);
+  }
+
+  //把以逗号分割的一个字符串重新包装，返回一个Set
+  protected Set<String> stringSetValueOf(String value, String defaultValue) {
+    value = (value == null ? defaultValue : value);
+    return new HashSet<String>(Arrays.asList(value.split(",")));
+  }
+
+  //解析JdbcType
+  protected JdbcType resolveJdbcType(String alias) {
+    if (alias == null) {
+      return null;
+    }
+    try {
+      return JdbcType.valueOf(alias);
+    } catch (IllegalArgumentException e) {
+      throw new BuilderException("Error resolving JdbcType. Cause: " + e, e);
+    }
+  }
+
+  //解析ResultSetType
+  protected ResultSetType resolveResultSetType(String alias) {
+    if (alias == null) {
+      return null;
+    }
+    try {
+      return ResultSetType.valueOf(alias);
+    } catch (IllegalArgumentException e) {
+      throw new BuilderException("Error resolving ResultSetType. Cause: " + e, e);
+    }
+  }
+
+  //解析ParameterMode(SP的IN/OUT/INOUT)
+  protected ParameterMode resolveParameterMode(String alias) {
+    if (alias == null) {
+      return null;
+    }
+    try {
+      return ParameterMode.valueOf(alias);
+    } catch (IllegalArgumentException e) {
+      throw new BuilderException("Error resolving ParameterMode. Cause: " + e, e);
+    }
+  }
+
+  //根据别名解析Class，然后创建实例
+  protected Object createInstance(String alias) {
+    Class<?> clazz = resolveClass(alias);
+    if (clazz == null) {
+      return null;
+    }
+    try {
+      return resolveClass(alias).newInstance();
+    } catch (Exception e) {
+      throw new BuilderException("Error creating instance. Cause: " + e, e);
+    }
+  }
+
+  //根据别名解析Class,其实是去查看 类型别名注册/事务管理器别名
+  protected Class<?> resolveClass(String alias) {
+    if (alias == null) {
+      return null;
+    }
+    try {
+      return resolveAlias(alias);
+    } catch (Exception e) {
+      throw new BuilderException("Error resolving class. Cause: " + e, e);
+    }
+  }
+
+  //解析类型处理器
+  protected TypeHandler<?> resolveTypeHandler(Class<?> javaType, String typeHandlerAlias) {
+    if (typeHandlerAlias == null) {
+      return null;
+    }
+    //先取得别名所属的Class
+    Class<?> type = resolveClass(typeHandlerAlias);
+    //如果不是TypeHandler的子类,报错
+    if (type != null && !TypeHandler.class.isAssignableFrom(type)) {
+      throw new BuilderException("Type " + type.getName() + " is not a valid TypeHandler because it does not implement TypeHandler interface");
+    }
+    @SuppressWarnings( "unchecked" ) // already verified it is a TypeHandler
+    Class<? extends TypeHandler<?>> typeHandlerType = (Class<? extends TypeHandler<?>>) type;
+    //再去调用另一个重载的方法
+    return resolveTypeHandler(javaType, typeHandlerType);
+  }
+
+  protected TypeHandler<?> resolveTypeHandler(Class<?> javaType, Class<? extends TypeHandler<?>> typeHandlerType) {
+    if (typeHandlerType == null) {
+      return null;
+    }
+    // javaType ignored for injected handlers see issue #746 for full detail
+    //去typeHandlerRegistry查询对应的TypeHandler
+    TypeHandler<?> handler = typeHandlerRegistry.getMappingTypeHandler(typeHandlerType);
+    if (handler == null) {
+      // not in registry, create a new one
+        //如果没有在Registry找到，调用typeHandlerRegistry.getInstance来new一个TypeHandler返回
+      handler = typeHandlerRegistry.getInstance(javaType, typeHandlerType);
+    }
+    return handler;
+  }
+
+  protected Class<?> resolveAlias(String alias) {
+    return typeAliasRegistry.resolveAlias(alias);
+  }
+}

src/main/java/org/apache/ibatis/builder/BuilderException.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+import org.apache.ibatis.exceptions.PersistenceException;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 构建异常,继承PersistenceException，没啥好说的，就是语义分类
+ * 
+ */
+public class BuilderException extends PersistenceException {
+
+  private static final long serialVersionUID = -3885164021020443281L;
+
+  public BuilderException() {
+    super();
+  }
+
+  public BuilderException(String message) {
+    super(message);
+  }
+
+  public BuilderException(String message, Throwable cause) {
+    super(message, cause);
+  }
+
+  public BuilderException(Throwable cause) {
+    super(cause);
+  }
+}

src/main/java/org/apache/ibatis/builder/CacheRefResolver.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+import org.apache.ibatis.cache.Cache;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 缓存引用解析器
+ *
+ */
+public class CacheRefResolver {
+  private final MapperBuilderAssistant assistant;
+  private final String cacheRefNamespace;
+
+  public CacheRefResolver(MapperBuilderAssistant assistant, String cacheRefNamespace) {
+    this.assistant = assistant;
+    this.cacheRefNamespace = cacheRefNamespace;
+  }
+
+  public Cache resolveCacheRef() {
+      //反调MapperBuilderAssistant解析
+    return assistant.useCacheRef(cacheRefNamespace);
+  }
+}
\ No newline at end of file

src/main/java/org/apache/ibatis/builder/IncompleteElementException.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+/**
+ * @author Eduardo Macarron
+ */
+/**
+ * 元素不全异常,比如XMLIncludeTransformer里使用
+ *
+ */
+public class IncompleteElementException extends BuilderException {
+  private static final long serialVersionUID = -3697292286890900315L;
+
+  public IncompleteElementException() {
+    super();
+  }
+
+  public IncompleteElementException(String message, Throwable cause) {
+    super(message, cause);
+  }
+
+  public IncompleteElementException(String message) {
+    super(message);
+  }
+
+  public IncompleteElementException(Throwable cause) {
+    super(cause);
+  }
+
+}

src/main/java/org/apache/ibatis/builder/ParameterExpression.java

+/*
+ * Copyright 2012-2013 MyBatis.org.
+ *
+ * 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.
+ */
+package org.apache.ibatis.builder;
+
+import java.util.HashMap;
+
+/**
+ * Inline parameter expression parser. Supported grammar (simplified):
+ * 
+ * <pre>
+ * inline-parameter = (propertyName | expression) oldJdbcType attributes
+ * propertyName = /expression language's property navigation path/
+ * expression = '(' /expression language's expression/ ')'
+ * oldJdbcType = ':' /any valid jdbc type/
+ * attributes = (',' attribute)*
+ * attribute = name '=' value
+ * </pre>
+ */
+/**
+ * @author Frank D. Martinez [mnesarco]
+ */
+/**
+ * 参数表达式,继承自HashMap，可以参考ParameterExpressionTest
+ *
+ */
+public class ParameterExpression extends HashMap<String, String> {
+
+  private static final long serialVersionUID = -2417552199605158680L;
+
+  public ParameterExpression(String expression) {
+    parse(expression);
+  }
+
+  private void parse(String expression) {
+    //#{property,javaType=int,jdbcType=NUMERIC}
+    //首先去除空白,返回的p是第一个不是空白的字符位置
+    int p = skipWS(expression, 0);
+    if (expression.charAt(p) == '(') {
+        //处理表达式
+      expression(expression, p + 1);
+    } else {
+        //处理属性
+      property(expression, p);
+    }
+  }
+
+  //表达式可能是3.2的新功能，可以先不管
+  private void expression(String expression, int left) {
+    int match = 1;
+    int right = left + 1;
+    while (match > 0) {
+      if (expression.charAt(right) == ')') {
+        match--;
+      } else if (expression.charAt(right) == '(') {
+        match++;
+      }
+      right++;
+    }
+    put("expression", expression.substring(left, right - 1));
+    jdbcTypeOpt(expression, right);
+  }
+
+  private void property(String expression, int left) {
+    //#{property,javaType=int,jdbcType=NUMERIC}
+    //property:VARCHAR
+    if (left < expression.length()) {
+      //首先，得到逗号或者冒号之前的字符串，加入到property
+      int right = skipUntil(expression, left, ",:");
+      put("property", trimmedStr(expression, left, right));
+      //第二，处理javaType，jdbcType
+      jdbcTypeOpt(expression, right);
+    }
+  }
+
+  private int skipWS(String expression, int p) {
+    for (int i = p; i < expression.length(); i++) {
+      if (expression.charAt(i) > 0x20) {
+        return i;
+      }
+    }
+    return expression.length();
+  }
+
+  private int skipUntil(String expression, int p, final String endChars) {
+    for (int i = p; i < expression.length(); i++) {
+      char c = expression.charAt(i);
+      if (endChars.indexOf(c) > -1) {
+        return i;
+      }
+    }
+    return expression.length();
+  }
+
+  private void jdbcTypeOpt(String expression, int p) {
+      //#{property,javaType=int,jdbcType=NUMERIC}
+      //property:VARCHAR
+    //首先去除空白,返回的p是第一个不是空白的字符位置
+    p = skipWS(expression, p);
+    if (p < expression.length()) {
+        //第一个property解析完有两种情况，逗号和冒号
+      if (expression.charAt(p) == ':') {
+        jdbcType(expression, p + 1);
+      } else if (expression.charAt(p) == ',') {
+        option(expression, p + 1);
+      } else {
+        throw new BuilderException("Parsing error in {" + new String(expression) + "} in position " + p);
+      }
+    }
+  }
+
+  private void jdbcType(String expression, int p) {
+      //property:VARCHAR
+    int left = skipWS(expression, p);
+    int right = skipUntil(expression, left, ",");
+    if (right > left) {
+      put("jdbcType", trimmedStr(expression, left, right));
+    } else {
+      throw new BuilderException("Parsing error in {" + new String(expression) + "} in position " + p);
+    }
+    option(expression, right + 1);
+  }
+
+  private void option(String expression, int p) {
+      //#{property,javaType=int,jdbcType=NUMERIC}
+    int left = skipWS(expression, p);
+    if (left < expression.length()) {
+      int right = skipUntil(expression, left, "=");
+      String name = trimmedStr(expression, left, right);
+      left = right + 1;
+      right = skipUntil(expression, left, ",");
+      String value = trimmedStr(expression, left, right);
+      put(name, value);
+      //递归调用option，进行逗号后面一个属性的解析
+      option(expression, right + 1);
+    }
+  }
+
+  private String trimmedStr(String str, int start, int end) {
+    while (str.charAt(start) <= 0x20) {
+      start++;
+    }
+    while (str.charAt(end - 1) <= 0x20) {
+      end--;
+    }
+    return start >= end ? "" : str.substring(start, end);
+  }
+
+}

src/main/java/org/apache/ibatis/builder/ResultMapResolver.java

+/*
+ *    Copyright 2009-2011 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.
+ */
+package org.apache.ibatis.builder;
+
+import java.util.List;
+
+import org.apache.ibatis.mapping.Discriminator;
+import org.apache.ibatis.mapping.ResultMap;
+import org.apache.ibatis.mapping.ResultMapping;
+
+/**
+ * @author Eduardo Macarron
+ */
+/**
+ * 结果映射解析器
+ *
+ */
+public class ResultMapResolver {
+  private final MapperBuilderAssistant assistant;
+  private String id;
+  private Class<?> type;
+  private String extend;
+  private Discriminator discriminator;
+  private List<ResultMapping> resultMappings;
+  private Boolean autoMapping;
+
+  public ResultMapResolver(MapperBuilderAssistant assistant, String id, Class<?> type, String extend, Discriminator discriminator, List<ResultMapping> resultMappings, Boolean autoMapping) {
+    this.assistant = assistant;
+    this.id = id;
+    this.type = type;
+    this.extend = extend;
+    this.discriminator = discriminator;
+    this.resultMappings = resultMappings;
+    this.autoMapping = autoMapping;
+  }
+
+  public ResultMap resolve() {
+      //解析又去调用MapperBuilderAssistant.addResultMap
+    return assistant.addResultMap(this.id, this.type, this.extend, this.discriminator, this.resultMappings, this.autoMapping);
+  }
+
+}
\ No newline at end of file

src/main/java/org/apache/ibatis/builder/SqlSourceBuilder.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import org.apache.ibatis.mapping.ParameterMapping;
+import org.apache.ibatis.mapping.SqlSource;
+import org.apache.ibatis.parsing.GenericTokenParser;
+import org.apache.ibatis.parsing.TokenHandler;
+import org.apache.ibatis.reflection.MetaClass;
+import org.apache.ibatis.reflection.MetaObject;
+import org.apache.ibatis.session.Configuration;
+import org.apache.ibatis.type.JdbcType;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * SQL源码构建器
+ * 
+ */
+public class SqlSourceBuilder extends BaseBuilder {
+
+  private static final String parameterProperties = "javaType,jdbcType,mode,numericScale,resultMap,typeHandler,jdbcTypeName";
+
+  public SqlSourceBuilder(Configuration configuration) {
+    super(configuration);
+  }
+
+  public SqlSource parse(String originalSql, Class<?> parameterType, Map<String, Object> additionalParameters) {
+    ParameterMappingTokenHandler handler = new ParameterMappingTokenHandler(configuration, parameterType, additionalParameters);
+    //替换#{}中间的部分,如何替换，逻辑在ParameterMappingTokenHandler
+    GenericTokenParser parser = new GenericTokenParser("#{", "}", handler);
+    String sql = parser.parse(originalSql);
+    //返回静态SQL源码
+    return new StaticSqlSource(configuration, sql, handler.getParameterMappings());
+  }
+
+  //参数映射记号处理器，静态内部类
+  private static class ParameterMappingTokenHandler extends BaseBuilder implements TokenHandler {
+
+    private List<ParameterMapping> parameterMappings = new ArrayList<ParameterMapping>();
+    private Class<?> parameterType;
+    private MetaObject metaParameters;
+
+    public ParameterMappingTokenHandler(Configuration configuration, Class<?> parameterType, Map<String, Object> additionalParameters) {
+      super(configuration);
+      this.parameterType = parameterType;
+      this.metaParameters = configuration.newMetaObject(additionalParameters);
+    }
+
+    public List<ParameterMapping> getParameterMappings() {
+      return parameterMappings;
+    }
+
+    @Override
+    public String handleToken(String content) {
+      //先构建参数映射
+      parameterMappings.add(buildParameterMapping(content));
+      //如何替换很简单，永远是一个问号，但是参数的信息要记录在parameterMappings里面供后续使用
+      return "?";
+    }
+
+    //构建参数映射
+    private ParameterMapping buildParameterMapping(String content) {
+        //#{favouriteSection,jdbcType=VARCHAR}
+        //先解析参数映射,就是转化成一个hashmap
+      Map<String, String> propertiesMap = parseParameterMapping(content);
+      String property = propertiesMap.get("property");
+      Class<?> propertyType;
+      //这里分支比较多，需要逐个理解
+      if (metaParameters.hasGetter(property)) { // issue #448 get type from additional params
+        propertyType = metaParameters.getGetterType(property);
+      } else if (typeHandlerRegistry.hasTypeHandler(parameterType)) {
+        propertyType = parameterType;
+      } else if (JdbcType.CURSOR.name().equals(propertiesMap.get("jdbcType"))) {
+        propertyType = java.sql.ResultSet.class;
+      } else if (property != null) {
+        MetaClass metaClass = MetaClass.forClass(parameterType);
+        if (metaClass.hasGetter(property)) {
+          propertyType = metaClass.getGetterType(property);
+        } else {
+          propertyType = Object.class;
+        }
+      } else {
+        propertyType = Object.class;
+      }
+      ParameterMapping.Builder builder = new ParameterMapping.Builder(configuration, property, propertyType);
+      Class<?> javaType = propertyType;
+      String typeHandlerAlias = null;
+      for (Map.Entry<String, String> entry : propertiesMap.entrySet()) {
+        String name = entry.getKey();
+        String value = entry.getValue();
+        if ("javaType".equals(name)) {
+          javaType = resolveClass(value);
+          builder.javaType(javaType);
+        } else if ("jdbcType".equals(name)) {
+          builder.jdbcType(resolveJdbcType(value));
+        } else if ("mode".equals(name)) {
+          builder.mode(resolveParameterMode(value));
+        } else if ("numericScale".equals(name)) {
+          builder.numericScale(Integer.valueOf(value));
+        } else if ("resultMap".equals(name)) {
+          builder.resultMapId(value);
+        } else if ("typeHandler".equals(name)) {
+          typeHandlerAlias = value;
+        } else if ("jdbcTypeName".equals(name)) {
+          builder.jdbcTypeName(value);
+        } else if ("property".equals(name)) {
+          // Do Nothing
+        } else if ("expression".equals(name)) {
+          throw new BuilderException("Expression based parameters are not supported yet");
+        } else {
+          throw new BuilderException("An invalid property '" + name + "' was found in mapping #{" + content + "}.  Valid properties are " + parameterProperties);
+        }
+      }
+      //#{age,javaType=int,jdbcType=NUMERIC,typeHandler=MyTypeHandler}
+      if (typeHandlerAlias != null) {
+        builder.typeHandler(resolveTypeHandler(javaType, typeHandlerAlias));
+      }
+      return builder.build();
+    }
+
+    private Map<String, String> parseParameterMapping(String content) {
+      try {
+        return new ParameterExpression(content);
+      } catch (BuilderException ex) {
+        throw ex;
+      } catch (Exception ex) {
+        throw new BuilderException("Parsing error was found in mapping #{" + content + "}.  Check syntax #{property|(expression), var1=value1, var2=value2, ...} ", ex);
+      }
+    }
+  }
+  
+}

src/main/java/org/apache/ibatis/builder/StaticSqlSource.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder;
+
+import java.util.List;
+
+import org.apache.ibatis.mapping.BoundSql;
+import org.apache.ibatis.mapping.ParameterMapping;
+import org.apache.ibatis.mapping.SqlSource;
+import org.apache.ibatis.session.Configuration;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 静态SQL源码
+ * 
+ */
+public class StaticSqlSource implements SqlSource {
+
+  private String sql;
+  private List<ParameterMapping> parameterMappings;
+  private Configuration configuration;
+
+  public StaticSqlSource(Configuration configuration, String sql) {
+    this(configuration, sql, null);
+  }
+
+  public StaticSqlSource(Configuration configuration, String sql, List<ParameterMapping> parameterMappings) {
+    this.sql = sql;
+    this.parameterMappings = parameterMappings;
+    this.configuration = configuration;
+  }
+
+  @Override
+  public BoundSql getBoundSql(Object parameterObject) {
+    return new BoundSql(configuration, sql, parameterMappings, parameterObject);
+  }
+
+}

src/main/java/org/apache/ibatis/builder/annotation/MethodResolver.java

+/*
+ *    Copyright 2009-2013 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.
+ */
+package org.apache.ibatis.builder.annotation;
+
+import java.lang.reflect.Method;
+
+/**
+ * @author Eduardo Macarron
+ */
+public class MethodResolver {
+  private final MapperAnnotationBuilder annotationBuilder;
+  private Method method;
+
+  public MethodResolver(MapperAnnotationBuilder annotationBuilder, Method method) {
+    this.annotationBuilder = annotationBuilder;
+    this.method = method;
+  }
+
+  public void resolve() {
+    annotationBuilder.parseStatement(method);
+  }
+
+}
\ No newline at end of file

src/main/java/org/apache/ibatis/builder/annotation/ProviderSqlSource.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.builder.annotation;
+
+import java.lang.reflect.Method;
+import java.util.HashMap;
+
+import org.apache.ibatis.builder.BuilderException;
+import org.apache.ibatis.builder.SqlSourceBuilder;
+import org.apache.ibatis.mapping.BoundSql;
+import org.apache.ibatis.mapping.SqlSource;
+import org.apache.ibatis.session.Configuration;
+
+/**
+ * @author Clinton Begin
+ */
+public class ProviderSqlSource implements SqlSource {
+
+  private SqlSourceBuilder sqlSourceParser;
+  private Class<?> providerType;
+  private Method providerMethod;
+  private boolean providerTakesParameterObject;
+
+  public ProviderSqlSource(Configuration config, Object provider) {
+    String providerMethodName = null;
+    try {
+      this.sqlSourceParser = new SqlSourceBuilder(config);
+      this.providerType = (Class<?>) provider.getClass().getMethod("type").invoke(provider);
+      providerMethodName = (String) provider.getClass().getMethod("method").invoke(provider);
+
+      for (Method m : this.providerType.getMethods()) {
+        if (providerMethodName.equals(m.getName())) {
+          if (m.getParameterTypes().length < 2
+              && m.getReturnType() == String.class) {
+            this.providerMethod = m;
+            this.providerTakesParameterObject = m.getParameterTypes().length == 1;
+          }
+        }
+      }
+    } catch (Exception e) {
+      throw new BuilderException("Error creating SqlSource for SqlProvider.  Cause: " + e, e);
+    }
+    if (this.providerMethod == null) {
+      throw new BuilderException("Error creating SqlSource for SqlProvider. Method '"
+          + providerMethodName + "' not found in SqlProvider '" + this.providerType.getName() + "'.");
+    }
+  }
+
+  @Override
+  public BoundSql getBoundSql(Object parameterObject) {
+    SqlSource sqlSource = createSqlSource(parameterObject);
+    return sqlSource.getBoundSql(parameterObject);
+  }
+
+  private SqlSource createSqlSource(Object parameterObject) {
+    try {
+      String sql;
+      if (providerTakesParameterObject) {
+        sql = (String) providerMethod.invoke(providerType.newInstance(), parameterObject);
+      } else {
+        sql = (String) providerMethod.invoke(providerType.newInstance());
+      }
+      Class<?> parameterType = parameterObject == null ? Object.class : parameterObject.getClass();
+      return sqlSourceParser.parse(sql, parameterType, new HashMap<String, Object>());
+    } catch (Exception e) {
+      throw new BuilderException("Error invoking SqlProvider method ("
+          + providerType.getName() + "." + providerMethod.getName()
+          + ").  Cause: " + e, e);
+    }
+  }
+
+}

src/main/java/org/apache/ibatis/builder/annotation/package-info.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+
+/**
+ * Parses annotions to create a Configuration
+ */
+package org.apache.ibatis.builder.annotation;

src/main/java/org/apache/ibatis/builder/package-info.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+
+/**
+ * Base package for the Configuration building code
+ */
+package org.apache.ibatis.builder;

src/main/java/org/apache/ibatis/builder/xml/XMLIncludeTransformer.java

+/*
+ * Copyright 2012 MyBatis.org.
+ *
+ * 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.
+ */
+package org.apache.ibatis.builder.xml;
+
+import org.apache.ibatis.builder.IncompleteElementException;
+import org.apache.ibatis.builder.MapperBuilderAssistant;
+import org.apache.ibatis.parsing.PropertyParser;
+import org.apache.ibatis.parsing.XNode;
+import org.apache.ibatis.session.Configuration;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+/**
+ * @author Frank D. Martinez [mnesarco]
+ */
+/**
+ * XML include转换器
+ *
+ */
+public class XMLIncludeTransformer {
+
+  private final Configuration configuration;
+  private final MapperBuilderAssistant builderAssistant;
+
+  public XMLIncludeTransformer(Configuration configuration, MapperBuilderAssistant builderAssistant) {
+    this.configuration = configuration;
+    this.builderAssistant = builderAssistant;
+  }
+
+//<select id="selectUsers" resultType="map">
+//  select <include refid="userColumns"/>
+//  from some_table
+//  where id = #{id}
+//</select>
+  public void applyIncludes(Node source) {
+    if (source.getNodeName().equals("include")) {
+      //走到这里，单独解析<include refid="userColumns"/>
+      //拿到SQL片段
+      Node toInclude = findSqlFragment(getStringAttribute(source, "refid"));
+      //递归调用自己,应用上?
+      applyIncludes(toInclude);
+      //总之下面就是将字符串拼接进来，看不懂。。。
+      if (toInclude.getOwnerDocument() != source.getOwnerDocument()) {
+        toInclude = source.getOwnerDocument().importNode(toInclude, true);
+      }
+      source.getParentNode().replaceChild(toInclude, source);
+      while (toInclude.hasChildNodes()) {
+        toInclude.getParentNode().insertBefore(toInclude.getFirstChild(), toInclude);
+      }
+      toInclude.getParentNode().removeChild(toInclude);
+    } else if (source.getNodeType() == Node.ELEMENT_NODE) {
+        //一开始会走这段，取得所有儿子
+      NodeList children = source.getChildNodes();
+      for (int i=0; i<children.getLength(); i++) {
+          //递归调用自己
+        applyIncludes(children.item(i));
+      }
+    }
+  }
+
+  private Node findSqlFragment(String refid) {
+    refid = PropertyParser.parse(refid, configuration.getVariables());
+    refid = builderAssistant.applyCurrentNamespace(refid, true);
+    try {
+      //去之前存到内存map的SQL片段中寻找
+      XNode nodeToInclude = configuration.getSqlFragments().get(refid);
+      //clone一下，以防改写？
+      return nodeToInclude.getNode().cloneNode(true);
+    } catch (IllegalArgumentException e) {
+      throw new IncompleteElementException("Could not find SQL statement to include with refid '" + refid + "'", e);
+    }
+  }
+
+  private String getStringAttribute(Node node, String name) {
+    return node.getAttributes().getNamedItem(name).getNodeValue();
+  }
+}

src/main/java/org/apache/ibatis/builder/xml/XMLMapperEntityResolver.java

+/*
+ *    Copyright 2009-2014 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.
+ */
+package org.apache.ibatis.builder.xml;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.HashMap;
+import java.util.Locale;
+import java.util.Map;
+
+import org.apache.ibatis.io.Resources;
+import org.xml.sax.EntityResolver;
+import org.xml.sax.InputSource;
+import org.xml.sax.SAXException;
+
+/**
+ * Offline entity resolver for the MyBatis DTDs
+ * 目的是未联网的情况下也能做DTD验证，实现原理就是将DTD搞到本地，然后用org.xml.sax.EntityResolver，最后调用DocumentBuilder.setEntityResolver来达到脱机验证
+ * EntityResolver
+ * public InputSource resolveEntity (String publicId, String systemId)
+ * 应用程序可以使用此接口将系统标识符重定向到本地 URI
+ * 但是用DTD是比较过时的做法，新的都改用xsd了
+ * 这个类的名字并不准确，因为它被两个类都用到了（XMLConfigBuilder,XMLMapperBuilder）
+ * 
+ * @author Clinton Begin
+ */
+public class XMLMapperEntityResolver implements EntityResolver {
+
+  private static final Map<String, String> doctypeMap = new HashMap<String, String>();
+
+	// <?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">
+	// 常量定义
+  private static final String IBATIS_CONFIG_PUBLIC = "-//ibatis.apache.org//DTD Config 3.0//EN".toUpperCase(Locale.ENGLISH);
+  private static final String IBATIS_CONFIG_SYSTEM = "http://ibatis.apache.org/dtd/ibatis-3-config.dtd".toUpperCase(Locale.ENGLISH);
+
+  private static final String IBATIS_MAPPER_PUBLIC = "-//ibatis.apache.org//DTD Mapper 3.0//EN".toUpperCase(Locale.ENGLISH);
+  private static final String IBATIS_MAPPER_SYSTEM = "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd".toUpperCase(Locale.ENGLISH);
+
+  private static final String MYBATIS_CONFIG_PUBLIC = "-//mybatis.org//DTD Config 3.0//EN".toUpperCase(Locale.ENGLISH);
+  private static final String MYBATIS_CONFIG_SYSTEM = "http://mybatis.org/dtd/mybatis-3-config.dtd".toUpperCase(Locale.ENGLISH);
+
+  private static final String MYBATIS_MAPPER_PUBLIC = "-//mybatis.org//DTD Mapper 3.0//EN".toUpperCase(Locale.ENGLISH);
+  private static final String MYBATIS_MAPPER_SYSTEM = "http://mybatis.org/dtd/mybatis-3-mapper.dtd".toUpperCase(Locale.ENGLISH);
+
+  private static final String MYBATIS_CONFIG_DTD = "org/apache/ibatis/builder/xml/mybatis-3-config.dtd";
+  private static final String MYBATIS_MAPPER_DTD = "org/apache/ibatis/builder/xml/mybatis-3-mapper.dtd";
+
+  static {
+		// 将DOCTYPE和URL都映射到本地类路径下的DTD
+    doctypeMap.put(IBATIS_CONFIG_SYSTEM, MYBATIS_CONFIG_DTD);
+    doctypeMap.put(IBATIS_CONFIG_PUBLIC, MYBATIS_CONFIG_DTD);
+
+    doctypeMap.put(IBATIS_MAPPER_SYSTEM, MYBATIS_MAPPER_DTD);
+    doctypeMap.put(IBATIS_MAPPER_PUBLIC, MYBATIS_MAPPER_DTD);
+
+    doctypeMap.put(MYBATIS_CONFIG_SYSTEM, MYBATIS_CONFIG_DTD);
+    doctypeMap.put(MYBATIS_CONFIG_PUBLIC, MYBATIS_CONFIG_DTD);
+
+    doctypeMap.put(MYBATIS_MAPPER_SYSTEM, MYBATIS_MAPPER_DTD);
+    doctypeMap.put(MYBATIS_MAPPER_PUBLIC, MYBATIS_MAPPER_DTD);
+  }
+
+  /*
+   * Converts a public DTD into a local one
+   * 
+   * @param publicId The public id that is what comes after "PUBLIC"
+   * @param systemId The system id that is what comes after the public id.
+   * @return The InputSource for the DTD
+   * 
+   * @throws org.xml.sax.SAXException If anything goes wrong
+   */
+  @Override
+  //核心就是覆盖这个方法，达到转public DTD到本地DTD的目的
+  public InputSource resolveEntity(String publicId, String systemId) throws SAXException {
+
+    if (publicId != null) {
+      publicId = publicId.toUpperCase(Locale.ENGLISH);
+    }
+    if (systemId != null) {
+      systemId = systemId.toUpperCase(Locale.ENGLISH);
+    }
+
+    InputSource source = null;
+    try {
+		//先找publicId，找不到再找systemId，貌似不可能找不到的说
+      String path = doctypeMap.get(publicId);
+      source = getInputSource(path, source);
+      if (source == null) {
+        path = doctypeMap.get(systemId);
+        source = getInputSource(path, source);
+      }
+    } catch (Exception e) {
+      throw new SAXException(e.toString());
+    }
+    return source;
+  }
+
+  private InputSource getInputSource(String path, InputSource source) {
+    if (path != null) {
+      InputStream in;
+      try {
+        in = Resources.getResourceAsStream(path);
+        source = new InputSource(in);
+      } catch (IOException e) {
+        // ignore, null is ok
+      }
+    }
+    return source;
+  }
+
+}
\ No newline at end of file

src/main/java/org/apache/ibatis/builder/xml/package-info.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+
+/**
+ * Parses XML files to create a Configuration
+ */
+package org.apache.ibatis.builder.xml;

src/main/java/org/apache/ibatis/cache/CacheException.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+package org.apache.ibatis.cache;
+
+import org.apache.ibatis.exceptions.PersistenceException;
+
+/**
+ * @author Clinton Begin
+ */
+/**
+ * 缓存异常
+ *
+ */
+public class CacheException extends PersistenceException {
+
+  private static final long serialVersionUID = -193202262468464650L;
+
+  public CacheException() {
+    super();
+  }
+
+  public CacheException(String message) {
+    super(message);
+  }
+
+  public CacheException(String message, Throwable cause) {
+    super(message, cause);
+  }
+
+  public CacheException(Throwable cause) {
+    super(cause);
+  }
+
+}

src/main/java/org/apache/ibatis/cache/decorators/package-info.java

+/*
+ *    Copyright 2009-2012 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.
+ */
+
+/**
+ * Contains cache decorators
+ */
+package org.apache.ibatis.cache.decorators;