BeanMapping新的功能点(6月22号)

What is BeanMapping ?

可以提前看一下原先的帖子： 我也造了个轮子:BeanMapping(属性拷贝)

 

新增功能(亮点)： 

1.  Convertor转化处理

• 支持(int,long,short,byte,char,boolean,float,double)8种原型和其对应的基本类型 + (BigInteger , BigDecimal)  + String 允许互相之间转化
• 支持(java.util.Date , java.util.Calendar)和字符串的转化，提供默认的day("yyyy-MM-dd") , time("yyyy-MM-dd HH:mm:ss")两种格式的转化
• 支持8种类型的Array +  List + Set，允许互相之间的转化

对应的issue :  http://code.google.com/p/mapping4java/issues/detail?id=4 ,  http://code.google.com/p/mapping4java/issues/detail?id=9

 

个人对Array<->Collection的转化比较满意，看一段测试代码片段就知道其强悍之处。

测试代码类： CollectionAndCollectionTest.java

 

// 来一个变态的，嵌套多维数组
        List<Map> firstList = Arrays.asList(first);
        List<List<Map>> twoList = Arrays.asList(firstList);
        List<List<List<Map>>> threeList = Arrays.asList(twoList);
        List<List<List<List<Map>>>> fourList = Arrays.asList(threeList);
        Convertor arrayConvertor = helper.getConvertor(List.class, ConvertorModel[][][][].class);
        Convertor setConvertor = helper.getConvertor(List.class, Set.class);
        ConvertorModel[][][][] oldValue = (ConvertorModel[][][][]) arrayConvertor.convert(fourList,
                                                                                          ConvertorModel[][][][].class);

        ConvertorModel[][][][] newValue = (ConvertorModel[][][][]) arrayConvertor.convertCollection(
                                                                                                    fourList,
                                                                                                    ConvertorModel[][][][].class,
                                                                                                    new Class[] {
                                                                                                            ConvertorModel[][][].class,
                                                                                                            ConvertorModel[][].class,
                                                                                                            ConvertorModel[].class,
                                                                                                            ConvertorModel.class });
        Set<Set<Set<Set<ConvertorOtherModel>>>> newSetValue = (Set) setConvertor.convertCollection(
                                                                                                   fourList,
                                                                                                   Set.class,
                                                                                                   new Class[] {
                                                                                                           Set.class,
                                                                                                           Set.class,
                                                                                                           Set.class,
                                                                                                           ConvertorOtherModel.class });
        assertEquals(oldValue.length, 1);
        assertEquals(oldValue[0][0][0][0].getI(), first.get("i"));
        assertEquals(oldValue[0][0][0][0].getInteger(), first.get("integer"));
        assertEquals(oldValue[0][0][0][0].getBigDecimal(), first.get("bigDecimal"));
        assertEquals(newValue.length, 1);
        assertEquals(newValue[0][0][0][0].getI(), first.get("i"));
        assertEquals(newValue[0][0][0][0].getInteger(), first.get("integer"));
        assertEquals(newValue[0][0][0][0].getBigDecimal(), first.get("bigDecimal"));
        assertEquals(newSetValue.size(), 1);
        ConvertorOtherModel model = newSetValue.iterator().next().iterator().next().iterator().next().iterator().next();
        assertEquals(model.getI(), first.get("i"));
        assertEquals(model.getInteger(), first.get("integer"));
        assertEquals(model.getBigDecimal(), first.get("bigDecimal"));

 说明：　该段测试代码主要是对 List<List<List<List<Map>>>> fourList的一个嵌套对象，转成 ConvertorModel[][][][] , Set<Set<Set<Set<ConvertorOtherModel>>>>的结构，支持任意深度的嵌套

2. 配置文件变更

新增了一些配置定义，更加方便客户端更加灵活的使用。

 

• global-configurations
  

  <global-configurations debug="false" mappingNullValue="true" mappingEmptyStrings="true" trimStrings="true" />

• class-alias-configurations
  

  <class-alias-configurations>
      	<classAlias alias="commonClass" class="com.agapple.mapping.process.convetor.CommonAndCommonConvertor$CommonToCommon" />
  </class-alias-configurations>

• convetors-configurations
  

  <convetors-configurations>
      	<convertor alias="common" class="commonClass" />
  </convetors-configurations>

   

说明下： 

* global-configurations： 允许定义一些行为控制，比如针对null value , emtpy string是否需要mapping到目标对象上。 issue :  http://code.google.com/p/mapping4java/issues/detail?id=8

* class-alias-configurations ： 允许定义class alias的别名，借鉴于ibatis的功能。 默认支持的alias (8种原生类型，string, map, list, set)等，这里也允许客户自己定义

* convetors-configurations ： 允许定义convertor配置，避免每次都需要手工向repository进行注册。 issue :   http://code.google.com/p/mapping4java/issues/detail?id=1

3.  继承对象mapping功能

针对Object存在继承情况，类似于： http://dozer.sourceforge.net/documentation/baseattributes.html

新的配置：

BeanMappingBuilder builder = new BeanMappingBuilder() {

            protected void configure() {
                behavior().debug(true);// 设置行为
                mapping(TwoObject.class, HashMap.class);
                fields(srcField("name").locatorClass(FirstObject.class), targetField("name"));// name从父类中获取
                fields(srcField("firstValue").locatorClass(FirstObject.class), targetField("firstValue"));// 也从父类中获取
                fields(srcField("twoValue"), targetField("twoValue"));
            }

        };

可以指定 locatorClass，默认为当前mapping class。允许指定其子类做为field查找的class。 对应issue : http://code.google.com/p/mapping4java/issues/detail?id=10

目前暂不支持子父属性同名方法，因为按照java动态性的原则，针对父类的Method，当前实例为子类时，会自动调用当前子类的方法。 

ps : 针对同名的处理，会该issue中同步解决 :  http://code.google.com/p/mapping4java/issues/detail?id=6

 

 

 

 

4.  Mapping Config API

mapping规则定义，允许使用java api进行定义， 对应issue : http://code.google.com/p/mapping4java/issues/detail?id=5

 

mapping API使用例子：

BeanMappingBuilder builder = new BeanMappingBuilder() {

            protected void configure() {
                mapping(HashMap.class, HashMap.class).batch(false).reversable(true).keys("src", "target");
                fields(srcField("one"), targetField("oneOther")).convertor("convertor").defaultValue("ljh");
                fields(srcField("two").clazz(String.class), targetField("twoOther")).script("1+2").convertor(
                                                                                                             StringToCommon.class);
                fields(srcField("three").clazz(ArrayList.class), targetField("threeOther").clazz(HashSet.class)).recursiveMapping(
                                                                                                                                  true);
            }

        };

//根据Builder构造mapping对象
BeanMapping mapping = new BeanMapping(builder);

 

对应的代码类：

• BeanMappingBuilderTest.java
• BeanMappingDymaicTest.java

其他

目前单元测试总体覆盖率已经达到78.9%以上，来一张截图看一下。

后续Action 

1.  完善Script的功能，完善script部分的功能单元测试

2.  文档整理。 现在BeanMapping功能基本和dozer有点接近，也有自定的一些优势和功能亮点

3.  完成User Guide，准备出1.0稳定版本，可以供大家使用。