Quarkus: აპლიკაციის მოდერნიზაცია Helloworld-ის გამოყენებით, როგორც მაგალითი JBoss EAP Quickstart-დან

გამარჯობა ყველას ამ ბლოგზე, აქ არის მეოთხე პოსტი Quarkus-ის სერიიდან!

წინა ჩანაწერი იყო იმის შესახებ, თუ როგორ აერთიანებს Quarkus MicroProfile და Spring. შეგახსენებთ რომ კვარკუსი პოზიციონირებულია, როგორც „ულტრა სწრაფი სუბატომიური ჯავა“, ასევე „Kubernetes-ზე ორიენტირებული ჯავა, მორგებული GraalVM-ისა და OpenJDK HotSpot-ისთვის და აწყობილი საუკეთესო ბიბლიოთეკებიდან და სტანდარტებით“. დღეს ჩვენ გაჩვენებთ, თუ როგორ უნდა მოდერნიზდეს არსებული Java აპლიკაციები Quarkus-ის შესაძლებლობების გამოყენებით, მაგალითის გამოყენებით helloworld აპლიკაციები Red Hat JBoss Enterprise Application Platform (JBoss EAP) Quickstart საცავიდან, რომელიც იყენებს CDI და Servlet 3 ტექნოლოგიებს Quarkus-ის მხარდაჭერით.

აქ მნიშვნელოვანია აღინიშნოს, რომ Quarkus და JBoss EAP ხაზს უსვამენ ინსტრუმენტების გამოყენებას რაც შეიძლება სტანდარტებზე დაფუძნებული. არ გაქვთ აპლიკაცია გაშვებული JBoss EAP-ზე? პრობლემა არ არის, მისი მარტივად გადატანა შესაძლებელია თქვენი ამჟამინდელი აპლიკაციის სერვერიდან JBoss EAP-ის გამოყენებით Red Hat აპლიკაციის მიგრაციის ხელსაწყოები. რის შემდეგაც მოდერნიზებული კოდის საბოლოო და სამუშაო ვერსია ხელმისაწვდომი იქნება საცავში github.com/mrizzi/jboss-eap-quickstarts/tree/quarkus, მოდულში გამარჯობა მსოფლიო.

ამ პოსტის დაწერისას ჩვენ გამოვიყენეთ Quarkus-ის სახელმძღვანელოებიძირითადად თქვენი პირველი აპლიკაციის შექმნა და შენობა ა მშობლიური შესრულებადი.

ავიღოთ კოდი

უპირველეს ყოვლისა, მოდით შევქმნათ საცავის ლოკალური კლონი JBoss EAP სწრაფ სტარტებს:

$ git clone https://github.com/jboss-developer/jboss-eap-quickstarts.git
Cloning into '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/

ვნახოთ, როგორ მუშაობს ორიგინალური helloworld

სინამდვილეში, ამ აპლიკაციის არსი სახელიდან ნათელია, მაგრამ ჩვენ მის კოდს მკაცრად მეცნიერულად მოდერნიზებთ. ამიტომ, პირველ რიგში, მოდით შევხედოთ ამ აპლიკაციას მისი ორიგინალური ფორმით.

Helloworld-ის განლაგება

1. გახსენით ტერმინალი და გადადით JBoss EAP საქაღალდის ძირში (შეგიძლიათ ჩამოტვირთოთ აქ), ანუ EAP_HOME საქაღალდეში.

2. გაუშვით JBoss EAP სერვერი ნაგულისხმევი პროფილით:

$ EAP_HOME/bin/standalone.sh

შენიშვნა: Windows-ზე მის გასაშვებად გამოიყენება EAP_HOMEbinstandalone.bat სკრიპტი.

რამდენიმე წამის შემდეგ, მსგავსი რამ უნდა გამოჩნდეს ჟურნალში:

[org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.2.0.GA (WildFly Core 6.0.11.Final-redhat-00001) started in 3315ms - Started 306 of 527 services (321 services are lazy, passive or on-demand)

3. გახსენით ბრაუზერში 127.0.0.1:8080 და ჩვენ ვხედავთ ამას:

ბრინჯი. 1. JBoss EAP-ის მთავარი გვერდი.

4. მიჰყევით სახელმძღვანელოში მითითებებს შექმენით და განათავსეთ Quickstart: გააფართოვეთ helloworld და გაუშვით (პროექტის root საქაღალდიდან) შემდეგი ბრძანება:

$ mvn clean install wildfly:deploy

ამ ბრძანების წარმატებით შესრულების შემდეგ, ჟურნალში ვნახავთ მსგავსი რამ:

[INFO] ------------------------------------------------------------------------ 
[INFO] BUILD SUCCESS 
[INFO] ------------------------------------------------------------------------ 
[INFO] Total time: 8.224 s

ასე რომ, helloworld აპლიკაციის პირველ გამოყენებას JBoss EAP-ზე სულ რაღაც 8 წამზე დასჭირდა.

Helloworld-ის ტესტირება

იმოქმედეთ მკაცრად ინსტრუქციის მიხედვით წვდომა აპლიკაციაში, გახსენით ბრაუზერში 127.0.0.1:8080/helloworld და ჩვენ ვხედავთ ამას:

ბრინჯი. 2. ორიგინალური Hello World JBoss EAP-ისგან.

ცვლილებების შეტანა

შეცვალეთ შეყვანის პარამეტრი createHelloMessage (სტრიქონის სახელი) World-დან Marco-ზე:

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

კვლავ გაუშვით შემდეგი ბრძანება:

$ mvn clean install wildfly:deploy

შემდეგ ჩვენ ვაახლებთ გვერდს ბრაუზერში და ვხედავთ, რომ ტექსტი შეიცვალა:

ბრინჯი. 3. გამარჯობა მარკო JBoss EAP-ში.

დააბრუნეთ helloworld განლაგება და გამორთეთ JBoss EAP

ეს არჩევითია, მაგრამ თუ გსურთ გააუქმოთ განლაგება, ამის გაკეთება შეგიძლიათ შემდეგი ბრძანებით:

$ mvn clean install wildfly:undeploy

თქვენი JBoss EAP ინსტანციის გამორთვისთვის, უბრალოდ დააჭირეთ Ctrl+C ტერმინალის ფანჯარაში.

Helloworld-ის განახლება

ახლა მოდით გავაუმჯობესოთ ორიგინალური helloworld აპლიკაცია.

შექმენით ახალი ფილიალი

ჩვენ ვქმნით ახალ სამუშაო ფილიალს სწრაფი დაწყების პროექტის დასრულების შემდეგ:

$ git checkout -b quarkus 7.2.0.GA

pom.xml ფაილის შეცვლა

ჩვენ დავიწყებთ აპლიკაციის შეცვლას pom.xml ფაილიდან. Quarkus-ისთვის XML ბლოკების მასში ჩასმის უფლება, გაუშვით შემდეგი ბრძანება helloworld საქაღალდეში:

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

ამ სტატიის წერისას გამოყენებული იქნა ვერსია 0.23.2. Quarkus ხშირად უშვებს ახალ ვერსიებს, შეგიძლიათ გაიგოთ, რომელი ვერსიაა უახლესი ვებსაიტზე github.com/quarkusio/quarkus/releases/latest.

ზემოთ მოყვანილი ბრძანება ჩასვამს შემდეგ ელემენტებს pom.xml-ში:

• თვისება , რომელიც განსაზღვრავს Quarkus-ის გამოსაყენებელ ვერსიას.
• ბლოკი Quarkus BOM-ის იმპორტისთვის, რათა არ დაემატოს ვერსია თითოეული Quarkus დამოკიდებულებისთვის.
• quarkus-maven-plugin პასუხისმგებელია აპლიკაციის შეფუთვაზე და განვითარების რეჟიმის უზრუნველყოფაზე.
• მშობლიური პროფილი აპლიკაციის შესრულებადების შესაქმნელად.

გარდა ამისა, ჩვენ ხელით ვაკეთებთ შემდეგ ცვლილებებს pom.xml-ში:

1. ჩვენ ამოვიღებთ ტეგს ბლოკიდან და ვათავსებთ ტეგის ზემოთ. ვინაიდან შემდეგ ეტაპზე ჩვენ წავშლით ბლოკს, უნდა შევინახოთ .
2. ჩვენ ვხსნით ბლოკს, რადგან Quarkus-თან მუშაობისას ამ აპლიკაციას აღარ დასჭირდება JBoss-ის მშობელი პომი.
3. დაამატეთ ტეგი და მოათავსეთ ტეგის ქვეშ. თქვენ შეგიძლიათ მიუთითოთ თქვენთვის სასურველი ვერსიის ნომერი.
4. ჩვენ ვხსნით ტეგს, რადგან ეს აპლიკაცია აღარ არის WAR, არამედ ჩვეულებრივი JAR.
5. ჩვენ ვაცვლით შემდეგ დამოკიდებულებებს:
   1. ჩვენ ვცვლით javax.enterprise:cdi-api დამოკიდებულებას io.quarkus:quarkus-arc-ზე, ვხსნით მოწოდებულ-ს, რადგან (დოკუმენტების მიხედვით) Quarkus-ის ეს გაფართოება უზრუნველყოფს CDI დამოკიდებულებების ინექციას.
   2. ჩვენ ვცვლით დამოკიდებულებას org.jboss.spec.javax.servlet:jboss-servlet-api_4.0_spec io.quarkus:quarkus-underdow-ზე, ვხსნით მოწოდებულ-ს, ვინაიდან (დოკუმენტების მიხედვით) ეს Quarkus გაფართოება უზრუნველყოფს servlet მხარდაჭერა 'ov.
   3. ჩვენ ვხსნით org.jboss.spec.javax.annotation:jboss-annotations-api_1.3_spec დამოკიდებულებას, რადგან მას ახლახან შევცვალეთ დამოკიდებულებები.

pom.xml ფაილის ვერსია ყველა ცვლილებით არის განთავსებული github.com/mrizzi/jboss-eap-quickstarts/blob/quarkus/helloworld/pom.xml.

გაითვალისწინეთ, რომ mvn io.quarkus:quarkus-maven-plugin:0.23.2:create ბრძანება ზემოთ არა მხოლოდ ცვლის pom.xml ფაილს, არამედ ამატებს პროექტს რამდენიმე კომპონენტს, კერძოდ, შემდეგ ფაილებსა და საქაღალდეებს:

• mvnw და mvnw.cmd ფაილი და .mvn საქაღალდე: Maven Wrapper საშუალებას გაძლევთ გაუშვათ Maven პროექტები მოცემული Maven ვერსიის ამ ვერსიის ინსტალაციის გარეშე.
• Docker საქაღალდე (src/main/ დირექტორიაში): ის შეიცავს Dockerfiles-ის მაგალითებს მშობლიური და jvm რეჟიმებისთვის (.dockerignore ფაილთან ერთად).
• რესურსების საქაღალდე (src/main/ დირექტორიაში): ის შეიცავს ცარიელ application.properties ფაილს და Quarkus index.html საწყისი გვერდის ნიმუშს (დამატებითი ინფორმაციისთვის იხილეთ მოდერნიზებული helloworld-ის გაშვება).

გაუშვით helloworld
აპლიკაციის შესამოწმებლად ჩვენ ვიყენებთ quarkus:dev, რომელიც ამუშავებს Quarkus-ს განვითარების რეჟიმში (დამატებითი ინფორმაციისთვის იხილეთ ეს განყოფილება სახელმძღვანელოში განვითარების რეჟიმი).

შენიშვნა: ეს ნაბიჯი სავარაუდოდ გამოიწვევს შეცდომას, რადგან ჩვენ ჯერ არ განხორციელებულა ყველა საჭირო ცვლილება.

ახლა მოდით გავუშვათ ბრძანება, რომ ნახოთ როგორ მუშაობს:

$ ./mvnw compile quarkus:dev
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------< org.jboss.eap.quickstarts:helloworld >----------------
[INFO] Building Quickstart: helloworld quarkus
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ helloworld ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 2 resources
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ helloworld ---
[INFO] Nothing to compile - all classes are up to date
[INFO]
[INFO] --- quarkus-maven-plugin:0.23.2:dev (default-cli) @ helloworld ---
Listening for transport dt_socket at address: 5005
INFO  [io.qua.dep.QuarkusAugmentor] Beginning quarkus augmentation
INFO  [org.jbo.threads] JBoss Threads version 3.0.0.Final
ERROR [io.qua.dev.DevModeMain] Failed to start quarkus: java.lang.RuntimeException: io.quarkus.builder.BuildException: Build failure: Build failed due to errors
	[error]: Build step io.quarkus.arc.deployment.ArcProcessor#validate threw an exception: javax.enterprise.inject.spi.DeploymentException: javax.enterprise.inject.UnsatisfiedResolutionException: Unsatisfied dependency for type org.jboss.as.quickstarts.helloworld.HelloService and qualifiers [@Default]
	- java member: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService
	- declared on CLASS bean [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)
Caused by: javax.enterprise.inject.UnsatisfiedResolutionException: Unsatisfied dependency for type org.jboss.as.quickstarts.helloworld.HelloService and qualifiers [@Default]
	- java member: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService
	- declared on CLASS bean [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 more

ასე რომ, ეს არ მუშაობს... რატომ?

UnsatisfiedResolutionException მიუთითებს HelloService კლასზე, რომელიც არის HelloWorldServlet კლასის წევრი (java წევრი: org.jboss.as.quickstarts.helloworld.HelloWorldServlet#helloService). პრობლემა ის არის, რომ HelloWorldServlet-ს სჭირდება HelloService-ის ინექციური ეგზემპლარი და მისი პოვნა შეუძლებელია (მიუხედავად იმისა, რომ ორივე კლასი ერთსა და იმავე პაკეტშია).

დაბრუნების დროა დოკუმენტაცია და წაიკითხეთ როგორ მუშაობს Quarkus-ში ინექცია, და, შესაბამისად კონტექსტები და დამოკიდებულების ინექცია (CDI). ამიტომ გახსენით Contexts and Dependency Injection სახელმძღვანელო და განყოფილებაში ლობიოს აღმოჩენა ვკითხულობთ: „ლობიოს კლასი, რომელსაც არ აქვს ლობიოს განმსაზღვრელი ანოტაცია, არ იძებნება“.

მოდით შევხედოთ HelloService კლასს - მას ნამდვილად არ აქვს ასეთი ანოტაცია. ამიტომ, ის უნდა დაემატოს, რათა კვარკუსმა შეძლოს ლობიოს მოძებნა და პოვნა. და რადგან ეს არის მოქალაქეობის არმქონე ობიექტი, ჩვენ შეგვიძლია მარტივად დავამატოთ @ApplicationScoped ანოტაცია ასე:

@ApplicationScoped
public class HelloService {

შენიშვნა: აქ განვითარების გარემომ შეიძლება მოგთხოვოთ საჭირო პაკეტის დამატება (იხილეთ ხაზი ქვემოთ) და თქვენ მოგიწევთ ამის გაკეთება ხელით, ასე:

import javax.enterprise.context.ApplicationScoped;

თუ ეჭვი გეპარებათ, რომელი ფარგლები უნდა გამოიყენოთ იმ შემთხვევაში, როდესაც ის საერთოდ არ არის მითითებული წყაროს ლობიოზე, წაიკითხეთ დოკუმენტაცია JSR 365: კონტექსტები და დამოკიდებულების ინექცია Java 2.0-ისთვის — ნაგულისხმევი ფარგლები.

ახლა ჩვენ კვლავ ვცდილობთ აპლიკაციის გაშვებას ბრძანებით ./mvnw compile quarkus:dev:

$ ./mvnw compile quarkus:dev
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------< org.jboss.eap.quickstarts:helloworld >----------------
[INFO] Building Quickstart: helloworld quarkus
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ helloworld ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 2 resources
[INFO]
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ helloworld ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 2 source files to /home/mrizzi/git/forked/jboss-eap-quickstarts/helloworld/target/classes
[INFO]
[INFO] --- quarkus-maven-plugin:0.23.2:dev (default-cli) @ helloworld ---
Listening for transport dt_socket at address: 5005
INFO  [io.qua.dep.QuarkusAugmentor] (main) Beginning quarkus augmentation
INFO  [io.qua.dep.QuarkusAugmentor] (main) Quarkus augmentation completed in 576ms
INFO  [io.quarkus] (main) Quarkus 0.23.2 started in 1.083s. Listening on: http://0.0.0.0:8080
INFO  [io.quarkus] (main) Profile dev activated. Live Coding activated.
INFO  [io.quarkus] (main) Installed features: [cdi]

ახლა ყველაფერი შეცდომების გარეშე მიდის.

მოდერნიზებული ჰელოუ სამყაროს გაშვება
როგორც ჟურნალში წერია, გახსენით ბრაუზერში 0.0.0.0:8080 (ნაგულისხმევი Quarkus საწყისი გვერდი) და ჩვენ ვხედავთ ამას:

ბრინჯი. 4. Quarkus-ის განვითარების საწყისი გვერდი.

ამ აპლიკაციის WebServlet ანოტაცია შეიცავს შემდეგ კონტექსტურ განმარტებას:

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

ამიტომ, ჩვენ ბრაუზერში გადავდივართ 0.0.0.0:8080/HelloWorld და ჩვენ ვხედავთ შემდეგს:

ბრინჯი. 5: Quarkus dev გვერდი Hello World აპლიკაციისთვის.

ისე, ყველაფერი მუშაობს.

ახლა მოდით შევიტანოთ ცვლილებები კოდში. გაითვალისწინეთ, რომ ./mvnw compile quarkus:dev ბრძანება ჯერ კიდევ მუშაობს და ჩვენ არ ვაპირებთ მის შეჩერებას. ახლა შევეცადოთ გამოვიყენოთ იგივე - ძალიან ტრივიალური - ცვლილებები თავად კოდში და ვნახოთ, როგორ უადვილებს Quarkus დეველოპერს ცხოვრებას:

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

შეინახეთ ფაილი და შემდეგ განაახლეთ ვებ გვერდი Hello Marco-ს სანახავად, როგორც ეს ნაჩვენებია ქვემოთ მოცემულ ეკრანის სურათზე:

ბრინჯი. 6. გამარჯობა მარკოს გვერდი Quarkus dev-ში.

ახლა შევამოწმოთ გამომავალი ტერმინალში:

INFO  [io.qua.dev] (vert.x-worker-thread-3) Changed source files detected, recompiling [/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 stopped in 0.003s
INFO  [io.qua.dep.QuarkusAugmentor] (vert.x-worker-thread-3) Beginning quarkus augmentation
INFO  [io.qua.dep.QuarkusAugmentor] (vert.x-worker-thread-3) Quarkus augmentation completed in 232ms
INFO  [io.quarkus] (vert.x-worker-thread-3) Quarkus 0.23.2 started in 0.257s. Listening on: http://0.0.0.0:8080
INFO  [io.quarkus] (vert.x-worker-thread-3) Profile dev activated. Live Coding activated.
INFO  [io.quarkus] (vert.x-worker-thread-3) Installed features: [cdi]
INFO  [io.qua.dev] (vert.x-worker-thread-3) Hot replace total time: 0.371s

გვერდის განახლებამ გამოიწვია საწყის კოდში ცვლილებების აღმოჩენა და Quarkus-მა ავტომატურად შეასრულა გაჩერების დაწყების პროცედურა. და ეს ყველაფერი დასრულდა მხოლოდ 0.371 წამში (აი, ეს არის "ულტრა სწრაფი სუბატომიური ჯავა").

Helloworld-ის აშენება JAR პაკეტში
ახლა, როდესაც კოდი მუშაობს ისე, როგორც უნდა, მოდით შევფუთოთ იგი შემდეგი ბრძანებით:

$ ./mvnw clean package

ეს ბრძანება ქმნის ორ JAR ფაილს /target საქაღალდეში: helloworld-.jar ფაილი, რომელიც არის Maven გუნდის მიერ აწყობილი სტანდარტული არტეფაქტი პროექტის კლასებთან და რესურსებთან ერთად. და helloworld-runner.jar ფაილი, რომელიც არის შესრულებადი JAR.

გთხოვთ გაითვალისწინოთ, რომ ეს არ არის uber-jar, რადგან ყველა დამოკიდებულება უბრალოდ კოპირებულია /target/lib საქაღალდეში (არ არის შეფუთული JAR ფაილში). ამიტომ, ამ JAR-ის სხვა საქაღალდიდან ან სხვა ჰოსტზე გასაშვებად, თქვენ უნდა დააკოპიროთ როგორც JAR ფაილი, ასევე /lib საქაღალდე იქ, იმის გათვალისწინებით, რომ Class-Path ელემენტი MANIFEST.MF ფაილში JAR პაკეტში შეიცავს. JAR-ების აშკარა ჩამონათვალი lib საქაღალდეებიდან
იმის გასაგებად, თუ როგორ უნდა შექმნათ uber-jar აპლიკაციები, გთხოვთ, ეწვიოთ სახელმძღვანელოს Uber-Jar შექმნა.

გაუშვით helloworld შეფუთული JAR-ში

ახლა ჩვენ შეგვიძლია გავუშვათ ჩვენი JAR სტანდარტული java ბრძანების გამოყენებით:

$ java -jar ./target/helloworld-<version>-runner.jar
INFO  [io.quarkus] (main) Quarkus 0.23.2 started in 0.673s. Listening on: http://0.0.0.0:8080
INFO  [io.quarkus] (main) Profile prod activated.
INFO  [io.quarkus] (main) Installed features: [cdi]

ყოველივე ამის შემდეგ, გადადით თქვენს ბრაუზერში 0.0.0.0:8080 და შეამოწმეთ, რომ ყველაფერი ისე მუშაობს, როგორც უნდა.

helloworld-ის შედგენა მშობლიურ შესრულებად ფაილში

ასე რომ, ჩვენი helloworld მუშაობს როგორც დამოუკიდებელი Java აპლიკაცია Quarkus-ის დამოკიდებულებების გამოყენებით. მაგრამ შეგიძლიათ უფრო შორს წახვიდეთ და გადააქციოთ ის მშობლიურ შესრულებად ფაილად.

GraalVM-ის ინსტალაცია
უპირველეს ყოვლისა, ამისათვის თქვენ უნდა დააინსტალიროთ საჭირო ხელსაწყოები:

1. ჩამოტვირთეთ GraalVM 19.2.0.1-დან github.com/oracle/graal/releases/tag/vm-19.2.0.1.

2. გააფართოვეთ გადმოწერილი არქივი:

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

3. გადადით untar საქაღალდეში.

4. გაუშვით ქვემოთ მოცემული ბრძანება, რომ ჩამოტვირთოთ და დაამატოთ მშობლიური სურათი:

$ ./bin/gu install native-image

5. დაარეგისტრირეთ მე-2 ნაბიჯში შექმნილი საქაღალდე GRAALVM_HOME გარემოს ცვლადში:

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

დამატებითი ინფორმაციისთვის და სხვა OS-ებზე ინსტალაციის ინსტრუქციებისთვის იხილეთ სახელმძღვანელო Native Executable-ის აშენება - წინაპირობები.

Helloworld-ის აშენება მშობლიურ შესრულებად ფაილში
სახელმძღვანელოს კითხვა Native Executable-ის აშენება - მშობლიური შესრულებადი ფაილის წარმოება: „ახლა შევქმნათ მშობლიური შესრულებადი ფაილი ჩვენი აპლიკაციისთვის, რათა შევამციროთ მისი გაშვების დრო და დისკის ზომა. შესრულებად ფაილს ექნება ყველაფერი, რაც საჭიროა აპლიკაციის გასაშვებად, მათ შორის JVM (უფრო სწორად, მისი შეკვეცილი ვერსია, რომელიც შეიცავს მხოლოდ იმას, რაც საჭიროა აპლიკაციის გასაშვებად) და თავად ჩვენს აპლიკაციას.”

მშობლიური შესრულებადი ფაილის შესაქმნელად, თქვენ უნდა ჩართოთ მშობლიური Maven პროფილი:

$ ./mvnw package -Pnative

ჩვენს აშენებას ერთი წუთი და 10 წამი დასჭირდა და საბოლოო helloworld-runner f ფაილი შეიქმნა /target საქაღალდეში.

გაუშვით მშობლიური helloworld შესრულებადი

წინა ეტაპზე მივიღეთ შესრულებადი ფაილი /target/helloworld-runner. ახლა მოდით გავუშვათ:

$ ./target/helloworld-<version>-runner
INFO  [io.quarkus] (main) Quarkus 0.23.2 started in 0.006s. Listening on: http://0.0.0.0:8080
INFO  [io.quarkus] (main) Profile prod activated.
INFO  [io.quarkus] (main) Installed features: [cdi]

ისევ გახსენით ბრაუზერში 0.0.0.0:8080 და შეამოწმეთ, რომ ყველაფერი ისე მუშაობს, როგორც უნდა.

Продолжение следует!

ჩვენ გვჯერა, რომ ამ პოსტში განხილული Quarkus-ის შესაძლებლობების გამოყენებით Java აპლიკაციების მოდერნიზაციის მეთოდი (თუმცა მარტივი მაგალითის გამოყენებით) აქტიურად უნდა იქნას გამოყენებული რეალურ ცხოვრებაში. ამგვარად, თქვენ სავარაუდოდ შეხვდებით უამრავ პრობლემას, რომელსაც ნაწილობრივ განვიხილავთ შემდეგ პოსტში, სადაც ვისაუბრებთ იმაზე, თუ როგორ გავზომოთ მეხსიერების მოხმარება შესრულების გაუმჯობესების შესაფასებლად, რაც მნიშვნელოვანი ნაწილია აპლიკაციის მოდერნიზაციის მთელი პროცესის.

წყარო: www.habr.com