概述 :
Undertow 是红帽公司开发的一款基于 NIO 的高性能 Web 嵌入式服务器。
Undertow 是一个采用 Java 开发的灵活的高性能 Web 服务器,提供包括阻塞和基于 NIO 的非堵塞机制。Undertow 是红帽公司的开源产品,是 Wildfly 默认的 Web 服务器。
Undertow 提供一个基础的架构用来构建 Web 服务器,这是一个完全为嵌入式设计的项目,提供易用的构建器 API,完全兼容 Java EE Servlet 3.1 和低级非堵塞的处理器。
特点 :
轻量级:它是一个 Web 服务器,但不像传统的 Web 服务器有容器概念,它由两个核心 Jar 包组成,加载一个 Web 应用可以小于 10MB 内存
Servlet3.1 支持:它提供了对 Servlet3.1 的支持
WebSocket 支持:对 Web Socket 完全支持,用以满足 Web 应用巨大数量的客户端
嵌套性:它不需要容器,只需通过 API 即可快速搭建 Web 服务器
Spring Boot项目中的引入方式 :
Spring Boot 内嵌 Jetty , Tomcat , Undertow , 默认是Tomcat
pom.xml配置添加如下依赖
spring boot内嵌容器默认为tomcat,想要换成undertow,非常容易,只需修改spring-boot-starter-web依赖,移除tomcat的依赖,然后,添加undertow依赖
<!--tomcat做服务器-->
<!--<dependency>-->
<!--<groupId>org.springframework.boot</groupId>-->
<!--<artifactId>spring-boot-starter-web</artifactId>-->
<!--</dependency>-->
<!--=================================================================-->
<!-- 下面的配置将使用undertow来做服务器而不是tomcat -->
<!--移除Tomcat依赖-->
<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>
<!--引入undertow-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-undertow</artifactId>
</dependency>
application.yml配置 :
与原来使用Tomcat时配置无太大差别 , 将tomca字段改为undertow即可
#与原来使用Tomcat时配置无太大差别 , 将tomca字段改为undertow即可
#压测结论 : 在并发量不高的情况下 , Tomcat与undertow的吞吐量区别不大 , 并发量高的情况下 , undertow的性能要优于Jetty与Tomcat
server:
port: 8100
undertow:
accesslog:
dir: D:\ # Undertow 日志存放目录
enabled: true # 是否启动日志
pattern: common # 日志格式
prefix: access_log # 日志文件名前缀
suffix: .log # 日志文件名后缀
max-http-post-size: 0 # HTTP POST请求最大的大小
io-threads: 4 # 设置IO线程数, 它主要执行非阻塞的任务,它们会负责多个连接, 默认设置每个CPU核心一个线程,不可设置过大,否则启动项目会报错:打开文件数过多。
worker-threads: 20 # 阻塞任务线程池, 当执行类似servlet请求阻塞操作, undertow会从这个线程池中取得线程,它的值设置取决于系统的负载,默认值是 io-threads*8
# 以下的配置会影响buffer,这些buffer会用于服务器连接的IO操作,有点类似netty的池化内存管理
buffer-size: 1024 # 每块buffer的空间大小,越小的空间被利用越充,不要设置太大,以免影响其他应用,合适即可
buffers-per-region: 1024 # 每个区分配的buffer数量 , 所以pool的大小是buffer-size * buffers-per-region
direct-buffers: true # 是否分配的直接内存(NIO直接分配的堆外内存)
添加启动类后运行就可以看到控制台中打印如下信息
o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup
o.s.b.w.e.u.UndertowServletWebServer : Undertow started on port(s) 8100 (http) with context path ''
org.example.UndertowServerApplication : Started UndertowServerApplication in 2.727 seconds (JVM running for 3.167)
性能/压力测试
测试结论参考链接 :
https://www.jianshu.com/p/ab78515265f4
https://www.cnblogs.com/maybo/p/7784687.html
https://blog.csdn.net/weixin_38187317/article/details/81532560
压测结论 : 在并发量不高的情况下 , Tomcat与undertow的吞吐量区别不大 , 并发量高的情况下 , undertow的性能要优于Jetty与Tomcat
使用Undertow做文件系统服务器:
Undertow 是基于java nio的web服务器,应用比较广泛,内置提供的PathResourceManager,可以用来直接访问文件系统;如果你有文件需要对外提供访问,除了ftp,nginx等,undertow 也是一个不错的选择,作为java开发,服务搭建非常简便。
package org.example.file;
import java.io.File;
import io.undertow.Handlers;
import io.undertow.Undertow;
import io.undertow.server.HttpHandler;
import io.undertow.server.HttpServerExchange;
import io.undertow.server.handlers.resource.PathResourceManager;
import io.undertow.util.Headers;
public class FileServer {
public static void main(String[] args) {
File file = new File("/");
Undertow server = Undertow
.builder()
.addHttpListener(8080, "localhost")
.setHandler(Handlers.resource(new PathResourceManager(file.toPath(), 100))
.setDirectoryListingEnabled(true))
.build();
// Undertow server2 = Undertow.builder()
// .addHttpListener(8080, "localhost")
// .setHandler(new HttpHandler() {
// @Override
// public void handleRequest(final HttpServerExchange exchange) throws Exception {
// System.out.println("hit "+exchange.getRequestPath());
// exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "text/plain");
// exchange.getResponseSender().send("Hello World");
// }
// }).build();
server.start();
}
}
启动main方法并访问:http://localhost:8080/