更新测试和文档，版本号变更为0.2.0

abel533 · abel533 · commit 993faf9065ae · 2014-12-10T11:31:30.000+08:00
diff --git a/README.md b/README.md
@@ -24,6 +24,16 @@ Mybatis工具群： 211286137 (Mybatis相关工具插件等等)
 
 推荐使用Mybatis分页插件:[PageHelper分页插件](https://github.com/pagehelper/Mybatis-PageHelper)
 
+##v0.2.0版本说明
+
+该版本做了大量的重构，在原有基础上增加了两个类，分别为`MapperTemplate`和`MapperProvider`，其他几个类都有相当大的改动。  
+
+**但是**，这次重构并不影响原有的业务代码。  
+
+这次重构的目的是为了方便开发者自行扩展，增加自己需要的通用Mapper。这次重构后，扩展变的更容易。稍后会写一篇**如何进行扩展**的文档。  
+
+这次更新还修复Oracle序列的BUG。
+
 ##如何使用?
 
 下面是通用Mapper的配置方法,还会提到Spring中的配置方法.还有和[PageHelper分页插件](https://github.com/pagehelper/Mybatis-PageHelper)集成的配置方式.
@@ -54,11 +64,17 @@ Mybatis工具群： 211286137 (Mybatis相关工具插件等等)
     <!--配置UUID生成策略需要使用OGNL表达式-->
     <!--默认值32位长度:@java.util.UUID@randomUUID().toString().replace("-", "")-->
     <!--<property name="UUID" value="@java.util.UUID@randomUUID().toString()"/>-->
-    <!--主键自增回写方法,默认值MYSQL,详细说明看下面的INENTITY参数配置-->
-    <!--<property name="IDENTITY" value="MYSQL"/>-->
+    <!--主键自增回写方法,默认值MYSQL,详细说明请看文档-->
+    <property name="IDENTITY" value="HSQLDB"/>
+    <!--序列的获取规则,使用{num}格式化参数，默认值为{0}.nextval，针对Oracle-->
+    <!--可选参数一共3个，对应0,1,2,分别为SequenceName，ColumnName,PropertyName-->
+    <property name="seqFormat" value="{0}.nextval"/>
     <!--主键自增回写方法执行顺序,默认AFTER,可选值为(BEFORE|AFTER)-->
     <!--<property name="ORDER" value="AFTER"/>-->
-    <!--通用Mapper接口，多个用逗号隔开-->
+    <!--支持Map类型的实体类，自动将大写下划线的Key转换为驼峰式-->
+    <!--这个处理使得通用Mapper可以支持Map类型的实体（实体中的字段必须按常规方式定义，否则无法反射获得列）-->
+    <property name="cameHumpMap" value="true"/>
+    <!--通用Mapper接口，多个通用接口用逗号隔开-->
     <property name="mappers" value="com.github.abel533.mapper.Mapper"/>
   </plugin>
 </plugins>
@@ -232,21 +248,24 @@ int updateByPrimaryKeySelective(T record);
 @Id
 private Integer id;
 ```
+该字段不会回写。   
 
 2. 使用UUID时:
 ```java
 //可以用于任意字符串类型长度超过32位的字段
 @GeneratedValue(generator = "UUID")
 private String countryname;
 ```
+该字段不会回写。 
 
 3. 使用主键自增:
 ```java
 //不限于@Id注解的字段,但是一个实体类中只能存在一个(继承关系中也只能存在一个)
 @Id
 @GeneratedValue(strategy = GenerationType.IDENTITY)
 private Integer id;
-```
+```  
+首先该字段必须是一个自增的字段，增加这个注解后，**会回写ID**。
 
 
 ###5. 将继承的Mapper接口添加到Mybatis配置中
@@ -325,7 +344,7 @@ try {
 
 直接在需要的地方注入Mapper继承的接口即可,和一般情况下的使用没有区别.
 
-##当前版本v0.1.0
+##当前版本v0.2.0
 
 ##这是一个新生的开源项目
 
diff --git a/pom.xml b/pom.xml
@@ -4,7 +4,7 @@
 
   <groupId>com.github.abel533</groupId>
   <artifactId>mapper</artifactId>
-  <version>0.1.0</version>
+  <version>0.2.0</version>
   <packaging>jar</packaging>
 
   <name>mapper</name>
@@ -15,35 +15,36 @@
   </properties>
 
   <dependencies>
+    <dependency>
+      <groupId>javax.persistence</groupId>
+      <artifactId>persistence-api</artifactId>
+      <version>1.0</version>
+    </dependency>
+    <dependency>
+      <groupId>org.mybatis</groupId>
+      <artifactId>mybatis</artifactId>
+      <version>3.2.6</version>
+      <optional>true</optional>
+    </dependency>
+
+    <!--测试-->
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>4.11</version>
       <scope>test</scope>
     </dependency>
-
     <dependency>
       <groupId>log4j</groupId>
       <artifactId>log4j</artifactId>
       <version>1.2.17</version>
       <scope>test</scope>
     </dependency>
-
-    <dependency>
-      <groupId>org.mybatis</groupId>
-      <artifactId>mybatis</artifactId>
-      <version>3.2.6</version>
-    </dependency>
     <dependency>
       <groupId>org.hsqldb</groupId>
       <artifactId>hsqldb</artifactId>
       <version>2.2.9</version>
-    </dependency>
-
-    <dependency>
-      <groupId>javax.persistence</groupId>
-      <artifactId>persistence-api</artifactId>
-      <version>1.0</version>
+      <scope>test</scope>
     </dependency>
   </dependencies>
   <build>
diff --git a/src/test/java/com/github/abel533/test/country/TestSelect.java b/src/test/java/com/github/abel533/test/country/TestSelect.java
@@ -7,6 +7,7 @@
 import org.junit.Assert;
 import org.junit.Test;
 
+import java.text.MessageFormat;
 import java.util.List;
 
 /**
@@ -33,17 +34,18 @@ public void testDynamicSelectAll() {
     }
 
     /**
-     * 除了通过主键的方法，其他的方法入参不能为null
+     * 入参为null时查询全部
      */
-    @Test(expected = RuntimeException.class)
+    @Test
     public void testDynamicSelectAllByNull() {
-        SqlSession sqlSession = MybatisHelper.getSqlSession();
-        try {
-            CountryMapper mapper = sqlSession.getMapper(CountryMapper.class);
-            mapper.select(null);
-        } finally {
-            sqlSession.close();
-        }
+//        SqlSession sqlSession = MybatisHelper.getSqlSession();
+//        try {
+//            CountryMapper mapper = sqlSession.getMapper(CountryMapper.class);
+//            mapper.select(null);
+//        } finally {
+//            sqlSession.close();
+//        }
+        System.out.println(MessageFormat.format("{2}-{0}.nextval ","SEQ_ID","HEHE","XIXI"));
     }
 
     /**
diff --git a/src/test/java/com/github/abel533/test/country/TestSelectCount.java b/src/test/java/com/github/abel533/test/country/TestSelectCount.java
@@ -30,9 +30,9 @@ public void testDynamicSelectCount() {
     }
 
     /**
-     * 除了通过主键的方法，其他的方法入参不能为null
+     * 入参为null时查询全部
      */
-    @Test(expected = RuntimeException.class)
+    @Test
     public void testDynamicSelectAllByNull() {
         SqlSession sqlSession = MybatisHelper.getSqlSession();
         try {
diff --git a/src/test/java/com/github/abel533/test/country/TestUpdateByPrimaryKey.java b/src/test/java/com/github/abel533/test/country/TestUpdateByPrimaryKey.java
@@ -29,9 +29,9 @@ public void testDynamicUpdateByPrimaryKeyAll() {
     }
 
     /**
-     * 除了通过主键的方法，其他的方法入参不能为null
+     * 入参为null时更新全部
      */
-    @Test(expected = RuntimeException.class)
+    @Test
     public void testDynamicUpdateByPrimaryKeyAllByNull() {
         SqlSession sqlSession = MybatisHelper.getSqlSession();
         try {
diff --git a/src/test/java/com/github/abel533/test/country2/TestInsert.java b/src/test/java/com/github/abel533/test/country2/TestInsert.java
@@ -3,7 +3,6 @@
 import com.github.abel533.mapper.Country2Mapper;
 import com.github.abel533.mapper.MybatisHelper;
 import com.github.abel533.model.Country2;
-import org.apache.ibatis.exceptions.PersistenceException;
 import org.apache.ibatis.session.SqlSession;
 import org.junit.Assert;
 import org.junit.Test;
@@ -42,7 +41,7 @@ public void testDynamicInsertAll() {
     /**
      * 不能插入null
      */
-    @Test(expected = PersistenceException.class)
+    @Test
     public void testDynamicInsertAllByNull() {
         SqlSession sqlSession = MybatisHelper.getSqlSession();
         try {
diff --git a/src/test/resources/mybatis-config.xml b/src/test/resources/mybatis-config.xml
@@ -26,9 +26,13 @@
 			<!--<property name="UUID" value="@java.util.UUID@randomUUID().toString()"/>-->
 			<!--主键自增回写方法,默认值MYSQL,详细说明请看文档-->
 			<property name="IDENTITY" value="HSQLDB"/>
+      <!--序列的获取规则,使用{num}格式化参数，默认值为{0}.nextval，针对Oracle-->
+      <!--可选参数一共3个，对应0,1,2,分别为SequenceName，ColumnName,PropertyName-->
+			<property name="seqFormat" value="{0}.nextval"/>
 			<!--主键自增回写方法执行顺序,默认AFTER,可选值为(BEFORE|AFTER)-->
 			<!--<property name="ORDER" value="AFTER"/>-->
       <!--支持Map类型的实体类，自动将大写下划线的Key转换为驼峰式-->
+      <!--这个处理使得通用Mapper可以支持Map类型的实体（实体中的字段必须按常规方式定义，否则无法反射获得列）-->
       <property name="cameHumpMap" value="true"/>
 			<!--通用Mapper接口，多个用逗号隔开-->
 			<property name="mappers" value="com.github.abel533.mapper.Mapper"/>
