title: 細(xì)思極恐-你真的會(huì)寫java嗎?
date: 2017-03-31 17:01:12
categories: Java
tags: Java
本文轉(zhuǎn)載自Lrwin的java技術(shù)博客
導(dǎo)語(yǔ)
自2013年畢業(yè)后,今年已經(jīng)是我工作的第4個(gè)年頭了,總在做java相關(guān)的工作畴蒲,終于有時(shí)間坐下來(lái)奄抽,寫一篇關(guān)于java寫法的一篇文章岩榆,來(lái)探討一下如果你真的是一個(gè)java程序員窥翩,那你真的會(huì)寫java嗎?
筆者是一個(gè)務(wù)實(shí)的程序員,故本文絕非扯淡文章项贺,文中內(nèi)容都是干貨,望讀者看后峭判,能有所收獲开缎。
文章核心
其實(shí),本不想把標(biāo)題寫的那么恐怖林螃,只是發(fā)現(xiàn)很多人干了幾年java以后奕删,都自認(rèn)為是一個(gè)不錯(cuò)的java程序員了,可以拿著上萬(wàn)的工資都處宣揚(yáng)自己了疗认,寫這篇文章的目的并不是嘲諷和我一樣做java的同行們完残,只是希望讀者看到此騙文章后伏钠,可以和我一樣,心平氣和的爭(zhēng)取做一個(gè)優(yōu)秀的程序員谨设。
講述方向
由于一直從事移動(dòng)互聯(lián)網(wǎng)相關(guān)工作熟掂,java開(kāi)發(fā)中經(jīng)常和移動(dòng)端打交道或者做一些后端的工作,所以本篇文章更可能涉及和移動(dòng)端的交互或者與后端的交互方式扎拣,筆者希望以自身的一些學(xué)習(xí)經(jīng)驗(yàn)或者開(kāi)發(fā)經(jīng)驗(yàn)赴肚,可以帶動(dòng)認(rèn)真閱讀本篇文章的讀者們,讓大家對(duì)java有一個(gè)更好的態(tài)度去學(xué)習(xí)它二蓝,它不只是一個(gè)賺錢的工具而已誉券。
筆者身邊有很多與筆者年齡相仿或年齡更大的朋友或同事,經(jīng)常有人問(wèn)我:“你現(xiàn)在還在學(xué)習(xí)嗎刊愚?我覺(jué)得沒(méi)什么好學(xué)的踊跟,這些東西都差不多”,我總是回答只要有時(shí)間鸥诽,我就要看一會(huì)書商玫,這個(gè)時(shí)候,大家都會(huì)露出一副不屑的眼神或笑容衙传。其實(shí)决帖,非常能理解身邊朋友或同事的看法,以目前狀態(tài)來(lái)講蓖捶,大多都是工作至少5年的程序員了地回,對(duì)于公司大大小小的業(yè)務(wù)需要,以目前的知識(shí)儲(chǔ)備來(lái)講俊鱼,都可以輕松應(yīng)對(duì)刻像,“沒(méi)有什么好學(xué)的”其實(shí)這句話沒(méi)有多大的問(wèn)題,但是并闲,如果你對(duì)編程還有一點(diǎn)點(diǎn)興趣细睡,只是不知道如何努力或改進(jìn),希望本篇文章可以幫到你帝火。
技術(shù)點(diǎn)
本文不是一個(gè)吹噓的文章溜徙,不會(huì)講很多高深的架構(gòu),相反犀填,會(huì)講解很多基礎(chǔ)的問(wèn)題和寫法問(wèn)題蠢壹,如果讀者自認(rèn)為基礎(chǔ)問(wèn)題和寫法問(wèn)題都是不是問(wèn)題,那請(qǐng)忽略這篇文章九巡,節(jié)省出時(shí)間去做一些有意義的事情图贸。
開(kāi)發(fā)工具
不知道有多少”老”程序員還在使用eclipse,這些程序員們要不就是因循守舊,要不就是根本就不知道其他好的開(kāi)發(fā)工具的存在疏日,eclipse吃內(nèi)存卡頓的現(xiàn)象以及各種偶然莫名異常的出現(xiàn)偿洁,都告知我們是時(shí)候?qū)ふ倚碌拈_(kāi)發(fā)工具了。
更換IDE
根本就不想多解釋要換什么樣的IDE沟优,如果你想成為一個(gè)優(yōu)秀的java程序員涕滋,請(qǐng)更換intellij idea. 使用idea的好處,請(qǐng)搜索谷歌净神。
別告訴我快捷鍵不好用
更換IDE不在我本文的重點(diǎn)內(nèi)容中何吝,所以不下想用太多的篇幅去寫為什么更換IDE,請(qǐng)谷歌鹃唯。
在這里爱榕,我只能告訴你,更換IDE只為了更好坡慌、更快的寫好java代碼黔酥。原因略。
別告訴我快捷鍵不好用洪橘,請(qǐng)嘗試新事物跪者。
bean
bean使我們使用最多的模型之一,我將以大篇幅去講解bean熄求,希望讀者好好體會(huì)渣玲。
domain包名
根據(jù)很多java程序員的”經(jīng)驗(yàn)”來(lái)看,一個(gè)數(shù)據(jù)庫(kù)表則對(duì)應(yīng)著一個(gè)domain對(duì)象弟晚,所以很多程序員在寫代碼時(shí)忘衍,包名則使用:com.xxx.domain 攒暇,這樣寫好像已經(jīng)成為了行業(yè)的一種約束踊赠,數(shù)據(jù)庫(kù)映射對(duì)象就應(yīng)該是domain。但是你錯(cuò)了狡门,domain是一個(gè)領(lǐng)域?qū)ο笊海覀冊(cè)僮鰝鹘y(tǒng)java軟件web開(kāi)發(fā)中搀捷,這些domain都是貧血模型,是沒(méi)有行為的多望,或是沒(méi)有足夠的領(lǐng)域模型的行為的嫩舟,所以,以這個(gè)理論來(lái)講怀偷,這些domain都應(yīng)該是一個(gè)普通的entity對(duì)象至壤,并非領(lǐng)域?qū)ο螅哉?qǐng)把包名改為:com.xxx.entity枢纠。
如果你還不理解我說(shuō)的話,請(qǐng)看一下Vaughn Vernon出的一本叫做《IMPLEMENTING DOMAIN-DRIVEN DESIGN》(實(shí)現(xiàn)領(lǐng)域驅(qū)動(dòng)設(shè)計(jì))這本書,書中講解了貧血模型與領(lǐng)域模型的區(qū)別晋渺,相信你會(huì)受益匪淺镰绎。
DTO
數(shù)據(jù)傳輸我們應(yīng)該使用DTO對(duì)象作為傳輸對(duì)象,這是我們所約定的木西,因?yàn)楹荛L(zhǎng)時(shí)間我一直都在做移動(dòng)端api設(shè)計(jì)的工作畴栖,有很多人告訴我,他們認(rèn)為只有給手機(jī)端傳輸數(shù)據(jù)的時(shí)候(input or output)八千,這些對(duì)象成為DTO對(duì)象吗讶。請(qǐng)注意!這種理解是錯(cuò)誤的恋捆,只要是用于網(wǎng)絡(luò)傳輸?shù)膶?duì)象照皆,我們都認(rèn)為他們可以當(dāng)做是DTO對(duì)象,比如電商平臺(tái)中沸停,用戶進(jìn)行下單膜毁,下單后的數(shù)據(jù),訂單會(huì)發(fā)到OMS 或者 ERP系統(tǒng)愤钾,這些對(duì)接的返回值以及入?yún)⒁步蠨TO對(duì)象瘟滨。
我們約定某對(duì)象如果是DTO對(duì)象,就將名稱改為XXDTO,比如訂單下發(fā)OMS:OMSOrderInputDTO能颁。
DTO轉(zhuǎn)化
正如我們所知杂瘸,DTO為系統(tǒng)與外界交互的模型對(duì)象,那么肯定會(huì)有一個(gè)步驟是將DTO對(duì)象轉(zhuǎn)化為BO對(duì)象或者是普通的entity對(duì)象伙菊,讓service層去處理败玉。
場(chǎng)景
比如添加會(huì)員操作,由于用于演示占业,我只考慮用戶的一些簡(jiǎn)單數(shù)據(jù)绒怨,當(dāng)后臺(tái)管理員點(diǎn)擊添加用戶時(shí),只需要傳過(guò)來(lái)用戶的姓名和年齡就可以了谦疾,后端接受到數(shù)據(jù)后南蹂,將添加創(chuàng)建時(shí)間和更新時(shí)間和默認(rèn)密碼三個(gè)字段,然后保存數(shù)據(jù)庫(kù)念恍。
@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);
}
}
我們只關(guān)注一下上述代碼中的轉(zhuǎn)化代碼六剥,其他內(nèi)容請(qǐng)忽略:
User user = new User();
user.setUsername(userInputDTO.getUsername());
user.setAge(userInputDTO.getAge());
請(qǐng)使用工具
上邊的代碼,從邏輯上講峰伙,是沒(méi)有問(wèn)題的疗疟,只是這種寫法讓我很厭煩,例子中只有兩個(gè)字段瞳氓,如果有20個(gè)字段策彤,我們要如何做呢? 一個(gè)一個(gè)進(jìn)行set數(shù)據(jù)嗎?當(dāng)然店诗,如果你這么做了裹刮,肯定不會(huì)有什么問(wèn)題,但是庞瘸,這肯定不是一個(gè)最優(yōu)的做法捧弃。
網(wǎng)上有很多工具,支持淺拷貝或深拷貝的Utils. 舉個(gè)例子擦囊,我們可以使用org.springframework.beans.BeanUtils#copyProperties對(duì)代碼進(jìn)行重構(gòu)和優(yōu)化:
@PostMapping
public User addUser(UserInputDTO userInputDTO){
User user = new User();
BeanUtils.copyProperties(userInputDTO,user);
return userService.addUser(user);
}
BeanUtils.copyProperties是一個(gè)淺拷貝方法违霞,復(fù)制屬性時(shí),我們只需要把DTO對(duì)象和要轉(zhuǎn)化的對(duì)象兩個(gè)的屬性值設(shè)置為一樣的名稱瞬场,并且保證一樣的類型就可以了买鸽。如果你在做DTO轉(zhuǎn)化的時(shí)候一直使用set進(jìn)行屬性賦值,那么請(qǐng)嘗試這種方式簡(jiǎn)化代碼泌类,讓代碼更加清晰!
轉(zhuǎn)化的語(yǔ)義
上邊的轉(zhuǎn)化過(guò)程癞谒,讀者看后肯定覺(jué)得優(yōu)雅很多,但是我們?cè)賹慾ava代碼時(shí)刃榨,更多的需要考慮語(yǔ)義的操作弹砚,再看上邊的代碼:
User user = new User();
BeanUtils.copyProperties(userInputDTO,user);
雖然這段代碼很好的簡(jiǎn)化和優(yōu)化了代碼,但是他的語(yǔ)義是有問(wèn)題的枢希,我們需要提現(xiàn)一個(gè)轉(zhuǎn)化過(guò)程才好,所以代碼改成如下:
@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;
}
這是一個(gè)更好的語(yǔ)義寫法桌吃,雖然他麻煩了些,但是可讀性大大增加了苞轿,在寫代碼時(shí)茅诱,我們應(yīng)該盡量把語(yǔ)義層次差不多的放到一個(gè)方法中,比如:
User user = convertFor(userInputDTO);
return userService.addUser(user);
這兩段代碼都沒(méi)有暴露實(shí)現(xiàn)搬卒,都是在講如何在同一個(gè)方法中瑟俭,做一組相同層次的語(yǔ)義操作,而不是暴露具體的實(shí)現(xiàn)契邀。
如上所述摆寄,是一種重構(gòu)方式,讀者可以參考Martin Fowler的《Refactoring Imporving the Design of Existing Code》(重構(gòu) 改善既有代碼的設(shè)計(jì)) 這本書中的Extract Method重構(gòu)方式坯门。
抽象接口定義
當(dāng)實(shí)際工作中微饥,完成了幾個(gè)api的DTO轉(zhuǎn)化時(shí),我們會(huì)發(fā)現(xiàn)古戴,這樣的操作有很多很多欠橘,那么應(yīng)該定義好一個(gè)接口,讓所有這樣的操作都有規(guī)則的進(jìn)行现恼。
如果接口被定義以后肃续,那么convertFor這個(gè)方法的語(yǔ)義將產(chǎn)生變化黍檩,他將是一個(gè)實(shí)現(xiàn)類。
看一下抽象后的接口:
public interface DTOConvert<S,T> {
T convert(S s);
}
雖然這個(gè)接口很簡(jiǎn)單痹升,但是這里告訴我們一個(gè)事情建炫,要去使用泛型,如果你是一個(gè)優(yōu)秀的java程序員疼蛾,請(qǐng)為你想做的抽象接口,做好泛型吧艺配。
我們?cè)賮?lái)看接口實(shí)現(xiàn):
public class UserInputDTOConvert implements DTOConvert {
@Override
public User convert(UserInputDTO userInputDTO) {
User user = new User();
BeanUtils.copyProperties(userInputDTO,user);
return user;
}
}
我們這樣重構(gòu)后察郁,我們發(fā)現(xiàn)現(xiàn)在的代碼是如此的簡(jiǎ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
如果你是一個(gè)優(yōu)秀的java程序員转唉,我相信你應(yīng)該和我一樣皮钠,已經(jīng)數(shù)次重復(fù)review過(guò)自己的代碼很多次了。
我們?cè)倏催@個(gè)保存用戶的例子赠法,你將發(fā)現(xiàn)麦轰,api中返回值是有些問(wèn)題的,問(wèn)題就在于不應(yīng)該直接返回User實(shí)體砖织,因?yàn)槿绻@樣的話款侵,就暴露了太多實(shí)體相關(guān)的信息,這樣的返回值是不安全的侧纯,所以我們更應(yīng)該返回一個(gè)DTO對(duì)象新锈,我們可稱它為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)還有其他問(wèn)題的存在妹笆,作為一個(gè)優(yōu)秀的java程序員,請(qǐng)看一下這段我們剛剛抽象完的代碼:
User user = new UserInputDTOConvert().convert(userInputDTO);
你會(huì)發(fā)現(xiàn)娜氏,new這樣一個(gè)DTO轉(zhuǎn)化對(duì)象是沒(méi)有必要的拳缠,而且每一個(gè)轉(zhuǎn)化對(duì)象都是由在遇到DTO轉(zhuǎn)化的時(shí)候才會(huì)出現(xiàn),那我們應(yīng)該考慮一下贸弥,是否可以將這個(gè)類和DTO進(jìn)行聚合呢窟坐,看一下我的聚合結(jié)果:
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中的轉(zhuǎn)化則由:
User user = new UserInputDTOConvert().convert(userInputDTO);
User saveUserResult = userService.addUser(user);
變成了:
User user = userInputDTO.convertToUser();
User saveUserResult = userService.addUser(user);
我們?cè)貲TO對(duì)象中添加了轉(zhuǎn)化的行為,我相信這樣的操作可以讓代碼的可讀性變得更強(qiáng)茂腥,并且是符合語(yǔ)義的狸涌。
再查工具類
再來(lái)看DTO內(nèi)部轉(zhuǎn)化的代碼,它實(shí)現(xiàn)了我們自己定義的DTOConvert接口最岗,但是這樣真的就沒(méi)有問(wèn)題帕胆,不需要再思考了嗎?
我覺(jué)得并不是般渡,對(duì)于Convert這種轉(zhuǎn)化語(yǔ)義來(lái)講懒豹,很多工具類中都有這樣的定義芙盘,這中Convert并不是業(yè)務(wù)級(jí)別上的接口定義,它只是用于普通bean之間轉(zhuǎn)化屬性值的普通意義上的接口定義脸秽,所以我們應(yīng)該更多的去讀其他含有Convert轉(zhuǎn)化語(yǔ)義的代碼儒老。
我仔細(xì)閱讀了一下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可以完成正向轉(zhuǎn)化和逆向轉(zhuǎn)化驮樊,繼續(xù)修改我們DTO中轉(zhuǎn)化的這段代碼:
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;
}
}
看了這部分代碼以后,你可能會(huì)問(wèn)片酝,那逆向轉(zhuǎn)化會(huì)有什么用呢囚衔?其實(shí)我們有很多小的業(yè)務(wù)需求中,入?yún)⒑统鰠⑹且粯拥牡裱兀敲次覀冏兛梢暂p松的進(jìn)行轉(zhuǎn)化练湿,我將上邊所提到的UserInputDTO和UserOutputDTO都轉(zhuǎn)成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;
}
當(dāng)然,上述只是表明了轉(zhuǎn)化方向的正向或逆向审轮,很多業(yè)務(wù)需求的出參和入?yún)⒌腄TO對(duì)象是不同的肥哎,那么你需要更明顯的告訴程序:逆向是無(wú)法調(diào)用的:
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("不支持逆向轉(zhuǎn)化方法!");
}
}
看一下doBackward方法,直接拋出了一個(gè)斷言異常疾渣,而不是業(yè)務(wù)異常篡诽,這段代碼告訴代碼的調(diào)用者,這個(gè)方法不是準(zhǔn)你調(diào)用的稳衬,如果你調(diào)用霞捡,我就”斷言”你調(diào)用錯(cuò)誤了。
關(guān)于異常處理的更詳細(xì)介紹薄疚,可以參考我之前的文章:如何優(yōu)雅的設(shè)計(jì)java異常 碧信,應(yīng)該可以幫你更好的理解異常。
bean的驗(yàn)證
如果你認(rèn)為我上邊寫的那個(gè)添加用戶api寫的已經(jīng)非常完美了街夭,那只能說(shuō)明你還不是一個(gè)優(yōu)秀的程序員砰碴。我們應(yīng)該保證任何數(shù)據(jù)的入?yún)⒌椒椒w內(nèi)都是合法的。
為什么要驗(yàn)證
很多人會(huì)告訴我板丽,如果這些api是提供給前端進(jìn)行調(diào)用的呈枉,前端都會(huì)進(jìn)行驗(yàn)證啊,你為什還要驗(yàn)證埃碱?
其實(shí)答案是這樣的猖辫,我從不相信任何調(diào)用我api或者方法的人,比如前端驗(yàn)證失敗了砚殿,或者某些人通過(guò)一些特殊的渠道(比如Charles進(jìn)行抓包),直接將數(shù)據(jù)傳入到我的api啃憎,那我仍然進(jìn)行正常的業(yè)務(wù)邏輯處理,那么就有可能產(chǎn)生臟數(shù)據(jù)似炎!
“對(duì)于臟數(shù)據(jù)的產(chǎn)生一定是致命”辛萍,這句話希望大家牢記在心悯姊,再小的臟數(shù)據(jù)也有可能讓你找?guī)讉€(gè)通宵!
jsr 303驗(yàn)證
hibernate提供的jsr 303實(shí)現(xiàn)贩毕,我覺(jué)得目前仍然是很優(yōu)秀的悯许,具體如何使用,我不想講辉阶,因?yàn)楣雀枭夏憧梢运阉鞒龊芏啻鸢?
再以上班的api實(shí)例進(jìn)行說(shuō)明先壕,我們現(xiàn)在對(duì)DTO數(shù)據(jù)進(jìn)行檢查:
public class UserDTO {
@NotNull
private String username;
@NotNull
private int age;
//其他代碼略
}
api驗(yàn)證:
@PostMapping
public UserDTO addUser(@Valid UserDTO userDTO){
User user = userDTO.convertToUser();
User saveResultUser = userService.addUser(user);
UserDTO result = userDTO.convertFor(saveResultUser);
return result;
}
我們需要將驗(yàn)證結(jié)果傳給前端,這種異常應(yīng)該轉(zhuǎn)化為一個(gè)api異常(帶有錯(cuò)誤碼的異常)睛藻。
@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 帶驗(yàn)證碼的驗(yàn)證錯(cuò)誤異常
}
}
BindingResult是Spring MVC驗(yàn)證DTO后的一個(gè)結(jié)果集启上,可以參考spring 官方文檔
檢查參數(shù)后,可以拋出一個(gè)“帶驗(yàn)證碼的驗(yàn)證錯(cuò)誤異车暧。”,具體異常設(shè)計(jì)可以參考如何優(yōu)雅的設(shè)計(jì)java異常
擁抱lombok
上邊的DTO代碼倒慧,已經(jīng)讓我看的很累了按摘,我相信讀者也是一樣,看到那么多的Getter和Setter方法纫谅,太煩躁了炫贤,那時(shí)候有什么方法可以簡(jiǎn)化這些呢。
請(qǐng)擁抱lombok,它會(huì)幫助我們解決一些讓我們很煩躁的問(wèn)題
去掉Setter和Getter
其實(shí)這個(gè)標(biāo)題付秕,我不太想說(shuō)兰珍,因?yàn)榫W(wǎng)上太多,但是因?yàn)楹芏嗳烁嬖V我询吴,他們根本就不知道lombok的存在掠河,所以為了讓讀者更好的學(xué)習(xí),我愿意寫這樣一個(gè)例子:
@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("不支持逆向轉(zhuǎn)化方法!");
}
}
}
看到了吧猛计,煩人的Getter和Setter方法已經(jīng)去掉了唠摹。
但是上邊的例子根本不足以體現(xiàn)lombok的強(qiáng)大。我希望寫一些網(wǎng)上很難查到奉瘤,或者很少人進(jìn)行說(shuō)明的lombok的使用以及在使用時(shí)程序語(yǔ)義上的說(shuō)明勾拉。
比如:@Data,@AllArgsConstructor,@NoArgsConstructor..這些我就不進(jìn)行一一說(shuō)明了,請(qǐng)大家自行查詢資料.
bean中的鏈?zhǔn)斤L(fēng)格
什么是鏈?zhǔn)斤L(fēng)格盗温?我來(lái)舉個(gè)例子藕赞,看下面這個(gè)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;
}
}
仔細(xì)看一下set方法,這樣的設(shè)置便是chain的style卖局,調(diào)用的時(shí)候斧蜕,可以這樣使用:
Student student = new Student()
.setAge(24)
.setName("zs");
相信合理使用這樣的鏈?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<String> list = new ArrayList<>();
看一下guava中的創(chuàng)建方式:
List<String> 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<String, String> objectObjectHashMap = Maps.newHashMap();
好了布朦,如果你理解了我說(shuō)的語(yǔ)義囤萤,那么,你已經(jīng)向成為java程序員更近了一步了是趴。
再回過(guò)頭來(lái)看剛剛的Student涛舍,很多時(shí)候,我們?nèi)慡tudent這個(gè)bean的時(shí)候唆途,他會(huì)有一些必輸字段富雅,比如Student中的name字段,一般處理的方式是將name字段包裝成一個(gè)構(gòu)造方法肛搬,只有傳入name這樣的構(gòu)造方法没佑,才能創(chuàng)建一個(gè)Student對(duì)象。
接上上邊的靜態(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模式我不想再多解釋了瓜晤,讀者可以看一下《Head First》(設(shè)計(jì)模式) 的建造者模式。
今天其實(shí)要說(shuō)的是一種變種的builder模式腹纳,那就是構(gòu)建bean的builder模式痢掠,其實(shí)主要的思想是帶著大家一起看一下lombok給我們帶來(lái)了什么。
看一下Student這個(gè)類的原始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;
}
}
}
調(diào)用方式:
Student student = Student.builder().name("zs").age(24).build();
這樣的builder代碼嘲恍,讓我是在惡心難受足画,于是我打算用lombok重構(gòu)這段代碼:
@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è)常見(jiàn)的行為動(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 <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很完美的更改了異常拋出的行為俘侠,讓程序更具有容錯(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> 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);
}
//其他實(shí)現(xiàn)代碼略霞怀。。莉给。
}
我相信你看了以上代碼毙石,你會(huì)和我一樣覺(jué)得惡心反胃,后來(lái)我用lombok提供的代理注解優(yōu)化了我的代碼(@Delegate):
@AllArgsConstructor
public abstract class FilterRestTemplate implements RestOperations {
@Delegate
protected volatile RestTemplate restTemplate;
}
這幾行代碼完全替代上述那些冗長(zhǎng)的代碼颓遏。
是不是很簡(jiǎn)潔徐矩,做一個(gè)擁抱lombok的程序員吧。
重構(gòu)
需求案例
項(xiàng)目需求
項(xiàng)目開(kāi)發(fā)階段叁幢,有一個(gè)關(guān)于下單發(fā)貨的需求:如果今天下午3點(diǎn)前進(jìn)行下單滤灯,那么發(fā)貨時(shí)間是明天,如果今天下午3點(diǎn)后進(jìn)行下單曼玩,那么發(fā)貨時(shí)間是后天力喷,如果被確定的時(shí)間是周日,那么在此時(shí)間上再加1天為發(fā)貨時(shí)間演训。
思考與重構(gòu)
我相信這個(gè)需求看似很簡(jiǎn)單,無(wú)論怎么寫都可以完成贝咙。
很多人可能看到這個(gè)需求样悟,就動(dòng)手開(kāi)始寫Calendar或Date進(jìn)行計(jì)算,從而完成需求庭猩。
而我給的建議是窟她,仔細(xì)考慮如何寫代碼,然后再去寫蔼水,不是說(shuō)所有的時(shí)間操作都用Calendar或Date去解決震糖,一定要看場(chǎng)景。
對(duì)于時(shí)間的計(jì)算我們要考慮joda-time這種類似的成熟時(shí)間計(jì)算框架來(lái)寫代碼趴腋,它會(huì)讓代碼更加簡(jiǎn)潔和易讀吊说。
請(qǐng)讀者先考慮這個(gè)需求如何用java代碼完成,或先寫一個(gè)你覺(jué)得完成這個(gè)代碼的思路优炬,再來(lái)看我下邊的代碼颁井,這樣,你的收獲會(huì)更多一些:
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() ;
}
讀這段代碼的時(shí)候蠢护,你會(huì)發(fā)現(xiàn)雅宾,我將判斷和有可能出現(xiàn)的不同結(jié)果都當(dāng)做一個(gè)變量,最終做一個(gè)三目運(yùn)算符的方式進(jìn)行返回葵硕,這樣的優(yōu)雅和可讀性顯而易見(jiàn)眉抬,當(dāng)然這樣的代碼不是一蹴而就的贯吓,我優(yōu)化了3遍產(chǎn)生的以上代碼。讀者可根據(jù)自己的代碼和我寫的代碼進(jìn)行對(duì)比蜀变。
提高方法
如果你做了3年+的程序員悄谐,我相信像如上這樣的需求,你很輕松就能完成昏苏,但是如果你想做一個(gè)會(huì)寫java的程序員尊沸,就好好的思考和重構(gòu)代碼吧。
寫代碼就如同寫字一樣贤惯,同樣的字洼专,大家都會(huì)寫,但是寫出來(lái)是否好看就不一定了孵构。如果想把程序?qū)懞闷ㄉ蹋鸵粩嗟乃伎己椭貥?gòu),敢于嘗試颈墅,敢于創(chuàng)新蜡镶,不要因循守舊,一定要做一個(gè)優(yōu)秀的java程序員恤筛。
提高代碼水平最好的方法就是有條理的重構(gòu)官还!(注意:是有條理的重構(gòu))
設(shè)計(jì)模式
設(shè)計(jì)模式就是工具,而不是提現(xiàn)你是否是高水平程序員的一個(gè)指標(biāo)毒坛。
我經(jīng)常會(huì)看到某一個(gè)程序員興奮的大喊望伦,哪個(gè)程序哪個(gè)點(diǎn)我用到了設(shè)計(jì)模式,寫的多么多么優(yōu)秀煎殷,多么多么好屯伞。我仔細(xì)去翻閱的時(shí)候,卻發(fā)現(xiàn)有很多是過(guò)度設(shè)計(jì)的豪直。
業(yè)務(wù)驅(qū)動(dòng)技術(shù) or 技術(shù)驅(qū)動(dòng)業(yè)務(wù)
業(yè)務(wù)驅(qū)動(dòng)技術(shù) or 技術(shù)驅(qū)動(dòng)業(yè)務(wù) 劣摇? 其實(shí)這是一個(gè)一直在爭(zhēng)論的話題,但是很多人不這么認(rèn)為弓乙,我覺(jué)得就是大家不愿意承認(rèn)罷了末融。我來(lái)和大家大概分析一下作為一個(gè)java程序員,我們應(yīng)該如何判斷自己所處于的位置.
業(yè)務(wù)驅(qū)動(dòng)技術(shù):如果你所在的項(xiàng)目是一個(gè)收益很小或者甚至沒(méi)有收益的項(xiàng)目唆貌,請(qǐng)不要搞其他創(chuàng)新的東西滑潘,不要驅(qū)動(dòng)業(yè)務(wù)要如何如何做,而是要熟知業(yè)務(wù)現(xiàn)在的痛點(diǎn)是什么锨咙?如何才能幫助業(yè)務(wù)盈利或者讓項(xiàng)目更好语卤,更順利的進(jìn)行。
技術(shù)驅(qū)動(dòng)業(yè)務(wù):如果你所在的項(xiàng)目是一個(gè)很牛的項(xiàng)目,比如淘寶這類的項(xiàng)目粹舵,我可以在滿足業(yè)務(wù)需求的情況下钮孵,和業(yè)務(wù)溝通,使用什么樣的技術(shù)能更好的幫助業(yè)務(wù)創(chuàng)造收益眼滤,比如說(shuō)下單的時(shí)候要進(jìn)隊(duì)列巴席,可能幾分鐘之后訂單狀態(tài)才能處理完成,但是會(huì)讓用戶有更流暢的體驗(yàn)诅需,賺取更多的訪問(wèn)流量漾唉,那么我相信業(yè)務(wù)愿意被技術(shù)驅(qū)動(dòng),會(huì)同意訂單的延遲問(wèn)題堰塌,這樣便是技術(shù)驅(qū)動(dòng)業(yè)務(wù)赵刑。
我相信大部分人還都處于業(yè)務(wù)驅(qū)動(dòng)技術(shù)的方向吧。
所以你既然不能驅(qū)動(dòng)業(yè)務(wù)场刑,那就請(qǐng)擁抱業(yè)務(wù)變化吧般此。
代碼設(shè)計(jì)
一直在做java后端的項(xiàng)目,經(jīng)常會(huì)有一些變動(dòng)牵现,我相信大家也都遇到過(guò)铐懊。
比如當(dāng)我們寫一段代碼的時(shí)候,我們考慮將需求映射成代碼的狀態(tài)模式瞎疼,突然有一天科乎,狀態(tài)模式里邊又添加了很多行為變化的東西,這時(shí)候你就撓頭了贼急,你硬生生的將狀態(tài)模式中添加過(guò)多行為和變化喜喂。
慢慢的你會(huì)發(fā)現(xiàn)這些狀態(tài)模式,其實(shí)更像是一簇算法竿裂,應(yīng)該使用策略模式,這時(shí)你應(yīng)該已經(jīng)暈頭轉(zhuǎn)向了照弥。
說(shuō)了這么多腻异,我的意思是,只要你覺(jué)得合理这揣,就請(qǐng)將狀態(tài)模式改為策略模式吧悔常,所有的模式并不是憑空想象出來(lái)的,都是基于重構(gòu)给赞。
java編程中沒(méi)有銀彈机打,請(qǐng)擁抱業(yè)務(wù)變化,一直思考重構(gòu)片迅,你就有一個(gè)更好的代碼設(shè)計(jì)!
你真的優(yōu)秀嗎残邀?
真不好意思,我取了一個(gè)這么無(wú)聊的標(biāo)題。
國(guó)外流行一種編程方式芥挣,叫做結(jié)對(duì)編程驱闷,我相信國(guó)內(nèi)很多公司都沒(méi)有這么做,我就不在講述結(jié)對(duì)編程帶來(lái)的好處了空免,其實(shí)就是一邊code review空另,一邊互相提高的一個(gè)過(guò)程。既然做不到這個(gè)蹋砚,那如何讓自己活在自己的世界中不斷提高呢扼菠?
“平時(shí)開(kāi)發(fā)的時(shí)候,做出的代碼總認(rèn)為是正確的坝咐,而且寫法是完美的循榆。”畅厢,我相信這是大部分人的心聲冯痢,還回到剛剛的問(wèn)題,如何在自己的世界中不斷提高呢框杜?
答案就是:
- 多看成熟框架的源碼
- 多回頭看自己的代碼
- 勤于重構(gòu)
你真的優(yōu)秀嗎浦楣? 如果你每周都完成了學(xué)習(xí)源碼,回頭看自己代碼咪辱,然后勤于重構(gòu)振劳,我認(rèn)為你就真的很優(yōu)秀了。
即使也許你只是剛剛?cè)腴T油狂,但是一直堅(jiān)持历恐,你就是一個(gè)真的會(huì)寫java代碼的程序員了。
技能
UML
不想多討論UML相關(guān)的知識(shí)专筷,但是我覺(jué)得你如果真的會(huì)寫java弱贼,請(qǐng)先學(xué)會(huì)表達(dá)自己,UML就是你說(shuō)話的語(yǔ)言磷蛹,做一名優(yōu)秀的java程序員吮旅,請(qǐng)至少學(xué)會(huì)這兩種UML圖:
- 類圖
- 時(shí)序圖
clean code
我認(rèn)為保持代碼的簡(jiǎn)潔和可讀性是代碼的最基本保證,如果有一天為了程序的效率而降低了這兩點(diǎn)味咳,我認(rèn)為是可以諒解的庇勃,除此之外,沒(méi)有任何理由可以讓你任意揮霍你的代碼槽驶。
- 讀者可以看一下Robert C. Martin出版的《Clean Code》(代碼整潔之道) 這本書
- 可以參考美團(tuán)文章聊聊clean code
- 也可以看一下阿里的Java編碼規(guī)范
無(wú)論如何责嚷,請(qǐng)保持你的代碼的整潔。
linux 基礎(chǔ)命令
這點(diǎn)其實(shí)和會(huì)寫java沒(méi)有關(guān)系掂铐,但是linux很多時(shí)候確實(shí)承載運(yùn)行java的容器罕拂,請(qǐng)學(xué)好linux的基礎(chǔ)命令揍异。
- 參考鳥(niǎo)哥的《Linux私房菜》
總結(jié)
java是一個(gè)大體系,今天討論并未涉及框架和架構(gòu)相關(guān)知識(shí)聂受,只是討論如何寫好代碼蒿秦。
本文從寫java程序的小方面一直寫到大方面,來(lái)闡述了如何才能寫好java程序蛋济,并告訴讀者們?nèi)绾尾拍芴岣咦陨淼木幋a水平棍鳖。
我希望看到這篇文章的各位都能做一個(gè)優(yōu)秀的java程序員