一个简单的Quarkus web服务入门

一个简单的Quarkus web服务Demo

介绍

Quarkus是一个由Red Hat开源的 Java 微服务框架，其特性包括：

• 容器优先：最小的Java应用程序，最适合在容器中运行
• 云原生：在 Kubernetes 等环境中采用 12 要素原则。
• 统一命令式与反应式：在一个编程模型下带来非阻塞和命令式开发风格。
• 基于标准：基于一些标准和框架（RESTEasy、Hibernate、Netty、Eclipse Vert.x、Apache Camel …）。
• 微服务优先：快速启动项目编写 Java 应用。

根据2020年8月18日发布的《 2020 年微服务领域开源数字化报告》，Quarkus 作为云原生微服务框架，在微服务框架中活跃度排名第一，全球 GitHub 开源项目活跃度中排名 40，也具有着巨大的影响力。

虽然目前SpringBoot拥有着几乎不可动摇的地位，但对于其他的微服务框架，还是可以了解下的，下面就来看下如何使用Quarkus来构建一个web服务吧。

本示例项目代码已上传github，地址：https://github.com/mrKyleWang/quarkus-demo

---

构建项目

1. pom文件

注意，这里使用的是最新发行版本1.7.2.Final，要求：jdk 8 or 11+、maven 3.6.2+，可根据环境使用低版本quarkus

<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"
         xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <modelVersion>4.0.0modelVersion>
    <groupId>com.examplegroupId>
    <artifactId>quarkus-demoartifactId>
    <version>1.0-SNAPSHOTversion>

    <properties>
        <quarkus.version>1.7.2.Finalquarkus.version>
    properties>

    <dependencies>
        
        <dependency>
            <groupId>io.quarkusgroupId>
            <artifactId>quarkus-resteasyartifactId>
        dependency>
    dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>io.quarkusgroupId>
                <artifactId>quarkus-bomartifactId>
                <version>${quarkus.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>io.quarkusgroupId>
                <artifactId>quarkus-maven-pluginartifactId>
                <version>${quarkus.version}version>
                <executions>
                    <execution>
                        <goals>
                            <goal>buildgoal>
                        goals>
                    execution>
                executions>
            plugin>
        plugins>
    build>
project>

2. 应用配置

application.properties文件

# http服务端口
quarkus.http.port=8081
# url根路径
quarkus.http.root-path=/

3. service声明

@ApplicationScoped
public class TestService {

    public String hello() {
        return "Hello!";
    }
}

@ApplicationScoped用于声明一个Bean，可用于其他类中依赖注入，类似Spring中的@Component

4. 接口声明及依赖注入

@Path("/test")
public class TestResource {
    
    @Inject
    TestService testService;

    @GET
    @Path("/hello")
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return testService.hello();
    }
}

这里通过@Inject注解将上一步中声明的TestService注入，类比@Autowired的用法。

@Path用于声明路径，@GET表示接受get方法请求，@Produces表示相应格式，这里是以普通文本格式，直接返回TestService中返回的字符串。

---

启动应用

使用quarkus-maven-plugin启动

使用命令：mvn quarkus:dev启动

或直接通过idea插件列表启动

查看控制台

显示启动成功，并监听8081端口

---

测试接口

向127.0.0.1:8081/test/hello发起get请求：