Quarkus初探

2024-04-11 17:52
文章标签 初探 quarkus

本文主要是介绍Quarkus初探，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Quarkus初探

  • 背景
  • 安装Quarkus
    • 安装Quarkus CLI
  • 创建Quarkus项目
    • 运行Quarkus
    • 初探代码
      • 修改一下代码
    • 数据持久化
      • 创建PanacheEntiry
      • 写入数据
      • 读取数据
    • Dev Service
      • 使用外部数据库
      • 区分dev和prod
    • 构建native应用（依赖Graalvm）

背景

最早是在Infoq上了解到Quarkus这个框架，内部集成了Vertx，对native-image有着非常好的支持，启动速度非常快，占用内存很小（相较于Springboot）,最近有时间就来体验一下。

安装Quarkus

Quarkus也是基于Java的微服务框架，所以想要体验Quarkus需要满足以下条件：

  1. JDK 17+，配置配置好了JAVA_HOME
  2. Apache Maven 3.9.6
  3. docker或podman（可选）
  4. Quarkus CLI（可选）
  5. Graalvm（可选，用于构建Native应用）

安装Quarkus CLI

Quarkus CLI中提供了很多命令，可以帮助我们快速的创建、运行Quarkus项目。这两天体验下来Quarkus CLI应该是主要对mvn的各类命令进行了集成，Quarkus CLI的命令相较于mvn来说更加便捷，也是推荐大家安装体验一下。目前官方支持以下几种安装方式：

  • JBang - for Linux, macOS and Windows
  • SDKMAN! - for Linux and macOS
  • Homebrew - for Linux and macOS
  • Chocolatey - for Windows
  • Scoop - for Windows

我目前这台机器是通过SDKMAN来管理JDK版本的，这里选择了使用SDKMAN进行安装

sdk install quarkus

安装完成之后验证一下

quarkus --version
3.9.2

创建Quarkus项目

通过quarkus执行以下命令

quarkus create app org.acme:getting-started-dev-services \--extension='rest'
cd getting-started-dev-services

或者通过maven

mvn io.quarkus.platform:quarkus-maven-plugin:3.9.2:create \-DprojectGroupId=org.acme \-DprojectArtifactId=getting-started-dev-services \-Dextensions='rest'
cd getting-started-dev-services

如果想要创建一个gradle项目，可以追加以下参数 -DbuildTool=gradle 或 -DbuildTool=gradle-kotlin-dsl

对于使用windows的同学，有以下两点需要注意:

  • 如果使用cmd，不要使用\分割命令，所有命令都要放在同一行中
  • 如果使用PowerShell，-D的参数需要使用双引号括起来，e.g."-DprojectArtifactId=getting-started-dev-services"

运行Quarkus

quarkus devor
./mvnw quarkus:devor
./gradlew --console=plain quarkusDev

正常启动后可以看到如下信息：

__  ____  __  _____   ___  __ ____  ______ --/ __ \/ / / / _ | / _ \/ //_/ / / / __/ -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \   
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/   
2024-04-10 11:22:05,350 INFO  [io.quarkus] (Quarkus Main Thread) code-with-quarkus 1.0.0-SNAPSHOT on JVM (powered by Quarkus 3.9.2) started in 0.842s. Listening on: http://localhost:80802024-04-10 11:22:05,351 INFO  [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.

然后我们在浏览器里访问 http://localhost:8080/hello，应该可以看到如下信息

Hello from Quarkus REST

初探代码

我们使用IDE打开刚刚创建的项目，可以看到只有一个很简单的类GreetingResource

package org.acme;import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;@Path("/hello")
public class GreetingResource {@GET@Produces(MediaType.TEXT_PLAIN)public String hello() {return "Hello from Quarkus REST";}
}

相交于Springboot来说，这里不需要定义一个Application启动类，再增加一个Controller，一个简简单单的GreetingResource就完成了所有的功能，这里使用到的注解也都是jakarta的标准注解。

修改一下代码

public String hello(@RestQuery String name) {return "Hello " + name;
}

然后我们访问http://localhost:8080/hello?name=Bloom
这时我们会看到这样一条消息: Hello Bloom.
quarkus dev模式支持代码热部署，在我们修改代码之后无需重启，调试修改的时候会非常方便。

对应的我们修改一下单元测试 src/test/java/org/acme/GreetingResourceTest.java，将

.body(is(“Hello from Quarkus REST”));

修改为

.body(containsString(“Hello”));

不然下次启动会报错（quarkus默认启动时会先执行单元测试）

数据持久化

在进行这一步之前，建议把我们本地的容器服务启动(docker或podman)起来，看看接下来会发生什么

创建PanacheEntiry

quarkus extension add hibernate-orm-panache jdbc-postgresql
或者
./mvnw quarkus:add-extension -Dextensions=‘hibernate-orm-panache jdbc-postgresql’

官方示例提供的是postgresql，你也可以替换为mysql。
创建一个Greeting.java

import io.quarkus.hibernate.orm.panache.PanacheEntity;
import jakarta.persistence.Entity;@Entity
public class Greeting extends PanacheEntity {public String name;
}

Panache是一个基于Hibernate的orm框架，PanacheEntity（类似于Spring-Data中的JpaRepository）中提供了大量的方法方便我们进行CRUD的操作

写入数据

@GET
@Transactional
@Produces(MediaType.TEXT_PLAIN)
public String hello(@QueryParam("name") String name) {Greeting greeting = new Greeting();greeting.name = name;greeting.persist();return "Hello " + name;
}

这里只是一个示例，在正式的代码中，GET请求不应该向后端服务写入数据

读取数据

@GET
@Path("names")
@Produces(MediaType.TEXT_PLAIN)
public String names() {List<Greeting> greetings = Greeting.listAll();String names = greetings.stream().map(g-> g.name).collect(Collectors.joining (", "));return "I've said hello to " + names;
}

来试一下效果, 先访问 http://localhost:8080/hello?name=Bloom, 再访问 http://localhost:8080/hello/names.

我们就能看到: “I’ve said hello to Bloom”.

Dev Service

进行到这里，你肯定会有很多疑问，我本地都没有PG数据库，项目中也没有任何数据库相关的配置，为什么没有报错？这一切都是怎么发生的？
这时你可以打开自己的Docker desktop或者使用docker ps的命令，你就会发现有一个PG的数据库实例正在运行

% docker ps
CONTAINER ID   IMAGE                       COMMAND                   CREATED              STATUS              PORTS                     NAMES
38c07eab6549   postgres:14                 "docker-entrypoint.s…"   About a minute ago   Up About a minute   0.0.0.0:61089->5432/tcp   kind_yalow

这一切都是Dev Service为我们做的，由于我们添加了jdbc-postgresql的依赖，Dev Service就为我们启动了一个postgresql的容器，方便我们更加快速的进行项目搭建。

另外，在dev模式下，处于Dev Services管理的数据库，Quarkus会使用drop-and-create的模式，所以我们每次修改代码重启服务之后，之前保存的数据都会丢失。在某些情况下，这种模式会很不方便，Quarkus也提供了一种机制来进行数据的初始化
我们可以创建一个sql文件src/main/resources/import.sql 

INSERT INTO Greeting(id, name)
VALUES (nextval('Greeting_SEQ'), 'Alice');
INSERT INTO Greeting(id, name)
VALUES (nextval('Greeting_SEQ'), 'Bob');

这样每次quarkus启动时都会将这些数据初始化进去

使用外部数据库

如果我们已经搭建好了一个数据库，我们可以在src/main/resources/application.properties中增加如下配置

# configure your datasource
quarkus.datasource.db-kind = postgresql
quarkus.datasource.username = leopold
quarkus.datasource.password = bloom
quarkus.datasource.jdbc.url = jdbc:postgresql://localhost:5432/mydatabase

区分dev和prod

如果你想在开发和测试环境中使用Dev Service，在生产环境使用外包数据库，可以通过一个%prod的前缀来区分

# configure your datasource
%prod.quarkus.datasource.db-kind = postgresql
%prod.quarkus.datasource.username = leopold
%prod.quarkus.datasource.password = bloom
%prod.quarkus.datasource.jdbc.url = jdbc:postgresql://localhost:5432/mydatabase

构建native应用（依赖Graalvm）

Quarkus一大亮点是对native-image有着非常好的支持，想要体验native-image需要先安装Graalvm，你可以通过官网或者SDKMAN进行安装和配置。

quarkus build --native
./mvnw install -Dnative

编译的过程会比较长，编译完成之后会在target文件夹下生成一个getting-started-dev-services-1.0.0-SNAPSHOT-runner的可执行文件，可以直接启动。

需要注意的是，通过native构建出来的可执行程序会失去跨平台的特性，因此在一个平台上构建出来的native-image往往无法在其他平台运行，最好的方式是通过docker等容器进行部署。

目前Graalvm有一个实验性的功能，在Linux平台来构建跨平台的应用，具体可以参考
https://www.graalvm.org/jdk21/reference-manual/native-image/guides/build-static-executables/#prerequisites-and-preparation

这篇关于Quarkus初探的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/894780。

相关文章

Java注解初探

Java注解初探

什么是注解 注解（Annotation）是从JDK5开始引入的一个概念，其实就是代码里的一种特殊标记。这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过注解开发人员可以在不改变原有代码和逻辑的情况下在源代码中嵌入补充信息。有了注解，就可以减少配置文件，现在越来越多的框架已经大量使用注解，而减少了XML配置文件的使用，尤其是Spring，已经将注解玩到了极致。 注解与XML配置各有
阅读更多...
IOS Core Data框架初探

IOS Core Data框架初探

在IOS系统中已经集成了关系型数据库SqLite3数据库，但是由于在OC中直接操作C语言风格的SqLite3相对繁琐，因此Apple贴心的提供了一个ORM（Object Relational Mapping对象关系映射）框架——Core Data让我们在程序中以面向对象的方式，操作数据库。Core Data框架提供的功能相当强大，属于入门容易精通难的东西，值得我们用心专研。现在，就先记录一下我对该
阅读更多...
Scala界面Panel、Layout初探

Scala界面Panel、Layout初探

示例代码： package com.dt.scala.guiimport scala.swing.SimpleSwingApplicationimport scala.swing.MainFrameimport scala.swing.Buttonimport scala.swing.Labelimport scala.swing.Orientationimport scal
阅读更多...
Java使用Redis初探

Java使用Redis初探

Redis的相关概念不做介绍了，大家也可以先了解下Memcached，然后比较下二者的区别，就会有个整体的印象。      服务器端通常选择Linux , Redis对于linux是官方支持的，使用资料很多，需要下载相关服务器端程序  ,然后解压安装。因为能力和条件有限，我只简单介绍下windows上如何安装和使用，有兴趣的可以娱乐一下。       服务器端程序下载地址：htt
阅读更多...
SQL查询优化器初探

SQL查询优化器初探

项目中期，特意借了一本SQL优化的书，现将优化器的知识点总结如下： 查询优化器是关系型数据库管理系统的核心之一，决定对特定的查询使用哪些索引、哪些关联算法，从而使其高效运行。查询优化器是SQL Server针对用户的请求进行内部优化，生成执行计划并传输给存储引擎来操作数据，最终返回结果给用户的组件。 查询过程 T-SQL->语法分析->绑定->查询优化->执行查询->返回结果 （1）分析和
阅读更多...
初探swift语言的学习笔记四－2(对上一节有些遗留进行处理)

初探swift语言的学习笔记四－2(对上一节有些遗留进行处理)

作者：fengsh998 原文地址：http://blog.csdn.net/fengsh998/article/details/30314359 转载请注明出处 如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号fengsh998来支持我，谢谢！ 在上一节中有些问题还没有弄清，在这里自己写了一下，做了一下验证，并希望能给读者有所帮助。
阅读更多...
初探swift语言的学习笔记四(类对象，函数)

初探swift语言的学习笔记四(类对象，函数)

作者：fengsh998 原文地址：http://blog.csdn.net/fengsh998/article/details/29606137 转载请注明出处 如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号fengsh998来支持我，谢谢！ swift扩展了很多功能和属性，有些也比较奇Ｐ。只有慢慢学习，通过经验慢慢总结了。 下面将
阅读更多...
初探swift语言的学习笔记三(闭包－匿名函数)

初探swift语言的学习笔记三(闭包－匿名函数)

作者：fengsh998 原文地址：http://blog.csdn.net/fengsh998/article/details/29353019 转载请注明出处 如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号fengsh998来支持我，谢谢！ 很多高级语言都支持匿名函数操作，在ＯＣ中的block也为大家所熟悉，然面在swift里好像是被
阅读更多...
初探swift语言的学习笔记二(可选类型？和隐式可选类型！)

初探swift语言的学习笔记二(可选类型？和隐式可选类型！)

作者：fengsh998 原文地址：http://blog.csdn.net/fengsh998/article/details/28904115 转载请注明出处 如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号fengsh998来支持我，谢谢！ 可选类型、隐式可选类型 在swift中，可选类型其根源是一个枚举型，里面有None和Som
阅读更多...
初探swift语言的学习笔记一(基本数据类型)

初探swift语言的学习笔记一(基本数据类型)

作者：fengsh998 原文地址：http://blog.csdn.net/fengsh998/article/details/28258805 转载请注明出处 如果觉得文章对你有所帮助，请通过留言或关注微信公众帐号fengsh998来支持我，谢谢！ 3号，端午刚过，回到公司第一个早上的两小时便贡献给了apple的ios 8 发布会，在看完后，感觉操作
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2