高性能非阻塞Web 服务器Undertow

概述

WildFly 8 包含了一个全新的Web服务器（Undertow），WildFly 8 默认的Web服务器为Undertow。一句话概括什么是Undertow - 高性能非阻塞 Web 服务器。Undertow 主要有以下几个特点：

• 轻量化 - Undertow 是一个Web 服务器，但它不像传统的Web 服务器有容器的概念，它由两个核心jar包组成，使用API加载一个Web应用可以使用小于10MB的内存
• HTTP Upgrade 支持 - 设计WildFly时一个重要的考虑因素是在云环境中减少端口数量的需求。在云环境中，一个系统可能运行了几百个甚至几千个WildFly实例。基于HTTP使用HTTP Upgrade可以升级成多种协议，Undertow提供了复用这些协议的能力。
• Web Socket 支持 - 对Web Socket的完全支持，用以满足Web应用现在面对巨大数量的客户端，以及对JSR-356规范的支持
• Servlet 3.1 的支持 - Undertow支持Servlet 3.1，提供了一个机会来构建一个超越Servlet规范、对开发人员非常友好的系统。
• 可嵌套性 - Web 服务器不在需要容器，我们只需要通过API在J2SE代码下快速搭建Web服务

相关链接及快速开始示例

Undertow 社区主页（ http://undertow.io/）：包括Undertow相关的所有新闻，消息。

Undertow 源代码（ https://github.com/undertow-io/）：包括所有Undertow相关的代码

Undertow 快速开始示例（ https://github.com/kylinsoong/wildfly-architecture/tree/master/undertow/quickstart）：包括Undertow 快速开始示例，本示例演示了如何使用Undertow，将Undertow整合到自己的应用中。Undertow编程使用的第一步是添加如下依赖到应用：

		<dependency>
			<groupId>io.undertow</groupId>
			<artifactId>undertow-core</artifactId>
			<version>1.0.0.Final</version>
		</dependency>
		<dependency>
			<groupId>io.undertow</groupId>
			<artifactId>undertow-servlet</artifactId>
			<version>1.0.0.Final</version>
		</dependency>

 使用 软件资料安装和下载章节中所描述方法使用Git下载quickstart应用。下载完成后使用如下命令编译

mvn clean install dependency:copy-dependencies  

编译完成或生成undertow-quickstart.jar包位于target目录下，运行时所有依赖包位于target/dependency目录下。

Undertow Hello World 示例

Undertow是一个高性能非阻塞 Web 服务器，接下来我们演示如何创建一个Web 服务器，如下为HelloWorldServer类代码明细：

public class HelloWorldServer {

	public static void main(String[] args) {
		Undertow server = Undertow.builder().addHttpListener(8080, "localhost").setHandler(new HttpHandler(){

					public void handleRequest(HttpServerExchange exchange)throws Exception {
						exchange.getRequestHeaders().put(Headers.CONTENT_TYPE, "text/plain");
						exchange.getResponseSender().send("Hello World");
					}
				}).build();
		server.start();
	}

}

 通过如下方法可以运行HelloWorldServer：

java -cp target/dependency/*:target/undertow-quickstart.jar org.wildfly.undertow.quickstart.HelloWorldServer

运行后打开浏览器输入 http://localhost:8080，则页面输出“Hello World”字符串。如上面，我们演示Undertow Web 服务器使用异步IO的方式向界面输出字符串。

Undertow 部署Servlet示例

Web 服务器主要是部署运行Web应用，接下来我们演示如何在Undertow 中通过API部署两个Servlet(MyServlet,MessageServlet)，然后分别访问这两个Servlet。两个Servlet代码明细分别如下：

MessageServlet 类代码

public class MessageServlet extends HttpServlet {

	private static final long serialVersionUID = 6861632231065498153L;

    private static final String message = "This is MessageServlet";
    
	protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		doPost(req, resp);
	}

	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		PrintWriter writer = resp.getWriter();
        writer.write(message);
        writer.close();
	}
    
}

MyServlet 类代码

public class MyServlet extends HttpServlet {

	private static final long serialVersionUID = 2378494112650465478L;
	
	private static final String message = "This is MyServlet";

	protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		doPost(req, resp);
	}

	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		PrintWriter writer = resp.getWriter();
        writer.write(message);
        writer.close();
	}
	
}

 接下来我们使用Undertow提供的API，启动Web服务器，部署这两个Servlet，相关的ServletServer类代码如下：

public class ServletServer {
	
	public static final String MYAPP = "/myapp";

	public static void main(String[] args) throws ServletException {
		
		DeploymentInfo servletBuilder = Servlets.deployment().setClassLoader(ServletServer.class.getClassLoader())
				                                             .setContextPath(MYAPP)
				                                             .setDeploymentName("myapp.war")
				                                             .addServlets(Servlets.servlet("MessageServlet", MessageServlet.class).addMappings("/messageServlet")
				                                            		    , Servlets.servlet("MyServlet", MyServlet.class).addMappings("/myServlet"));
		DeploymentManager manager = Servlets.defaultContainer().addDeployment(servletBuilder);
		manager.deploy();
		
		HttpHandler servletHandler = manager.start();
		PathHandler path = Handlers.path(Handlers.redirect(MYAPP)).addPrefixPath(MYAPP, servletHandler);
		
		Undertow server = Undertow.builder().addHttpListener(8080, "localhost").setHandler(path).build();
		server.start();
	}

}

 通过如下方法可以运行ServletServer，运行成功后访问 http://localhost:8080/myapp/messageServlet，页面显示字符串“This is MessageServlet”；访问 http://localhost:8080/myapp/myServlet，页面显示字符串“This is MyServlet”。