Java_JavaBean映射框架Orika

绝地灬酷狼 2021-10-06 02:32 485阅读 0赞

# 简介 #

Orika是一个JavaBean映射框架，它递归地将数据从一个对象复制到另一个对象。它在开发多层应用程序时非常有用。

Orika使用字节代码生成来创建开销最小的快速映射程序。

<dependency>
    		<groupId>ma.glasnost.orika</groupId>
    		<artifactId>orika-core</artifactId>
    		<version>1.5.2</version>
    	</dependency>

# 使用 #

## 相同字段bean映射 ##

MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
    //MapperFacade
    @Test
    public void givenSrcAndDest_whenMaps_thenCorrect() {
        mapperFactory.classMap(Source.class, Dest.class);
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Source src = new Source("Baeldung", 10);
        Dest dest = mapper.map(src, Dest.class);
        assertEquals(dest.getAge(), src.getAge());
        assertEquals(dest.getName(), src.getName());
    }
    
    
    //BoundMapperFacade（较快）
    @Test
    public void givenSrcAndDest_whenMapsUsingBoundMapperInReverse_thenCorrect() {
        BoundMapperFacade<Source, Dest> 
          boundMapper = mapperFactory.getMapperFacade(Source.class, Dest.class);
        Dest src = new Dest("baeldung", 10);
        Source dest = boundMapper.mapReverse(src);
    
        assertEquals(dest.getAge(), src.getAge());
        assertEquals(dest.getName(), src.getName());
    }

## 不同字段bean映射 ##

//指定不同字段
    @Test
    public void givenSrcAndDestWithDifferentFieldNames_whenMaps_thenCorrect() {
    	mapperFactory.classMap(Personne.class, Person.class)
        .field("nom", "name").field("surnom", "nickname").byDefault().register();//注册不同的字段名
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Personne frenchPerson = new Personne("Claire", "cla", 25);
        Person englishPerson = mapper.map(frenchPerson, Person.class);
        assertEquals(englishPerson.getName(), frenchPerson.getNom());
        assertEquals(englishPerson.getNickname(), frenchPerson.getSurnom());
        assertEquals(englishPerson.getAge(), frenchPerson.getAge());
    }
    
    //排查字段字段
    //因为我们在配置排除了nom字段映射，所以单元测试中第一个行name值断言为null。
    @Test
    public void givenSrcAndDest_whenCanExcludeField_thenCorrect() {
        mapperFactory.classMap(Personne.class, Person.class).exclude("nom")
          .field("surnom", "nickname").field("age", "age").register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Personne frenchPerson = new Personne("Claire", "cla", 25);
        Person englishPerson = mapper.map(frenchPerson, Person.class);
        assertEquals(null, englishPerson.getName());
        assertEquals(englishPerson.getNickname(), frenchPerson.getSurnom());
        assertEquals(englishPerson.getAge(), frenchPerson.getAge());
    }

## List属性映射 ##

@Test
    public void givenSrcWithListAndDestWithPrimitiveAttributes_whenMaps_thenCorrect() {
        mapperFactory.classMap(PersonNameList.class, PersonNameParts.class)
          .field("nameList[0]", "firstName")
          .field("nameList[1]", "lastName").register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        List<String> nameList = Arrays.asList(new String[] { "Sylvester", "Stallone" });
        PersonNameList src = new PersonNameList(nameList);
        PersonNameParts dest = mapper.map(src, PersonNameParts.class);
    
        assertEquals(dest.getFirstName(), "Sylvester");
        assertEquals(dest.getLastName(), "Stallone");
    }

## Map属性映射 ##

@Test
    public void givenSrcWithMapAndDestWithPrimitiveAttributes_whenMaps_thenCorrect() {
        mapperFactory.classMap(PersonNameMap.class, PersonNameParts.class)
          .field("nameMap['first']", "firstName")
          .field("nameMap[\"last\"]", "lastName")
          .register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Map<String, String> nameMap = new HashMap<>();
        nameMap.put("first", "Leornado");
        nameMap.put("last", "DiCaprio");
        PersonNameMap src = new PersonNameMap(nameMap);
        PersonNameParts dest = mapper.map(src, PersonNameParts.class);
    
        assertEquals(dest.getFirstName(), "Leornado");
        assertEquals(dest.getLastName(), "DiCaprio");
    }

## 对象属性映射 ##

@Test
    public void givenSrcWithNestedFields_whenMaps_thenCorrect() {
        mapperFactory.classMap(PersonContainer.class, PersonNameParts.class)
          .field("name.firstName", "firstName")
          .field("name.lastName", "lastName").register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        PersonContainer src = new PersonContainer(new Name("Nick", "Canon"));
        PersonNameParts dest = mapper.map(src, PersonNameParts.class);
    
        assertEquals(dest.getFirstName(), "Nick");
        assertEquals(dest.getLastName(), "Canon");
    }

# Null控制 #

## 全局 ##

MapperFactory mapperFactory = new DefaultMapperFactory.Builder()
      .mapNulls(false).build();

## 局部 ##

//映射null值可以通过ClassMapBuilder类mapNulls(true|false)方法进行控制，或 mapNullsInReverse(true|false)方法进行反向映射控制
    @Test
    public void givenSrcWithNullAndLocalConfigForNoNull_whenFailsToMap_ThenCorrect() {
        mapperFactory.classMap(Source.class, Dest.class).field("age", "age")
          .mapNulls(false).field("name", "name").byDefault().register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Source src = new Source(null, 10);
        Dest dest = new Dest("Clinton", 55);
        mapper.map(src, dest);
    
        assertEquals(dest.getAge(), src.getAge());
        assertEquals(dest.getName(), "Clinton");
    }

## 字段 ##

//配置仅影响name字段
    @Test
    public void givenSrcWithNullAndFieldLevelConfigForNoNull_whenFailsToMap_ThenCorrect() {
        mapperFactory.classMap(Source.class, Dest.class).field("age", "age")
          .fieldMap("name", "name").mapNulls(false).add().byDefault().register();
        MapperFacade mapper = mapperFactory.getMapperFacade();
        Source src = new Source(null, 10);
        Dest dest = new Dest("Clinton", 55);
        mapper.map(src, dest);
    
        assertEquals(dest.getAge(), src.getAge());
        assertEquals(dest.getName(), "Clinton");
    }