Элегантный Builder на Java
Наверняка большинство сколько-нибудь опытных программистов знакомы с паттерном Builder. Он позволяет сделать инициализацию структур данных более наглядной, гибкой при этом сохраняя такое полезное их свойство как неизменяемость (immutability). Вот классический пример с первой страницы выдачи гугла на запрос «java builder pattern example». При всех своих преимуществах, самый главный недостаток данной реализации паттерна — в два раза больше кода, по сравнению с обычным плоским бином. Если генерация этого дополнительного кода не проблема для любой популярной IDE, то редактировать такой класс становится достаточно утомительно и читабельность страдает в любом случае.
В какой-то момент я решил, что хватит это терпеть и занялся поисками альтернативы. Надо сказать, альтернатива нашлась достаточно быстро. В Java есть редко использующийся механизм нестатических внутренних классов. Экземпляр такого класса можно создать только через экземпляр класса-родителя с помощью оператора .new. Что важно, такой объект имеет доступ к приватным полям своего родителя.
Итак, у нас есть неизменяемая структура
public class Account < private final String userId; private final String token; public Account(String token, String userId) < this.token = token; this.userId = userId; >public String getUserId() < return userId; >public String getToken() < return token; >> Здесь сейчас всего два поля, но билдер все равно был бы полезен чтобы не путать порядок параметров в конструкторе и если понадобится проинициализировать только одно поле из двух или оба, но в разные моменты времени. Что говорить, когда полей станет 20!
Чтобы не дублировать поля в классе-билдере, просто заводим внутренний класс. Он имеет доступ к приватным полям своего родительского класса и может выставлять их напрямую. Собственный конструктор класса сделаем приватным, а с полей уберем модификатор final.
public class Account < private String userId; private String token; private Account() < // private constructor >public String getUserId() < return userId; >public String getToken() < return token; >public class Builder < private Builder() < // private constructor >public Builder setUserId(String userId) < Account.this.userId = userId; return this; >public Builder setToken(String token) < Account.this.token = token; return this; >public Account build() < return Account.this; >> > Конструктор у билдера тоже приватный, иначе имея доступ к экземляру Account можно было бы сделать билдер и через него изменять поля уже созданного объекта. Метод build просто возвращает уже готовый объект (здесь можно проверять все ли обязательные поля на месте, например.
Последний штрих — добавляем в метод для создания экземпляра билдера.
public class Account < private String userId; private String token; private Account() < // private constructor >public String getUserId() < return userId; >public String getToken() < return token; >public static Builder newBuilder() < return new Account().new Builder(); >public class Builder < private Builder() < // private constructor >public Builder setUserId(String userId) < Account.this.userId = userId; return this; >public Builder setToken(String token) < Account.this.token = token; return this; >public Account build() < return Account.this; >> > Сравните с традиционной реализацией:
public class Account < private final String userId; private final String token; public Account(String userId, String token) < this.userId = userId; this.token = token; >public String getUserId() < return userId; >public String getToken() < return token; >public static class Builder < private String userId; private String token; public Builder setUserId(String userId) < this.userId = userId; return this; >public Builder setToken(String token) < this.token = token; return this; >public Account build() < return new Account(userId, token); >> > Попробуйте добавить новое поле или изменить тип поля token в том и другом случае. С увеличением количества полей разница в объеме кода и читабельности будет все более заметной. Сравним пример из статьи, на которую я ссылался в начале топика (я его изменил, чтобы стили примеров совпадали):
public class Person < private final String lastName; private final String firstName; private final String middleName; private final String salutation; private final String suffix; private final String streetAddress; private final String city; private final String state; private final boolean isFemale; private final boolean isEmployed; private final boolean isHomeOwner; public Person( final String newLastName, final String newFirstName, final String newMiddleName, final String newSalutation, final String newSuffix, final String newStreetAddress, final String newCity, final String newState, final boolean newIsFemale, final boolean newIsEmployed, final boolean newIsHomeOwner) < this.lastName = newLastName; this.firstName = newFirstName; this.middleName = newMiddleName; this.salutation = newSalutation; this.suffix = newSuffix; this.streetAddress = newStreetAddress; this.city = newCity; this.state = newState; this.isFemale = newIsFemale; this.isEmployed = newIsEmployed; this.isHomeOwner = newIsHomeOwner; >public String getLastName() < return lastName; >public String getFirstName() < return firstName; >public String getMiddleName() < return middleName; >public String getSalutation() < return salutation; >public String getSuffix() < return suffix; >public String getStreetAddress() < return streetAddress; >public String getCity() < return city; >public String getState() < return state; >public boolean isFemale() < return isFemale; >public boolean isEmployed() < return isEmployed; >public boolean isHomeOwner() < return isHomeOwner; >public static class Builder < private String nestedLastName; private String nestedFirstName; private String nestedMiddleName; private String nestedSalutation; private String nestedSuffix; private String nestedStreetAddress; private String nestedCity; private String nestedState; private boolean nestedIsFemale; private boolean nestedIsEmployed; private boolean nestedIsHomeOwner; public Builder setNestedLastName(String nestedLastName) < this.nestedLastName = nestedLastName; return this; >public Builder setNestedFirstName(String nestedFirstName) < this.nestedFirstName = nestedFirstName; return this; >public Builder setNestedMiddleName(String nestedMiddleName) < this.nestedMiddleName = nestedMiddleName; return this; >public Builder setNestedSalutation(String nestedSalutation) < this.nestedSalutation = nestedSalutation; return this; >public Builder setNestedSuffix(String nestedSuffix) < this.nestedSuffix = nestedSuffix; return this; >public Builder setNestedStreetAddress(String nestedStreetAddress) < this.nestedStreetAddress = nestedStreetAddress; return this; >public Builder setNestedCity(String nestedCity) < this.nestedCity = nestedCity; return this; >public Builder setNestedState(String nestedState) < this.nestedState = nestedState; return this; >public Builder setNestedIsFemale(boolean nestedIsFemale) < this.nestedIsFemale = nestedIsFemale; return this; >public Builder setNestedIsEmployed(boolean nestedIsEmployed) < this.nestedIsEmployed = nestedIsEmployed; return this; >public Builder setNestedIsHomeOwner(boolean nestedIsHomeOwner) < this.nestedIsHomeOwner = nestedIsHomeOwner; return this; >public Person build() < return new Person( nestedLastName, nestedFirstName, nestedMiddleName, nestedSalutation, nestedSuffix, nestedStreetAddress, nestedCity, nestedState, nestedIsFemale, nestedIsEmployed, nestedIsHomeOwner); >> > И реализация через внутренний класс:
public class Person < private String lastName; private String firstName; private String middleName; private String salutation; private String suffix; private String streetAddress; private String city; private String state; private boolean isFemale; private boolean isEmployed; private boolean isHomeOwner; private Person() < // private constructor >public String getLastName() < return lastName; >public String getFirstName() < return firstName; >public String getMiddleName() < return middleName; >public String getSalutation() < return salutation; >public String getSuffix() < return suffix; >public String getStreetAddress() < return streetAddress; >public String getCity() < return city; >public String getState() < return state; >public boolean isFemale() < return isFemale; >public boolean isEmployed() < return isEmployed; >public boolean isHomeOwner() < return isHomeOwner; >public static Builder newBuilder() < return new Person().new Builder(); >public class Builder < private Builder() < // private constructor >public Builder setLastName(String lastName) < Person.this.lastName = lastName; return this; >public Builder setFirstName(String firstName) < Person.this.firstName = firstName; return this; >public Builder setMiddleName(String middleName) < Person.this.middleName = middleName; return this; >public Builder setSalutation(String salutation) < Person.this.salutation = salutation; return this; >public Builder setSuffix(String suffix) < Person.this.suffix = suffix; return this; >public Builder setStreetAddress(String streetAddress) < Person.this.streetAddress = streetAddress; return this; >public Builder setCity(String city) < Person.this.city = city; return this; >public Builder setState(String state) < Person.this.state = state; return this; >public Builder setFemale(boolean isFemale) < Person.this.isFemale = isFemale; return this; >public Builder setEmployed(boolean isEmployed) < Person.this.isEmployed = isEmployed; return this; >public Builder setHomeOwner(boolean isHomeOwner) < Person.this.isHomeOwner = isHomeOwner; return this; >public Person build() < return Person.this; >> > Можно заметить, что с точки зрения организации кода такой класс отличается от обычного плоского бина с полями и гетерами-сетерами только тем, что сеттеры сгруппированы в отдельном внутреннем классе, добавились только пара методов newBuilder() и build(), строчка с объявлением внутреннего класса и приватные конструкторы.
1. Метод build билдера возвращает один и тот же объект и если после его вызова продолжить выставлять поля через методы билдера, поля уже созданного объекта будут меняться. Это легко исправить, если создавать каждый раз новый экземпляр объекта:
При этом возвращается часть дублирующего кода, от которого мы пытались избавиться. Обычно ссылка на билдер не покидает метод, поэтому я предпочитаю вариант, который показал сначала. Если вы часто передаете билдер туда-сюда и переиспользуете его для повторной генерации объектов, используйте вариант, как показано выше.
2. Спасибо комментаторам, мои сомнения развеяны — объект, получаемый из такого билдера, не потокобезопасен из-за того, что поля в нем не объявлены как final. Если в вашем приложении важен этот момент, лучше использовать классический билдер.
И напоследок — использование билдера.
Account account = Account.newBuilder() .setToken("hello") .setUserId("habr") .build(); Account.Builder accountBuilder = Account.newBuilder(); . accountBuilder.setToken("hello"); . accountBuilder..setUserId("habr"); return accountBuilder.build(); Опять же Account.newBuilder() моим программерским глазам милее, чем new Account.Builder(), хотя это уже дело вкуса.
UPD: Как часто бывает на хабре, комментарии оказались полезнее самого топика, рекомендуются к ознакомлению.
Создать в главном классе метод генерации
Я создал в классе Cat конструктор так, чтобы можно было создать кошку с весом переданным в конструктор
Мог бы кто-то подсказать, как
Создать в главном классе Loader метод генерации котенка private static Cat getKitten(), который будет возвращать кошку с весом 1100.00, используя конструктор в который передаем вес кошки.
public class Loader { public static void main(String[] args) { Cat murka = new Cat (3500); System.out.println(murka.getWeight()); } }
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
public class Cat { private double originWeight; private double weight; private double minWeight; private double maxWeight; public Cat() { weight = 1500.0 + 3000.0 * Math.random(); originWeight = weight; minWeight = 1000.0; maxWeight = 9000.0; } public Cat (int weight) { this.weight = weight; } public void meow() { weight = weight - 5000; System.out.println("Meow"); } public void feed(Double amount) { weight = weight + amount; } public void drink(Double amount) { weight = weight + amount; } public Double getWeight() { return weight; } public String getStatus() { if(weight minWeight) { return "Dead"; } else if(weight > maxWeight) { return "Exploded"; } else if(weight > originWeight) { return "Sleeping"; } else { return "Playing"; } } }
Как в классе Thread реализован вызов run(), если метод run() определён в АВТОРСКОМ классе?
И, следовательно, в классе Thread ничего не известно о вызове run? То есть, ребята, мне пришла в.
Работа с классами (в главном классе создать указатель на экземпляр другого класса)
Недавно начал изучение С++, в частности ООП. В связи с чем у меня есть вопрос как в главном классе.
Для автоматической генерации элементов коллекций в классе надо определить статический метод
Есть 2 класса Person (базовый класс) и Student (наследуемый класс). Для автоматической.
В классе OnlyData написать метод, который выводит значение переменной i и вызвать этот метод в том же классе
Я конечно понимаю, что задача оч простая, но все же. В классе OnlyData нужно написать метод.
Сообщение было отмечено Swile как решение
Решение
private static Cat getKitten(){ return new Cat(1000.00); }
public Cat (double weight) { this.weight = weight; }
Сообщение от InvalidCode 
Сообщение от Swile
Swile, в твоей реализации котенок ничем не отличается от кошки, кроме веса. и потом, он два раза мявкнет и все, сдох котенок!
Сообщение от InvalidCode
private static Cat getKitten(){ return new Cat(1000.00); }
public Cat (double weight) { this.weight = weight; }
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
public class Loader { public static void main(String[] args) { Cat murka = new Cat (3500.00); System.out.println(murka.getWeight()); private static Cat getKitten() { return new Cat(1100.00); } } } Error:(13, 1) java: class, interface, or enum expected Error:(8, 9) java: illegal start of expression
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
public class Loader { public static void main(String[] args) { Cat murka = new Cat(3500.00); System.out.println(murka.getWeight()); Cat bob = new Cat(); System.out.println("вес Боба " + bob.getWeight()); } private static Cat getKitten() { return new Cat(1100.00); } }
Сообщение от Swile
ты совсем не понимаешь свой код, чтоль?! вот, у тя в конструкторе, без параметров, weight = 1500.0 + 3000.0 * Math.random();
Подскажите, пожалуйста с решением задачи:
Создайте три объекта класса Cat в методе main(), используя метод getKitten().
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98
public class Loader { private static Cat getKitten(double weight){ return new Cat(1100.00); } public static void main(String[] args) { public class Cat { private double originWeight; private double weight; private double minWeight; private double maxWeight; private double eatenFood = 0; public static int catCount = 0; public static final int EYES_COUNT = 2; public static final int MIN_WEIGHT = 500; public static final int MAX_WEIGHT = 11000; public Cat() { weight = 1500.0 + 3000.0 * Math.random(); originWeight = weight; minWeight = 1000.0; maxWeight = 9000.0; Cat.catCount++; } public Cat(double weight) { this.weight = weight; } public void setColor(Color type) { } public void pee() { weight = weight - 20; System.out.println("Hooch"); } public void meow() { weight = weight - 1; System.out.println("Meow"); } public void drink(Double amount) { weight = weight + amount; } public void feed(Double amount) { eatenFood += amount; weight = weight + amount; } public Double getEatenFood() {return eatenFood;} public Double getWeight() { return weight; } public static int getCatCount() { return Cat.catCount; } public String getStatus() { if(weight minWeight) { Cat.catCount--; return "Dead"; } else if(weight > maxWeight) { Cat.catCount--; return "Exploded"; } else if(weight > originWeight) { return "Sleeping"; } else { return "Playing"; } } public void feed() { } }
Паттерн (Шаблон) Builder
Этот шаблон рекомендуется использовать, когда класс имеет большое количество однотипных параметров и трудно запомнить их порядок и назначение.
public class Good < public final int a; public final int b; public final int c; public final int d; public final int e; public final int f; //Реализация Builder через статический внутренний класс public static class Builder< //Обязательные параметры public int a; public int b; //Необязательные параметры со значениями по умолчанию public int c = 0; public int d = 0; public int e = 0; public int f = 0; //Конструктор с обязательными параметрами public Builder(int a, int b)< this.a=a; this.b=b; >//Методы с возвращающим типом Builder для необязательного параметра с, d, e, f, public Builder c (int val) < c = val; return this; >public Builder d (int val) < d = val; return this; >public Builder e (int val) < e = val; return this; >public Builder f (int val) < f = val; return this; >//Метод с возвращающим типом Good для генерации объекта public Good buidl() < return new Good (this); >private Good(Builder builder)
Теперь в методе main при создании объекта вызывается конструктор статического класса Builder с обязательными параметрами. Затем через точку вызываются все необходимые необязательные параметры. В завершение вызывается метод buidl(); для генерации объекта.
Good good = new Good.Builder(40, 20) .c(2) .d(4) .e(23) .f(9) .buidl(); Если хочу создать объект с двумя обязательными и одним необязательным параметром, это будет выглядеть так:
Good good = new Good.Builder(40, 20) .c(2) .buidl(); Good good = new Good.Builder(40, 20) .buidl();