streamalism.org

1. Prehľad

Hikari je JDBC Dátový zdroj implementácia, ktorá poskytuje mechanizmus združovania pripojení.

V porovnaní s inými implementáciami sľubuje ľahkú váhu a lepší výkon. Úvod do Hikari nájdete v tomto článku.

Tento rýchly tutoriál ukazuje, ako môžeme nakonfigurovať aplikáciu Spring Boot 2 alebo Spring Boot 1 na používanie Hikari Dátový zdroj.

2. Konfigurácia Hikari pomocou Spring Boot 2.x

V Spring Boot 2 je Hikari predvolenou implementáciou DataSource.

Toto sa zmenilo od Spring Boot 1.x:

• závislosť na Hikari je teraz automaticky zahrnutá do spring-boot-starter-data-jpa a spring-boot-starter-jdbc
• objavovací algoritmus, ktorý automaticky určuje a Dátový zdroj implementácia teraz uprednostňuje Hikari pred TomcatJDBC (pozri referenčnú príručku).

Nemáme teda čo robiť, ak chceme Hikari použiť v aplikácii založenej na Spring Boot 2.x.

3. Ladenie konfiguračných parametrov Hikari

Jedna z výhod Hikari oproti iným Dátový zdroj implementácií je skutočnosť, že ponúka veľa konfiguračných parametrov.

Hodnoty týchto parametrov môžeme určiť pomocou predpony spring.datasource.hikari a pripojenie názvu parametra Hikari:

spring.datasource.hikari.connectionTimeout = 30000 spring.datasource.hikari.idleTimeout = 600000 spring.datasource.hikari.maxLifetime = 1800000 ...

Zoznam všetkých parametrov Hikari s dobrým vysvetlením je k dispozícii na webe Hikari Github, ako aj v dokumentoch Spring.

4. Konfigurácia Hikari pomocou Spring Boot 1.x

Spring Boot 1.x predvolene používa fond pripojení TomD JDBC.

Hneď ako zaradíme spring-boot-starter-data-jpa do našej pom.xml, prechodne zahrnieme závislosť od implementácie Tomcat JDBC. Počas behu programu Spring Boot potom vytvorí Tomcat Dátový zdroj pre nás na použitie.

Ak chcete nakonfigurovať Spring Boot tak, aby namiesto toho používal Hikari Connection Pool, máme dve možnosti.

4.1. Maven závislosť

Najprv musíme do nášho zahrnúť závislosť na Hikari pom.xml:

 com.zaxxer HikariCP 3.2.0 

Najaktuálnejšiu verziu nájdete na serveri Maven Central.

4.2. Explicitná konfigurácia

Najbezpečnejším spôsobom, ako spoločnosti Spring Boot povedať, aby používala Hikari, je výslovná konfigurácia implementácie DataSource.

Ak to chcete urobiť, jednoducho nastaviť nehnuteľnosť spring.datasource.type na úplný názov spoločnosti Dátový zdroj implementáciu, ktorú chceme použiť:

@RunWith (SpringRunner.class) @SpringBootTest (properties = "spring.datasource.type = com.zaxxer.hikari.HikariDataSource") verejná trieda HikariIntegrationTest {@Autowired private DataSource dataSource; @Test public void hikariConnectionPoolIsConfigured () {assertEquals ("com.zaxxer.hikari.HikariDataSource", dataSource.getClass (). GetName ()); }}

4.3. Odstránenie závislosti Tomcat JDBC

Druhou možnosťou je nechať Spring Boot nájsť Hikari Dátový zdroj samotná implementácia.

Ak Spring Boot nemôže nájsť Tomcat Dátový zdroj v triede automaticky vyhľadá Hikari Dátový zdroj Ďalšie. Algoritmus objavenia je opísaný v referenčnej príručke.

Ak chcete odstrániť skupinu pripojení Tomcat z cesty triedy, môžeme ju vylúčiť z našej pom.xml:

 org.springframework.boot spring-boot-starter-data-jpa org.apache.tomcat tomcat-jdbc 

Teraz bude test z predchádzajúcej časti fungovať aj bez nastavenia spring.datasource.type nehnuteľnosť.

5. Záver

V tomto článku sme nakonfigurovali Hikari Dátový zdroj implementácia v aplikácii Spring Boot 2.x a naučili sa, ako využiť autokonfiguráciu Spring Boot. Pozreli sme sa tiež na zmeny potrebné na konfiguráciu Hikari pri použití Spring Boot 1.x.

Kód príkladu Spring Boot 1.x je k dispozícii tu a kód príkladu Spring Boot 2.x tu.