◆ 作者簡介 ◆

Alex Soto Bueno 是Red Hat的開發者體驗總監，自 2017 年以來一直是 Java Champion。

Jason Porter 是一名首席軟件工程師，在Red Hat從事中間件工程服務、Arquillian、Quarkus 和其他開發者體驗項目。

◆ 譯者簡介 ◆

張曉宇 騰訊雲專家工程師，目前從事騰訊專有雲場景下的雲原生研發工作，曾就職於阿裡雲和中興通訊。同時也是Kubernetes社區和雲原生社區成員，多場KubeCon的演講嘉賓。

劉岩  容器開發工程師，雲原生社區成員，目前從事雲原生應用平臺建設相關的工作，熱衷於雲原生技術。

宋淨超 Tetrate 布道師，雲原生社區創始人，CNCF Ambassador，多本雲原生相關圖書作譯者。

序言1
前言3
第1章 Quarkus概述7
1.1 開發者友好7
1.2 與Kubernetes集成8
1.3 內存和響應時間8
1.4 Quarkus基本工作流程9
第2章 搭建腳手架10
2.1用Maven搭建Quarkus項目的腳手架10
2.2用Gradle搭建Quarkus項目的腳手架12
2.3 用Quarkus Start Coding網站搭建Quarkus項目的腳手架13
2.4 用Visual Studio Code搭建Quarkus項目的腳手架15
2.5 使用開發模式實時重載19
2.6 提供靜態資源20
第3章 開發RESTful服務22
3.1 創建一個簡單的REST API端點22
3.2 提取請求參數24
3.3 使用HTTP響應狀態碼25
3.4 綁定HTTP方法28
3.5 啟用跨源資源共享29
3.6 使用響應式路由30
3.7攔截HTTP請求33
3.8 使用SSL進行安全連接35
第4章 配置37
4.1使用自定義屬性配置應用程序37
4.2 以程序化的方式訪問配置屬性41
4.3 在外部覆蓋配置值41
4.4 使用profile進行配置43
4.5 修改日志配置44
4.6 添加應用程序日志45
4.7 高級日志配置46
4.8 使用自定義profile進行配置49
4.9 創建自定義配置源51
4.10 創建自定義轉換器53
4.11 配置值的分組55
4.12 驗證配置值57
第5章 編程模型59
5.1 對JSON進行編組和解組59
5.2 對XML進行編組和解組62
5.3 校驗輸入值和輸出值65
5.4 創建自定義校驗69
5.5 以程序化的方式校驗對像71
5.6依賴注入73
5.7 創建工廠類75
5.8 執行對像生命周期事件77
5.9 執行應用程序生命周期事件78
5.10 使用命名限定符79
5.11 使用自定義限定符81
5.12 限定和配置注解82
5.13 創建攔截器83
5.14 行為測試85
5.1測試89
5.16 創建mock對像91
5.17使用Mockito創建mock對像92
5.注解將多個注解組合為一個注解94
5.19 在測試代碼前後執行代碼95
5.20測試本地可執行文件101
第6章 打包Quarkus應用程序104
6.1 在命令行模式下運行104
6.2創建一個可運行的JAR文件106
6.3 über-JAR打包108
6.4 構建原生可執行文件108
6.5 為JAR文件構建一個Docker容器110
6.6 為原生可執行文件構建一個Docker容器111
6.7 構建和容器化原生SSL應用程序112
第7章 持久化115
7.1配置數據源115
7.2 使用多個數據源116
7.3 添加數據源的健康檢查117
7.4 定義事務的邊界118
7.5 設置事務的上下文119
7.6 程序化事務控制120
7.7 設置和修改事務超時時間121
7.8 使用persistence.xml122
7.9 不使用persistence.xml122
7.10 使用不同JAR文件的實體123
7.11 用Panache持久化數據123
7.12 用Panache listAll方法查找所有實體條目125
7.13 用Panache findById方法查找單個實體125
7.14 用Panache find和list方法查找實體126
7.15 用Panache count方法獲取實體計數127
7.16 用Panache page方法對實體列表進行分頁127
7.17 用Panache stream方法對結果進行流處理128
7.18 測試Panache實體128
7.19 使用數據訪問對像和repository模式129
7.20 使用Amazon DynamoDB130
7.21 使用MongoDB135
7.22 用Panache連接MongoDB139
7.23 使用Neo4j140
7.24 使用Flyway144
7.25 以程序化的方式使用Flyway145
第8章 容錯146
8.1 自動重試146
8.2 超時148
8.3 使用艙壁模式進行過載保護149
8.4 使用斷路器模式避免故障傳遞151
8.5 禁用容錯功能153
第9章 可觀察性155
9.1 使用自動化健康檢查155
9.2 創建自定義健康檢查157
9.3 暴露指標160
9.4 創建指標162
9.5 使用分布式跟蹤167
9.6 自定義分布式跟蹤173
第10章 與Kubernetes集成176
10.1 構建和推送容器鏡像176
10.2 生成Kubernetes資源179
10.3 生成帶有健康檢查的Kubernetes資源182
10.4 在Kubernetes上部署服務184
10.5 在OpenShift上部署服務185
10.6 自動構建和部署容器鏡像189
10.7 通過Kubernetes配置應用程序190
10.8 使用配置擴展通過Kubernetes配置應用程序192
10.9 以程序化的方式與Kubernetes集群進行交互193
10.10 測試Kubernetes Client交互197
10.11 實現一個Kubernetes Operator198
10.12 用Knative部署和管理無服務器工作負載211
第11章 認證與授權215
11.1 使用Elytron屬性文件配置進行認證和授權219
11.2 使用Elytron Security JDBC配置進行認證和授權222
11.3 使用MicroProfile JWT進行授權226
11.4 使用OpenId Connect進行授權和認證232
11.5 使用OpenId Connect保護網絡資源236
第12章 應用程序密鑰管理237
12.1 使用Kubernetes中的secret存儲數據237
12.2使用Vault安全地存儲配置的secret240
12.3 密碼即服務243
12.4 生成數據庫密碼並存入secret246
12.5 使用Vault Kubernetes Auth進行認證服務250
第13章 Quarkus RE

與傳統的Java框架不同，Quarkus建立在我們已熟知的技術之上。它使用JPA、JAX-RS、Eclipse Vert.x、Eclipse MicroProfile和CDI等一些熟悉的技術，並將這些技術組合到一個緊湊、易於部署、針對OpenJDK Hotspot或GraalVM的Kubernetes優化的容器中。你可以高效地使用Kubernetes集群，在應用程序需要擴展時，限度地利用機器上的資源。無論你處於Kubernetes的什麼階段，都會發現它的用處，本書將為你提供掌握Quarkus所需的工具和資源。
本書目標讀者
顯然，我們希望每個人都能閱讀本書！不過，我們的目標讀者需要：
熟悉Java和應用程序開發。
了解傳統的軟件開發。
經常將服務部署到機器集群或雲中。
寫作原因
Quarkus是一個相對較新的框架，又處於新的領域（原生Java和GraalVM）。我們想深入研究一些互聯網上找不到的例子和實踐。本書中沒有需要理解的大型應用，所有的例子都是自包含的，可以隨時使用。我們希望本書能夠作為Quarkus開發的參考！
閱讀指南
本書的章節組織相對松散，基本順序如下：
第1章和第2章介紹Quarkus和項目的建立。
第3～6章介紹Quarkus的核心部分—使用CDI和Eclipse MicroProfile構建RESTful應用程序。這些章節還將展示如何打包應用程序。
第7～14章將更加深入地介紹一些重要的概念，如容錯、持久性、安全性，以及與其他服務的交互。你還將了解Quarkus與Kubernetes的集成。
第15章和第16章講述使用Quarkus進行響應式編程（reactive programming），以及框架的一些附加功能，如模板、調度和OpenAPI。
排版約定
本書中使用以下排版約定：
斜體（Italic）
表示新的術語、URL、電子郵件地址、文件名和文件擴展名。
等寬字體（Constant width）
用於程序清單，以及段落中素，例如變量名、函數名、數據庫、 數據類型、環境變量、語句以及關鍵字。
等寬粗體（Constant width bold）
表示應由用戶直接輸入的命令或其他文本。
等寬斜體（Constant width italic）
表示應由用戶提供的值或由上下文確定的值替換的文本。
該圖示表示提示或建議。
該圖示表示一般性說明。
該圖示表示警告或注意。
該圖示表示需要記住的要點。
示例代碼
可以從https://oreil.ly/quarkus-cookbook-code下載補充材料（示例代碼、練習等）。
這裡的代碼是為了幫助你更好地理解本書的內容。通常，可以在程序或文檔中使用本書中的代碼，而不需要聯繫O’Reilly獲得許可，除非需要大段地復制代碼。例如，使用本書中所提供的幾個代碼片段來編寫一個程序不需要得到我們的許可，但銷售或發布O’Reilly的示例代碼則需要獲得許可。引用本書的示例代碼來回答問題也不需要許可，將本書中的很大一部分示例代碼放到自己的產品文檔中則需要獲得許可。
非常歡迎讀者使用本書中的代碼，希望（但不強制）注明出處。注明出處的形式包含書名、作者、出版社和ISBN，例如：
Quarkus Cookbook，作者Alex Soto Bueno和 Jason Porter，由O’Reilly出版，書號978-1-492-06265-3
如果讀者覺得對示例代碼的使用超出了上面所給出的許可範圍，歡迎通過permissions@oreilly.com聯繫我們。
O’Reilly在線學習平臺（O’Reilly Online Learning）
40多年來，O’Reilly Media致力於提供技術和商業培訓、知識和卓越見解，來幫助眾多公司取得成功。
我們擁有獨一無二的專家和革新者組成的龐大網絡，他們通過圖書、文章、會議和我們的在線學習平臺分享他們的知識和經驗。O’Reilly的在線學習平臺允許你按需訪問現場培訓課程、深入的學習路徑、交互式編程環境，以及O’Reilly和200多家其他出版商提供的大量文本和視頻資源。有關的更多信息，請訪問http://oreilly.com。
如何聯繫我們
對於本書，如果有任何意見或疑問，請按照以下地址聯繫本書出版商。
美國：
O’Reilly Media，Inc.
1005 Gravenstein Highway North
Sebastopol，CA 95472
中國：
北京市西城區西直門南大街2號成銘大廈C座807室（100035）
奧萊利技術咨詢（北京）有限公司
要詢問技術問題或對本書提出建議，請發送電子郵件至bookquestions@oreilly.com。
本書配套網站https://oreil.ly/quarkus-cookbook上列出了勘誤表、示例以及其他信息。
關於書籍、課程、會議和新聞的更多信息，請訪問我們的網站http://www.oreilly.com。
我們在Facebook上的地址：http://facebook.com/oreilly
我們在Twitter上的地址：http://twitter.com/oreillymedia
我們在YouTube上的地址：http://www.youtube.com/oreillymedia
致謝
Jason Porter：在疫情隔離期間做什麼？當然是寫書了！感謝所有奮戰在醫療一線的勇士。我要感謝Quarkus和GraalVM背後的團隊提供了一個神奇的工具和有趣的開發體驗。我從事軟件開發已經有20多年了，Quarkus給我帶來了像剛開始學習軟件開發時的樂趣。非常感謝Georgios Andrianakis和Daniel Hinojosa對本書的技術審閱，使得本書更易理解、更加實用，希望學習Quarkus的人能夠喜歡。還要感謝Red Hat公司讓我有機會寫作本書。感謝Alex再次邀請我一起寫書。後，感謝我的5個孩子（Kaili、Emily、Zackary、Nicolas和Rebecca）和妻子Tessie。
Alex Soto Bueno：本書是在COVID-19流行期間完成的，所以首先我要感謝所有的醫護人員。還要感謝Red Hat開發者團隊，特別是Burr Sutter，讓我有機會寫作本書。能和Jason一起寫書是我的榮幸。後，感謝我的父母、妻子Jessica，還有女兒Ada和Alexandra。