WildFly8(JBoss)默認web服務器-------Undertow

Java微服務框架之Undertow

 

一、Undertow簡介:

      Undertow 是紅帽公司（RedHat）的開源產品，是 WildFly8（JBoos） 默認的 Web 服務器。

      官網API給出一句話概述Undertow：

      Undertow is a flexible performant web server written in java, providing both blocking and non-blocking API’s based on NIO.

      譯文： Undertow是一個用java編寫的靈活的高性能Web服務器，提供基於NIO的阻塞和非阻塞API。

      官網API總結特點：

       Lightweight（輕量級）

          Undertow非常輕量級，Undertow核心jar包在1Mb以下。 它在運行時也是輕量級的，有一個簡單的嵌入式服務器使用少於4Mb的堆空間

       HTTP Upgrade Support（支持http升級）

          支持HTTP升級，允許多個協議通過HTTP端口進行多路復用

       Web Socket Support（支持WebScoket）

          Undertow提供對Web Socket的全面支持，包括JSR-356支持

       Servlet 3.1  

           Undertow提供對Servlet 3.1的支持，包括對嵌入式servlet的支持。 還可以在同一部署中混合Servlet和本機Undertow非阻塞處理程序

       Embeddable（可嵌入的）

           Undertow可以嵌入在應用程序中或獨立運行，只需幾行代碼

       6. Flexible（靈活性）

         Undertow框架jar包： undertow-core.jar undertow-servlet.jar

 

二、Undertow示例:

 1.官網給出一個Undertow Web 服務器使用異步IO的方式向界面輸出字符串

import io.undertow.Undertow;
import io.undertow.server.HttpHandler;
import io.undertow.server.HttpServerExchange;
import io.undertow.util.Headers;

public class HelloWorldServer {
   public static void main(String[] args) {
       Undertow server=Undertow.builder()
       .addHttpListener(8080, "localhost").setHandler(new HttpHandler(){//設置HttpHandler的回調方法
            @Override
            public void handleRequest(HttpServerExchange exchange)
                    throws Exception {        
                exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "text/plain");
                exchange.getResponseSender().send("This is my first insert server!");
            }
        }).build();
       server.start();
   }
}

---

   運行后打開瀏覽器輸入 http://localhost:8080 ，則頁面輸出“Hello World”字符串

  2.Undertow來部署Servlet

import io.undertow.Handlers;
import io.undertow.Undertow;
import io.undertow.server.HttpHandler;
import io.undertow.server.handlers.PathHandler;
import io.undertow.servlet.Servlets;
import io.undertow.servlet.api.DeploymentInfo;
import io.undertow.servlet.api.DeploymentManager;
import io.undertow.servlet.api.ServletContainer;
import io.undertow.servlet.api.ServletInfo;

import javax.servlet.ServletException;

import org.wildfly.undertow.quickstart.servlet.MyServlet;

public class ServletServer {
    
       public static void main(String[] args) {
    
        /*
         * 創建ServletInfo，Servelt的最小單位。是對javax.servlet.Servlet具體實現的再次封裝。
         * 注意：ServletInfo的name必須是唯一的
         */
        ServletInfo servletInfo1 = Servlets.servlet("MyServlet",
                MyServlet.class);
        // 創建servletInfo的初始化參數
        servletInfo1.addInitParam("message", "This is my first MyServlet!");
        // 綁定映射為/myServlet
        servletInfo1.addMapping("/myServlet");
        /**
         * 創建包部署對象，包含多個servletInfo。可以認為是servletInfo的集合
         */
        DeploymentInfo deploymentInfo1 = Servlets.deployment();
        // 指定ClassLoader
        deploymentInfo1.setClassLoader(ServletServer.class.getClassLoader());
        // 應用上下文(必須與映射路徑一致，否則sessionId會出現問題，每次都會新建)
        deploymentInfo1.setContextPath("/myapp");
        // 設置部署包名
        deploymentInfo1.setDeploymentName("myServlet.war");
        // 添加servletInfo到部署對象中
        deploymentInfo1.addServlets(servletInfo1);
        /**
         * 使用默認的servlet容器，並將部署添加至容器
         * 容器，用來管理DeploymentInfo，一個容器可以添加多個DeploymentInfo
         */
        ServletContainer container = Servlets.defaultContainer();
        /**
         * 將部署添加至容器並生成對應的容器管理對象
         * 包部署管理。是對添加到ServletContaint中DeploymentInfo的一個引用，用於運行發布和啟動容器
         */
        DeploymentManager manager = container.addDeployment(deploymentInfo1);
        // 實施部署
        manager.deploy();
        /**
         * 分發器：將用戶請求分發給對應的HttpHandler
         */
        PathHandler pathHandler = Handlers.path();
        /**
         * servlet path處理器，DeploymentManager啟動后返回的Servlet處理器。
         */
        HttpHandler myApp=null;
        try {
            //啟動容器，生成請求處理器
            myApp=manager.start();
        } catch (ServletException e) {
            throw new RuntimeException("容器啟動失敗！");
        }
        //綁定映射關系
        pathHandler.addPrefixPath("/myapp", myApp);
        
        Undertow server=Undertow.builder().
                //綁定端口號和主機
                addHttpListener(8081, "localhost")
                //設置分發處理器
                .setHandler(pathHandler).build();
        //啟動server
        server.start();
    }
}

---

自定義MyServlet

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class MyServlet extends HttpServlet {

    private static final long serialVersionUID = 2378494112650465478L;

    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("<p style='color:red;text-align:center;'>"+this.getInitParameter("message")+"</p>");
        writer.close();
    }
    
}

   如下圖，是本人抽象出Undertow生成應用的架構：

---

     示例運行：

     在瀏覽器地址欄里輸入：http://localhost:8081/myapp/myServlet，界面上會顯示ServletInfo的初始化參數message數據

 

---

    Undertow jar包：點擊下載

    Undertow 官網API地址:http://undertow.io/index.html

---