quarkus

 

Quarkus – 一个针对OpenJDK HotSpot和GraalVM量身定制的Kubernetes本机Java堆栈,它是从最佳Java库和标准中精制而成的。 –是一个容器优先的框架,针对快速启动时间和低内存消耗进行了优化。 该框架基于许多流行的Java库构建,并且为构建标准REST以及响应式消息驱动型微服务提供支持。 由于快速的启动时间和较低的内存使用量,Quarkus也可用于在无服务器环境中实现功能。 凭借统一的配置,出色的实时重装功能和工具支持,Quarkus为快速开发应用程序提供了许多可能性。

了解如何开始使用Quarkus和构建PetClinic REST API。

这篇博客文章涵盖:

  • 开发环境要求
  • 建立新专案
  • 使用Java 11开发,构建和运行应用程序
  • 使用Postgres和Flyway进行数据源配置
  • 分页CRUD服务
  • 创建集成测试
  • 实时重新加载和调试
  • Docker化应用程序(本机和非本机)

关于PetClinic API

我决定重新使用在本博文Spring Boot和Spring Data REST中使用的PetClinic模型。

基本上,它是用于管理虚拟PetClinic的基本CRUD服务:宠物,兽医,来访等。

先决条件

码头工人

Docker将用于运行服务本身的dockerized版本,但也将用于运行PostgreSQL服务器。

带有GraalVM的JDK 11

PetClinic API将使用Java 11构建,因此必须安装JDK 11。 为了构建本机可执行文件,必须存在GraalVM 19.3+,并且由于它是基于OpenJDK 11构建的,因此这将是本教程的最佳选择。 安装(和管理Java SDK的多个版本)最简单的方法是使用SDKMAN!

了解如何使用SDKMAN管理多个Java SDK! 轻松

要支持本机映像,请确保安装所有必需的依赖项。 可以在GraalVM文档中找到更多信息: https ://www.graalvm.org/docs/reference-manual/native-image/

GraalVM官方文档: GraalVM

终奌站

该服务是使用iTerm2oh-my-zsh在macOS上开发的。 我还将httpie用作默认的HTTP客户端。

IntelliJ

我首选的IDE是IntelliJ,我在从事此项目时就使用了它。

在本文中了解有关我在macOS上使用的工具的更多信息: macOS:(Java)开发人员的基本工具

使用Docker运行PostgreSQL

该应用程序将连接到Postgres服务器,并根据配置文件( dev , test , prod )应用不同的配置。 为此,我们将需要运行三台服务器:每台服务器具有不同的数据库名称,端口和凭据。 为了简化设置,可以利用Docker。

开发数据库

  • 创建并运行容器:
 $ docker run --name petclinic-db-dev -p 5433 : 5432 -e POSTGRES_DB=petclinic-dev -e POSTGRES_USER=petclinic-dev -e POSTGRES_PASSWORD=petclinic-dev -d postgres:alpine 
  • 运行先前停止的容器:
 $ docker start petclinic-db-dev 

测试数据库

  • 创建并运行容器:
 $ docker run --name petclinic-db-test -p 5434 : 5432 -e POSTGRES_DB=petclinic-test -e POSTGRES_USER=petclinic-test -e POSTGRES_PASSWORD=petclinic-test -d postgres:alpine 
  • 运行先前停止的容器:
 $ docker start petclinic-db-test 

产品数据库

  • 创建并运行容器:
 $ docker run --name petclinic-db -p 5432 : 5432 -e POSTGRES_DB=petclinic -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -d postgres:alpine 
  • 运行先前停止的容器:
 $ docker start petclinic-db 

入门

引导应用程序

您可以在命令行中使用Maven引导应用程序,也可以使用在线生成器。 在线生成器允许探索可以构成Quarkus应用程序的扩展和技术,并且不需要本地Maven安装。 您可以在此处访问生成器: https : //code.quarkus.io

需要以下扩展来构建PetClinic API服务:

  • RESTEasy JAX-RS –实现JAX-RS等的REST框架
  • RESTEasy Jackson –对RESTEasy的Jackson序列化支持
  • SmallRye OpenAPI –使用OpenAPI记录您的REST API – Swagger UI随附
  • 带有Panache的Hibernate ORM –在带有Panache的Hibernate ORM中定义持久性模型
  • Hibernate Validator –验证进入您的REST端点的数据
  • JDBC驱动程序– PostgreSQL – PostgreSQL数据库连接器
  • Flyway –处理数据库架构迁移

选择依赖项后,您可以下载zip,解压缩并开始开发服务。

下载的项目具有标准的Maven项目布局。 它包含Maven包装器,因此无需本地Maven安装即可开发项目。 您还会注意到src/main/docker带有本机和JVM映像的Docker文件。

主配置文件application.properties位于src/main/resources 。 此文件夹还包含META-INF/resources文件夹,用于存储应用程序的静态资源,例如index.html文件。

在线生成器默认情况下使用Java 8生成项目,因此要使用Java 11,需要进行一些调整。

  • 在生成的项目的pom.xml中,更改Java版本:
  1.  
    < maven.compiler.source >11</ maven.compiler.source >
  2.  
         < maven.compiler.target >11</ maven.compiler.target >
  • src/main/docker/Dockerfile.jvm设置ARG JAVA_PACKAGE=java-11-openjdk-headless

在开发模式下运行项目

进行更改后,您可以启动应用程序。 打开终端,导航到项目的文件夹并运行以下命令:

 $ ./mvnw compile quarkus:dev 

注意:Quarkus具有三种内置模式: dev , testprod取决于您如何运行应用程序。

在IntelliJ中开发

在IntelliJ中,您只需打开项目的文件夹或pom.xml 。 ( File > Open )。 该项目只能使用Maven启动。 这可以通过Maven运行配置来完成,因为没有类可以启动应用程序,例如在Spring Boot中 。

对我来说,使用Quarkus进行开发时最好的体验是当我在IntelliJ外部的终端中运行应用程序时。

调试

开发模式下执行Quarkus应用程序时,它将以启用的调试协议(在端口5005上)启动。 要在IntelliJ中调试Quarkus应用程序,您需要通过Run > Attach to Process调试器附加到正在Run > Attach to Process 。 我没有调试应用程序的麻烦。

注意:可以在禁用调试的开发模式下运行该应用程序: ./mvnw quarkus:dev -Ddebug=false ,但老实说,默认情况下启用调试器时,我没有发现任何性能问题。

实时重载

我认为,实时重新加载是Quarkus最强大的功能。 效果惊人。 基本上,您可以更改源代码中所需的任何内容,执行请求,然后眨眼间即可重新加载应用程序。 我正在重新整理类和程序包,移动文件,添加和删除端点,而所有这些操作都没有一次重启。

数据源配置

所有属性都转到src/main/resources/application.properties 。

默认数据源属性(

 quarkus.datasource.url=jdbc:postgresql: //localhost:5432/petclinic  quarkus.datasource.driver=org.postgresql.Driver  quarkus.datasource.username=petclinic  quarkus.datasource.password=petclinic 

Dev数据源属性(

要设置模式(或配置文件)的特定属性,请使用%mode :

 %dev.quarkus.datasource.url=jdbc:postgresql: //localhost:5433/petclinic-dev  %dev.quarkus.datasource.username=petclinic-dev  %dev.quarkus.datasource.password=petclinic-dev 

测试数据源属性(

 %test.quarkus.datasource.url=jdbc:postgresql: //localhost:5434/petclinic-test  %test.quarkus.datasource.username=petclinic-test  %test.quarkus.datasource.password=petclinic-test 

另请参阅: https : //quarkus.io/guides/datasource

飞路迁移

要使用Flyway,请在src/main/resources创建db/migration文件夹,然后添加迁移文件。 我的第一个迁移文件称为V1.0.0__PetClinic.sql ,其中包含该服务的所有架构(DDL)和示例数据。

注意:Quarkus支持SQL导入,可以通过quarkus.hibernate-orm.sql-load-script为每个配置文件配置SQL导入,但是我无法使其工作。 请参阅我在Github上报告的问题: https : //github.com/quarkusio/quarkus/issues/7358

另请参阅: https : //quarkus.io/guides/flyway

JPA实体

PetClinic的域模型相对简单,但是它包含一些单向和双向关联以及基本继承,这使其比简单的Hello World类型的模型要好一些。

请注意,在此示例中,JPA实体由相应的Panache存储库直接在JAX-RS资源中返回(请参见下文),因此,实体类包含JPA和Jackson批注的混合。

例如:

  1.  
    @Entity @Table (name = “visits” ) public class Visit extends BaseEntity {
  2.  
         @Column (name = “visit_date” )
  3.  
         @JsonFormat (pattern = “yyyy/MM/dd HH:mm” )
  4.  
         private LocalDateTime date;
  5.  
         @NotEmpty
  6.  
         @Column (name = “description” )
  7.  
         private String description;
  8.  
         @ManyToOne
  9.  
         @JoinColumn (name = “pet_id” )
  10.  
         private Pet pet;
  11.  
         @ManyToOne
  12.  
         @JoinColumn (name = “vet_id” )
  13.  
         private Vet vet;
  14.  
         public Visit() {
  15.  
             this .date = LocalDateTime.now();
  16.  
         } } @Entity @Table (name = “vets” ,
  17.  
             uniqueConstraints =
  18.  
             @UniqueConstraint (columnNames = { “first_name” , “last_name” }) ) public class Vet extends Person {
  19.  
         @ManyToMany (fetch = FetchType.EAGER)
  20.  
         @JoinTable (name = “vet_specialties” , joinColumns = @JoinColumn (name = “vet_id” ),
  21.  
                 inverseJoinColumns = @JoinColumn (name = “specialty_id” ))
  22.  
         @JsonIgnore
  23.  
         private Set<Specialty> specialties;
  24.  
         @OneToMany (cascade = CascadeType.ALL, mappedBy = “vet” , fetch = FetchType.EAGER)
  25.  
         @JsonIgnore
  26.  
         private Set<Visit> visits; }

所有实体都位于pl.codeleak.samples.petclinic.model包中。

HibernateORM与Panache

如果您熟悉Spring,我想您已经听说过Spring Data项目。 在我看来, 带有Panache的Hibernate ORM具有相似的目标:通过消除重复和繁琐的工作,简化了JPA的开发。 Panache支持排序,分页, java.util.Optionaljava.utitl.stream.Stream等。

你有两种方法来工作,以耀目:与创建实体PanacheEntity或创建库PanacheRepository 。 我在这个项目中尝试了两种方法,但是由于实体中的继承问题,我决定坚持使用老式的方法。

带有Panache的Hibernate ORM的基本存储库定义:

  1.  
    public class OwnerRepository implements PanacheRepository<Owner> {
  2.  
         List<Owner> findByLastName(String lastName) {
  3.  
             return list( “lastName” , lastName);
  4.  
         } }

所有存储库都位于pl.codeleak.samples.petclinic.repository包中。

另请参阅: https : //quarkus.io/guides/hibernate-orm-panache

创建REST API

JAX-RS资源

Quarkus使用带有RESTEasy的JAX-RS。 要创建API端点,我们需要创建JAX-RS资源:

  1.  
    @Path (OwnerResource.RESOURCE_PATH) @Produces (MediaType.APPLICATION_JSON) public class OwnerResource {
  2.  
         public static final String RESOURCE_PATH = “/owners” ;
  3.  
         @Context
  4.  
         UriInfo uriInfo;
  5.  
         @Inject
  6.  
         OwnerRepository ownerRepository;
  7.  
         @Inject
  8.  
         PetRepository petRepository;
  9.  
         @GET
  10.  
         public Response getAll( @BeanParam PageRequest pageRequest) {         
  11.  
         }
  12.  
         @GET
  13.  
         @Path ( “{id}” )
  14.  
         public Response getOne( @PathParam ( “id” ) Long id) {
  15.  
         }
  16.  
         @GET
  17.  
         @Path ( “{id}/pets” )
  18.  
         public List<Pet> getPets( @PathParam ( “id” ) Long id) {     
  19.  
         }
  20.  
         @POST
  21.  
         @Consumes (MediaType.APPLICATION_JSON)
  22.  
         @Transactional
  23.  
         public Response create( @Valid Owner owner) {     
  24.  
         } }

依赖注入是通过CDI完成的-上下文和依赖注入 。 资源对象将由Quarkus自动配置。 必须将所有其他依赖项配置为具有CDI批注的依赖项注入。

例如,可以使用@ApplicationScoped注释存储库,然后使用@Inject注入存储库:

  1.  
    @ApplicationScoped public class OwnerRepository implements PanacheRepository<Owner> {
  2.  
         List<Owner> findByLastName(String lastName) {
  3.  
             return list( “lastName” , lastName);
  4.  
         } } @ApplicationScoped public class PetRepository implements PanacheRepository<Pet> { }

所有资源都位于pl.codeleak.samples.petclinic.api包中。

另请参阅: https : //quarkus.io/guides/cdi-reference

分页

如前所述,Panache为分页结果提供支持。 我们可以轻松地在我们的资源中轻松利用它:

  1.  
    @GET public Response getAll( @BeanParam PageRequest pageRequest) {
  2.  
         return Response.ok(((PanacheRepository) petRepository).findAll()
  3.  
                         .page(Page.of(pageRequest.getPageNum(), pageRequest.getPageSize()))
  4.  
                         .list()).build(); }

PageRequest是一个包含pageNumpageSize查询参数的bean:

  1.  
    public class PageRequest {
  2.  
         @QueryParam ( “pageNum” )
  3.  
         @DefaultValue ( “0” )
  4.  
         private int pageNum;
  5.  
         @QueryParam ( “pageSize” )
  6.  
         @DefaultValue ( “10” )
  7.  
         private int pageSize; }

使用httpie可以轻松完成分页请求:

  1.  
    $ http get : 8080 /owners pageNum== 0 pageSize== 2 HTTP/ 1.1 200 OK Content-Length: 250 Content-Type: application/json [
  2.  
         {
  3.  
             “address” : “110 W. Liberty St.” ,
  4.  
             “city” : “Madison” ,
  5.  
             “firstName” : “George” ,
  6.  
             “id” : 1 ,
  7.  
             “lastName” : “Franklin” ,
  8.  
             “telephone” : “6085551023”
  9.  
         },
  10.  
         {
  11.  
             “address” : “638 Cardinal Ave.” ,
  12.  
             “city” : “Sun Prairie” ,
  13.  
             “firstName” : “Betty” ,
  14.  
             “id” : 2 ,
  15.  
             “lastName” : “Davis” ,
  16.  
             “telephone” : “6085551749”
  17.  
         } ]

交易次数

在JPA中创建新对象需要活动事务。 为了将事务绑定到资源对象中的当前方法,请使用@Transactional ,否则在方法执行期间将引发异常:

  1.  
    @POST @Consumes (MediaType.APPLICATION_JSON) @Transactional public Response create( @Valid Owner owner) {
  2.  
         ownerRepository.persist(owner);
  3.  
         var location = uriInfo.getAbsolutePathBuilder()
  4.  
                 .path( “{id}” )
  5.  
                 .resolveTemplate( “id” , owner.getId())
  6.  
                 .build();
  7.  
         return Response.created(location).build(); }

使用httpie创建新资源:

  1.  
    $ http post : 8080 /owners <<< ‘ {
  2.  
         “address” : “110 W. Liberty St.” ,
  3.  
         “city” : “Madison” ,
  4.  
         “firstName” : “George” ,
  5.  
         “lastName” : “Franklin” ,
  6.  
         “telephone” : “6085551023” }’ HTTP/ 1.1 201 Created Content-Length: 0 Location: http: //localhost:8080/owners/1042

验证方式

该项目使用Hibernate Validator扩展。 通过此扩展,您可以使用标准的Hibernate验证批注(例如@NotBlank ),并且当资源方法的输入参数使用@Valid注释时,验证将自动触发,并且错误响应将返回给调用该方法的客户端。

以下请求的示例响应:

  1.  
    $ http post : 8080 /owners <<< ‘{}’ HTTP/ 1.1 400 Bad Request Content-Length: 626 Content-Type: application/json validation-exception: true {
  2.  
         “classViolations” : [],
  3.  
         “exception” : null ,
  4.  
         “parameterViolations” : [
  5.  
             {
  6.  
                 “constraintType” : “PARAMETER” ,
  7.  
                 “message” : “must not be empty” ,
  8.  
                 “path” : “create.owner.address” ,
  9.  
                 “value” : “”
  10.  
             },         
  11.  
             …
  12.  
             {
  13.  
                 “constraintType” : “PARAMETER” ,
  14.  
                 “message” : “must not be empty” ,
  15.  
                 “path” : “create.owner.telephone” ,
  16.  
                 “value” : “”
  17.  
             }
  18.  
         ],
  19.  
         “propertyViolations” : [],
  20.  
         “returnValueViolations” : [] }

关于实时重新加载功能的注意事项:您可以对源代码进行任何更改,并使用httpie执行新请求。 该应用程序快速重新加载,您会立即获得结果。 无需重新启动。

另请参阅: https : //quarkus.io/guides/validation

Java 8日期和时间支持

RESTEasy Jackson扩展位于项目中时,在JSON序列化和反序列化期间支持java.util.time类型。

在以下示例中,访问日期以@JsonFormat批注提供的格式进行序列化和反序列化:

  1.  
    @Entity @Table (name = “visits” ) public class Visit extends BaseEntity {
  2.  
         @Column (name = “visit_date” )
  3.  
         @JsonFormat (pattern = “yyyy/MM/dd HH:mm” )
  4.  
         private LocalDateTime date; }

检查如何使用htppie序列化日期:

  1.  
    $ http get : 8080 /visits/ 1 HTTP/ 1.1 200 OK Content-Length: 174 Content-Type: application/json {
  2.  
         “date” : “2013/01/01 00:00” ,
  3.  
         “description” : “rabies shot” ,
  4.  
         “id” : 1 ,
  5.  
         “pet” : {
  6.  
             “birthDate” : “2012/09/04” ,
  7.  
             “id” : 7 ,
  8.  
             “name” : “Samantha”
  9.  
         },
  10.  
         “vet” : {
  11.  
             “firstName” : “Helen” ,
  12.  
             “id” : 2 ,
  13.  
             “lastName” : “Leary”
  14.  
         } }

您还可以使用所需的日期时间格式将访问存储在请求正文中:

  1.  
    $ http post : 8080 /visits <<< ‘ {
  2.  
         “date” : “2020/01/01 00:00” ,
  3.  
         “description” : “lorem ipsum” ,
  4.  
         “pet” : {
  5.  
             “id” : 7
  6.  
         },
  7.  
         “vet” : {
  8.  
             “id” : 2
  9.  
         } }’ HTTP/ 1.1 201 Created Content-Length: 0 Location: http: //localhost:8080/visits/1042

OpenAPI / Swagger支持

SmallRye OpenAPI扩展负责提供API文档,并且在开发模式下启用了SwaggerUI。

默认端点是:

  • OpenAPI文档– /openapi
  • SwaggerUI – /swaggerui

另请参阅: https : //quarkus.io/guides/openapi-swaggerui

整合测试

Quarkus使用JUnit 5和RESTAssured进行集成测试。 可以使用@QuarkusTest批注创建test ,并且默认情况下会在激活test配置文件的情况下执行test 。

  1.  
    @QuarkusTest public class PetResourceTest {
  2.  
         @Test
  3.  
         public void pagedList() {
  4.  
             given()
  5.  
                     .when().get( “/pets?pageNum=0&pageSize=2” )
  6.  
                     .then()
  7.  
                     .statusCode( 200 )
  8.  
                     .body(
  9.  
                             “$.size()” , is( 2 ),
  10.  
                             “name” , containsInAnyOrder( “Leo” , “Basil” )
  11.  
                     );
  12.  
         } }

Quarkus测试要求应用程序正在运行。 通过使用CDI @Alternate bean定义,可以替换测试中的选定bean。 备用bean必须放置在src/test/java 。

注意:由于有了配置文件支持,您可以使用单独的数据库容器轻松配置test配置文件的数据源。 请参阅测试数据源属性 。

另请参阅: https : //quarkus.io/guides/getting-started-testing

打包并运行应用程序

该应用程序可以打包为./mvnw package 。

它在/target目录中生成可执行文件quarkus-petclinic-api-1.0.0-runner.jar文件,并将依赖项复制到target/lib目录中。

 [INFO] [io.quarkus.deployment.pkg.steps.JarResultBuildStep] Building thin jar: /Users/rafal.borowiec/Projects/quarkus/quarkus-petclinic-api/target/quarkus-petclinic-api- 1.0 . 0 -runner.jar  [INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 1888ms  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 15.868 s  [INFO] Finished at: 2020 - 02 -23T19: 18 : 25 + 01 : 00  [INFO] ------------------------------------------------------------------------ 

现在可以使用java -jar target/quarkus-petclinic-api-1.0.0-runner.jar运行该应用程序。

 2020 - 02 - 23 19 : 19 : 10 , 169 INFO [io.quarkus] (main) quarkus-petclinic-api 1.0 . 0 (running on Quarkus 1.2 . 1 .Final) started in 2 .011s. Listening on: http: .011s. Listening on: http: //0.0.0.0:8080 .011s. Listening on: http: //0.0.0.0:8080  2020 - 02 - 23 19 : 19 : 10 , 171 INFO [io.quarkus] (main) Profile prod activated.  2020 - 02 - 23 19 : 19 : 10 , 171 INFO [io.quarkus] (main) Installed features: [agroal, cdi, flyway, hibernate-orm, hibernate-orm-panache, hibernate-validator, jdbc-postgresql, narayana-jta, rest-client, resteasy, resteasy-jackson, smallrye-openapi] 

注意: uber-jar可以与./mvnw clean package -DskipTests=true -Dquarkus.package.uber-jar=true一起打包。

创建一个以JVM模式运行应用程序的Docker容器

 $ ./mvnw clean package  $ docker build -f src/main/docker/Dockerfile.jvm -t quarkus/petclinic-api-jvm .  Successfully built 1a5d963fedfa  Successfully tagged quarkus/petclinic-api-jvm:latest 

使用链接运行容器,执行Postgres数据库容器,并使用环境变量覆盖数据源url:

 $ docker run -i --rm -p 8080 : 8080 --link petclinic-db -e QUARKUS_DATASOURCE_URL= 'jdbc:postgresql://petclinic-db/petclinic' quarkus/petclinic-api-jvm  2020 - 02 - 23 20 : 39 : 18 , 949 INFO [io.quarkus] (main) quarkus-petclinic-api 1.0 . 0 (running on Quarkus 1.2 . 1 .Final) started in 3 .475s. Listening on: http: .475s. Listening on: http: //0.0.0.0:8080 .475s. Listening on: http: //0.0.0.0:8080  2020 - 02 - 23 20 : 39 : 18 , 949 INFO [io.quarkus] (main) Profile prod activated.  2020 - 02 - 23 20 : 39 : 18 , 949 INFO [io.quarkus] (main) Installed features: [agroal, cdi, flyway, hibernate-orm, hibernate-orm-panache, hibernate-validator, jdbc-postgresql, narayana-jta, rest-client, resteasy, resteasy-jackson, smallrye-openapi 

注意: petclinic-db是在此处创建的Postgres容器的名称: Prod database 。 我们还需要传递数据源URL。 阅读有关在运行时覆盖配置属性的更多信息:在运行时覆盖属性

创建本机可执行文件

您可以使用以下命令创建本机可执行文件:

 $ ./mvnw package -Pnative  [INFO] [io.quarkus.deployment.pkg.steps.NativeImageBuildStep] Building image from /Users/rafal.borowiec/Projects/quarkus/quarkus-petclinic-api/target/quarkus-petclinic-api- 1.0 [INFO] [io.quarkus.deployment.pkg.steps.NativeImageBuildStep] Building native image from /Users/rafal.borowiec/Projects/quarkus/quarkus-petclinic-api/target/quarkus-petclinic-api- . 0 - native -image-source-jar/quarkus-petclinic-api- 1.0 . 0 -runner.jar  ...  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]  (typeflow): 72 , 535.72 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]   (objects): 49 , 325.68 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]  (features): 3 , 115.04 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]    analysis: 135 , 220.10 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]    (clinit): 1 , 966.77 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]    universe: 6 , 919.51 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]     (parse): 13 , 679.33 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]    (inline): 18 , 193.40 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]   (compile): 70 , 849.75 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]     compile: 111 , 062.75 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]       image: 8 , 843.46 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]       write: 1 , 789.58 ms  [quarkus-petclinic-api- 1.0 . 0 -runner: 50503 ]     [total]: 282 , 727.03 ms  [INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 287304ms  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 04 : 58 min  [INFO] Finished at: 2020 - 02 -23T19: 25 : 10 + 01 : 00  [INFO] ------------------------------------------------------------------------ 

创建本机可执行文件的过程需要花费一些时间,但是值得等待它完成以查看应用程序的启动时间:

 $ ./target/quarkus-petclinic-api- 1.0 . 0 -runner  2020 - 02 - 23 19 : 26 : 03 , 959 INFO [io.quarkus] (main) quarkus-petclinic-api 1.0 . 0 (running on Quarkus 1.2 . 1 .Final) started in 0 .066s. Listening on: http: .066s. Listening on: http: //0.0.0.0:8080 .066s. Listening on: http: //0.0.0.0:8080  2020 - 02 - 23 19 : 26 : 03 , 959 INFO [io.quarkus] (main) Profile prod activated.  2020 - 02 - 23 19 : 26 : 03 , 959 INFO [io.quarkus] (main) Installed features: [agroal, cdi, flyway, hibernate-orm, hibernate-orm-panache, hibernate-validator, jdbc-postgresql, narayana-jta, rest-client, resteasy, resteasy-jackson, smallrye-openapi] 

本机可执行文件启动为0.67秒,而JVM版本为2秒。

创建一个以纯模式运行应用程序的Docker容器

默认情况下,本机可执行文件以操作系统支持的格式创建。 由于容器使用的可执行文件格式可能与操作系统生成的格式不同,因此Maven构建可以从容器内部生成可执行文件:

 $ ./mvnw package -Pnative -Dquarkus. native .container-build= true 

要调整构建器映像的版本,您需要设置quarkus.native.builder-image属性:

 $ ./mvnw clean package -Pnative -DskipTests= true -Dquarkus. native .container-build= true -Dquarkus. native .builder-image=quay.io/quarkus/ubi-quarkus- native -image: 20.0 . 0 -java11 

现在,构建并运行容器:

 $ docker build -f src/main/docker/Dockerfile. native -t quarkus/petclinic-api .  $ docker run -i --rm -p 8080 : 8080 quarkus/petclinic-api 

注意:有关构建本机可执行文件的更多信息,请参见Quarkus文档: https ://quarkus.io/guides/building-native-image

源代码

可以在Github上找到本文的源代码: https : //github.com/kolorobot/quarkus-petclinic-api

翻译自: https://www.javacodegeeks.com/2020/02/getting-started-with-quarkus.html

quarkus