👩‍💻 Генерация HTTP клиентов для Spring Boot приложения по OpenAPI спецификации

В новом переводе от команды Spring АйО вы узнаете, как можно сгенерировать код HTTP клиентов для Spring Boot приложения по OpenAPI спецификации, используя плагин openapi-generator для Gradle.

В статье вы найдете:

💡 Пошаговую инструкцию по использованию openapi-generator для Gradle
⚙️ Настройки для генератора, которые помогут оставить только нужный код
🍃 Пример конфигурации сгенерированных Spring-бинов

📚 Подробнее читайте на Хабре

😲 Awesome System Design

Нашли интересный репозиторий (больше 10к звезд на GitHub!) с материалами по системному проектированию:

– 18 статей по ключевым концепциям проектирования систем
– 26 статей по основным блокам проектирования систем
– Разбор 50 задач по проектированию на YouTube, разбитых по уровню сложности
– Ответы на вопросы по проектированию системы на интервью
– Ссылки на статьи, книги и каналы YouTube

🔗 https://github.com/ashishps1/awesome-system-design-resources

Сохраняйте, чтобы не потерять!

🗓 Еженедельный дайджест №7

Для тех, кто был слишком занят на неделе или просто пропустил некоторые посты, публикуем дайджест!

– Кастомные валидаторы в Spring Boot: Как сделать валидацию под себя – вспомнили основные нюансы реализации собственных аннотаций и валидаторов

– Soft Assertions в AssertJ – Михаил Поливаха (эксперт сообщества Spring АйО) объяснил, как и в каких ситуации стоит использовать soft assertions

– Spring Boot Tips: Переопределение свойств через переменные окружения – узнали, как переопределять свойства через переменные окружения без их явного указания в application.properties

– Генерация HTTP клиентов для Spring Boot приложения по OpenAPI спецификации – выяснили, как можно сгенерировать код HTTP-клиентов и доработать его при необходимости

– Awesome System Design – нашли отличный репозиторий с материалами по системному дизайну на GitHub

😌@spring_aio

⚡️ Вышел Hibernate 7.0.0.Beta1!

Основное, на что стоит обратить внимание:

* Переход на Jakarta Persistence версии 3.2
* Более строгая проверка доменной модели
* Новая схема mapping.xsd c расширенными возможностями маппинга
* Переход на Hibernate Models с Hibernate Commons Annotations (HCANN)

📚 Подробнее читайте на Хабре

#spring_news #hibernate

🔥 Состояние Spring в 2024 году

Команда Spring АйО перевела важнейший документ для Spring-разработчиков!

В начале июня компания VMWare, владеющая Spring, опубликовала результаты исследования, в котором приняло учатие более 1,500 разработчиков по всему миру. Отчёт получился действительно интересным и всеобъемлющим. Были рассмотрены как базовые темы, такие как выбор архитектурных подходов и типов API, так и продвинутые, такие как компиляция в Native Image и использование Spring вместе с Kubernetes.

Обязательно к прочтению: https://habr.com/ru/companies/spring_aio/articles/834050/

Сохраняй, делись с друзьями и оставляй своё мнение касаемо результатов этого исследования в комментариях!

😌@spring_aio

✨ Spring Tips: Рекурсивные запросы в Hibernate

Рекурсивные запросы в SQL очень полезны при работе с иерархическими или графовыми структурами данных. Конструкция WITH, введенная в SQL:1999, позволяет задавать Common Table Expressions (CTE), которые представляют собой именованные подзапросы. CTE упрощают сложные запросы, улучшают их читаемость и, что самое важное, позволяют нам реализовать рекурсию.

Рассмотрим таблицу, которая хранит информацию о сотрудниках и их менеджерах:

CREATE TABLE employees (
  employee_id INTEGER GENERATED BY DEFAULT AS IDENTITY NOT NULL,
  employee_name VARCHAR(255),
  manager_id INTEGER,
  CONSTRAINT pk_employees PRIMARY KEY (employee_id)
);

ALTER TABLE employees ADD CONSTRAINT 
FK_EMPLOYEES_ON_MANAGER FOREIGN KEY (manager_id) 
REFERENCES employees (employee_id);

Эта таблица представляет собой список сотрудников, где у каждого сотрудника есть уникальный идентификатор (employee_id), имя (employee_name) и ссылка на менеджера (manager_id). Поле manager_id является внешним ключом, ссылающимся на employee_id в той же таблице, что позволяет создать иерархическую структуру, где один сотрудник может быть менеджером для других.

Предположим, что нам нужно выбрать всех подчиненных определенного менеджера. Для решения этой задачи мы можем использовать рекурсивный SQL запрос:

WITH RECURSIVE EmployeeHierarchy AS (
    -- Базовый случай: начнем с верхнего уровня менеджера
    SELECT employee_id, employee_name, manager_id
    FROM employees
    WHERE manager_id = :id

    UNION ALL

    -- Рекурсивный случай: найдем всех сотрудников, подчиненных найденным ранее сотрудникам
    SELECT e.employee_id, e.employee_name, e.manager_id
    FROM employees e
    INNER JOIN EmployeeHierarchy eh ON e.manager_id = eh.employee_id
)

SELECT *
FROM EmployeeHierarchy;

До выхода версии Hibernate 6.2, для выполнения подобных запросов приходилось использовать nativeQuery. Пример с использованием entityManager выглядит следующим образом:

var sql = {SQL-запрос, представленный выше};

var employees = entityManager.createNativeQuery(sql, Employee.class)
        .setParameter("id", 1)
        .getResultList();

Либо так, если используется Spring Data JPA:

public interface EmployeeRepository extends JpaRepository<Employee, Integer> {
    @Query(value = "{SQL-запрос, представленный выше}", nativeQuery = true)
    List<Employee> findAllEmployeesByManagerIdSQL(@Param("id") Integer id);
}

List<Employee> employees = employeeRepository.findAllEmployeesByManagerIdSQL(1);

С выходом Hibernate 6.2, появилась возможность писать рекурсивные запросы, используя HQL. Запрос, представленный выше, теперь можно написать так:

String jpql = """
        WITH EmployeeHierarchy AS (
            SELECT e.employeeId AS id, e.employeeName AS name, e.manager AS mgr
            FROM Employee e
            WHERE e.manager.id = :id
        
            UNION ALL
        
            SELECT e.employeeId, e.employeeName, e.manager.id
            FROM Employee e
            JOIN EmployeeHierarchy eh ON e.manager.id = eh.id
        )
        SELECT new Employee(
            eh.id,
            eh.name,
            eh.mgr
        )
        FROM EmployeeHierarchy eh
        """;

var employees = entityManager.createQuery(jpql, Employee.class)
        .setParameter("id", 1)
        .getResultList();

А также со Spring Data JPA:

public interface EmployeeRepository extends JpaRepository<Employee, Integer> {
    @Query(value = "{JPQL-запрос, представленный выше}")
    List<Employee> findAllEmployeesByManagerIdJPQL(@Param("id") Integer id);
}

List<Employee> employees = employeeRepository.findAllEmployeesByManagerIdJPQL(1);

Как можно заметить, синтаксис HQL и SQL запросов довольно сильно похож. Но есть некоторые различия:

* В отличие от стандартного SQL, в Hibernate нет необходимости использовать ключевое слово RECURSIVE
* В Hibernate имена атрибутов CTE задаются через псевдонимы в выражении SELECT. Другими словами, в заголовке CTE имена не указываются.

#SpringTips #Hiberante #CTE

👸 The Mother Of All Demo Apps

Когда вы изучаете новую технологию, наличие хорошего примера может значительно облегчить процесс. Представляем полезный ресурс под названием RealWorld или, как, говорят сами его разработчики, - The Mother Of All Demo Apps.

RealWorld - это сервис, на котором собраны проекты с различным стеком, которые, благодаря спеке, должны предоствлять один и тот же API.

Команда Spring АйО выбрала из всего списка самые свежие проекты на Spring Boot с актуальным стеком:

- Spring Boot
- Spring Boot + GraalVM + Spring Data JPA + Spring Security
- Spring Boot + MyBatis
- Spring Boot + Spring Data JPA
- Spring Boot + Spring Data JPA + openapi-generator
- Spring Boot + Spring Data JPA + PostgreSQL
- Spring Boot + Spring Data JPA + Spring Security
- Spring Boot + Spring Security + jOOQ
- Spring Boot + WebFlux + MongoDB
- Spring Boot + WebFlux + RouterFunction + Spock
- Spring Data Couchbase + Spring Boot + Couchbase

Сохраняйте, чтобы не потерять!

🗓 Еженедельный дайджест №8

Для тех, кто был слишком занят на неделе или просто пропустил некоторые посты, публикуем дайджест!

– Вышел Hibernate 7.0.0.Beta1 – узнали, что нового в грядущем мажорном релизе

– Состояние Spring в 2024 году – выяснили, какие технологии по-прежнему остаются актуальными, а какие стремительно набирают популярность в Spring-экосистеме

– Рекурсивные запросы в Hibernate – вспомнили одну из ключевых фич Hibernate 6.3, и посмотрели на неё в действии

– The Mother Of All Demo Apps – нашли ресурс с большим количеством open-source проектов, но не все из них оказались безупречными

😌@spring_aio