使用 Spring Boot 內(nèi)嵌容器 Undertow創(chuàng)建服務(wù)器的方法
Undertow是一個Web服務(wù)器,那么它就需要具備的現(xiàn)代Web服務(wù)器的基本特性,比如Servlet,JSP,文件服務(wù)器,代理服務(wù)器,安全認(rèn)證等。undertow目前已經(jīng)實現(xiàn)了絕大多數(shù)功能,并且因為wildfly通過了JavaEE7 TCK認(rèn)證,所以可以說Undertow是一個通過Servlet 3.1認(rèn)證的Web服務(wù)器和容器。這篇文章只分析Undertow的主干流程上的主要功能,即undertow-core和undertow-servlet。
1、簡介
Undertow是一個非常輕量并高性能的web server,它來自 JBoss。支持blocking和non-blocking兩種NIO API。
由于它是用Java寫的,所以它可以被那些JVM-based 的應(yīng)用通過內(nèi)嵌的方式來使用。甚至JBoss的WilfFly服務(wù)器在內(nèi)部使用Undertow來提高服務(wù)器的性能。
在本文中,我們將介紹Undertow的主要功能并給出使用代碼。
2. 為什么要選擇Undertow?
- 輕量級 :Undertow 是非常小的,只有不到1MB。在內(nèi)嵌模式下,運(yùn)行時只占heap空間的4MB左右。
- Servlet 3.1:完美支持 Servlet 3.1
- Web Socket :支持 Web Socket (包括JSR-356)
- 長連接 :默認(rèn)情況下 ,Undertow 通過添加keep-alive 的response header來支持長連接。它通過重用連接信息(connection details)來改善長連接的性能。
3. 使用Undertow
不多說,讓我們使用Undertow來創(chuàng)建一個簡單的web server吧!
3.1. Maven 依賴
加入如下依賴:
要構(gòu)建一個可運(yùn)行的jar,我們還需要添加一個maven-shade-plugin。像下面這樣:

最新版的Undertow已經(jīng)放到了maven 中央倉庫,隨便玩耍吧。
3.2. 簡單的Server
僅僅需要下面的幾行代碼,就可以創(chuàng)建一個簡單的web server,Undertow的入口使用的是Builder API。

這里我們使用Builder API把server綁定到8080端口上。同時我們使用了lambda表達(dá)式配置了一個handler。你也可以不用lambda表達(dá)式做同樣的事情:

最主要的事情就是這里對HttpHandler API的使用。這個是根據(jù)我們的需要定制Undertow應(yīng)用程序的最重要的武器。
在這里,我們添加了一個自定義的handler,邏輯就是讓每個request都有一個Content-Type: text/plain response header。
同樣的,如果你想讓每個response都返回默認(rèn)的text文本,你可以像下面這樣來定義:

3.3.安全訪問
在大多數(shù)情況下,我們不希望所有的用戶都可以訪問我們的server。通常,只有那些攜帶了合法“護(hù)照”的才可以訪問。在Undertow上,我們同樣可以實現(xiàn)這樣的機(jī)制。
要想實現(xiàn)這個,我們只需要創(chuàng)建一個認(rèn)證管理器,這個管理器會檢查每個請求的用戶信息。
下面我們就來實現(xiàn)一個自定義的IdentityManager:

一旦認(rèn)證mananger被創(chuàng)建,我們需要創(chuàng)建一個“領(lǐng)地”來保存用戶的信息。

這里我們使用了 AuthenticationMode.PRO_ACTIVE,表示每個來到這個server的請求都將會經(jīng)過我們指定的認(rèn)證機(jī)制來踴躍的進(jìn)行認(rèn)證。
如果我們使用了AuthenticationMode.CONSTRAINT_DRIVEN模式,那么只有那些被明確要求過濾的請求才會經(jīng)過認(rèn)證機(jī)制。
現(xiàn)在,我們只需要把保存用戶信息的“領(lǐng)地”和認(rèn)證管理器關(guān)聯(lián)起來就可以了。

截止目前,我們已經(jīng)創(chuàng)建了兩個用戶實例。一旦server啟動了以后,要想訪問,我們就需要使用這個兩個證書才行。



3.4. Web Socket
使用Undertow的WebSocketHttpExchange API創(chuàng)建web socket exchange channel 同樣非常簡單。
下面,我們就打開一個socket通信channel,在/importsourceApp path上:

然后我們就可以創(chuàng)建一個HTML頁面 index.html,然后使用js的WebSocket API來連接到這個channel上了。
3.5. File Server
使用Undertow,我們也可以創(chuàng)建一個文件服務(wù)器(file server),它可以顯示目錄內(nèi)容,并直接從目錄中提供文件:

你甚至都不需要穿件任何UI來顯示目錄。Undertow 為你提供了一個開箱即用的頁面。

4. Spring Boot Plugin
Spring Boot把Undertow也內(nèi)嵌進(jìn)去了,作為繼Tomcat和Jetty之后第三個內(nèi)嵌的servlet 容器。要想在Spring Boot中使用Undertow只需要加下面的依賴就是了:

5. 總結(jié)
在本文中,我們了解了Undertow以及如何使用它創(chuàng)建不同類型的服務(wù)器。
以上所述是小編給大家介紹的Spring Boot 內(nèi)嵌容器 Undertow,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復(fù)大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
相關(guān)文章
Mybatis實戰(zhàn)之TypeHandler高級進(jìn)階
本文主要介紹了自定義的枚舉TypeHandler的相關(guān)知識,具有很好的參考價值,下面跟著小編一起來看下吧2017-02-02
Java+Swing實現(xiàn)經(jīng)典五子棋游戲
五子棋是世界智力運(yùn)動會競技項目之一,是一種兩人對弈的純策略型棋類游戲,是世界智力運(yùn)動會競技項目之一。本文將采用Java Swing實現(xiàn)這一經(jīng)典游戲,需要的可以參考一下2022-01-01
詳解Spring Cloud Hystrix斷路器實現(xiàn)容錯和降級
本篇文章主要介紹了詳解Spring Cloud Hystrix斷路器實現(xiàn)容錯和降級,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-05-05
JAVA 生成隨機(jī)數(shù)并根據(jù)后臺概率靈活生成的實例代碼
本篇文章主要介紹了JAVA 生成隨機(jī)數(shù)并根據(jù)后臺概率靈活生成的實例代碼,具有一定的參考價值,有興趣的可以了解一下2017-08-08
java.lang.Instrument 代理Agent使用詳細(xì)介紹
這篇文章主要介紹了java.lang.Instrument 代理Agent使用詳細(xì)介紹的相關(guān)資料,附有實例代碼,幫助大家學(xué)習(xí)參考,需要的朋友可以參考下2016-11-11
SpringBoot啟動報錯的11個高頻問題排查與解決終極指南
這篇文章主要為大家詳細(xì)介紹了SpringBoot啟動報錯的11個高頻問題的排查與解決,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解一下2025-03-03
Spring?Data?JPA?在?@Query?中使用投影的方法示例詳解
這篇文章主要介紹了Spring?Data?JPA?在?@Query?中使用投影的方法,大家需要注意如果要在 @Query 中使用投影,必須要主動聲明要查詢的字段,并且主動寫明字段的別名才行,本文通過sql代碼給大家介紹的非常詳細(xì),需要的朋友參考下吧2022-07-07

