BeanMapping新的功能点(6月22号)
What is 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>>>>的结构,支持任意深度的嵌套
新增了一些配置定义,更加方便客户端更加灵活的使用。
?
global-configurations<global-configurations debug="false" mappingNullValue="true" mappingEmptyStrings="true" trimStrings="true" />class-alias-configurations
<class-alias-configurations> <classAlias alias="commonClass" /></class-alias-configurations>convetors-configurations
<convetors-configurations> <convertor alias="common" /></convetors-configurations>?说明下:?
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 APImapping规则定义,允许使用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.javaBeanMappingDymaicTest.java目前单元测试总体覆盖率已经达到78.9%以上,来一张截图看一下。
1. ?完善Script的功能,完善script部分的功能单元测试
2. ?文档整理。 现在BeanMapping功能基本和dozer有点接近,也有自定的一些优势和功能亮点
3. ?完成User Guide,准备出1.0稳定版本,可以供大家使用。