Використання JdbcTemplate

this.jdbcTemplate.update(
        "update t_actor set last_name = ? where id = ?",
        "Banjo", 5276L);

jdbcTemplate.update(
        "update t_actor set last_name = ? where id = ?",
        "Banjo", 5276L)
        

this.jdbcTemplate.update(
        "delete from t_actor where id = ?",
        Long.valueOf(actorId));
        

jdbcTemplate.update("delete from t_actor where id = ?", actorId.toLong())

Інші операції JdbcTemplate

Можна використовувати метод execute(..) для виконання довільного SQL. Отже, цей метод часто використовується для стейтментів мовою визначення даних (Data Definition Language/DDL). Він сильно перевантажений варіантами, які приймають інтерфейси зворотного виклику, прив'язують масиви змінних тощо. У цьому прикладі створюється таблиця:

this.jdbcTemplate.execute("create table mytable (id integer, name varchar(100))");

jdbcTemplate.execute("create table mytable (id integer, name varchar(100))")

У наступному прикладі викликається збережена процедура:

this.jdbcTemplate.update(
        "call SUPPORT.REFRESH_ACTORS_SUMMARY(?)",
        Long.valueOf(unionId));
            

jdbcTemplate.update(
        "call SUPPORT.REFRESH_ACTORS_SUMMARY(?)",
        unionId.toLong())
            

Удосконалена підтримка збережених процедур описується далі.

Оптимальні методи роботи з JdbcTemplate

Після завершення конфігурування екземпляри класу JdbcTemplate є потокобезпечними. Це важливо, оскільки означає, що можна налаштувати один екземпляр JdbcTemplate і потім безпечно впровадити це загальне посилання до кількох DAO (або репозиторіїв). JdbcTemplate зберігає стан, оскільки зберігає посилання на DataSource, але цей стан не є діалоговим станом.

Оптимальним методом роботи під час використання класу JdbcTemplate (і пов'язаного з ним класу NamedParameterJdbcTemplate) є конфігурація DataSource у конфігураційному файлі Spring, а потім — впровадження залежності цього спільного біна DataSource до класів DAO. JdbcTemplate створюється в сетері для DataSource. Це призводить до появи DAO приблизно такого вигляду:

public class JdbcCorporateEventDao implements CorporateEventDao {
    private JdbcTemplate jdbcTemplate;
    public void setDataSource(DataSource dataSource) {
        this.jdbcTemplate = new JdbcTemplate(dataSource);
    }
    // Реалізації методів CorporateEventDao з підтримкою JDBC слідують...
}

class JdbcCorporateEventDao(dataSource: DataSource) : CorporateEventDao {
    private val jdbcTemplate = JdbcTemplate(dataSource)
    // Реалізації методів CorporateEventDao з підтримкою JDBC слідують...
}

У наступному прикладі показано відповідну конфігурацію XML:

<?xml version="1.0" encoding="UTF-8"?>
            <beans xmlns="http://www.springframework.org/schema/beans"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xmlns:context="http://www.springframework.org/schema/context"
                   xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        https://www.springframework.org/schema/context/spring-context.xsd">
    <bean id="corporateEventDao" class="com.example.JdbcCorporateEventDao">
        <property name="dataSource" ref="dataSource"/>
    </bean>
    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
        <property name="driverClassName" value="${jdbc.driverClassName}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
    </bean>
    <context:property-placeholder location="jdbc.properties"/>
</beans>

Альтернативою явної конфігурації є використання сканування компонентів та підтримка анотацій для впровадження залежностей. У цьому випадку ти можеш позначити клас анотацією @Repository (що робить його кандидатом на сканування компонентів) і позначити метод встановлення DataSource анотацією @Autowired. У цьому прикладі показано, як це зробити:

@Repository 
public class JdbcCorporateEventDao implements CorporateEventDao {
    private JdbcTemplate jdbcTemplate;
    @Autowired
    public void setDataSource(DataSource dataSource) {
        this.jdbcTemplate = new JdbcTemplate(dataSource); 
    }
    // Реалізації методів CorporateEventDao з підтримкою JDBC слідують...
}

1. Анотуємо клас за допомогою @Repository.
2. Анотуємо сетер DataSource за допомогою @Autowired.
3. Створюємо новий JdbcTemplate за допомогою DataSource.

@Repository 
class JdbcCorporateEventDao(dataSource: DataSource) : CorporateEventDao { 
    private val jdbcTemplate = JdbcTemplate(dataSource) 
    // Реалізації методів CorporateEventDao з підтримкою JDBC слідують...
}

1. Анотуємо клас за допомогою @Repository.
2. Constructor injection of the DataSource.
3. Створюємо новий JdbcTemplate за допомогою DataSource.

У наступному прикладі показано відповідну XML-конфігурацію:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        https://www.springframework.org/schema/context/spring-context.xsd">
    <!-- Пошук у базовому пакеті програми класів з анотацією @Component для конфігурування як біни -->
    <context:component-scan base-package="org.springframework.docs.test" />
    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
        <property name="driverClassName" value="${jdbc.driverClassName}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
    </bean>
    <context:property-placeholder location="jdbc.properties"/>
</beans>

Якщо ти використовуєш клас JdbcDaoSupport зі Spring, а різні класи DAO із підтримкою JDBC примикають до нього, твій підклас успадковує метод setDataSource(..) від класу JdbcDaoSupport. Ти можеш визначати, чи успадковувати від цього класу. Клас JdbcDaoSupport вказується лише для зручності.

Незалежно від того, який із описаних вище стилів ініціалізації шаблону ти вирішиш використовувати (або не використовувати), рідко виникає необхідність створювати новий екземпляр класу JdbcTemplate щоразу, коли потрібно виконати SQL. Після завершення конфігурування екземпляр JdbcTemplate є потокобезпечним. Якщо твій додаток звертається до кількох баз даних, тобі може знадобитися декілька екземплярів JdbcTemplate, що вимагає наявності кількох DataSources і, відповідно, кількох по-різному налаштованих екземплярів JdbcTemplate.