手?jǐn)]lombok

weakish 發(fā)布于2019-08-16 16:50 / 3037人閱讀

摘要：靜態(tài)構(gòu)造方法靜態(tài)構(gòu)造方法的語(yǔ)義和簡(jiǎn)化程度真的高于直接去一個(gè)對(duì)象。當(dāng)然，看過(guò)很多源碼以后，我想相信將靜態(tài)構(gòu)造方法換成會(huì)先的更加簡(jiǎn)潔測(cè)試代碼當(dāng)然他仍然是支持鏈?zhǔn)秸{(diào)用的這樣來(lái)寫代碼，真的很簡(jiǎn)潔，并且可讀性很強(qiáng)。

擁抱 lombok,它會(huì)幫助我們解決一些讓我們很煩躁的問(wèn)題

去掉 Setter 和 Getter

    @Setter @Getter public class UserDTO {
        @NotNull
        private String username;
        @NotNull
        private int age;
    
        public User convertToUser(){
            UserDTOConvert userDTOConvert = new UserDTOConvert();
            User convert = userDTOConvert.convert(this);
            return convert;
        }
    
        public UserDTO convertFor(User user){
            UserDTOConvert userDTOConvert = new UserDTOConvert();
            UserDTO convert = userDTOConvert.reverse().convert(user);
            return convert;
        }
    
        private static class UserDTOConvert extends Converter {
            @Override
            protected User doForward(UserDTO userDTO) {
                User user = new User();
                BeanUtils.copyProperties(userDTO,user);
                return user;
            }
    
            @Override
            protected UserDTO doBackward(User user) {
                throw new AssertionError("不支持逆向轉(zhuǎn)化方法!");
            }
        }
    }

看到了吧，煩人的 Getter 和 Setter 方法已經(jīng)去掉了。

bean 中的鏈?zhǔn)斤L(fēng)格

改造前

public class Student {
    private String name;
    private int age;

    public String getName() {
        return name;
    }

    public Student setName(String name) {
        this.name = name;
        return this;
    }

    public int getAge() {
        return age;
    }

    public Student setAge(int age) {
        return this;
    }
}

相信合理使用這樣的鏈?zhǔn)酱a，會(huì)更多的程序帶來(lái)很好的可讀性，那看一下如果使用 lombok 進(jìn)行改善呢，請(qǐng)使用 @Accessors(chain = true)，看如下代碼：

@Accessors(chain = true)
@Setter
@Getter
public class Student {
    private String name;
    private int age;
}

這樣就完成了一個(gè)對(duì)于 bean 來(lái)講很友好的鏈?zhǔn)讲僮鳌?/p> 靜態(tài)構(gòu)造方法

靜態(tài)構(gòu)造方法的語(yǔ)義和簡(jiǎn)化程度真的高于直接去 new 一個(gè)對(duì)象。比如 new 一個(gè) List 對(duì)象，過(guò)去的使用是這樣的：

List list = new ArrayList<>();

看一下 guava 中的創(chuàng)建方式：

List list = Lists.newArrayList();

Lists 命名是一種約定(俗話說(shuō)：約定優(yōu)于配置)，它是指 Lists 是 List 這個(gè)類的一個(gè)工具類，那么使用 List 的工具類去產(chǎn)生 List，這樣的語(yǔ)義是不是要比直接 new 一個(gè)子類來(lái)的更直接一些呢，答案是肯定的，再比如如果有一個(gè)工具類叫做 Maps，那你是否想到了創(chuàng)建 Map 的方法呢：

HashMap objectObjectHashMap = Maps.newHashMap();

接上上邊的靜態(tài)構(gòu)造方法和必傳參數(shù)的構(gòu)造方法，使用 lombok 將更改成如下寫法（@RequiredArgsConstructor 和 @NonNull）:

@Accessors(chain = true)
@Setter
@Getter
@RequiredArgsConstructor(staticName = "ofName")
public class Student {
    @NonNull private String name;
    private int age;
}

測(cè)試代碼：

Student student = Student.ofName("zs");

這樣構(gòu)建出的 bean 語(yǔ)義是否要比直接 new 一個(gè)含參的構(gòu)造方法(包含 name 的構(gòu)造方法)要好很多。

當(dāng)然，看過(guò)很多源碼以后，我想相信將靜態(tài)構(gòu)造方法 ofName 換成 of 會(huì)先的更加簡(jiǎn)潔：

@Accessors(chain = true)
@Setter
@Getter
@RequiredArgsConstructor(staticName = "of")
public class Student {
        @NonNull private String name;
        private int age;
}

測(cè)試代碼：

Student student = Student.of("zs");

當(dāng)然他仍然是支持鏈?zhǔn)秸{(diào)用的：

Student student = Student.of("zs").setAge(24);

這樣來(lái)寫代碼，真的很簡(jiǎn)潔，并且可讀性很強(qiáng)。

使用 builder

@Builder
public class Student {
    private String name;
    private int age;
}

調(diào)用方式：

Student student = Student.builder().name("zs").age(24).build();

代理模式

正如我們所知的，在程序中調(diào)用 rest 接口是一個(gè)常見的行為動(dòng)作，如果你和我一樣使用過(guò) spring 的 RestTemplate，我相信你會(huì)我和一樣，對(duì)他拋出的非 http 狀態(tài)碼異常深惡痛絕。

所以我們考慮將 RestTemplate 最為底層包裝器進(jìn)行包裝器模式的設(shè)計(jì)：

public abstract class FilterRestTemplate implements RestOperations {
        protected volatile RestTemplate restTemplate;

        protected FilterRestTemplate(RestTemplate restTemplate){
                this.restTemplate = restTemplate;
        }

        //實(shí)現(xiàn)RestOperations所有的接口
}

然后再由擴(kuò)展類對(duì) FilterRestTemplate 進(jìn)行包裝擴(kuò)展：

public class ExtractRestTemplate extends FilterRestTemplate {
    private RestTemplate restTemplate;
    public ExtractRestTemplate(RestTemplate restTemplate) {
            super(restTemplate);
            this.restTemplate = restTemplate;
    }

    public  RestResponseDTO postForEntityWithNoException(String url, Object request, Class responseType, Object... uriVariables)
                    throws RestClientException {
            RestResponseDTO restResponseDTO = new RestResponseDTO();
            ResponseEntity tResponseEntity;
            try {
                    tResponseEntity = restTemplate.postForEntity(url, request, responseType, uriVariables);
                    restResponseDTO.setData(tResponseEntity.getBody());
                    restResponseDTO.setMessage(tResponseEntity.getStatusCode().name());
                    restResponseDTO.setStatusCode(tResponseEntity.getStatusCodeValue());
            }catch (Exception e){
                    restResponseDTO.setStatusCode(RestResponseDTO.UNKNOWN_ERROR);
                    restResponseDTO.setMessage(e.getMessage());
                    restResponseDTO.setData(null);
            }
            return restResponseDTO;
    }
}

包裝器 ExtractRestTemplate 很完美的更改了異常拋出的行為，讓程序更具有容錯(cuò)性。在這里我們不考慮 ExtractRestTemplate 完成的功能，讓我們把焦點(diǎn)放在 FilterRestTemplate 上，“實(shí)現(xiàn) RestOperations 所有的接口”,這個(gè)操作絕對(duì)不是一時(shí)半會(huì)可以寫完的，當(dāng)時(shí)在重構(gòu)之前我?guī)缀鯇懥税雮€(gè)小時(shí),如下：

public abstract class FilterRestTemplate implements RestOperations {

    protected volatile RestTemplate restTemplate;

    protected FilterRestTemplate(RestTemplate restTemplate) {
            this.restTemplate = restTemplate;
    }

    @Override
    public  T getForObject(String url, Class responseType, Object... uriVariables) throws RestClientException {
            return restTemplate.getForObject(url,responseType,uriVariables);
    }

    @Override
    public  T getForObject(String url, Class responseType, Map uriVariables) throws RestClientException {
            return restTemplate.getForObject(url,responseType,uriVariables);
    }

    @Override
    public  T getForObject(URI url, Class responseType) throws RestClientException {
            return restTemplate.getForObject(url,responseType);
    }

    @Override
    public  ResponseEntity getForEntity(String url, Class responseType, Object... uriVariables) throws RestClientException {
            return restTemplate.getForEntity(url,responseType,uriVariables);
    }
    //其他實(shí)現(xiàn)代碼略。。。
}

我相信你看了以上代碼，你會(huì)和我一樣覺得惡心反胃，后來(lái)我用 lombok 提供的代理注解優(yōu)化了我的代碼(@Delegate)：

@AllArgsConstructor
public abstract class FilterRestTemplate implements RestOperations {
    @Delegate
    protected volatile RestTemplate restTemplate;
}

這幾行代碼完全替代上述那些冗長(zhǎng)的代碼。

是不是很簡(jiǎn)潔，做一個(gè)擁抱 lombok 的程序員吧。