quarkus_Quarkus入门

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

终奌站

该服务是使用iTerm2和oh-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 ， test和prod取决于您如何运行应用程序。

在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.Optional和java.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是一个包含pageNum和pageSize查询参数的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