streamalism.org

1. Overzicht

Spring Boot maakt het heel gemakkelijk om onze databasewijzigingen op een gemakkelijke manier te beheren. Als we de standaardconfiguratie verlaten, zoekt het naar entiteiten in onze pakketten en maakt het automatisch de respectieve tabellen.

Maar soms hebben we wat fijnere controle nodig over de wijzigingen in de database. Dat is wanneer we de data.sql en schema.sql bestanden in het voorjaar.

2. Het data.sql het dossier

Laten we hier ook aannemen dat we met JPA werken - en een eenvoudig definiëren Land entiteit in ons project:

@Entity openbare klasse Land {@Id @GeneratedValue (strategy = IDENTITY) privé Geheel getal-id; @Column (nullable = false) private String naam; // ...}

Als we onze applicatie uitvoeren, Spring Boot zal een lege tabel voor ons maken, maar deze met niets vullen.

Een gemakkelijke manier om dit te doen, is door een bestand met de naam data.sql:

INVOEGEN IN land (naam) WAARDEN ('India'); INVOEGEN IN land (naam) WAARDEN ('Brazilië'); INVOEGEN IN land (naam) WAARDEN ('VS'); INVOEGEN IN land (naam) WAARDEN ('Italië');

Wanneer we het project met dit bestand op het klassenpad uitvoeren, pikt Spring het op en gebruikt het voor het vullen van de database.

3. Het schema.sql het dossier

Soms willen we niet vertrouwen op het standaardmechanisme voor het maken van schema's. In dergelijke gevallen kunnen we een custom schema.sql het dossier:

CREATE TABLE land (id INTEGER NOT NULL AUTO_INCREMENT, naam VARCHAR (128) NOT NULL, PRIMARY KEY (id));

Spring pikt dit bestand op en gebruikt het om een ​​schema te maken.

Het is ook belangrijk om te onthouden om het automatisch maken van schema's uit te schakelen om conflicten te voorkomen:

spring.jpa.hibernate.ddl-auto = geen

4. Beheer van het maken van databases met behulp van de slaapstand

Spring biedt een JPA-specifiek eigenschap die Hibernate gebruikt voor het genereren van DDL: spring.jpa.hibernate.ddl-auto.

De standaardwaarden van de Hibernate-eigenschap zijn: creëren, bijwerken, create-drop, valideren en geen:

• creëren - Hibernate verwijdert eerst bestaande tabellen en maakt vervolgens nieuwe tabellen
• bijwerken - het objectmodel dat is gemaakt op basis van de toewijzingen (annotaties of XML) wordt vergeleken met het bestaande schema, en vervolgens werkt Hibernate het schema bij volgens de diff. Het verwijdert nooit de bestaande tabellen of kolommen, zelfs als ze niet meer nodig zijn door de toepassing
• create-drop - gelijkwaardig aan creëren, met de toevoeging dat Hibernate de database laat vallen nadat alle bewerkingen zijn voltooid. Meestal gebruikt voor het testen van eenheden
• valideren - Hibernate valideert alleen of de tabellen en kolommen bestaan, anders genereert het een uitzondering
• geen - deze waarde schakelt de DDL-generatie effectief uit

Spring Boot stelt deze parameterwaarde intern standaard in op create-drop als er geen schemamanager is gedetecteerd, anders geen voor alle andere gevallen.

We moeten de waarde zorgvuldig instellen of een van de andere mechanismen gebruiken om de database te initialiseren.

5. @Sql

De lente biedt ook de @Sql annotatie - een declaratieve manier om ons testschema te initialiseren en te vullen.

Laten we eens kijken hoe we de @Sql annotatie om een ​​nieuwe tabel te maken en ook de tabel te laden met initiële gegevens voor onze integratietest:

@Sql ({"/ workers_schema.sql", "/import_employees.sql"}) openbare klasse SpringBootInitialLoadIntegrationTest {@Autowired privé EmployeeRepository employeeRepository; @Test openbare ongeldige testLoadDataForTestClass () {assertEquals (3, employeeRepository.findAll (). Size ()); }}

De attributen van de @Sql annotaties zijn:

• config - lokale configuratie voor de SQL-scripts. We beschrijven dit in detail in de volgende sectie
• uitvoeringsfase - we kunnen ook specificeren wanneer de scripts moeten worden uitgevoerd BEFORE_TEST_METHOD of AFTER_TEST_METHOD
• verklaringen - we kunnen inline SQL-instructies declareren om uit te voeren
• scripts - we kunnen de paden naar uit te voeren SQL-scriptbestanden declareren. Dit is een alias voor de waarde attribuut

De @Sql annotatie kan worden gebruikt op klassenniveau of op methodeniveau. We kunnen aanvullende gegevens laden die nodig zijn voor een bepaald testgeval door die methode te annoteren:

@Test @Sql ({"/ import_senior_employees.sql"}) openbare ongeldige testLoadDataForTestCase () {assertEquals (5, employeeRepository.findAll (). Size ()); }

@Test @Sql (scripts = {"/import_senior_employees.sql"}, config = @SqlConfig (encoding = "utf-8", transactionMode = TransactionMode.ISOLATED)) openbare ongeldige testLoadDataForTestCase () {assertEquals (5, employeeRepository (5, employeeRepository (5, employeeRepository () ).grootte()); }

@SqlGroup ({@Sql (scripts = "/employees_schema.sql", config = @SqlConfig (transactionMode = TransactionMode.ISOLATED)), @Sql ("/ import_employees.sql")}) openbare klasse SpringBootSqlGroupAnnotation EmployeeIntegrationTest privé werknemerRepository ; @Test openbare ongeldige testLoadDataForTestCase () {assertEquals (3, employeeRepository.findAll (). Size ()); }}