Spring АйО

🔗 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. Благодаря этому можно вызывать методы цепочкой.



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