🗓 Еженедельный дайджест №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

🖥 Scoped Values в Java (Часть 2)

Недавно мы рассказывали про Scoped Values. Одной из ключевых особенностей Scoped Values (JEP-481) является отсутствие метода set, в отличие от ThreadLocal, что позволяет гарантировать, что после привязки значения к run/call методам конкретных Runnable и Callable, оно не может быть в них изменено:

private static final ScopedValue<String> X = ScopedValue.newInstance();

void foo() {
    ScopedValue.runWhere(X, "hello", () -> bar()); //привязываем значение "hello" для метода bar()
}

void bar() {
    System.out.println(X.get()); // "hello"
    ScopedValue.runWhere(X, "goodbye", () -> baz()); //привязываем значение "goodbye" для метода baz()
    System.out.println(X.get()); // "hello"
}

void baz() {
    System.out.println(X.get()); // "goodbye"
}
 

1. В методе foo() устанавливаем значение "hello" для области видимости внутри метода bar()
2. В методе bar() запрашиваем значение. Получаем "hello"
3. В методе bar() устанавливаем значение "goodbye" для области видимости внутри метода baz()
4. В методе bar() запрашиваем значение. Получаем "hello". Тем самым убеждаемся, что после установки значения для области видимости внутри метода baz() оно не поменялось для метода bar()
5. В методе baz() запрашиваем значение. Получаем "goodbye".

Важно отметить, что привязка "goodbye" действует только внутри вложенной области видимости. После завершения выполнения метода baz() значение X в bar() возвращается к "hello". Таким образом, тело метода bar() не может изменить привязку, видимую этим методом, но может изменить привязку, видимую его вызываемыми методами. После завершения метода foo() X возвращается в состояние без привязки. Такое вложение гарантирует ограниченный срок действия для совместного использования нового значения.

Scoped Values API также предоставляет метод callWhere, который позволяет получить результат выполнения:

var result = ScopedValue.callWhere(X, "hello", () -> bar());

В этом случае callWhere выполняет код внутри области видимости, где X привязан к значению "hello", и возвращает результат выполнения.

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

Ставьте 🔥 если разбор JEP был полезен и вы хотели бы видеть больше подобных обзоров

#Java #JEP

🚀 Вышла IntelliJ IDEA 2024.2

В конце прошлой недели стала доступна новая версия IntelliJ IDEA. Вот основные нововведения, которые попали в свежую сборку:

🏎 Уменьшено время запуска IDE, ключевые функции стали доступны еще до завершения полной индексации проекта
▶️ Теперь можно запускать методы Spring Data JPA непосредственно в среде разработки, без необходимости запускать проект целиком
⏰ Добавлены человеко-понятные описания для cron-выражений, улучшено их автодополнение
🔧 Улучшен режим K2, — новый механизм поддержки Kotlin, — который делает IDE стабильнее и быстрее
⭐️ Новый интерфейс теперь включен по умолчанию для всех пользователей

Полный список изменений и улучшений доступен на сайте IntelliJ IDEA: https://www.jetbrains.com/ru-ru/idea/whatsnew/

P.S. А какие улучшения вам показались самыми полезными?

🔝 JPA Entity. Загрузи меня не полностью

JPA часто подвергается критике за невозможность загружать сущности частично, что на самом деле является большим заблуждением. Spring Data JPA и Hibernate включают в себя множество инструментов по частичной загрузке сущностей.

Команда Spring АйО подготовила статью, в которой рассмотрела имеющиеся в Spring Data JPA инструменты для частичной загрузки сущностей, а также разобрала их особенности и corner-кейсы.

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

🔗 Spring 6 JdbcClient API

Посмотрите на своего мужчину:

List<Student> getStudentsOfGradeStateAndGenderWithPositionalParams(int grade, String state, String gender) {
    String sql = "select student_id, student_name, age, grade, gender, state from student where grade = ? and state = ? and gender = ?";
    return jdbcTemplate.query(sql, new Object[]{grade, state, gender}, new StudentRowMapper());
}

А теперь на меня:

List<Student> getStudentsOfGradeStateAndGenderWithPositionalParams(int grade, String state, String gender) {
    String sql = "select student_id, student_name, age, grade, gender, state from student where grade = ? and state = ? and gender = ?";
    return jdbcClient.sql(sql)
      .param(grade)
      .param(state)
      .param(gender)
      .query(new StudentRowMapper()).list();
}

Это и есть новая фича Spring Framework 6.1, которая предоставляет интерфейс JdbcClient, благодаря которому параметры запроса можно указывать прямо в chain-вызовах.

Предположим, что у нас есть таблица student с полями student_id (INT), student_name (VARCHAR(255)), age (INT), grade (INT), gender (VARCHAR(10)) и state VARCHAR(100)

Объявим bean:

@Repository
class StudentDao {
    @Autowired
    private JdbcClient jdbcClient;
}

JdbcClient готов к использованию.

Нам также завезли поддержку именованных параметров:

int getCountOfStudentsOfGradeStateAndGenderWithNamedParam(int grade, String state, String gender) {
    String sql = "select student_id, student_name, age, grade, gender, state from student where grade = :grade and state = :state and gender = :gender";
    var countCallbackHandler = new RowCountCallbackHandler();
    jdbcClient.sql(sql)
      .param("grade", grade)
      .param("state", state)
      .param("gender", gender)
      .query(countCallbackHandler);
    return countCallbackHandler.getRowCount();
}

Если необходимо обратиться к параметру запроса по индексу:

List<Student> getStudentsOfGradeStateAndGenderWithParamIndex(int grade, String state, String gender) {
    String sql = "select student_id, student_name, age, grade, gender, state from student"
      + " where grade = ? and state = ? and gender = ?";
    return jdbcClient.sql(sql)
      .param(1, grade)
      .param(2, state)
      .param(3, gender)
      .query(new StudentResultExtractor());
}

А еще можем вытащить значения полей прямо из объекта класса, но в этот раз продемонстрируем пример с использованием перегруженного метода param(), который в качестве третьего параметра примет тип данных, чтобы избежать возможных проблем при сопоставлении типов между Java-приложением и БД (например, при использовании null-значений), после чего вызвать метод update():

Integer insertWithSetParamWithNamedParamAndSqlType(Student student) {
    String sql = "INSERT INTO student (student_name, age, grade, gender, state) VALUES (:name, :age, :grade, :gender, :state)";
    var noOfRowsAffected = this.jdbcClient.sql(sql)
      .param("name", student.getStudentName(), Types.VARCHAR)
      .param("age", student.getAge(), Types.INTEGER)
      .param("grade", student.getGrade(), Types.INTEGER)
      .param("gender", student.getStudentGender(), Types.VARCHAR)
      .param("state", student.getState(), Types.VARCHAR)
      .update()
    return noOfRowsAffected;
}

Можно передать целый список параметров, однако в этом случае необходимо использовать метод params() (таким же образом можно использовать и объект Map в качестве входного параметра):

Optional<Student> getStudentsOfGradeStateAndGenderWithParamsInList(List params) {
    String sql = "select student_id, student_name, age, grade, gender, state from student"
      + " where grade = ? and state = ? and gender = ? limit 1";
    return jdbcClient.sql(sql)
      .params(params)
      .query(new StudentRowMapper()).optional();
}

По итогу интерфейс JdbcClient объединяет возможности JdbcTemplate и NamedParameterJdbcTemplate, предоставляя более удобный API для работы с JDBC. Благодаря этому можно вызывать методы цепочкой.

Ставьте 🔥 если фича кажется полезной