MapStruct: быстрый и безопасный маппинг объектов

⚙️ Как это работает

MapStruct анализирует названия полей в исходном (source) и целевом (target) классах. Если поля совпадают по названию и типу, он автоматически создаёт код для их преобразования.

Когда названия полей не совпадают, нужно явно указать соответствие с помощью аннотации @Mapping:

— source — поле в исходном классе
— target — поле в целевом классе

@Mapping(source = "fullName", target = "name")
UserDTO toDTO(User user);

⌛ Как начать

1. Добавьте зависимости: mapstruct, mapstruct-processor

2. Выберите интерфейс или абстрактный класс и определите методы для преобразования объектов

3. Используйте маппер. В Spring-приложении маппер можно заинжектить как обычный бин.

❓ Абстрактный класс или интерфейс

Документация MapStruct приводит примеры с интерфейсами, но библиотека поддерживает и абстрактные классы. Выбор за вами.

Интерфейс — MapStruct сам создаёт реализацию:

@Mapper(componentModel = "spring")
public interface UserMapper {
    @Mapping(source = "fullName", target = "name")
    UserDTO toDTO(User user);
}

Абстрактный класс — позволяет добавлять кастомную логику:

@Mapper(componentModel = "spring")
public abstract class UserMapper {
    @Mapping(source = "fullName", target = "name")
    public abstract UserDTO toDTO(User user);

    public String mapAgeToString(int age) {
        return age + " лет";
    }
}

📌 Имена методов можно задавать любые. MapStruct анализирует типы аргументов и возвращаемых значений, чтобы понять, что куда маппить.

🔥 Интеграция со Spring

При использовании componentModel = "spring" маппер регистрируется как Spring-бин. Что позволяет заинжектить маппер:

@Service
public class UserService {
    private final UserMapper userMapper;

    public UserService(UserMapper userMapper) {
        this.userMapper = userMapper;
    }

    public UserDTO convertUser(User user) {
        return userMapper.toDTO(user);
    }
}

💡 Где применять

— Маппинг DTO ↔️ Entity в Spring-приложениях
— Конвертация данных между разными объектами
— Обработка вложенных структур и коллекций

💬 Используете MapStruct в своих проектах? Делитесь опытом

✅ Java библиотека #java

🖥 OpenPDF — это библиотека с открытым исходным кодом для работы с PDF-документами на Java!

🌟 Она позволяет создавать, изменять и подписывать PDF-файлы, а также поддерживает функции шифрования и работы с формами. OpenPDF основана на старой версии iText и активно развивается сообществом для обеспечения современных возможностей работы с PDF.

🖥 Github

✅ Java библиотека #java

Что такое Virtual Threads

В Java 21 появилась революционная фича — виртуальные потоки (Virtual Threads). Это лёгкие потоки, которые управляются самой JVM, а не операционной системой. Они позволяют создавать тысячи и даже миллионы потоков без значительных затрат ресурсов.

⚙️ Как это работает

Обычные потоки (Thread) привязаны к потокам ОС и работают с тяжёлым контекстным переключением (context switching).

Virtual Threads — это user-mode потоки, управляемые JVM, а не ОС, поэтому они могут эффективно мультиплексироваться на ограниченном количестве платформенных потоков.

🟢Ключевая особенность

Виртуальные потоки не блокируют платформенные потоки, когда выполняют блокирующие операции ввода-вывода (I/O). Они просто освобождают платформенный поток и продолжают выполнение, когда ресурс снова доступен.

Пример

public class VirtualThreadsDemo {
    public static void main(String[] args) throws InterruptedException {
        try (var executor = Executors.newVirtualThreadPerTaskExecutor()) {
            IntStream.range(0, 10_000).forEach(i -> 
                executor.submit(() -> {
                    System.out.println("Task " + i + " running on " + Thread.currentThread());
                    Thread.sleep(100); 
                })
            );
        }
    }
}

Этот код создаёт 10 000 потоков, но JVM будет эффективно управлять ими без перегрузки системы.

✔️ Где применять

— Высоконагруженные I/O задачи.
— Обработка веб-запросов без перегрузки ресурсов.
— Микросервисы, которые взаимодействуют с API.
— Асинхронные операции, где ранее использовали CompletableFuture.

❌ Когда НЕ стоит использовать

— При вычислениях на процессоре.
— При работе с кодом, который активно использует synchronized.
— При глубокой интеграции со сторонними библиотеками, которые не оптимизированы под виртуальные потоки.

ℹ️ Преимущества и недостатки

— Плюсы: миллионы потоков без overhead, упрощённый асинхронный код без CompletableFuture, меньше блокировок и выше производительность, полная совместимость со старыми API.
— Минусы: может ломать старый код с synchronized, не даёт преимуществ для CPU-bound задач, требует оптимизации библиотек под Virtual Threads.

Virtual Threads — мощный инструмент, который не заменяет потоки ОС, но отлично подходит для массовых I/O-задач. Если у вас есть сервис, работающий с сетью, базами данных или API — пора внедрять Virtual Threads.

❓ Делитесь опытом работы с виртуальными потоками

✅ Java библиотека #java

🖥 OpenGrok — это инструмент для индексирования и поиска исходного кода!

🌟 Он помогает разработчикам быстро находить и анализировать код в больших репозиториях, поддерживает множество языков программирования (Java, C/C++, Python, и другие). OpenGrok предоставляет функциональность для поиска по меткам, комментариям, коду и даже документации. Инструмент ориентирован на улучшение работы с кодом в больших проектах и используется для облегчения навигации по огромным кодовым базам.

🖥 Github

✅ Java библиотека #java

Лайфхак: оптимизируем DTO с record

Вместо обычных POJO-классов для DTO используйте record (Java 14+). Меньше кода, больше удобства.

Record автоматически создает иммутабельный класс с приватными финальными полями, конструктором, геттерами, а также переопределенными методами toString(), equals() и hashCode().

❌ Избыточно

public class User {
    private final String name;
    private final int age;
    
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public String getName() { return name; }
    public int getAge() { return age; }

    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + "}";
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        User user = (User) obj;
        return age == user.age && Objects.equals(name, user.name);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name, age);
    }
} 

✔️ Красиво и лаконично

public record User(String name, int age) {}

✅ Java библиотека #java

🖥 Shizuku — это инструмент, позволяющий обычным Android-приложениям напрямую использовать системные API с привилегиями ADB или root!

🌟 Он работает путем запуска Java-процесса с помощью app_process, что позволяет приложениям взаимодействовать с системными сервисами без необходимости в полном рут-доступе.

🔐 Лицензия: Apache-2.0

🖥 Github

✅ Java библиотека #java

Паттерн Состояние (State)

State — это поведенческий паттерн, который позволяет объекту менять свое поведение в зависимости от внутреннего состояния. Вместо множества условных операторов (if-else или switch), каждое состояние представляется отдельным классом, а сам объект делегирует управление текущему состоянию.

Когда использовать

🟢Когда у объекта есть несколько состояний, и его поведение зависит от текущего состояния.
🟢Когда код с if-else или switch начинает разрастаться и усложняет поддержку.
🟢Когда необходимо четко разделить логику различных состояний и сделать систему более гибкой.

Преимущества

1️⃣Избавляет от множества if-else конструкций, делая код более читаемым и поддерживаемым.
2️⃣Облегчает добавление новых состояний без изменения существующего кода.
3️⃣Обеспечивает инкапсуляцию логики для каждого состояния, упрощая тестирование и модификации.

Недостатки

1️⃣Может усложнить код, если состояний слишком мало, а логика простая.
2️⃣Увеличивает количество классов, так как каждое состояние реализуется отдельно.
3️⃣Вводит дополнительные связи между классами состояний и контекстом.

State — мощный инструмент, когда объекту нужно динамически изменять свое поведение. Он особенно полезен в конечных автоматах, обработке пользовательских действий и моделировании процессов с четко определенными шагами.

✅ Java библиотека #java

🖥OkHttp — это эффективный HTTP-клиент с открытым исходным кодом, разработанный компанией Square для платформ Java и Kotlin!

🌟 Он обеспечивает простоту выполнения HTTP-запросов и обработки ответов, поддерживая современные протоколы, такие как HTTP/2. OkHttp активно используется в Android-разработке и является основой для таких библиотек, как Retrofit.

🔐 Лицензия: Apache-2.0

🖥 Github

✅ Java библиотека #java

Что такое микросервисы?

Микросервисы — это архитектурный стиль, при котором приложение разбивается на небольшие, независимые сервисы. Каждый сервис отвечает за определённую бизнес-логику, имеет собственную базу данных (или логически обособленное хранилище) и взаимодействует с другими сервисами через API (обычно REST или gRPC).

🟢Ключевые принципы

— Можно обновлять и масштабировать отдельные сервисы без затрагивания всей системы.
— Каждый сервис выполняет свою узкую задачу.
— У сервиса свои изолированные данные, код и зависимости.
— Сервисы общаются через HTTP, AMQP, Kafka и другие механизмы.

✅ Java библиотека #java

Java Streams: Основные методы для чистого и эффективного кода!

Java Streams предлагают множество методов для упрощения манипуляций с данными и повышения читаемости кода.
Вот краткое руководство с примерами:

Освойте эти методы, чтобы писать более чистый и эффективный код на Java! 💡

✅ Java библиотека #java

🖥 Vert.x — это набор инструментов для создания реактивных приложений на JVM

Ядро Vert.x содержит достаточно низкоуровневую функциональность, включая поддержку HTTP, TCP, доступ к файловой системе и различные другие возможности. Можно использовать Vert.x непосредственно в своих приложениях.

🖥 GitHub
🟡 Доки

✅ Java библиотека #java

🖥 JDK, JRE и JVM

▪️ JDK (Java Development Kit) — это набор инструментов для разработки приложений на Java. Включает компилятор, библиотеки и утилиты, необходимые для написания и сборки кода.

▪️ JRE (Java Runtime Environment) — среда выполнения, которая позволяет запускать Java-приложения. Включает в себя JVM и стандартные библиотеки, но без инструментов разработки.

▪️ JVM (Java Virtual Machine) — виртуальная машина, которая исполняет байт-код, сгенерированный при компиляции. Именно JVM делает Java переносимой, так как позволяет запускать программы на разных платформах.

✅ Java библиотека #java

Абстракция в Java

Абстракция — это способность выделять существенные характеристики объекта и упускать несущественные.
Абстракция позволяет сосредоточиться на важных свойствах и поведении объекта, скрыв детали реализации.

В Java абстракция реализуется с помощью абстрактных классов и интерфейсов.

Абстрактный класс содержит абстрактные методы без реализации. Подклассы обязаны реализовать эти методы.
Интерфейс задает «контракт», описывая поведение классов без деталей реализации. Классы реализуют интерфейс.

Реализация абстракции требует тщательного анализа предметной области и выделения общих свойств объектов.

✅ Java библиотека #java

Sorted set

SortedSet — это интерфейс в Java Collection Framework, который предоставляет упорядочение элементов в множестве. Элементы упорядочиваются с помощью их естественного порядка или с помощью компаратора, который обычно предоставляется при создании отсортированного множества.

SortedSet имеет несколько дополнительных операций, которые позволяют использовать упорядочение элементов:
— first() и last() возвращают первый и последний элементы в множестве соответственно.
— headSet(), tailSet() и subSet() возвращают подмножества элементов, которые находятся до, после или между заданными элементами соответственно.

В этом примере мы создаем TreeSet (класс, который реализует SortedSet) и добавляем в него несколько строк. Поскольку строки реализуют интерфейс Comparable, они упорядочиваются в алфавитном порядке. Затем мы используем различные методы SortedSet для получения первого и последнего элементов, а также подмножеств элементов.

✅ Java библиотека #java

⚡️ Как избавиться от задержек и сделать систему быстрее

1️⃣ Кэширование

Временное хранение часто используемых данных в памяти для сокращения времени доступа.

🔘Чем полезно:
- Получение данных из кэша (например, Redis, Memcached) гораздо быстрее, чем запросы к базе данных.
- Кэширование статических ресурсов (изображения, CSS, JS) снижает необходимость многократного запроса их с исходного сервера.

2️⃣ Распределение нагрузки

Распределение входящего сетевого трафика между несколькими серверами для предотвращения перегрузки одного сервера.

🔘Чем полезно:
- Балансировка нагрузки предотвращает перегрузку одного сервера, что может замедлить отклик.
- Обеспечивает отказоустойчивость, гарантируя обработку запросов даже при выходе некоторых серверов из строя.

3️⃣ Асинхронная обработка

Обработка задач в фоновом режиме без блокировки основного потока выполнения, что позволяет системе продолжать обработку других запросов.

🔘Чем полезно:
- Пользователям не нужно ждать завершения длительных задач (например, отправки электронной почты или обработки изображений).

4️⃣ Разделение данных (шардирование)

Разделение базы данных на более мелкие части (шарды), которые можно распределить между несколькими серверами.

🔘Чем полезно:
- Запросы могут выполняться параллельно на нескольких шардах, сокращая время получения данных.
- Распределение нагрузки предотвращает перегрузку одного экземпляра базы данных.

5️⃣ Сети доставки контента (CDA)

Распределенные сети серверов, которые доставляют веб-контент на основе географического расположения пользователя.

🔘Чем полезно:
- Контент предоставляется с серверов, находящихся ближе к пользователю, сокращая физическое расстояние, которое данные должны преодолеть.
- Кэширует статический и динамический контент для ускорения его доставки.

6️⃣ Оптимизация баз данных

Оптимизация работы баз данных через индексацию, оптимизацию запросов и правильное проектирование схемы.

🔘Чем полезно:
- Ускоряет получение данных, позволяя базе данных находить записи без сканирования всех таблиц.

7️⃣ Минимизация сетевых переходов

Сокращение числа промежуточных шагов, через которые проходят данные, и выбор эффективных протоколов связи.

🔘Чем полезно:
- Каждый сетевой переход добавляет задержку; их минимизация ускоряет передачу данных.

8️⃣ Параллельная и конкурентная обработка

Разделение задач на несколько параллельно выполняемых потоков или процессов для увеличения скорости выполнения операций.

🔘Чем полезно:
- Параллельное выполнение задач позволяет обрабатывать данные быстрее за счёт разделения работы на несколько потоков.
- Более эффективное использование ресурсов процессора, что снижает задержки при выполнении сложных операций.

9️⃣ Предварительная и предсказательная загрузка

Предугадывание будущих запросов данных и их предварительная загрузка.

🔘 Чем полезно:
- Данные уже доступны, когда они запрашиваются, устраняя задержки при получении.
- Особенно эффективно в приложениях с предсказуемыми шаблонами доступа.

✅ Java библиотека #java

CompletableFuture

CompletableFuture в пакете java.util.concurrent является классом, который предоставляет мощный и гибкий подход к асинхронному программированию. Он позволяет выполнять асинхронные операции и обрабатывать их результаты, комбинировать несколько операций и управлять зависимостями между ними.

Помимо операций, представленных на изображении, CompletableFuture также предоставляет множество других методов для работы с асинхронными операциями, таких как thenApply(), thenCompose(), thenCombine(), exceptionally() и другие, которые позволяют обрабатывать результаты, комбинировать операции, обрабатывать исключения и многое другое. Это делает CompletableFuture мощным инструментом для асинхронного программирования.

✅ Java библиотека #java

Агрегация: что это и когда использовать?

Агрегация — это тип отношения между классами, при котором один класс "владеет" экземпляром другого, но их жизненные циклы не зависят друг от друга. Это «слабое» отношение, так как объект одного класса может существовать независимо от объекта другого.

Пример:

class Engine {
    void start() {
        System.out.println("Двигатель запущен");
    }
}

class Car {
    private Engine engine;

    Car(Engine engine) {
        this.engine = engine;
    }

    void startCar() {
        engine.start();
        System.out.println("Машина поехала");
    }
}

public class Main {
    public static void main(String[] args) {
        Engine engine = new Engine(); // Двигатель может существовать отдельно
        Car car = new Car(engine);
        car.startCar();
    }
}

🟢В этом примере класс Car агрегирует объект Engine, но двигатель может существовать сам по себе, вне машины.

Агрегацию стоит использовать, когда один объект логически принадлежит другому, но их существование не связано напрямую. Например, библиотека и книги, где книги могут существовать без самой библиотеки

✅ Java библиотека #java

🖥 Scoped Values в Java 21

Разберем новую фичу Java 21 — Scoped Values, которая пришла на замену (а точнее, в дополнение) к старому доброму ThreadLocal. Если вы когда-либо мучились с ThreadLocal в многопоточных приложениях, этот пост для вас.

🔽 Проблема ThreadLocal

ThreadLocal — это механизм для хранения данных, привязанных к потоку. Но у него есть недостатки:

— Данные остаются в потоке, даже когда уже не нужны (утечки памяти).
— Передавать данные в дочерние потоки неудобно.
— Нужно очистить данные вручную.

Scoped Values решают эти проблемы без магии и костылей.

⚙️ Как работают Scoped Values

Scoped Values (ScopedValue<T>) создаются только один раз и не изменяются после инициализации. Они передаются вглубь стека вызовов через метод ScopedValue.where(), а не через хранение в потоке, как ThreadLocal.

▪️ Пример кода с потоками

Допустим, есть обработчик запросов, который передает идентификатор пользователя.

— С ThreadLocal код выглядел бы так:

public class ThreadLocalExample {
    private static final ThreadLocal<String> USER = new ThreadLocal<>();

    public static void main(String[] args) {
        USER.set("Alice");
        new Thread(ThreadLocalExample::process).start();
    }

    private static void process() {
        System.out.println("User: " + USER.get()); // null: поток не видит значение
    }
}

ThreadLocal привязан к потоку, а не к области выполнения. Значение не наследуется

Теперь переделаем на Scoped Values:

public class ScopedValueExample {
    private static final ScopedValue<String> USER = ScopedValue.newInstance();

    public static void main(String[] args) {
        ScopedValue.where(USER, "Alice").run(() -> {
            new Thread(ScopedValueExample::process).start();
        });
    }

    private static void process() {
        System.out.println("User: " + USER.get()); // ✅ Видит "Alice"
    }
}

Scoped Values автоматически передают значение в новые потоки.

🎯 Где использовать Scoped Values

1. Контекст запроса (Request Context)
В веб-приложениях часто нужно передавать ID запроса или текущего пользователя через слои сервиса.

2. Логирование (Tracing & Logging)
Можно автоматически передавать traceId в логи.

3. Конфигурация временных параметров
Можно временно менять настройки для фрагмента кода.

🔘Преимущества и недостатки

— ScopedValue быстрее и безопаснее, так как нет необходимости очищать значения вручную.
— Отлично подходит для работы с виртуальными потоками.
— Ограничение: они неизменяемые (Immutable).

❓ Уже использовали? Делитесь опытом