jsoup是一款Java的HTML解析器，可直接解析某個URL地址、HTML文本內(nèi)容。它提供了一套非常省力的API，可通過DOM，CSS以及類似于JQuery的操作方法來取出和操作數(shù)據(jù)。

jsoup的主要功能如下：

從一個URL，文件或字符串中解析HTML；

使用DOM或CSS選擇器來查找、取出數(shù)據(jù)；

可操作HTML元素、屬性、文本；

jsoup是基于MIT協(xié)議發(fā)布的，可放心使用于商業(yè)項目。

更新日志

更改

增加了對 http/2 請求的支持 Jsoup.connect()，當(dāng)在 Java 11+ 上運行時，通過 Java HttpClient 實現(xiàn)。#2257.

在這個版本的jsoup中，默認(rèn)是通過HttpUrlConnection實現(xiàn)來發(fā)送請求：使用 System.setProperty("jsoup.useHttpClient", "true");來改為通過HttpClient發(fā)送請求，這將啟用http/2支持（如果可用）。這將在jsoup的以后版本中成為默認(rèn)設(shè)置，所以現(xiàn)在是一個驗證的好時機。

如果你在部署中重新打包jsoup jar（即創(chuàng)建一個遮罩 jar 或胖 jar），請確保將其指定為 Multi-Release JAR。

如果 HttpClient 在您的 JRE 中不可用，請求將繼續(xù)通過 HttpURLConnection 進(jìn)行 (在 http/1.1 模式下)。

將最低 Android API 級別驗證從 10 更新到 21。與之前的 jsoup 版本一樣，Android 開發(fā)者需要啟用核心庫 desugaring。最低 Java 版本仍然是 Java 8。 #2173

移除了之前已棄用的類：org.jsoup.UncheckedIOException （用java.io.UncheckedIOException替換）； 將之前已棄用的方法Element Element#forEach(Consumer) 移動到 void Element#forEach(Consumer())。#2246

已棄用方法Document#updateMetaCharsetElement(boolean)和Document#updateMetaCharsetElement()，因為該設(shè)置沒有效果。當(dāng)Document#charset(Charset)被調(diào)用時，文檔的meta charset或XML編碼指令總是會被設(shè)置。#2247

改進(jìn)

當(dāng)使用一個Safelist來清理HTML并保持相對鏈接時，isValid()方法現(xiàn)在會認(rèn)為這些鏈接有效。此外，強制屬性rel=nofollow只有在安全列表中配置時才會添加到外部鏈接。#2245

添加了 Element#selectStream(String query) 和 Element#selectStream(Evaluator) 方法，這些方法返回一個 Stream 匹配元素的列表。元素在找到時會被評估并返回，且流可以提前終止。#2092

Element 對象現(xiàn)在實現(xiàn)了 Iterable，使它們能夠在增強的 for 循環(huán)中使用。

增加了從 Reader解析片段的支持 Parser#parseFragmentInput(Reader, Element, String)。#1177

重新引入 CLI 可執(zhí)行文件示例，在 jsoup-examples.jar。 #1702

通過更好地平衡查詢計劃器中祖先評估器的成本函數(shù)，優(yōu)化了選擇器的性能，如#id .class（和其他類似的后代查詢）提高了約4.6倍。#2254

移除了用于<isindex>標(biāo)簽的遺留解析規(guī)則，這些規(guī)則會自動創(chuàng)建一個帶有標(biāo)簽的form元素。這不再在規(guī)范中。

添加了 Elements.selectFirst(String cssQuery) 和 Elements.expectFirst(String cssQuery)，以從 Elements 列表中選擇第一個匹配的元素。 #2263

在使用XML解析器解析時，XML聲明和處理指令是直接處理的，而不是通過HTML解析器的假注釋處理程序。非文檔類型聲明的序列化不再以虛假的!。#2275

在將解析的HTML轉(zhuǎn)換為XML或W3C DOM時，包含<的元素名稱被規(guī)范為_，以確保有效的XML。例如，<foo<bar>變成<foo_bar>，因為XML不允許<在元素名稱中，但HTML5允許。#2276

實現(xiàn)了當(dāng)前規(guī)范的HTML5采用機構(gòu)算法。這處理了錯誤嵌套的格式/結(jié)構(gòu)元素。#2278

錯誤修復(fù)

如果一個元素的屬性名中包含 ;，則無法轉(zhuǎn)換為 W3C DOM 元素，因此后續(xù)的 XPath 查詢可能會忽略該元素。現(xiàn)在，屬性名被更完全地 標(biāo)準(zhǔn)化。#2244

為了兼容性，將文檔類型名稱的內(nèi)部屬性鍵恢復(fù)為“name”。#2241

在Connection中，跳過沒有名字的Cookies，而不是拋出驗證異常。#2242

在運行于 JDK 1.8 時，錯誤java.lang.NoSuchMethodError: java.nio.ByteBuffer.flip()Ljava/nio/ByteBuffer; 可能在從 URL 解析后調(diào)用Response#body()且緩沖區(qū)大小被超過時拋出。#2250

為了向后兼容，允許null InputStream 輸入到Jsoup.parse(InputStream stream, ...)，通過返回一個空的Document。#2252

一個 template 標(biāo)簽包含一個 li 在一個打開的 li 標(biāo)簽內(nèi)，會被解析錯誤，因為它沒有被識別為一個 “特殊” 標(biāo)簽（具有額外的處理規(guī)則）。另外，將 SVG 和 MathML 命名空間標(biāo)簽添加到特殊標(biāo)簽列表中。#2258

一個 template 標(biāo)簽包含一個 button 在一個打開的 button 標(biāo)簽內(nèi)，解析會不正確，因為“在按鈕作用域”檢查沒有意識到 template 元素。修正了其他實例，包括 MathML 和 SVG 元素。#2271

一個:nth-child選擇器的步長為負(fù)且沒有數(shù)字，例如:nth-child(-n+2)，會被解析為一個正步長，因此不會如預(yù)期那樣匹配。#1147

調(diào)用 doc.charset(charset) 在一個空的XML文檔上會拋出一個 IndexOutOfBoundsException. #2266

修復(fù)了在重用嵌套時的內(nèi)存泄漏StructuralEvaluator（例如，選擇器祖先鏈如A B C）通過確保緩存重置調(diào)用傳遞到內(nèi)部成員。#2277

對doc.clone().append(html)的并發(fā)調(diào)用不被支持。當(dāng)克隆一個文檔時，它的Parser沒有被克隆，而是原始解析器的淺拷貝。#2281