Перейти до основного вмісту

Патерн Builder в Java

Проблема

У нас є клас, який містить велику кількість полів. Частина із цих полів є обов'язковими, а частина ні. Потрібно створити "інструменти" для створення екземплярів цього класу.

Приклад. У нас є клас Користувач (User), який містить 3 обов'язкових поля: Ім'я, Прізвище, ЕлектроннаПошта та ряд неов'язкових.


public class User {
    private String firstName;
    private String lastName;
    private String email;
    private String middleName;//optional
    private int age;//optional
    private String address;//optional
    private String comment;//optional
    private String phone;//optional
    //...
}

Розглянемо можливі рішення

Використання перевантажених конструкторів

В Java є можливість створити ряд конструкторів із різним набором параметрів.


public class User {
    private String firstName;
    private String lastName;
    private String email;
    private String middleName;//optional
    private int age;//optional
    private String address;//optional
    private String comment;//optional
    private String phone;//optional

    public User(String firstName, String lastName, String email) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
    }

    public User(String firstName, String lastName, String email, String middleName, int age, String address, String comment, String phone) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
        this.middleName = middleName;
        this.age = age;
        this.address = address;
        this.comment = comment;
        this.phone = phone;
    }

    public User(String firstName, String lastName, String email, String middleName) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
        this.middleName = middleName;
    }

    public User(String firstName, String lastName, String email, int age) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
        this.age = age;
    }
    
    //...
}

Недоліки підходу:

  • Якщо необов'язкових полів багато, то можливих варіантів конструкторів буде дуже багато.
  • Якщо поля мають однаковий тип, то важко буде (або й неможливо) створити конструктор для кожного варіанту.
  • При виклику конструктора потрібно буде враховувати порядок параметрів. А при цьому легко помилитися, особливо, коли параметри мають однаковий тип.

Використання сеттерів

Можна, наприклад, ініціалізувати обов'язкові параметри через конструктор, а інші - через сетери:


public class User {
    private String firstName;
    private String lastName;
    private String email;
    private String middleName;//optional
    private int age;//optional
    private String address;//optional
    private String comment;//optional
    private String phone;//optional

    public User(String firstName, String lastName, String email) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
    }

    public void setMiddleName(String middleName) {
        this.middleName = middleName;
    }

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

    public void setAddress(String address) {
        this.address = address;
    }

    public void setComment(String comment) {
        this.comment = comment;
    }

    public void setPhone(String phone) {
        this.phone = phone;
    }

    //...
}

Недоліки підходу:

  • Використання сеттерів не дуже гарний стиль програмування.
  • Неможливо створити незмінні (immutable) об'єкти.

Використання патерну Будівельник

Патерн Будівельник позбавлений недоліків попередніх двох підходів.

Один із напростіших підходів реалізації цього патерна, це створення статичного вкладеного класу. Цей клас має містити такі ж поля, як і зовнішній клас. Зрозуміло, що необо'язкові поля можна ініціалізувати значеннями по замовчуванню. Вкладений клас повинен мати конструктор для обов'язкових полів. Для ініціалізації необов'язкових полів використовуються методі, схожі на сетери, але які повертають об'єкт класу будівельника.


    public static class Builder{
        private String firstName;
        private String lastName;
        private String email;
        private String middleName="";
        private int age=25;
        private String address="";
        private String comment="No comment";
        private String phone="+555555555";

        public Builder(String firstName, String lastName, String email) {
            this.firstName = firstName;
            this.lastName = lastName;
            this.email = email;
        }

        public Builder middleName(String middleName) {
            this.middleName = middleName;
            return this;
        }

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


    }

В класі User потрібно створити приватний конструктор, який в якості параметра приймає екземпляр класу Builder:


    private User(Builder builder) {
        this.firstName = builder.firstName;
        this.lastName = builder.lastName;
        this.email = builder.email;
        this.middleName = builder.middleName;
        this.age = builder.age;
        this.address = builder.address;
        this.comment = builder.comment;
        this.phone = builder.phone;
    }

В класі Builder сторити метод, що викликає цей конструктор:


        public User build(){
            return new User(this);
        }

Повний код класу User:


public class User {
    private String firstName;
    private String lastName;
    private String email;
    private String middleName;//optional
    private int age;//optional
    private String address;//optional
    private String comment;//optional
    private String phone;//optional

    private User(Builder builder) {
        this.firstName = builder.firstName;
        this.lastName = builder.lastName;
        this.email = builder.email;
        this.middleName = builder.middleName;
        this.age = builder.age;
        this.address = builder.address;
        this.comment = builder.comment;
        this.phone = builder.phone;
    }

    public static class Builder{
        private String firstName;
        private String lastName;
        private String email;
        private String middleName="";
        private int age=25;
        private String address="";
        private String comment="No comment";
        private String phone="+555555555";

        public Builder(String firstName, String lastName, String email) {
            this.firstName = firstName;
            this.lastName = lastName;
            this.email = email;
        }

        public Builder middleName(String middleName) {
            this.middleName = middleName;
            return this;
        }

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

        public Builder address(String address) {
            this.address = address;
            return this;
        }

        public Builder comment(String comment) {
            this.comment = comment;
            return this;
        }

        public Builder phone(String phone) {
            this.phone = phone;
            return this;
        }

        public User build(){
            return new User(this);
        }
    }

    public String getFirstName() {
        return firstName;
    }

    public String getLastName() {
        return lastName;
    }

    public String getEmail() {
        return email;
    }

    public String getMiddleName() {
        return middleName;
    }

    public int getAge() {
        return age;
    }

    public String getAddress() {
        return address;
    }

    public String getComment() {
        return comment;
    }

    public String getPhone() {
        return phone;
    }

    //...

}

Сворення об'єкту з допомогою будівельника:


User user=new User.Builder("Петро","Іваненко","someemail@mail.com")
        .age(35)
        .build();

Коментарі

Популярні публікації

Angular CLI

CLI (command-line interface) – інтерфейс командного рядка. Перед початком роботи має бути встановлений Node.js Встановлення: npm install -g @angular/cli Отримання допомоги: ng help Буде приблизно такий результат: add Adds support for an external library to your project. analytics Configures the gathering of Angular CLI usage metrics. See https://angular.io/cli/usage-analytics-gathering. build (b) Compiles an Angular app into an output directory named dist/ at the given output path. Must be executed from within a workspace directory. deploy Invokes the deploy builder for a specified project or for the default project in the workspace. config Retrieves or sets Angular configuration values in the angular.json file for the workspace. doc (d) Opens the official Angular documentation (angular.io) in a browser, and searches for a given keyword. e2e (e) Builds and serves an Angular app, then runs end-to-end tests. extract-i18n (i18n-extract, xi18n) Extracts i18n mes...

Створення нового Elixir-проєкту

Для створення новго Elixir-проєкту можна використати команду mix new first_project --sup Зрозуміло, що Elixir має бути встановлений раніше. Пояснення команди: mix — це вбудований інструмент для управління проєктами в Elixir (аналог maven у Java чи npm у JavaScript ). new — підкоманда mix, яка створює новий проєкт. first_project — назва твого нового проєкту. Папка з цією назвою буде створена у поточному каталозі. --sup — опціональний прапорець, який додає шаблон структури з Supervision Tree. Це означає, що створений проєкт одразу буде мати структуру, яка підтримує супервізор (супервізор керує життєвим циклом процесів у системі, перезапускаючи їх при падінні). Щоб створити файл з тестом, можна запустити команду із директорії проєкту mix test Приблизний вигляд структури проєкту:

Агрегати в DDD

Domain-Driven Design (DDD, предметно-орієнтоване проєктування) — це підхід до розробки програмного забезпечення, який зосереджується на моделюванні бізнес-логіки на основі реального домену (предметної області). Його запропонував Ерік Еванс у своїй книзі "Domain-Driven Design: Tackling Complexity in the Heart of Software". Основні принципи DDD Фокус на домені – головна увага приділяється предметній області, а не технічним деталям. Єдина мова (Ubiquitous Language) – розробники, бізнес-аналітики та інші учасники проєкту використовують спільну термінологію, щоб уникнути непорозумінь. Бізнес-логіка відокремлена від технічної реалізації – код моделюється так, щоб він чітко відображав реальний бізнес-процес. Основні концепції DDD Entity (Сутність) – об’єкт з унікальним ідентифікатором, що зберігається в системі (наприклад, Користувач, Замовлення). Value Object (Об’єкт-значення) – об’єкт, який не має унікального ідентифікатора та є незмінним (наприклад, Адреса або Гроші)...

Основи Elixir

Elixir — це функційна мова програмування, яка працює на віртуальній машині Erlang (BEAM). Вона призначена для створення масштабованих і відмовостійких систем. Elixir успадкував багато переваг Erlang, таких як легкість паралельного програмування та висока доступність, але також додав сучасний синтаксис та інструменти для розробки. Основні концепції Elixir Elixir є функційною мовою, тому вона орієнтована на використання функцій та незмінних даних. Ось декілька ключових концепцій: Незмінність даних. Усі дані в Elixir є незмінними, що спрощує роботу з паралельними процесами. Функції. Функції є основним будівельним блоком програми. Вони можуть бути анонімними або іменованими. Паттерн-матчинг. Elixir використовує паттерн-матчинг для роботи з даними, що дозволяє легко розбирати структури даних. Процеси. Elixir використовує легкі процеси для паралельного виконання завдань. Ці процеси ізольовані та спілкуються через передачу повідомлень. Синтаксис Elixir Синтаксис Elixir є прос...

Стратегії ребалансування в Kafka

Стратегії ребалансування в Kafka Ребалансування (Rebalancing) — це процес перерозподілу партицій між споживачами (сonsumer) у групі (Consumer Group). Kafka має кілька стратегій ребалансування: RangeAssignor. Ця стратегія розподіляє партиції на основі діапазонів, які створюються відповідно до сортування топіків і партицій. Наприклад, якщо є два консюмери і 6 партицій (P0–P5), перший консюмер отримає P0–P2, а другий — P3–P5. Особливості: Простий алгоритм. Може призводити до нерівномірного розподілу, якщо кількість партицій не ділиться порівну між консюмерами. RoundRobinAssignor. Ця стратегія рівномірно розподіляє партиції між консюмерами за круговим принципом. Наприклад, якщо є два консюмери і 6 партицій, перший отримає P0, P2, P4, а другий — P1, P3, P5. Особливості: Гарантує більш рівномірний розподіл партицій. Використовується в багатотопікових сценаріях. StickyAssignor. Ця стратегія намагається мінімізувати кількість змін у розподілі партицій між консюмерами при ре...