Tavaszi Boot Gradle plugin

1. Áttekintés

A Spring Boot Gradle plugin segít a Spring Boot függőségek kezelésében, valamint az alkalmazásunk csomagolásában és futtatásában, amikor a Gradle-t építési eszközként használjuk.

Ebben az oktatóanyagban megvitatjuk, hogyan adhatjuk hozzá és konfigurálhatjuk a beépülő modult, majd megnézzük, hogyan kell felépíteni és futtatni a Spring Boot projektet.

2. Építsen fájlkonfigurációt

Első, hozzá kell adnunk a Spring Boot plugint a mi épít.gradle fájlba történő felvételével bővítmények szakasz:

bővítmények {id "org.springframework.boot" verzió "2.0.1.RELEASE"}

Ha a Gradle 2.1-nél korábbi verziót használunk, vagy dinamikus konfigurációra van szükségünk, akkor ezt így hozzáadhatjuk:

buildscript {ext {springBootVersion = '2.0.1.RELEASE'} adattárak {mavenCentral ()} függőségek {classpath ("org.springframework.boot: spring-boot-gradle-plugin: $ {springBootVersion}")}}} plugin alkalmazása: 'org.springframework.boot'

3. Alkalmazásunk csomagolása

Csomagolhatjuk alkalmazásunkat egy futtatható archívumba (jar vagy war file) azáltal, hogy felépítjük a épít parancs:

./gradlew build

Ennek eredményeként a létrehozott futtatható archívum a build / libs Könyvtár.

Ha futtatható fájlt akarunk létrehozni befőttes üveg fájlt, akkor a Jáva csatlakoztat:

plugin alkalmazása: 'java'

Másrészt, ha szükségünk van a háború fájlt, akkor a háború csatlakoztat:

plugin alkalmazása: 'war'

Az alkalmazás felépítése futtatható archívumokat generál a Spring Boot 1.x és a 2.x egyaránt. Az egyes verzióknál azonban a Gradle különböző feladatokat indít el.

Ezután nézzük meg közelebbről az egyes Boot verziók összeállítási folyamatát.

3.1. Tavaszi csizma 2.x

A Boot 2.x-ben a bootJar és bootWar feladatok felelősek az alkalmazás csomagolásáért.

A bootJar feladat felelős a futtatható fájl létrehozásáért befőttes üveg fájl. Ez automatikusan létrejön, ha a Jáva plugin van alkalmazva.

Nézzük meg, hogyan tudjuk végrehajtani a bootJar feladat közvetlenül:

./gradlew bootJar

Hasonlóképpen, bootWar generál egy futtatható háborús fájlt, és létrejön, ha a háború plugin van alkalmazva.

Végrehajthatjuk a bootWar feladat felhasználásával:

./gradlew bootWar

Vegye figyelembe, hogy a Spring Boot 2.x verzióhoz a Gradle 4.0 vagy újabb verziót kell használnunk.

Konfigurálhatjuk mindkét feladatot is. Például állítsuk be a fő osztályt a mainClassName ingatlan:

bootJar {mainClassName = 'com.baeldung.Application'}

Alternatív megoldásként ugyanazt a tulajdonságot használhatjuk a Spring Boot DSL-től:

springBoot {mainClassName = 'com.baeldung.Application'}

3.2. Tavaszi csizma 1.x

Tavaszi csomagtartóval 1.x, bootRepackage felelős a futtatható archívum létrehozásáért(befőttes üveg vagy háború fájl a konfigurációtól függően.

Végrehajthatjuk a bootRepackage feladat közvetlenül a következők segítségével:

./gradlew bootRepackage

A Boot 2.x verzióhoz hasonlóan konfigurációkat is felvehetünk a bootRepackage feladat a mi build.gradle:

bootRepackage {mainClass = 'com.example.demo.Application'}

Letilthatjuk a bootRepackage feladatot a engedélyezve opció hamis:

bootRepackage {engedélyezve = hamis}

4. Alkalmazásunk futtatása

Az alkalmazás elkészítése után egyszerűen futtathatjuk a java -jar parancs a létrehozott futtatható jar fájlon:

java -jar build / libs / demo.jar

A Spring Boot Gradle plugin is biztosítja számunkra a bootRun feladat amely lehetővé teszi számunkra az alkalmazás futtatását anélkül, hogy először fel kellene építenünk:

./gradlew bootRun

A bootRun a feladat egyszerűen konfigurálható épít.gradle.

Meghatározhatjuk például a fő osztályt:

bootRun {main = 'com.example.demo.Application'}

5. Kapcsolat más beépülő modulokkal

5.1. Függőségkezelő beépülő modul

A Spring Boot 1.x esetében a függőségkezelő beépülő modult automatikusan alkalmazta. Ez importálná a Spring Boot függőségek BOM-ját, és hasonlóan viselkedne, mint a Maven függőségkezelése.

De a Spring Boot 2.x óta kifejezetten alkalmaznunk kell a mi épít.gradle ha szükségünk van erre a funkcióra:

plugin alkalmazása: 'io.spring.dependency-management'

5.2. Java beépülő modul

Amikor alkalmazzuk a Jáva plugin, a Spring Boot Gradle plugin többféle műveletet hajt végre, például:

  • létrehozása egy bootJar feladat, amelyet futtatható jar fájl előállításához használhatunk
  • létrehozása a bootRun feladat, amelyet felhasználhatunk az alkalmazásunk közvetlen futtatásához
  • letiltása befőttes üveg feladat

5.3. War Plugin

Hasonlóképpen, amikor a háború plugin, amelynek eredménye:

  • létrehozása bootWar feladat, amelyet futtatható háborús fájl előállításához használhatunk
  • letiltja a háború feladat

6. Következtetés

Ebben a gyors bemutatóban megismerhettük a Spring Boot Gradle beépülő modult és annak különböző feladatait.

Megbeszéltük azt is, hogy milyen interakcióban van a többi pluginnel.