知識庫 / Spring / Spring Boot RSS 訂閱

4.2. 使用程序化配置

現在，讓我們看看如何通過代碼配置我們的嵌入式 Netty 服務器。為此，Spring Boot 提供了 WebServerFactoryCustomizer 和 NettyServerCustomizer 類。

讓我們使用這些類，就像我們之前使用屬性文件一樣，將 Netty 端口配置為我們之前所做的那樣：

@Component
public class NettyWebServerFactoryPortCustomizer 
  implements WebServerFactoryCustomizer<NettyReactiveWebServerFactory> {

    @Override
    public void customize(NettyReactiveWebServerFactory serverFactory) {
        serverFactory.setPort(8088);
    }
}

Spring Boot 在啓動時會拾取我們的工廠定製器組件，並配置服務器端口。

或者，我們可以實現 NettyServerCustomizer：

private static class PortCustomizer implements NettyServerCustomizer {
    private final int port;

    private PortCustomizer(int port) {
        this.port = port;
    }
    @Override
    public HttpServer apply(HttpServer httpServer) {
        return httpServer.port(port);
    }
}

將它添加到服務器工廠中：

serverFactory.addServerCustomizers(new PortCustomizer(8088));

這兩種方法在配置我們的嵌入式 Reactor Netty 服務器時，給我們提供了很大的靈活性。

此外，我們還可以自定義 EventLoopGroup：

private static class EventLoopNettyCustomizer implements NettyServerCustomizer {

    @Override
    public HttpServer apply(HttpServer httpServer) {
        EventLoopGroup eventLoopGroup = new NioEventLoopGroup();
        eventLoopGroup.register(new NioServerSocketChannel());
        return httpServer.runOn(eventLoopGroup);
    }
}

當然，以下是翻譯後的內容：

然而，在特定情況下存在一個注意事項。由於 Spring Boot 自動配置了 Netty 服務器，因此我們可能需要通過顯式定義 NettyReactiveWebServerFactory bean 來跳過自動配置。

為了實現此目的，我們應該在配置類中定義 bean 並將其添加到該類中。

@Bean
public NettyReactiveWebServerFactory nettyReactiveWebServerFactory() {
    NettyReactiveWebServerFactory webServerFactory = new NettyReactiveWebServerFactory();
    webServerFactory.addServerCustomizers(new EventLoopNettyCustomizer());
    return webServerFactory;
}

接下來，我們將繼續探討一些常見的 Netty 配置場景。

5. SSL 配置

讓我們看看如何配置 SSL。

我們將使用 SslServerCustomizer 類，它是 NettyServerCustomizer 的另一種實現。

@Component
public class NettyWebServerFactorySslCustomizer 
  implements WebServerFactoryCustomizer<NettyReactiveWebServerFactory> {

    @Override
    public void customize(NettyReactiveWebServerFactory serverFactory) {
        Ssl ssl = new Ssl();
        ssl.setEnabled(true);
        ssl.setKeyStore("classpath:sample.jks");
        ssl.setKeyAlias("alias");
        ssl.setKeyPassword("password");
        ssl.setKeyStorePassword("secret");
        Http2 http2 = new Http2();
        http2.setEnabled(false);
        serverFactory.addServerCustomizers(new SslServerCustomizer(ssl, http2, null));
        serverFactory.setPort(8443);
    }
}

我們已定義了與 keystore 相關的屬性，禁用了 HTTP/2，並將端口設置為 8443。

6. 訪問日誌配置

現在，我們將探討如何使用 Logback 配置訪問日誌。

Spring Boot 允許我們通過 Tomcat、Jetty 和 Undertow 的應用程序屬性文件中配置訪問日誌。但是，Netty 目前尚不支持此功能。

為了啓用 Netty 訪問日誌，我們應該在運行應用程序時設置 –Dreactor.netty.http.server.accessLogEnabled=true：

mvn spring-boot:run -Dreactor.netty.http.server.accessLogEnabled=true

7. 結論

在本文中，我們介紹瞭如何在 Spring Boot 應用程序中配置 Reactor Netty 服務器的方法。

首先，我們使用了 Spring Boot 通用的基於屬性的配置能力。然後，我們探討了如何以精細的方式通過編程方式配置 Netty。