🥇Quarkus: rakenduste moderniseerimine helloworld näiteks JBoss EAP Quickstart

Tere kõigile sellel blogis ja siin on neljas postitus Quarkuse sarjast!

Eelmise postituse teema oli see, kuidas Quarkus ühendab MicroProfile’i ja Springi. Meenutame, et Quarkus positsioneeritakse kui "ülikiire subaatomaarne Java", see on "Kubernetes-centriline Java-pesa, mis on kohandatud GraalVM-i ja OpenJDK HotSpot'i, ning kogutud parimatest raamatukogudest ja standarditest". Täna näitame, kuidas uuendada juba olemasolevaid Java-rakendusi, kasutades Quarkuse funktsioone, järgmise näite abil helloworld rakendusest Red Hat JBoss Enterprise Application Platform (JBoss EAP) Quickstart'i hoidlast, kus kasutatakse Quarkuses toetatud tehnoloogiaid CDI ja Servlet 3.

Siin on oluline märkida, et nii Quarkus kui ka JBoss EAP keskenduvad tööriistadele, mis on maksimaalselt põhinenud standarditel. Kas teie rakendus ei tööta JBoss EAP-l? Pole probleemi, seda saab hõlpsasti migreerida praeguselt rakendusserverilt JBoss EAP-le kasutades Red Hat Application Migration Toolkit. Pärast seda on lõplik ja töötav versioon moderniseeritud koodist saadaval hoidlas github.com/mrizzi/jboss-eap-quickstarts/tree/quarkus, moodulis helloworld.

Selle postituse kirjutamisel kasutati Quarkuse juhendeid, peamiselt Creating Your First Application ja Building a.

Native Executable

Saame koodi Esiteks loome kohaliku klooni hoidlast:

$ git clone https://github.com/jboss-developer/jboss-eap-quickstarts.git
Kloonimine 'jboss-eap-quickstarts'...
remote: Enumerating objects: 148133, done.
remote: Total 148133 (delta 0), reused 0 (delta 0), pack-reused 148133
Receiving objects: 100% (148133/148133), 59.90 MiB | 7.62 MiB/s, done.
Resolving deltas: 100% (66476/66476), done.
$ cd jboss-eap-quickstarts/helloworld/

Vaadake, kuidas originaal helloworld töötab

Oma olemuselt on selle rakenduse sisu nimest arusaadav, kuid me uuendame selle koodi rangelt teaduslikult. Seetõttu vaatame esmalt seda rakendust selle algses vormis.

Käivitame helloworldi

1. Avage terminal ja minge JBoss EAP kausta juure, kuhu selle alla laadida siin), st EAP_HOME kausta.

2. Käivitage JBoss EAP server vaikimisi profiiliga:

$ EAP_HOME/bin/standalone.sh

Märkus: Windowsi puhul kasutage skripti EAP_HOMEbinstandalone.bat.

Mõne sekundi pärast peaks logis ilmuma umbes midagi sellist:

[org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.2.0.GA (WildFly Core 6.0.11.Final-redhat-00001) käivitatud 3315ms - Käivitati 306 527 teenust (321 teenust on laisk, passiivne või nõudmisel)

3. Avage brauseris 127.0.0.1:8080 ja näete seda:

Joon. 1. JBoss EAP avaleht.

4. Järgige juhendites olevaid juhiseid Build and Deploy the Quickstart: käivitame helloworld ja täidame (projekti juurkataloogis) järgmise käskluse:

$ mvn clean install wildfly:deploy

Kuna see käsklus on edukalt täidetud, näeme logis umbes järgmist:

[INFO] ------------------------------------------------------------------------ 
[INFO] EHITUS ÕNNESTUS 
[INFO] ------------------------------------------------------------------------ 
[INFO] Kokku võetud aeg: 8.224 s

Seega kestis helloworld rakenduse esmane juurutamine JBoss EAP-s natuke üle 8 sekundi.

Testime helloworld

Järgides täpselt juhiseid Rakendusele juurdepääs, avame brauseris 127.0.0.1:8080/helloworld ja näeme järgmist:

Joonis 2. Algne Hello World JBoss EAP-st.

Teeme muudatusi

Muudame sisendparameetri createHelloMessage(String name) World aga Marco-ks:

writer.println("<h1>" + helloService.createHelloMessage("Marco") + "</h1>");

Uuesti täidame järgmise käskluse:

$ mvn clean install wildfly:deploy

Seejärel värskendame brauseri lehte ja näeme, et tekst on muutunud:

Joonis 3. Hello Marco JBoss EAP-s.

Tühistame helloworld juurutamise ja lõpetame JBoss EAP töö

See ei ole kohustuslik, kuid kui soovite juurutamist tühistada, siis saate seda teha järgmise käsklusega:

$ mvn clean install wildfly:undeploy

JBoss EAP eksemplari lõpetamiseks vajutage lihtsalt Ctrl+C terminaliaknas.

Uuendame helloworld

Nüüd tegeleme algse helloworld rakenduse uuendamisega.

Loome uue haru

Loome uue tööharu pärast quickstart projekti täitmist:

$ git checkout -b quarkus 7.2.0.GA

Muudame faili pom.xml

Rakenduse muutmise alustame failist pom.xml. Et Quarkus saaks sinna lisada XML-bloke, täidame järgmise käskluse helloworld kataloogis:

$ mvn io.quarkus:quarkus-maven-plugin:0.23.2:create

Käesoleva artikli kirjutamise ajal kasutati versiooni 0.23.2. Quarkusel ilmub sageli uusi versioone, viimase versiooni leidmiseks külastage github.com/quarkusio/quarkus/releases/latest.

Ülaltoodud käsk lisab pom.xml järgmised elemendid:

Omadus , mis määrab kasutatava Quarkus versiooni.
Block Quarkus BOM-i (materjalide arve) importimiseks, et iga Quarkus sõltuvuse jaoks versiooni juurde ei lisataks.
quarkus-maven-plugin, mis vastutab rakenduse pakkimise ja arendusrežiimi pakkumise eest.
Native profiil rakenduse käivitatavate failide loomiseks.

Lisaks viime pom.xml faili käsitsi sisse järgmised muudatused:

Tõmbame sildi plokist välja ja asetame selle sildi kohale. Kuna järgmises etapis eemaldame ploki , tuleb säilitada.
Eemaldame bloki , kuna selle rakenduse jaoks ei ole Quarkusega enam vajalik JBossi vanem pom.
Lisame sildi ja asetame selle sildi alla. Versiooni numbri võite määrata, nagu soovite.
Eemaldame sildi , kuna see rakendus ei ole enam WAR, vaid tavaline JAR.
Muudame järgmisi sõltuvusi:
1. Vahetame sõltuvuse javax.enterprise:cdi-api io.quarkus:quarkus-arc vastu, eemaldades provided, kuna (vastavalt dokumentatsioonile) see Quarkus-i laiendus tagab CDI sõltuvuse süstimise.
2. Vahetame sõltuvuse org.jboss.spec.javax.servlet:jboss-servlet-api_4.0_spec io.quarkus:quarkus-undertow vastu, eemaldades provided, kuna (vastavalt dokumentatsioonile) see Quarkus-i laiendus tagab Servletide toe.
3. Eemaldame sõltuvuse org.jboss.spec.javax.annotation:jboss-annotations-api_1.3_spec, kuna see on kaasas sõltuvustega, mida just muutsime.

Muudetud pom.xml faili versioon on saadaval aadressil github.com/mrizzi/jboss-eap-quickstarts/blob/quarkus/helloworld/pom.xml.

Pange tähele, et ülaltoodud käsk mvn io.quarkus:quarkus-maven-plugin:0.23.2:create ei muudab mitte ainult pom.xml faili, vaid lisab projekti hulga komponente, nimelt järgmised failid ja kaustad:

Fail mvnw ja mvnw.cmd ning kaust .mvn: Maven Wrapper võimaldab teil käivitada Maven projekte määratud versiooniga ilma selle versiooni installimiseta.
Kaust docker (kaustas src/main/): siin on näidis Dockerfile faile native ja jvm režiimide jaoks (koos faili .dockerignore).
Kaust resources (kaustas src/main/): siin on tühi fail application.properties ja näidis Quarkus'i stardileht index.html (ülaltoodu kohta, vaata Run the modernized helloworld ).

Käivitame helloworld
Rakenduse testimiseks kasutame quarkus:dev, mis käivitab Quarkuse arendusrežiimis (ülaltoodud, vaata seda jaotist juhendis Arendusrežiim).

Märkus: see samm toob oodatult kaasa vea, kuna me ei ole veel kõik vajalikud muudatused teinud.

Nüüd käivitame käsu, et kontrollida, kuidas see töötab:

$ ./mvnw compile quarkus:dev
[INFO] Otsitakse projekte...
[INFO]
[INFO] ----------------< org.jboss.eap.quickstarts:helloworld >----------------
[INFO] Ehitatakse Quickstart: helloworld quarkus
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ helloworld ---
[INFO] Kasutatakse 'UTF-8' kodeeringut filtreeritud ressursside kopeerimiseks.
[INFO] Kopeeritakse 2 ressursi
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ helloworld ---
[INFO] Midagi pole kompileerida - kõik klassid on ajakohased
[INFO]
[INFO] --- quarkus-maven-plugin:0.23.2:dev (default-cli) @ helloworld ---
Oodatakse transport dt_socket aadressil: 5005
INFO  [io.qua.dep.QuarkusAugmentor] Algab quarkus'i täiendamine
INFO  [org.jbo.threads] JBoss Threads versioon 3.0.0.Final
ERROR [io.qua.dev.DevModeMain] Quarkus'i käivitamine ebaõnnestus: java.lang.RuntimeException: io.quarkus.builder.BuildException: Ehitus ebaõnnestus: Ehitus ebaõnnestus vigade tõttu
	[error]: Ehitus etapp io.quarkus.arc.deployment.ArcProcessor#validate viskas erandi: javax.enterprise.inject.spi.DeploymentException: javax.enterprise.inject.UnsatisfiedResolutionException: Rahuldamata sõltuvus tüübi org.jboss.as.quickstarts.helloworld.HelloService ja kvalifikaatorite [@Default]
	- java liik: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService
	- deklareeritud KLASI bean'il [types=[javax.servlet.ServletConfig, java.io.Serializable, org.jboss.as.quickstarts.helloworld.HelloWorldServlet, javax.servlet.GenericServlet, javax.servlet.Servlet, java.lang.Object, javax.servlet.http.HttpServlet], qualifiers=[@Default, @Any], target=org.jboss.as.quickstarts.helloworld.HelloWorldServlet]
	at io.quarkus.arc.processor.BeanDeployment.processErrors(BeanDeployment.java:841)
	at io.quarkus.arc.processor.BeanDeployment.init(BeanDeployment.java:214)
	at io.quarkus.arc.processor.BeanProcessor.initialize(BeanProcessor.java:106)
	at io.quarkus.arc.deployment.ArcProcessor.validate(ArcProcessor.java:249)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:498)
	at io.quarkus.deployment.ExtensionLoader$1.execute(ExtensionLoader.java:780)
	at io.quarkus.builder.BuildContext.run(BuildContext.java:415)
	at org.jboss.threads.ContextClassLoaderSavingRunnable.run(ContextClassLoaderSavingRunnable.java:35)
	at org.jboss.threads.EnhancedQueueExecutor.safeRun(EnhancedQueueExecutor.java:2011)
	at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.doRunTask(EnhancedQueueExecutor.java:1535)
	at org.jboss.threads.EnhancedQueueExecutor$ThreadBody.run(EnhancedQueueExecutor.java:1426)
	at java.lang.Thread.run(Thread.java:748)
	at org.jboss.threads.JBossThread.run(JBossThread.java:479)
Põhjus: javax.enterprise.inject.UnsatisfiedResolutionException: Rahuldamata sõltuvus tüübi org.jboss.as.quickstarts.helloworld.HelloService ja kvalifikaatorite [@Default]
	- java liik: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService
	- deklareeritud KLASI bean'il [types=[javax.servlet.ServletConfig, java.io.Serializable, org.jboss.as.quickstarts.helloworld.HelloWorldServlet, javax.servlet.GenericServlet, javax.servlet.Servlet, java.lang.Object, javax.servlet.http.HttpServlet], qualifiers=[@Default, @Any], target=org.jboss.as.quickstarts.helloworld.HelloWorldServlet]
	at io.quarkus.arc.processor.Beans.resolveInjectionPoint(Beans.java:428)
	at io.quarkus.arc.processor.BeanInfo.init(BeanInfo.java:371)
	at io.quarkus.arc.processor.BeanDeployment.init(BeanDeployment.java:206)
	... 14 rohkem

Nii, ei tööta... Aga miks?

UnsatisfiedResolutionException näitab klassi HelloService, mis on osa klassist HelloWorldServlet (java liikmed: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService). Probleem on selles, et HelloWorldServlet vajab süstimist HelloService'i eksemplarist, kuid seda ei leita (kuigi mõlemad klassid asuvad samas paketis).

On aeg tagasi pöörduda dokumentatsioon ja lugeda, kuidas Quarkuses töötab Süstimine, seega ka Kontekstid ja Sõltuvuse Süstimine (CDI). Seetõttu avame Kontekstid ja Sõltuvuse Süstimise juhendi ja jaotises Bean'i avastamine loeme: «Bean-i klass, millel ei ole määravat bean-annotatsiooni, ei otsita.»

Vaadake klassi HelloService – selles tõepoolest ei ole sellist annotatsiooni. Seega tuleb see lisada, et Quarkus saaks bean'i otsida ja leida. Ja kuna see on stateless objekt, saame me küll lisada annotatsiooni @ApplicationScoped järgmiselt:

@ApplicationScoped
public class HelloService {

Märkus: siin võib arenduskeskkond paluda teil lisada nõutav pakett (vt allolevat rida), ja see tuleb käsitsi teha, nagu nii:

import javax.enterprise.context.ApplicationScoped;

Kui te kahtlete, millist ulatust tuleks kasutada juhul, kui algse bean'i ulatus ei ole üldse määratud, uurige dokumentatsiooni JSR 365: Kontekstid ja Sõltuvuse Süstimine Java 2.0—Vaikeulatus.

Nüüd proovime uuesti käivitada rakendust käsuga .\/mvnw compile quarkus:dev:

$ .\/mvnw compile quarkus:dev
[INFO] Otsin projekte...
[INFO]
[INFO] ----------------< org.jboss.eap.quickstarts:helloworld >----------------
[INFO] Ehitan Quickstart: helloworld quarkus
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ helloworld ---
[INFO] Kasutatakse 'UTF-8' kodeeringut filtreeritud ressursside kopeerimiseks.
[INFO] Kopeerin 2 ressurssi
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ helloworld ---
[INFO] Tuletatud muudatused - kompileerin mooduli uuesti!
[INFO] Kompileerimine 2 allika faili jaoks /home/mrizzi/git/forked/jboss-eap-quickstarts/helloworld/target/classes
[INFO]
[INFO] --- quarkus-maven-plugin:0.23.2:dev (default-cli) @ helloworld ---
Kuulan transpordi dt_socket aadressil: 5005
INFO  [io.qua.dep.QuarkusAugmentor] (peamine) Algab quarkus augmentatsioon
INFO  [io.qua.dep.QuarkusAugmentor] (peamine) Quarkuse augmentatsioon lõpetatud 576ms jooksul
INFO  [io.quarkus] (peamine) Quarkus 0.23.2 käivitatud 1.083s jooksul. Kuulab aadressil: http:\/\/0.0.0.0:8080
INFO  [io.quarkus] (peamine) Profiil dev aktiveeritud. Elav kodeerimine aktiveeritud.
INFO  [io.quarkus] (peamine) Installitud funktsioonid: [cdi]

Nüüd läheb kõik veatult.

Käivitage uuendatud helloworld
Nagu logis öeldud, avame brauseris 0.0.0.0:8080 (Quarkuse vaikimisi algusleht) ja näeme järgmist:

Joon. 4. Quarkuse arengu algusleht.

Selles rakenduses on annotatsioonis WebServlet järgmine konteksti määratlemine:

@WebServlet("\/HelloWorld")
public class HelloWorldServlet extends HttpServlet {

Seetõttu läheme brauseris aadressile 0.0.0.0:8080/HelloWorld ja näeme järgmist:

Joonis 5: The Quarkus dev leht Hello World rakenduse jaoks.

Noh, kõik töötab.

Nüüd teeme koodis muudatusi. Pange tähele, et käsk ./mvnw compile quarkus:dev töötab endiselt ja me ei kavatse seda peatada. Nüüd proovime teha samu – ääretult lihtsaid – muudatusi koodis ja vaatame, kuidas Quarkus arendaja elu lihtsamaks teeb:

writer.println("<h1>" + helloService.createHelloMessage("Marco") + "</h1>");

Salvestame faili ja seejärel värskendame veebilehte, et näha kirjutist Hello Marco, nagu on näidatud alloleval ekraanipildil:

Joonis 6. Leht Hello Marco Quarkus dev-is.

Nüüd kontrollime väljundit terminalis:

INFO  [io.qua.dev] (vert.x-worker-thread-3) Muudetud allika faile tuvastatud, kompileerimine [ /home/mrizzi/git/forked/jboss-eap-quickstarts/helloworld/src/main/java/org/jboss/as/quickstarts/helloworld/HelloWorldServlet.java ]
INFO  [io.quarkus] (vert.x-worker-thread-3) Quarkus peatatud 0.003s
INFO  [io.qua.dep.QuarkusAugmentor] (vert.x-worker-thread-3) Alustatakse quarkus peensuse suurendamist
INFO  [io.qua.dep.QuarkusAugmentor] (vert.x-worker-thread-3) Quarkus peensuse suurendamine lõpetatud 232ms
INFO  [io.quarkus] (vert.x-worker-thread-3) Quarkus 0.23.2 käivitatud 0.257s. Kuulab aadressil: http://0.0.0.0:8080
INFO  [io.quarkus] (vert.x-worker-thread-3) Profiil dev aktiveeritud. Elav kodeerimine aktiveeritud.
INFO  [io.quarkus] (vert.x-worker-thread-3) Paigaldatud funktsioonid: [cdi]
INFO  [io.qua.dev] (vert.x-worker-thread-3) Kuum asendamise koguaeg: 0.371s

Lehe värskendamine käivitas allika koodi muudatuste tuvastamise ja Quarkus sooritas automaatselt protseduuri "peatamine-alustamine". Ja kõik see toimus vaid 0.371 sekundi jooksul (see ongi see "superkiire subaatomaarne Java").

Kogume helloworld paketti JAR-iks
Nüüd, kui kood töötab nagu peab, pakime selle järgmise käsuga:

$ ./mvnw clean package

See käsk loob kaks JAR-faili kaustas /target: fail helloworld-.jar, mis on standardne artefakt, mis on loodud Maven-käsuga koos projektide klasside ja ressurssidega. Ja fail helloworld—runner.jar, mis on käivitatav JAR.

Pange tähele, et see ei ole uber-jar, kuna kõik sõltuvused on lihtsalt kopeeritud kausta /target/lib (mitte pakitud JAR-faili). Seetõttu, et käivitada see JAR mujalt kaustast või muul hostil, tuleb seal kopeerida nii JAR-fail kui ka kaust /lib, arvestades, et Class-Path element failis MANIFEST.MF JAR-pakendis sisaldab selget nimekirja JAR-idest kaustast lib.
Kuidas luua uber-jar rakendusi, vaata juhendist Uber-Jar loomine.

Käivitame helloworld, mis on pakitud JAR-iks

Nüüd saame käivitada meie JAR-i standardse Java käsuga:

$ java -jar ./target/helloworld--runner.jar
INFO  [io.quarkus] (main) Quarkus 0.23.2 käivitamine kestis 0.673 sekundit. Kuulamine aadressil: http://0.0.0.0:8080
INFO  [io.quarkus] (main) Profiil prod aktiveeritud.
INFO  [io.quarkus] (main) Installitud omadused: [cdi]

Pärast selle lõpetamist avage brauser ja minge 0.0.0.0:8080 ja kontrollige, et kõik töötab nagu peab.

Kogume helloworldi natiivseks täidetavaks failiks

Nii et meie helloworld töötab kui standalone Java rakendus, kasutades Quarkuse sõltuvusi. Kuid saame minna edasi ja muuta selle natiivseks täidetavaks failiks.

Paigaldame GraalVM
Esiteks tuleb installida vajalikud tööriistad:

1. Laadige alla GraalVM 19.2.0.1 aadressilt github.com/oracle/graal/releases/tag/vm-19.2.0.1.

2. Pakkige lahti allalaaditud arhiiv:

$ tar xvzf graalvm-ce-linux-amd64-19.2.0.1.tar.gz

3. Liikuge avatud kausta.

4. Käivitage allpool toodud käsk, et alla laadida ja lisada natiivne pilt:

$ ./bin/gu install native-image

5. Lisage 2. sammus loodud kaust keskkonnamuutujasse GRAALVM_HOME:

$ export GRAALVM_HOME={untar-folder}/graalvm-ce-19.2.0.1)

Lisainfot ja installijuhiseid teistele operatsioonisüsteemidele leiate juhendist Building a Native Executable—Prerequisites.

Kogume helloworldi natiivseks täidetavaks failiks
Lugege juhendit Building a Native Executable—Producing a native executable: «Ja nüüd loome natiivse täidetava faili meie rakenduse jaoks, et vähendada käivitamise aega ja suurust kettal. Täidetav fail sisaldab kõike, mis on vajalik rakenduse käivitamiseks, sealhulgas JVM-masinat (täpsemalt, selle kärbitud versioon, mis sisaldab ainult seda, mis on vajalik rakenduse täitmiseks) ja meie rakendust ise.»

Natiivse täidetava faili loomiseks tuleb aktiveerida Maven'i native-profiil:

$ ./mvnw package -Pnative

Meie kogumine kestis ühe minuti ja 10 sekundit ning lõplik fail helloworld-runner loodi kaustas /target.

Käivitame helloworldi natiivse täidetava faili

Eelmises etapis saime täidetava faili /target/helloworld-runner. Nüüd käivitame selle:

$ ./target/helloworld--runner
INFO  [io.quarkus] (main) Quarkus 0.23.2 käivitamine kestis 0.006 sekundit. Kuulamine aadressil: http://0.0.0.0:8080
INFO  [io.quarkus] (main) Profiil prod aktiveeritud.
INFO  [io.quarkus] (main) Installitud omadused: [cdi]

Avame taas brauseris 0.0.0.0:8080 ja kontrollime, et kõik töötab nagu peab.

Jätkub!

Me arvan, et selles postituses käsitletud (kuigi kõige lihtsama näite põhjal) Java-rakenduste moderniseerimise meetodit Quarkuse võimaluste kasutamisel tasub reaalses elus aktiivselt rakendada. Samuti võite tõenäoliselt silmitsi seista mitmete probleemidega, mille lahendust käsitleme osaliselt järgmises postituses, kus räägime, kuidas mõõta mälu kasutust, et hinnata jõudluse paranemist, mis on kogu rakenduste moderniseerimise protsessi oluline osa.

Allikas: habr.com

Quarkus: rakenduste moderniseerimine näite põhjal helloworld JBoss EAP Quickstartis

Native Executable

Vaadake, kuidas originaal helloworld töötab

Uuendame helloworld