細思極恐-你真的會寫java嗎?

轉載自:https://www.itcodemonkey.com/article/6309.html

導語

自2013年畢業(yè)后,今年已經是我工作的第4個年頭了驹针,總在做java相關的工作,終于有時間坐下來,寫一篇關于java寫法的一篇文章,來探討一下如果你真的是一個java程序員岁忘,那你真的會寫java嗎?
筆者是一個務實的程序員,故本文絕非扯淡文章区匠,文中內容都是干貨干像,望讀者看后,能有所收獲辱志。

文章核心

其實蝠筑,本不想把標題寫的那么恐怖,只是發(fā)現(xiàn)很多人干了幾年java以后揩懒,都自認為是一個不錯的java程序員了,可以拿著上萬的工資都處宣揚自己了挽封,寫這篇文章的目的并不是嘲諷和我一樣做java的同行們已球,只是希望讀者看到此騙文章后,可以和我一樣辅愿,心平氣和的爭取做一個優(yōu)秀的程序員智亮。

講述方向

由于一直從事移動互聯(lián)網相關工作,java開發(fā)中經常和移動端打交道或者做一些后端的工作点待,所以本篇文章更可能涉及和移動端的交互或者與后端的交互方式阔蛉,筆者希望以自身的一些學習經驗或者開發(fā)經驗,可以帶動認真閱讀本篇文章的讀者們癞埠,讓大家對java有一個更好的態(tài)度去學習它状原,它不只是一個賺錢的工具而已聋呢。

筆者身邊有很多與筆者年齡相仿或年齡更大的朋友或同事,經常有人問我:“你現(xiàn)在還在學習嗎颠区?我覺得沒什么好學的削锰,這些東西都差不多”,我總是回答只要有時間毕莱,我就要看一會書器贩,這個時候,大家都會露出一副不屑的眼神或笑容朋截。其實蛹稍,非常能理解身邊朋友或同事的看法,以目前狀態(tài)來講部服,大多都是工作至少5年的程序員了稳摄,對于公司大大小小的業(yè)務需要,以目前的知識儲備來講饲宿,都可以輕松應對厦酬,“沒有什么好學的”其實這句話沒有多大的問題,但是瘫想,如果你對編程還有一點點興趣仗阅,只是不知道如何努力或改進,希望本篇文章可以幫到你国夜。

技術點

本文不是一個吹噓的文章减噪,不會講很多高深的架構,相反车吹,會講解很多基礎的問題和寫法問題筹裕,如果讀者自認為基礎問題和寫法問題都是不是問題,那請忽略這篇文章窄驹,節(jié)省出時間去做一些有意義的事情朝卒。

開發(fā)工具

不知道有多少”老”程序員還在使用eclipse,這些程序員們要不就是因循守舊乐埠,要不就是根本就不知道其他好的開發(fā)工具的存在抗斤,eclipse吃內存卡頓的現(xiàn)象以及各種偶然莫名異常的出現(xiàn),都告知我們是時候尋找新的開發(fā)工具了丈咐。

更換IDE

根本就不想多解釋要換什么樣的IDE瑞眼,如果你想成為一個優(yōu)秀的java程序員,請更換intellij idea. 使用idea的好處棵逊,請搜索谷歌伤疙。

別告訴我快捷鍵不好用

更換IDE不在我本文的重點內容中,所以不下想用太多的篇幅去寫為什么更換IDE辆影,請谷歌徒像。

在這里黍特,我只能告訴你,更換IDE只為了更好厨姚、更快的寫好java代碼衅澈。原因略。

別告訴我快捷鍵不好用谬墙,請嘗試新事物今布。

bean

bean使我們使用最多的模型之一,我將以大篇幅去講解bean拭抬,希望讀者好好體會部默。

domain包名

根據(jù)很多java程序員的”經驗”來看,一個數(shù)據(jù)庫表則對應著一個domain對象造虎,所以很多程序員在寫代碼時傅蹂,包名則使用:com.xxx.domain ,這樣寫好像已經成為了行業(yè)的一種約束算凿,數(shù)據(jù)庫映射對象就應該是domain份蝴。但是你錯了,domain是一個領域對象氓轰,往往我們再做傳統(tǒng)java軟件web開發(fā)中婚夫,這些domain都是貧血模型,是沒有行為的署鸡,或是沒有足夠的領域模型的行為的案糙,所以,以這個理論來講靴庆,這些domain都應該是一個普通的entity對象时捌,并非領域對象,所以請把包名改為:com.xxx.entity炉抒。

如果你還不理解我說的話奢讨,請看一下Vaughn Vernon出的一本叫做《IMPLEMENTING DOMAIN-DRIVEN DESIGN》(實現(xiàn)領域驅動設計)這本書,書中講解了貧血模型與領域模型的區(qū)別端礼,相信你會受益匪淺禽笑。

DTO

數(shù)據(jù)傳輸我們應該使用DTO對象作為傳輸對象,這是我們所約定的蛤奥,因為很長時間我一直都在做移動端api設計的工作,有很多人告訴我僚稿,他們認為只有給手機端傳輸數(shù)據(jù)的時候(input or output)凡桥,這些對象成為DTO對象蚀同。請注意缅刽!這種理解是錯誤的啊掏,只要是用于網絡傳輸?shù)膶ο螅覀兌颊J為他們可以當做是DTO對象衰猛,比如電商平臺中迟蜜,用戶進行下單,下單后的數(shù)據(jù)啡省,訂單會發(fā)到OMS 或者 ERP系統(tǒng)娜睛,這些對接的返回值以及入?yún)⒁步蠨TO對象。

我們約定某對象如果是DTO對象卦睹,就將名稱改為XXDTO,比如訂單下發(fā)OMS:OMSOrderInputDTO畦戒。

DTO轉化

正如我們所知,DTO為系統(tǒng)與外界交互的模型對象结序,那么肯定會有一個步驟是將DTO對象轉化為BO對象或者是普通的entity對象障斋,讓service層去處理。

場景

比如添加會員操作徐鹤,由于用于演示垃环,我只考慮用戶的一些簡單數(shù)據(jù),當后臺管理員點擊添加用戶時返敬,只需要傳過來用戶的姓名和年齡就可以了遂庄,后端接受到數(shù)據(jù)后,將添加創(chuàng)建時間和更新時間和默認密碼三個字段救赐,然后保存數(shù)據(jù)庫涧团。

@RequestMapping("/v1/api/user")
@RestController
public class UserApi {

    @Autowired
    private UserService userService;

    @PostMapping
    public User addUser(UserInputDTO userInputDTO){
        User user = new User();
        user.setUsername(userInputDTO.getUsername());
        user.setAge(userInputDTO.getAge());

        return userService.addUser(user);
    }
}

我們只關注一下上述代碼中的轉化代碼,其他內容請忽略:

User user = new User();
user.setUsername(userInputDTO.getUsername());
user.setAge(userInputDTO.getAge());

請使用工具

上邊的代碼经磅,從邏輯上講泌绣,是沒有問題的,只是這種寫法讓我很厭煩预厌,例子中只有兩個字段阿迈,如果有20個字段,我們要如何做呢轧叽? 一個一個進行set數(shù)據(jù)嗎苗沧?當然,如果你這么做了炭晒,肯定不會有什么問題待逞,但是美旧,這肯定不是一個最優(yōu)的做法孽惰。

網上有很多工具,支持淺拷貝或深拷貝的Utils. 舉個例子猴贰,我們可以使用org.springframework.beans.BeanUtils#copyProperties對代碼進行重構和優(yōu)化:

@PostMapping
public User addUser(UserInputDTO userInputDTO){
    User user = new User();
    BeanUtils.copyProperties(userInputDTO,user);

    return userService.addUser(user);
}

BeanUtils.copyProperties是一個淺拷貝方法,復制屬性時怜庸,我們只需要把DTO對象和要轉化的對象兩個的屬性值設置為一樣的名稱当犯,并且保證一樣的類型就可以了。如果你在做DTO轉化的時候一直使用set進行屬性賦值割疾,那么請嘗試這種方式簡化代碼嚎卫,讓代碼更加清晰!

轉化的語義

上邊的轉化過程,讀者看后肯定覺得優(yōu)雅很多宏榕,但是我們再寫java代碼時拓诸,更多的需要考慮語義的操作,再看上邊的代碼:

User user = new User();
BeanUtils.copyProperties(userInputDTO,user);

雖然這段代碼很好的簡化和優(yōu)化了代碼担扑,但是他的語義是有問題的恰响,我們需要提現(xiàn)一個轉化過程才好,所以代碼改成如下:

@PostMapping
 public User addUser(UserInputDTO userInputDTO){
         User user = convertFor(userInputDTO);

         return userService.addUser(user);
 }

 private User convertFor(UserInputDTO userInputDTO){

         User user = new User();
         BeanUtils.copyProperties(userInputDTO,user);
         return user;
 }

這是一個更好的語義寫法,雖然他麻煩了些涌献,但是可讀性大大增加了胚宦,在寫代碼時,我們應該盡量把語義層次差不多的放到一個方法中燕垃,比如:

User user = convertFor(userInputDTO);
return userService.addUser(user);

這兩段代碼都沒有暴露實現(xiàn)枢劝,都是在講如何在同一個方法中,做一組相同層次的語義操作卜壕,而不是暴露具體的實現(xiàn)您旁。

如上所述,是一種重構方式轴捎,讀者可以參考Martin Fowler的《Refactoring Imporving the Design of Existing Code》(重構 改善既有代碼的設計) 這本書中的Extract Method重構方式鹤盒。

抽象接口定義

當實際工作中,完成了幾個api的DTO轉化時侦副,我們會發(fā)現(xiàn)侦锯,這樣的操作有很多很多,那么應該定義好一個接口秦驯,讓所有這樣的操作都有規(guī)則的進行尺碰。
如果接口被定義以后,那么convertFor這個方法的語義將產生變化译隘,他將是一個實現(xiàn)類亲桥。

看一下抽象后的接口:

public interface DTOConvert<S,T> {
    T convert(S s);
}

雖然這個接口很簡單,但是這里告訴我們一個事情固耘,要去使用泛型题篷,如果你是一個優(yōu)秀的java程序員,請為你想做的抽象接口厅目,做好泛型吧悼凑。

我們再來看接口實現(xiàn):

public class UserInputDTOConvert implements DTOConvert {
    @Override
    public User convert(UserInputDTO userInputDTO) {
        User user = new User();
        BeanUtils.copyProperties(userInputDTO,user);
        return user;
    }
}

我們這樣重構后偿枕,我們發(fā)現(xiàn)現(xiàn)在的代碼是如此的簡潔璧瞬,并且那么的規(guī)范:

@RequestMapping("/v1/api/user")
@RestController
public class UserApi {

    @Autowired
    private UserService userService;

    @PostMapping
    public User addUser(UserInputDTO userInputDTO){
        User user = new UserInputDTOConvert().convert(userInputDTO);

        return userService.addUser(user);
    }
}

review code

如果你是一個優(yōu)秀的java程序員户辫,我相信你應該和我一樣,已經數(shù)次重復review過自己的代碼很多次了嗤锉。
我們再看這個保存用戶的例子渔欢,你將發(fā)現(xiàn),api中返回值是有些問題的瘟忱,問題就在于不應該直接返回User實體奥额,因為如果這樣的話,就暴露了太多實體相關的信息访诱,這樣的返回值是不安全的垫挨,所以我們更應該返回一個DTO對象,我們可稱它為UserOutputDTO:

@PostMapping
public UserOutputDTO addUser(UserInputDTO userInputDTO){
        User user = new UserInputDTOConvert().convert(userInputDTO);
        User saveUserResult = userService.addUser(user);
        UserOutputDTO result = new UserOutDTOConvert().convertToUser(saveUserResult);
        return result;
}

這樣你的api才更健全触菜。

不知道在看完這段代碼之后九榔,讀者有是否發(fā)現(xiàn)還有其他問題的存在,作為一個優(yōu)秀的java程序員涡相,請看一下這段我們剛剛抽象完的代碼:

User user = new UserInputDTOConvert().convert(userInputDTO);

你會發(fā)現(xiàn)哲泊,new這樣一個DTO轉化對象是沒有必要的,而且每一個轉化對象都是由在遇到DTO轉化的時候才會出現(xiàn)催蝗,那我們應該考慮一下切威,是否可以將這個類和DTO進行聚合呢,看一下我的聚合結果:

public class UserInputDTO {
private String username;
private int age;

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }


    public User convertToUser(){
        UserInputDTOConvert userInputDTOConvert = new UserInputDTOConvert();
        User convert = userInputDTOConvert.convert(this);
        return convert;
    }

    private static class UserInputDTOConvert implements DTOConvert<UserInputDTO,User> {
        @Override
        public User convert(UserInputDTO userInputDTO) {
            User user = new User();
            BeanUtils.copyProperties(userInputDTO,user);
            return user;
        }
    }

}

然后api中的轉化則由:

User user = new UserInputDTOConvert().convert(userInputDTO);
User saveUserResult = userService.addUser(user);

變成了:

User user = userInputDTO.convertToUser();
User saveUserResult = userService.addUser(user);

我們再DTO對象中添加了轉化的行為丙号,我相信這樣的操作可以讓代碼的可讀性變得更強先朦,并且是符合語義的。

再查工具類

再來看DTO內部轉化的代碼犬缨,它實現(xiàn)了我們自己定義的DTOConvert接口喳魏,但是這樣真的就沒有問題,不需要再思考了嗎遍尺?
我覺得并不是截酷,對于Convert這種轉化語義來講,很多工具類中都有這樣的定義乾戏,這中Convert并不是業(yè)務級別上的接口定義迂苛,它只是用于普通bean之間轉化屬性值的普通意義上的接口定義,所以我們應該更多的去讀其他含有Convert轉化語義的代碼鼓择。
我仔細閱讀了一下GUAVA的源碼三幻,發(fā)現(xiàn)了com.google.common.base.Convert這樣的定義:

public abstract class Converter<A, B> implements Function<A, B> {
    protected abstract B doForward(A a);
    protected abstract A doBackward(B b);
    //其他略
}

從源碼可以了解到,GUAVA中的Convert可以完成正向轉化和逆向轉化呐能,繼續(xù)修改我們DTO中轉化的這段代碼:

private static class UserInputDTOConvert implements DTOConvert<UserInputDTO,User> {
        @Override
        public User convert(UserInputDTO userInputDTO) {
                User user = new User();
                BeanUtils.copyProperties(userInputDTO,user);
                return user;
        }
}

修改后:

private static class UserInputDTOConvert extends Converter<UserInputDTO, User> {
         @Override
         protected User doForward(UserInputDTO userInputDTO) {
                 User user = new User();
                 BeanUtils.copyProperties(userInputDTO,user);
                 return user;
         }

         @Override
         protected UserInputDTO doBackward(User user) {
                 UserInputDTO userInputDTO = new UserInputDTO();
                 BeanUtils.copyProperties(user,userInputDTO);
                 return userInputDTO;
         }
 }

看了這部分代碼以后念搬,你可能會問抑堡,那逆向轉化會有什么用呢?其實我們有很多小的業(yè)務需求中朗徊,入?yún)⒑统鰠⑹且粯拥氖籽敲次覀冏兛梢暂p松的進行轉化,我將上邊所提到的UserInputDTO和UserOutputDTO都轉成UserDTO展示給大家:
DTO:

public class UserDTO {
    private String username;
    private int age;

    public String getUsername() {
            return username;
    }

    public void setUsername(String username) {
            this.username = username;
    }

    public int getAge() {
            return age;
    }

    public void setAge(int age) {
            this.age = 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<UserDTO, User> {
            @Override
            protected User doForward(UserDTO userDTO) {
                    User user = new User();
                    BeanUtils.copyProperties(userDTO,user);
                    return user;
            }

            @Override
            protected UserDTO doBackward(User user) {
                    UserDTO userDTO = new UserDTO();
                    BeanUtils.copyProperties(user,userDTO);
                    return userDTO;
            }
    }

}

api:

@PostMapping
 public UserDTO addUser(UserDTO userDTO){
         User user =  userDTO.convertToUser();
         User saveResultUser = userService.addUser(user);
         UserDTO result = userDTO.convertFor(saveResultUser);
         return result;
 }

當然爷恳,上述只是表明了轉化方向的正向或逆向有缆,很多業(yè)務需求的出參和入?yún)⒌腄TO對象是不同的,那么你需要更明顯的告訴程序:逆向是無法調用的:

private static class UserDTOConvert extends Converter<UserDTO, User> {
         @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("不支持逆向轉化方法!");
         }
 }

看一下doBackward方法温亲,直接拋出了一個斷言異常棚壁,而不是業(yè)務異常,這段代碼告訴代碼的調用者栈虚,這個方法不是準你調用的袖外,如果你調用,我就”斷言”你調用錯誤了魂务。

關于異常處理的更詳細介紹曼验,可以參考我之前的文章:如何優(yōu)雅的設計java異常 ,應該可以幫你更好的理解異常头镊。

bean的驗證

如果你認為我上邊寫的那個添加用戶api寫的已經非常完美了蚣驼,那只能說明你還不是一個優(yōu)秀的程序員。我們應該保證任何數(shù)據(jù)的入?yún)⒌椒椒w內都是合法的相艇。

為什么要驗證

很多人會告訴我颖杏,如果這些api是提供給前端進行調用的,前端都會進行驗證啊坛芽,你為什還要驗證留储?
其實答案是這樣的,我從不相信任何調用我api或者方法的人咙轩,比如前端驗證失敗了获讳,或者某些人通過一些特殊的渠道(比如Charles進行抓包),直接將數(shù)據(jù)傳入到我的api,那我仍然進行正常的業(yè)務邏輯處理活喊,那么就有可能產生臟數(shù)據(jù)丐膝!
“對于臟數(shù)據(jù)的產生一定是致命”,這句話希望大家牢記在心钾菊,再小的臟數(shù)據(jù)也有可能讓你找?guī)讉€通宵帅矗!

jsr 303驗證

hibernate提供的jsr 303實現(xiàn),我覺得目前仍然是很優(yōu)秀的煞烫,具體如何使用浑此,我不想講,因為谷歌上你可以搜索出很多答案!
再以上班的api實例進行說明滞详,我們現(xiàn)在對DTO數(shù)據(jù)進行檢查:

public class UserDTO {
    @NotNull
    private String username;
    @NotNull
    private int age;
        //其他代碼略
}

api:

@PostMapping
    public UserDTO addUser(@Valid UserDTO userDTO){
            User user =  userDTO.convertToUser();
            User saveResultUser = userService.addUser(user);
            UserDTO result = userDTO.convertFor(saveResultUser);
            return result;
    }

我們需要將驗證結果傳給前端凛俱,這種異常應該轉化為一個api異常(帶有錯誤碼的異常)紊馏。

@PostMapping
public UserDTO addUser(@Valid UserDTO userDTO, BindingResult bindingResult){
     checkDTOParams(bindingResult);

     User user =  userDTO.convertToUser();
     User saveResultUser = userService.addUser(user);
     UserDTO result = userDTO.convertFor(saveResultUser);
     return result;
}
private void checkDTOParams(BindingResult bindingResult){
     if(bindingResult.hasErrors()){
             //throw new 帶驗證碼的驗證錯誤異常
     }
}

BindingResult是Spring MVC驗證DTO后的一個結果集,可以參考spring 官方文檔

檢查參數(shù)后蒲犬,可以拋出一個“帶驗證碼的驗證錯誤異持旒啵”,具體異常設計可以參考如何優(yōu)雅的設計java異常

擁抱lombok

上邊的DTO代碼暖哨,已經讓我看的很累了赌朋,我相信讀者也是一樣,看到那么多的Getter和Setter方法篇裁,太煩躁了,那時候有什么方法可以簡化這些呢赡若。
請擁抱lombok,它會幫助我們解決一些讓我們很煩躁的問題

去掉Setter和Getter

其實這個標題达布,我不太想說,因為網上太多逾冬,但是因為很多人告訴我黍聂,他們根本就不知道lombok的存在,所以為了讓讀者更好的學習身腻,我愿意寫這樣一個例子:

@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<UserDTO, User> {
        @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("不支持逆向轉化方法!");
        }
    }

}

看到了吧产还,煩人的Getter和Setter方法已經去掉了。
但是上邊的例子根本不足以體現(xiàn)lombok的強大嘀趟。我希望寫一些網上很難查到脐区,或者很少人進行說明的lombok的使用以及在使用時程序語義上的說明。
比如:@Data,@AllArgsConstructor,@NoArgsConstructor..這些我就不進行一一說明了她按,請大家自行查詢資料.

bean中的鏈式風格

什么是鏈式風格牛隅?我來舉個例子,看下面這個Student的bean:

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;
    }
}

仔細看一下set方法酌泰,這樣的設置便是chain的style媒佣,調用的時候,可以這樣使用:

Student student = new Student()
        .setAge(24)
        .setName("zs");

相信合理使用這樣的鏈式代碼陵刹,會更多的程序帶來很好的可讀性默伍,那看一下如果使用lombok進行改善呢,請使用 @Accessors(chain = true),看如下代碼:

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

這樣就完成了一個對于bean來講很友好的鏈式操作衰琐。

靜態(tài)構造方法

靜態(tài)構造方法的語義和簡化程度真的高于直接去new一個對象也糊。比如new一個List對象,過去的使用是這樣的:

List<String> list = new ArrayList<>();

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

List<String> list = Lists.newArrayList();

Lists命名是一種約定(俗話說:約定優(yōu)于配置)碘耳,它是指Lists是List這個類的一個工具類显设,那么使用List的工具類去產生List,這樣的語義是不是要比直接new一個子類來的更直接一些呢辛辨,答案是肯定的捕捂,再比如如果有一個工具類叫做Maps瑟枫,那你是否想到了創(chuàng)建Map的方法呢:

HashMap<String, String> objectObjectHashMap = Maps.newHashMap();

好了,如果你理解了我說的語義指攒,那么慷妙,你已經向成為java程序員更近了一步了。

再回過頭來看剛剛的Student允悦,很多時候膝擂,我們去寫Student這個bean的時候,他會有一些必輸字段隙弛,比如Student中的name字段架馋,一般處理的方式是將name字段包裝成一個構造方法,只有傳入name這樣的構造方法全闷,才能創(chuàng)建一個Student對象叉寂。

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

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

測試代碼:

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

這樣構建出的bean語義是否要比直接new一個含參的構造方法(包含 name的構造方法)要好很多总珠。

當然屏鳍,看過很多源碼以后,我想相信將靜態(tài)構造方法ofName換成of會先的更加簡潔:

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

測試代碼:

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

當然他仍然是支持鏈式調用的:

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

這樣來寫代碼局服,真的很簡潔钓瞭,并且可讀性很強。

使用builder

Builder模式我不想再多解釋了淫奔,讀者可以看一下《Head First》(設計模式) 的建造者模式山涡。

今天其實要說的是一種變種的builder模式,那就是構建bean的builder模式搏讶,其實主要的思想是帶著大家一起看一下lombok給我們帶來了什么佳鳖。

看一下Student這個類的原始builder狀態(tài):

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

    public String getName() {
            return name;
    }

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

    public int getAge() {
            return age;
    }

    public void setAge(int age) {
            this.age = age;
    }

    public static Builder builder(){
            return new Builder();
    }
    public static class Builder{
            private String name;
            private int age;
            public Builder name(String name){
                    this.name = name;
                    return this;
            }

            public Builder age(int age){
                    this.age = age;
                    return this;
            }

            public Student build(){
                    Student student = new Student();
                    student.setAge(age);
                    student.setName(name);
                    return student;
            }
    }

}

調用方式:

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

這樣的builder代碼,讓我是在惡心難受媒惕,于是我打算用lombok重構這段代碼:

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

調用方式:

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

代理模式

正如我們所知的系吩,在程序中調用rest接口是一個常見的行為動作,如果你和我一樣使用過spring 的RestTemplate,我相信你會我和一樣妒蔚,對他拋出的非http狀態(tài)碼異常深惡痛絕穿挨。

所以我們考慮將RestTemplate最為底層包裝器進行包裝器模式的設計:

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

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

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

然后再由擴展類對FilterRestTemplate進行包裝擴展:

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

    public <T> RestResponseDTO<T> postForEntityWithNoException(String url, Object request, Class<T> responseType, Object... uriVariables)
                    throws RestClientException {
            RestResponseDTO<T> restResponseDTO = new RestResponseDTO<T>();
            ResponseEntity<T> 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很完美的更改了異常拋出的行為,讓程序更具有容錯性肴盏。在這里我們不考慮ExtractRestTemplate完成的功能科盛,讓我們把焦點放在FilterRestTemplate上,“實現(xiàn)RestOperations所有的接口”,這個操作絕對不是一時半會可以寫完的菜皂,當時在重構之前我?guī)缀鯇懥税雮€小時,如下:

public abstract class FilterRestTemplate implements RestOperations {

    protected volatile RestTemplate restTemplate;

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

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

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

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

    @Override
    public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... uriVariables) throws RestClientException {
            return restTemplate.getForEntity(url,responseType,uriVariables);
    }
    //其他實現(xiàn)代碼略贞绵。。恍飘。
}

我相信你看了以上代碼榨崩,你會和我一樣覺得惡心反胃谴垫,后來我用lombok提供的代理注解優(yōu)化了我的代碼(@Delegate):

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

這幾行代碼完全替代上述那些冗長的代碼。
是不是很簡潔母蛛,做一個擁抱lombok的程序員吧翩剪。

重構

需求案例

項目需求

項目開發(fā)階段,有一個關于下單發(fā)貨的需求:如果今天下午3點前進行下單彩郊,那么發(fā)貨時間是明天前弯,如果今天下午3點后進行下單,那么發(fā)貨時間是后天秫逝,如果被確定的時間是周日恕出,那么在此時間上再加1天為發(fā)貨時間。

思考與重構

我相信這個需求看似很簡單筷登,無論怎么寫都可以完成剃根。

很多人可能看到這個需求,就動手開始寫Calendar或Date進行計算前方,從而完成需求。

而我給的建議是廉油,仔細考慮如何寫代碼惠险,然后再去寫,不是說所有的時間操作都用Calendar或Date去解決抒线,一定要看場景班巩。

對于時間的計算我們要考慮joda-time這種類似的成熟時間計算框架來寫代碼,它會讓代碼更加簡潔和易讀嘶炭。

請讀者先考慮這個需求如何用java代碼完成抱慌,或先寫一個你覺得完成這個代碼的思路,再來看我下邊的代碼眨猎,這樣抑进,你的收獲會更多一些:

final DateTime DISTRIBUTION_TIME_SPLIT_TIME = new DateTime().withTime(15,0,0,0);
private Date calculateDistributionTimeByOrderCreateTime(Date orderCreateTime){
    DateTime orderCreateDateTime = new DateTime(orderCreateTime);
    Date tomorrow = orderCreateDateTime.plusDays(1).toDate();
    Date theDayAfterTomorrow = orderCreateDateTime.plusDays(2).toDate();
    return orderCreateDateTime.isAfter(DISTRIBUTION_TIME_SPLIT_TIME) ? wrapDistributionTime(theDayAfterTomorrow) : wrapDistributionTime(tomorrow);
}
private Date wrapDistributionTime(Date distributionTime){
    DateTime currentDistributionDateTime = new DateTime(distributionTime);
    DateTime plusOneDay = currentDistributionDateTime.plusDays(1);
    boolean isSunday = (DateTimeConstants.SUNDAY == currentDistributionDateTime.getDayOfWeek());
    return isSunday ? plusOneDay.toDate() : currentDistributionDateTime.toDate() ;
}

讀這段代碼的時候,你會發(fā)現(xiàn)睡陪,我將判斷和有可能出現(xiàn)的不同結果都當做一個變量寺渗,最終做一個三目運算符的方式進行返回,這樣的優(yōu)雅和可讀性顯而易見兰迫,當然這樣的代碼不是一蹴而就的信殊,我優(yōu)化了3遍產生的以上代碼。讀者可根據(jù)自己的代碼和我寫的代碼進行對比汁果。

提高方法
如果你做了3年+的程序員涡拘,我相信像如上這樣的需求,你很輕松就能完成鳄乏,但是如果你想做一個會寫java的程序員姓赤,就好好的思考和重構代碼吧。
寫代碼就如同寫字一樣,同樣的字,大家都會寫距芬,但是寫出來是否好看就不一定了。如果想把程序寫好离斩,就要不斷的思考和重構棋弥,敢于嘗試宪祥,敢于創(chuàng)新仁锯,不要因循守舊野芒,一定要做一個優(yōu)秀的java程序員。
提高代碼水平最好的方法就是有條理的重構丹拯!(注意:是有條理的重構)

設計模式

設計模式就是工具融求,而不是提現(xiàn)你是否是高水平程序員的一個指標县昂。

我經常會看到某一個程序員興奮的大喊,哪個程序哪個點我用到了設計模式预明,寫的多么多么優(yōu)秀酥馍,多么多么好。我仔細去翻閱的時候,卻發(fā)現(xiàn)有很多是過度設計的。

業(yè)務驅動技術 or 技術驅動業(yè)務

業(yè)務驅動技術 or 技術驅動業(yè)務 兴想? 其實這是一個一直在爭論的話題闸与,但是很多人不這么認為几迄,我覺得就是大家不愿意承認罷了。我來和大家大概分析一下作為一個java程序員弛姜,我們應該如何判斷自己所處于的位置.

業(yè)務驅動技術:如果你所在的項目是一個收益很小或者甚至沒有收益的項目寂恬,請不要搞其他創(chuàng)新的東西莱没,不要驅動業(yè)務要如何如何做初肉,而是要熟知業(yè)務現(xiàn)在的痛點是什么?如何才能幫助業(yè)務盈利或者讓項目更好饰躲,更順利的進行牙咏。

技術驅動業(yè)務:如果你所在的項目是一個很牛的項目,比如淘寶這類的項目嘹裂,我可以在滿足業(yè)務需求的情況下妄壶,和業(yè)務溝通,使用什么樣的技術能更好的幫助業(yè)務創(chuàng)造收益焦蘑,比如說下單的時候要進隊列盯拱,可能幾分鐘之后訂單狀態(tài)才能處理完成,但是會讓用戶有更流暢的體驗,賺取更多的訪問流量狡逢,那么我相信業(yè)務愿意被技術驅動宁舰,會同意訂單的延遲問題,這樣便是技術驅動業(yè)務奢浑。

我相信大部分人還都處于業(yè)務驅動技術的方向吧蛮艰。

所以你既然不能驅動業(yè)務,那就請擁抱業(yè)務變化吧雀彼。

代碼設計

一直在做java后端的項目壤蚜,經常會有一些變動,我相信大家也都遇到過徊哑。

比如當我們寫一段代碼的時候袜刷,我們考慮將需求映射成代碼的狀態(tài)模式,突然有一天莺丑,狀態(tài)模式里邊又添加了很多行為變化的東西著蟹,這時候你就撓頭了,你硬生生的將狀態(tài)模式中添加過多行為和變化梢莽。

慢慢的你會發(fā)現(xiàn)這些狀態(tài)模式萧豆,其實更像是一簇算法,應該使用策略模式昏名,這時你應該已經暈頭轉向了涮雷。

說了這么多,我的意思是轻局,只要你覺得合理洪鸭,就請將狀態(tài)模式改為策略模式吧,所有的模式并不是憑空想象出來的仑扑,都是基于重構卿嘲。

java編程中沒有銀彈,請擁抱業(yè)務變化夫壁,一直思考重構,你就有一個更好的代碼設計!

你真的優(yōu)秀嗎沃疮?

真不好意思盒让,我取了一個這么無聊的標題。

國外流行一種編程方式司蔬,叫做結對編程邑茄,我相信國內很多公司都沒有這么做,我就不在講述結對編程帶來的好處了俊啼,其實就是一邊code review肺缕,一邊互相提高的一個過程。既然做不到這個,那如何讓自己活在自己的世界中不斷提高呢同木?

“平時開發(fā)的時候浮梢,做出的代碼總認為是正確的,而且寫法是完美的彤路★跸酰”,我相信這是大部分人的心聲洲尊,還回到剛剛的問題远豺,如何在自己的世界中不斷提高呢?
答案就是:

多看成熟框架的源碼
多回頭看自己的代碼
勤于重構
你真的優(yōu)秀嗎坞嘀? 如果你每周都完成了學習源碼躯护,回頭看自己代碼,然后勤于重構丽涩,我認為你就真的很優(yōu)秀了棺滞。

即使也許你只是剛剛入門,但是一直堅持内狸,你就是一個真的會寫java代碼的程序員了检眯。

技能

UML

不想多討論UML相關的知識,但是我覺得你如果真的會寫java昆淡,請先學會表達自己锰瘸,UML就是你說話的語言,做一名優(yōu)秀的java程序員昂灵,請至少學會這兩種UML圖:

類圖
時序圖

clean code

我認為保持代碼的簡潔和可讀性是代碼的最基本保證避凝,如果有一天為了程序的效率而降低了這兩點,我認為是可以諒解的眨补,除此之外管削,沒有任何理由可以讓你任意揮霍你的代碼。

讀者可以看一下Robert C. Martin出版的《Clean Code》(代碼整潔之道) 這本書
可以參考美團文章聊聊clean code
也可以看一下阿里的Java編碼規(guī)范
無論如何撑螺,請保持你的代碼的整潔含思。

linux 基礎命令

這點其實和會寫java沒有關系,但是linux很多時候確實承載運行java的容器甘晤,請學好linux的基礎命令含潘。

參考鳥哥的《Linux私房菜》

總結

java是一個大體系,今天討論并未涉及框架和架構相關知識线婚,只是討論如何寫好代碼遏弱。

本文從寫java程序的小方面一直寫到大方面,來闡述了如何才能寫好java程序塞弊,并告訴讀者們如何才能提高自身的編碼水平漱逸。

我希望看到這篇文章的各位都能做一個優(yōu)秀的java程序員泪姨。

?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市饰抒,隨后出現(xiàn)的幾起案子肮砾,更是在濱河造成了極大的恐慌,老刑警劉巖循集,帶你破解...
    沈念sama閱讀 206,126評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件唇敞,死亡現(xiàn)場離奇詭異,居然都是意外死亡咒彤,警方通過查閱死者的電腦和手機疆柔,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評論 2 382
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來镶柱,“玉大人旷档,你說我怎么就攤上這事⌒穑” “怎么了鞋屈?”我有些...
    開封第一講書人閱讀 152,445評論 0 341
  • 文/不壞的土叔 我叫張陵,是天一觀的道長故觅。 經常有香客問我厂庇,道長,這世上最難降的妖魔是什么输吏? 我笑而不...
    開封第一講書人閱讀 55,185評論 1 278
  • 正文 為了忘掉前任权旷,我火速辦了婚禮,結果婚禮上贯溅,老公的妹妹穿的比我還像新娘拄氯。我一直安慰自己,他們只是感情好它浅,可當我...
    茶點故事閱讀 64,178評論 5 371
  • 文/花漫 我一把揭開白布译柏。 她就那樣靜靜地躺著,像睡著了一般姐霍。 火紅的嫁衣襯著肌膚如雪鄙麦。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 48,970評論 1 284
  • 那天镊折,我揣著相機與錄音黔衡,去河邊找鬼。 笑死腌乡,一個胖子當著我的面吹牛,可吹牛的內容都是我干的夜牡。 我是一名探鬼主播与纽,決...
    沈念sama閱讀 38,276評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼侣签,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了急迂?” 一聲冷哼從身側響起影所,我...
    開封第一講書人閱讀 36,927評論 0 259
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎僚碎,沒想到半個月后猴娩,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經...
    沈念sama閱讀 43,400評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡勺阐,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 35,883評論 2 323
  • 正文 我和宋清朗相戀三年卷中,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片渊抽。...
    茶點故事閱讀 37,997評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖懒闷,靈堂內的尸體忽然破棺而出十减,到底是詐尸還是另有隱情,我是刑警寧澤愤估,帶...
    沈念sama閱讀 33,646評論 4 322
  • 正文 年R本政府宣布帮辟,位于F島的核電站,受9級特大地震影響玩焰,放射性物質發(fā)生泄漏由驹。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,213評論 3 307
  • 文/蒙蒙 一震捣、第九天 我趴在偏房一處隱蔽的房頂上張望荔棉。 院中可真熱鬧,春花似錦蒿赢、人聲如沸润樱。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽壹若。三九已至,卻和暖如春皂冰,著一層夾襖步出監(jiān)牢的瞬間店展,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評論 1 260
  • 我被黑心中介騙來泰國打工秃流, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留赂蕴,地道東北人。 一個月前我還...
    沈念sama閱讀 45,423評論 2 352
  • 正文 我出身青樓舶胀,卻偏偏與公主長得像概说,于是被迫代替她去往敵國和親碧注。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 42,722評論 2 345

推薦閱讀更多精彩內容

  • 圖片發(fā)自簡書App title: 細思極恐-你真的會寫java嗎?date: 2017-03-31 17:01:1...
    luosv閱讀 834評論 0 11
  • 文章核心 其實糖赔,本不想把標題寫的那么恐怖萍丐,只是發(fā)現(xiàn)很多人干了幾年java以后,都自認為是一個不錯的java程序員了...
    Java紅茶閱讀 1,158評論 3 34
  • 文章核心 其實,本不想把標題寫的那么恐怖奋构,只是發(fā)現(xiàn)很多人干了幾年java以后壳影,都自認為是一個不錯的java程序員了...
    Gallrax閱讀 681評論 0 4
  • 昨天刷到新聞,《扎克伯格砸下2億巨資的明星學校altschool關門了》态贤。 其實不是關門了,只是關了兩個校區(qū)醋火,所以...
    朵拉念力閱讀 950評論 0 0
  • 從一只狗開始
    王博森林閱讀 118評論 0 0