日皮视频免费网站,欧美女同网站,97免费在线视频,波多野结衣黄色视频,99久久久无码国产一区二区三区,国产一页,av一级片,亚洲AV男人天堂

來源：cnblogs.com/ajing2018/p/14281700.html

Builder 使用創(chuàng)建者模式又叫建造者模式。簡單來說，就是一步步創(chuàng)建一個對象，它對用戶屏蔽了里面構建的細節(jié)，但卻可以精細地控制對象的構造過程。

# 基礎使用

@Builder注釋為你的類生成相對略微復雜的構建器API。@Builder可以讓你以下面顯示的那樣調用你的代碼，來初始化你的實例對象：

Student.builder()               .sno( "001" )               .sname( "admin" )               .sage( 18 )               .sphone( "110" )               .build();

@Builder可以放在類，構造函數或方法上。雖然放在類上和放在構造函數上這兩種模式是最常見的用例，但@Builder最容易用放在方法的用例來解釋。

# 那么@Builder內部幫我們做了什么？

創(chuàng)建一個名為ThisClassBuilder的內部靜態(tài)類，并具有和實體類形同的屬性（稱為構建器）。
在構建器中：對于目標類中的所有的屬性和未初始化的final字段，都會在構建器中創(chuàng)建對應屬性。
在構建器中：創(chuàng)建一個無參的default構造函數。
在構建器中：對于實體類中的每個參數，都會對應創(chuàng)建類似于setter的方法，只不過方法名與該參數名相同。并且返回值是構建器本身（便于鏈式調用），如上例所示。
在構建器中：一個build()方法，調用此方法，就會根據設置的值進行創(chuàng)建實體對象。
在構建器中：同時也會生成一個toString()方法。
在實體類中：會創(chuàng)建一個builder()方法，它的目的是用來創(chuàng)建構建器。

說這么多，不如讓我們通過下面這個例子來理解

@Builderpublic class User {    private final Integer code = 200;    private String username;    private String password;}
// 編譯后：public class User {    private String username;    private String password;    User(String username, String password) {        this.username = username; this.password = password;    }    public static User.UserBuilder builder() {        return new User.UserBuilder();    }
    public static class UserBuilder {        private String username;        private String password;        UserBuilder() {}
        public User.UserBuilder username(String username) {            this.username = username;            return this;        }        public User.UserBuilder password(String password) {            this.password = password;            return this;        }        public User build() {            return new User(this.username, this.password);        }        public String toString() {            return "User.UserBuilder(username=" + this.username + ", password=" + this.password + ")";        }    }}

# 組合用法

1. @Builder中使用 @Singular 注釋集合

@Builder也可以為集合類型的參數或字段生成一種特殊的方法。它采用修改列表中一個元素而不是整個列表的方式，可以是增加一個元素，也可以是刪除一個元素。

Student.builder()                .sno( "001" )                .sname( "admin" )                .sage( 18 )                .sphone( "110" ).sphone( "112" )                .build();

?這樣就可以輕松地將List 字段中包含2個字符串。但是想要這樣來操作集合，你需要使用@Singular來注釋字段或參數。?

在使用@Singular注釋注釋一個集合字段（使用@Builder注釋類），lombok會將該構建器節(jié)點視為一個集合，并生成兩個adder方法而不是setter方法。

一個向集合添加單個元素
一個將另一個集合的所有元素添加到集合中

將不生成僅設置集合（替換已添加的任何內容）的setter。還生成了clear方法。這些singular構建器相對而言是有些復雜的，主要是來保證以下特性：

在調用build()時，生成的集合將是不可變的。
在調用build()之后調用其中一個adder方法或clear方法不會修改任何已經生成的對象。如果對集合修改之后，再調用build()，則會創(chuàng)建一個基于上一個對象創(chuàng)建的對象實體。
生成的集合將被壓縮到最小的可行格式，同時保持高效。

@Singular只能應用于lombok已知的集合類型。目前，支持的類型有：

java.util:?

Iterable, Collection, 和List (一般情況下，由壓縮的不可修改的ArrayList支持).
Set, SortedSet, and NavigableSet (一般情況下，生成可變大小不可修改的HashSet或者TreeSet).
Map, SortedMap, and NavigableMap (一般情況下，生成可變大小不可修改的HashMap或者TreeMap).

Guava’s com.google.common.collect:

ImmutableCollection and ImmutableList
ImmutableSet and ImmutableSortedSet
ImmutableMap, ImmutableBiMap, and ImmutableSortedMap
ImmutableTable

?來看看使用了@Singular注解之后的編譯情況：

@Builderpublic class User {    private final Integer id;    private final String zipCode = "123456";    private String username;    private String password;    @Singular    private List hobbies;}
// 編譯后：public class User {    private final Integer id;    private final String zipCode = "123456";    private String username;    private String password;    private List hobbies;    User(Integer id, String username, String password, List hobbies) {        this.id = id; this.username = username;        this.password = password; this.hobbies = hobbies;    }
    public static User.UserBuilder builder() {return new User.UserBuilder();}
    public static class UserBuilder {        private Integer id;        private String username;        private String password;        private ArrayList hobbies;        UserBuilder() {}        public User.UserBuilder id(Integer id) { this.id = id; return this; }        public User.UserBuilder username(String username) { this.username = username; return this; }        public User.UserBuilder password(String password) { this.password = password; return this; }
        public User.UserBuilder hobby(String hobby) {            if (this.hobbies == null) {                this.hobbies = new ArrayList();            }            this.hobbies.add(hobby);            return this;        }
        public User.UserBuilder hobbies(Collection hobbies) {            if (this.hobbies == null) {                this.hobbies = new ArrayList();            }            this.hobbies.addAll(hobbies);            return this;        }
        public User.UserBuilder clearHobbies() {            if (this.hobbies != null) {                this.hobbies.clear();            }            return this;        }
        public User build() {            List hobbies;            switch(this.hobbies == null ? 0 : this.hobbies.size()) {            case 0:                hobbies = Collections.emptyList();                break;            case 1:                hobbies = Collections.singletonList(this.hobbies.get(0));                break;            default:                hobbies = Collections.unmodifiableList(new ArrayList(this.hobbies));            }            return new User(this.id, this.username, this.password, hobbies);        }        public String toString() {            return "User.UserBuilder(id=" + this.id + ", username=" + this.username + ", password=" + this.password + ", hobbies=" + this.hobbies + ")";        }    }}

其實，lombok的創(chuàng)作者還是很用心的，在進行build()來創(chuàng)建實例對象時，

并沒有直接使用Collections.unmodifiableList(Collection)此方法來床架實例，而是分為三種情況。

第一種，當集合中沒有元素時，創(chuàng)建一個空list
第二種情況，當集合中存在一個元素時，創(chuàng)建一個不可變的單元素list
第三種情況，根據當前集合的元素數量創(chuàng)建對應合適大小的list

?當然我們看編譯生成的代碼，創(chuàng)建了三個關于集合操作的方法：

hobby(String hobby)：向集合中添加一個元素
hobbies(Collection hobbies)：添加一個集合所有的元素
clearHobbies()：清空當前集合數據

2. @Singular 注解配置value屬性

我們先來看看 @Singular 注解的詳情：

@Target({FIELD, PARAMETER})@Retention(SOURCE)public @interface Singular {    // 修改添加集合元素的方法名    String value() default "";}

測試如何使用注解屬性value

@Builderpublic class User {    private final Integer id;    private final String zipCode = "123456";    private String username;    private String password;    @Singular(value = "testHobbies")    private List<String> hobbies;}
// 測試類public class BuilderTest {    public static void main(String[] args) {        User user = User.builder()                .testHobbies("reading")                .testHobbies("eat")                .id(1)                .password("admin")                .username("admin")                .build();        System.out.println(user);    }}

說明，當我們使用了注解屬性value之后，我們在使用添加集合元素時的方法名發(fā)生相應的改變。但是，同時生成的添加整個集合的方法名發(fā)生改變了嗎？我們再來看看編譯后的代碼：

/ 編譯后：public class User {    // 省略部分代碼，只看關鍵部分    public static class UserBuilder {        public User.UserBuilder testHobbies(String testHobbies) {            if (this.hobbies == null) {                this.hobbies = new ArrayList();            }            this.hobbies.add(testHobbies);            return this;        }
        public User.UserBuilder hobbies(Collection hobbies) {            if (this.hobbies == null) {                this.hobbies = new ArrayList();            }            this.hobbies.addAll(hobbies);            return this;        }
        public User.UserBuilder clearHobbies() {            if (this.hobbies != null) {                this.hobbies.clear();            }            return this;        }    }}

?可以看到，只有添加一個元素的方法名發(fā)生了改變。

3. @Builder.Default 的使用

比如有這樣一個實體類：

@Builder@ToStringpublic class User {    @Builder.Default    private final String id = UUID.randomUUID().toString();    private String username;    private String password;    @Builder.Default    private long insertTime = System.currentTimeMillis();}

在類中我在id和insertTime上都添加注解@Builder.Default，當我在使用這個實體對象時，我就不需要在為這兩個字段進行初始化值，如下面這樣：

public class BuilderTest {    public static void main(String[] args) {        User user = User.builder()                .password("admin")                .username("admin")                .build();        System.out.println(user);    }}
// 輸出內容：User(id=416219e1-bc64-43fd-b2c3-9f8dc109c2e8, username=admin, password=admin, insertTime=1546869309868)

lombok在實例化對象時就為我們初始化了這兩個字段值。

當然，你如果再對這兩個字段進行設值的話，那么默認定義的值將會被覆蓋掉，如下面這樣：

public class BuilderTest {    public static void main(String[] args) {        User user = User.builder()                .id("admin")                .password("admin")                .username("admin")                .build();        System.out.println(user);    }}// 輸出內容User(id=admin, username=admin, password=admin, insertTime=1546869642151)

4. @Builder 詳細配置

下面我們再來詳細看看@Builder這個注解類地詳細實現：

@Target({TYPE, METHOD, CONSTRUCTOR})@Retention(SOURCE)public @interface Builder {    // 如果@Builder注解在類上，可以使用 @Builder.Default指定初始化表達式    @Target(FIELD)    @Retention(SOURCE)    public @interface Default {}    // 指定實體類中創(chuàng)建 Builder 的方法的名稱，默認為: builder (個人覺得沒必要修改)    String builderMethodName() default "builder";    // 指定 Builder 中用來構件實體類的方法的名稱，默認為：build (個人覺得沒必要修改)    String buildMethodName() default "build";    // 指定創(chuàng)建的建造者類的名稱，默認為：實體類名+Builder    String builderClassName() default "";    // 使用toBuilder可以實現以一個實例為基礎繼續(xù)創(chuàng)建一個對象。（也就是重用原來對象的值）    boolean toBuilder() default false;        @Target({FIELD, PARAMETER})    @Retention(SOURCE)    public @interface ObtainVia {        // 告訴lombok使用表達式獲取值        String field() default "";        // 告訴lombok使用表達式獲取值        String method() default "";         boolean isStatic() default false;    }}

以上注解屬性，我只測試一個比較常用的toBuilder，因為我們在對實體對象進行操作時，往往會存在對某些實體對象的某個字段進行二次賦值，這個時候就會用到這一屬性。但是，這會創(chuàng)建一個新的對象，而不是原來的對象，原來的對象屬性是不可變的，除非你自己想要給這個實體類再添加上@Data或者@setter方法。下面就來測試一下：

@Builder(toBuilder = true)@ToStringpublic class User {    private String username;    private String password;}// 測試類public class BuilderTest {    public static void main(String[] args) {        User user1 = User.builder()                .password("admin")                .username("admin")                .build();        System.out.println(user1);         User user2 = user1.toBuilder().username("admin2").build();        // 驗證user2是否是基于user1的現有屬性創(chuàng)建的        System.out.println(user2);        // 驗證對象是否是同一對象        System.out.println(user1 == user2);    }}// 輸出內容User(username=admin, password=admin)User(username=admin2, password=admin)false

5. @Builder 全局配置

# 是否禁止使用@Builderlombok.builder.flagUsage = [warning | error] (default: not set)# 是否使用Guaualombok.singular.useGuava = [true | false] (default: false)# 是否自動使用singular，默認是使用lombok.singular.auto = [true | false] (default: true)

總的來說@Builder還是很好用的。

關注公眾號【Java技術江湖】后回復“PDF”即可領取200+頁的《Java工程師面試指南》

強烈推薦，幾乎涵蓋所有Java工程師必知必會的知識點，不管是復習還是面試，都很實用。

呵呵，Lombok 中的 @Builder 竟然都不會用！