Undertow的特點(diǎn)和使用方法

Undertow

• Undertow 是紅帽公司開(kāi)發(fā)的一款基于 NIO 的高性能 Web 嵌入式服務(wù)器

• Untertow 的特點(diǎn)：
  輕量級(jí)：它是一個(gè) Web 服務(wù)器，但不像傳統(tǒng)的 Web 服務(wù)器有容器概念，它由兩個(gè)核心 Jar 包組成，加載一個(gè) Web 應(yīng) 用可以小于 10MB 內(nèi)存
  Servlet3.1 支持：它提供了對(duì) Servlet3.1 的支持
  WebSocket 支持：對(duì) Web Socket 完全支持，用以滿(mǎn)足 Web 應(yīng)用巨大數(shù)量的客戶(hù)端
  嵌套性：它不需要容器，只需通過(guò) API 即可快速搭建 Web 服務(wù)器

• 默認(rèn)情況下 Spring Cloud 使用 Tomcat 作為內(nèi)嵌 Servlet 容器，可啟動(dòng)一個(gè) Tomcat 的 Spring Boot 程序與一個(gè) Undertow 的 Spring Boot 程序，通過(guò) VisualVM 工具進(jìn)行比較，可看到 Undertow 性能優(yōu)于 Tomcat

使用 Undertow

添加依賴(lài)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-undertow</artifactId>
</dependency>

支持 HTTP2

// 在@Configuration的類(lèi)中添加@bean
@Bean
UndertowEmbeddedServletContainerFactory embeddedServletContainerFactory() {

    UndertowEmbeddedServletContainerFactory factory = new UndertowEmbeddedServletContainerFactory();

    // 這里也可以做其他配置
    factory.addBuilderCustomizers(builder -> builder.setServerOption(UndertowOptions.ENABLE_HTTP2, true));

    return factory;
}

配置 Undertow

    # Undertow 日志存放目錄
    server.undertow.accesslog.dir
    # 是否啟動(dòng)日志
    server.undertow.accesslog.enabled=false 
    # 日志格式
    server.undertow.accesslog.pattern=common
    # 日志文件名前綴
    server.undertow.accesslog.prefix=access_log
    # 日志文件名后綴
    server.undertow.accesslog.suffix=log
    # HTTP POST請(qǐng)求最大的大小
    server.undertow.max-http-post-size=0 
    # 設(shè)置IO線程數(shù), 它主要執(zhí)行非阻塞的任務(wù),它們會(huì)負(fù)責(zé)多個(gè)連接, 默認(rèn)設(shè)置每個(gè)CPU核心一個(gè)線程
    server.undertow.io-threads=4
    # 阻塞任務(wù)線程池, 當(dāng)執(zhí)行類(lèi)似servlet請(qǐng)求阻塞操作, undertow會(huì)從這個(gè)線程池中取得線程,它的值設(shè)置取決于系統(tǒng)的負(fù)載
    server.undertow.worker-threads=20
    # 以下的配置會(huì)影響buffer,這些buffer會(huì)用于服務(wù)器連接的IO操作,有點(diǎn)類(lèi)似netty的池化內(nèi)存管理
    # 每塊buffer的空間大小,越小的空間被利用越充分
    server.undertow.buffer-size=1024
    # 每個(gè)區(qū)分配的buffer數(shù)量 , 所以pool的大小是buffer-size * buffers-per-region
    server.undertow.buffers-per-region=1024
    # 是否分配的直接內(nèi)存
    server.undertow.direct-buffers=true