15、Jakarta EE规范与Helidon WebServer组件详解

最新推荐文章于 2025-09-18 00:28:34 发布

work3

最新推荐文章于 2025-09-18 00:28:34 发布

阅读量61

点赞数

CC 4.0 BY-SA版权

分类专栏：探索Helidon：构建现代Java微服务文章标签： Jakarta EE Helidon WebServer

本文链接：https://blog.youkuaiyun.com/work3/article/details/150211773

探索Helidon：构建现代Java微服务专栏收录该内容

15 篇文章 ¥499.90

订阅专栏¥69.90

会员秒杀 ¥9.9 重磅福利

超级会员免费看

Jakarta EE规范与Helidon WebServer组件详解

1. Jakarta EE规范概述

2. Helidon Reactive WebServer组件

Helidon的WebServer组件是一个受Node.js和其他Java框架启发的异步和反应式API，它基于Netty异步事件驱动网络应用程序框架运行。以下是该组件的详细介绍：

2.1 WebServer组件基础

接口签名 ：

public interface WebServer

该接口定义了配置、构建、启动和停止Web服务器所需的方法。

创建方法 ：WebServer接口定义了四个重载的 create() 方法：

• create(Routing routing)：从提供的路由和默认配置创建新实例。
• create(Routing routing, Config config)：从提供的路由和配置创建新实例。
• create(Supplier<? extends Routing> routingBuilder)：从提供的路由和默认配置创建新实例。
• create(Supplier<Routing> routingBuilder, Config config)：从提供的路由和配置创建新实例。

2.2 配置WebServer

直接配置 ：可以使用 WebServer.Builder 类的方法直接配置Web服务器，示例代码如下：

WebServer server = WebServer.builder() 
      .bindAddress(InetAddress.getLocalHost()) 
      .port(8080) 
      .build();

- `builder()`方法创建`WebServer`接口的流畅API构建器，并返回`WebServer.Builder`的静态实例。
- `bindAddress(InetAddress bindAddress)`方法配置服务器套接字监听的本地地址，若未配置则监听所有本地地址。
- `port(int port)`方法配置服务器套接字监听的端口，若设置为0则使用任何可用的临时端口。
- `build()`方法使用构建器及其参数的配置构建`WebServer`接口的实例。

外部配置 ：可以使用配置文件创建Web服务器，Helidon的默认配置文件是 src/main/resources 文件夹中的 application.yaml ，也可以使用其他常用文件名。示例配置文件如下：

server:
  port: 8080
  host: 0.0.0.0

加载配置文件的代码如下：

Config config = Config.create();
Config greeting = config.get("server");

2.3 路由配置

路由接口签名 ：

public interface Routing extends ServerLifecycle

该接口扩展了 ServerLifecycle 接口，定义了基本的服务器生命周期操作，并声明了 beforeStart() 和 afterStart() 方法。

构建路由实例 ：可以使用 Routing.Builder 类构建 Routing 接口的实例，示例代码如下：

Routing routing = Routing.builder()
    .get("/hello", (request, response) -> response.send("Hello World!"))
    .build();

Routing.Builder 提供了三个重载的 get() 方法：

• get(Handler... requestHandlers)：将所有GET请求路由到提供的处理程序。
• get(PathMatcher pathMatcher, Handler... requestHandlers)：通过`PathMatcher`接口将具有相应路径的所有GET请求路由到提供的处理程序。
• get(String pathPattern, Handler... requestHandlers)：通过字符串将具有相应路径的所有GET请求路由到提供的处理程序。

Routing.Builder 还提供了处理其他HTTP请求的对应重载方法，如下表所示：
| HTTP请求 | 对应的Routing.Builder方法 |
| — | — |
| GET | .get() |
| PUT | .put() |
| POST | .post() |
| HEAD | .head() |
| 任何请求 | .any() |

以下是WebServer配置和启动的流程图：

graph TD
    A[开始] --> B[创建WebServer.Builder实例]
    B --> C{选择配置方式}
    C -->|直接配置| D[设置绑定地址和端口]
    C -->|外部配置| E[加载配置文件]
    D --> F[构建WebServer实例]
    E --> F
    F --> G[启动WebServer]
    G --> H[监听请求并处理]
    H --> I[停止WebServer]
    I --> J[结束]

以上介绍了Jakarta EE的部分重要规范及其兼容实现，以及Helidon Reactive WebServer组件的详细内容，包括其接口、创建方法、配置方式和路由配置等。这些知识对于开发基于Jakarta EE和Helidon的应用程序具有重要的指导意义。

3. 构建Helidon WebServer应用程序

3.1 依赖配置

在构建Helidon WebServer应用程序时，需要添加相应的依赖。根据使用的构建工具不同，依赖配置如下：
- Maven ：

<dependency>
    <groupId>io.helidon.webserver</groupId>
    <artifactId>helidon-webserver</artifactId>
    <version>3.2.9</version>
</dependency>

Gradle ：

implementation group: 'io.helidon.webserver', name: 'helidon-webserver', version: '3.2.9'

3.2 启动WebServer示例

以下是一个完整的启动WebServer的示例代码，定义在 Application 类中的 startServer() 方法：

static Single<WebServer> startServer() {
    LogConfig.configureRuntime(); 
    Config config = Config.create(); 
    WebServer server = WebServer.builder(createRouting(config))
            .config(config.get("server"))
            .addMediaSupport(JsonpSupport.create()) 
            .build();
    Single<WebServer> webserver = server.start(); 
    webserver.thenAccept(ws -> { 
        System.out.println("WEB server is up! http://localhost:" + ws.port() + "/greet");
        ws.whenShutdown().thenRun(() -> System.out.println("WEB server is DOWN. Goodbye!"));
        })
    .exceptionallyAccept(t -> { 
            System.err.println("Startup failed: " + t.getMessage());
            t.printStackTrace(System.err);
        });
    return webserver;
    }

代码解释如下：
1. LogConfig.configureRuntime() ：如果应用程序通过GraalVM转换为本地映像，此方法会使用运行时配置重新配置日志记录。在应用程序启动时，Helidon会调用相关方法，只要类路径或当前目录中有 logging.properties 文件，就无需显式配置日志记录，也可以使用系统属性（如 java.util.logging.config.class 和 java.util.logging.config.file ）进行显式配置。
2. Config.create() ：加载默认配置文件 application.yaml 。
3. addMediaSupport(MediaSupport mediaSupport) ：接受 MediaSupport 接口的实现，为应用程序注册读取器和写入器。实现类如下：
- DefaultMediaSupport ：向上下文注册默认的读取器和写入器。
- JacksonSupport ：提供Jackson集成支持。
- JsonbSupport ：提供JSON Binding（JSON - B）集成支持。
- JsonpSupport ：提供JSON Processing（JSON - P）集成支持。
- MultiPartSupport ：提供多媒体支持。
MediaSupport 的实例可用于 WebServer 和 WebClient 组件。

4. 总结

本文详细介绍了Jakarta EE的众多规范及其对应的兼容实现，涵盖了从基础服务到高级应用开发的各个方面，如拦截器、JSON处理、邮件服务、持久化等。同时，深入探讨了Helidon Reactive WebServer组件，包括其基础接口、创建方法、配置方式（直接配置和外部配置）以及路由配置。

希望这些内容能帮助开发者更好地理解和应用Jakarta EE规范以及Helidon WebServer组件，开发出高效、稳定的Java应用程序。

以下是整个应用开发流程的流程图：

graph LR
    A[选择Jakarta EE规范] --> B[配置Helidon WebServer依赖]
    B --> C{选择配置方式}
    C -->|直接配置| D[设置WebServer参数]
    C -->|外部配置| E[加载配置文件]
    D --> F[配置路由]
    E --> F
    F --> G[启动WebServer]
    G --> H[应用运行]

以上就是关于Jakarta EE规范和Helidon Reactive WebServer组件的详细介绍，希望对开发者有所帮助。