jsoup?框架的使用小結(jié)
概述
參考:
概念簡(jiǎn)介
jsoup 是一款基于 Java 的 HTML 解析器,它提供了一套非常省力的 API,不但能直接解析某個(gè) URL 地址、HTML 文本內(nèi)容,而且還能通過(guò)類似于 DOM、CSS 或者 jQuery 的方法來(lái)操作數(shù)據(jù),所以 jsoup 也可以被當(dāng)做爬蟲(chóng)工具使用。
jsoup 實(shí)現(xiàn) WHATWG HTML5 規(guī)范,并將 HTML 解析為與現(xiàn)代瀏覽器相同的 DOM。
- 從 URL,文件或字符串中提取并解析 HTML
- 查找和提取數(shù)據(jù),使用 DOM 遍歷或 CSS 選擇器
- 操縱 HTML元素,屬性和文本
- 根據(jù)安全的白名單清理用戶提交的內(nèi)容,以防止 XSS 攻擊
- 輸出整潔的 HTML
相關(guān)概念簡(jiǎn)介
- Document :文檔對(duì)象
- 每份 HTML 頁(yè)面都是一個(gè)文檔對(duì)象,Document 是 jsoup 體系中最頂層的結(jié)構(gòu)。
- Element:元素對(duì)象。
- 一個(gè) Document 中可以著包含著多個(gè) Element 對(duì)象,可以使用 Element 對(duì)象來(lái)遍歷節(jié)點(diǎn)提取數(shù)據(jù)或者直接操作 HTML。
- Elements:元素對(duì)象集合,類似于
List<Element>。 - Node:節(jié)點(diǎn)對(duì)象。
- 標(biāo)簽名稱、屬性等都是節(jié)點(diǎn)對(duì)象,節(jié)點(diǎn)對(duì)象用來(lái)存儲(chǔ)數(shù)據(jù)。
- 類繼承關(guān)系:Document 繼承自 Element ,Element 繼承自 Node。
- 一般執(zhí)行流程:先獲取 Document 對(duì)象,然后獲取 Element 對(duì)象,最后再通過(guò) Node 對(duì)象獲取數(shù)據(jù)。

依賴
<dependency>
<groupId>org.jsoup</groupId>
<artifactId>jsoup</artifactId>
<version>1.15.4</version>
</dependency>jsoup 的主要類
雖然完整的類庫(kù)中有很多類,但大多數(shù)情況下,需要重點(diǎn)了解下面給出3 個(gè)類即可
org.jsoup.Jsoup 類
Jsoup 類是任何 Jsoup 程序的入口點(diǎn),并將提供從各種來(lái)源加載和解析 HTML 文檔的方法。
Jsoup 類的一些重要方法如下:
// 創(chuàng)建并返回URL的連接。 static Connection connect(String url) // 將指定的字符集文件解析成文檔。 static Document parse(File in, String charsetName) // 將給定的html代碼解析成文檔。 static Document parse(String html) // 從本地文件中加載文檔對(duì)象 static Document parse(File in, String charsetName) // 從輸入 HTML 返回安全的 HTML,通過(guò)解析輸入 HTML 并通過(guò)允許的標(biāo)簽和屬性的白名單進(jìn)行過(guò)濾。 static String clean(String bodyHtml, Whitelist whitelist)
org.jsoup.nodes.Document 類
該類表示通過(guò) Jsoup 庫(kù)加載 HTML 文檔。
可以使用此類執(zhí)行適用于整個(gè) HTML 文檔的操作。
org.jsoup.nodes.Element 類
HTML 元素是由標(biāo)簽名稱,屬性和子節(jié)點(diǎn)組成。 使用 Element 類,可以提取數(shù)據(jù),遍歷節(jié)點(diǎn)和操作 HTML。
注:繼承關(guān)系為 Document extends Element extends Node
API
Jsoup 類
Jsoup 類的一些重要方法如下:
// 創(chuàng)建并返回URL的連接。 static Connection connect(String url) // 將指定的字符集文件解析成文檔。 static Document parse(File in, String charsetName) // 將給定的html代碼解析成文檔。 static Document parse(String html) // 從本地文件中加載文檔對(duì)象 static Document parse(File in, String charsetName) // 從輸入 HTML 返回安全的 HTML,通過(guò)解析輸入 HTML 并通過(guò)允許的標(biāo)簽和屬性的白名單進(jìn)行過(guò)濾。 static String clean(String bodyHtml, Whitelist whitelist)
Connection 接口
// 將請(qǐng)求作為GET執(zhí)行,并解析結(jié)果 Document get() throws IOException; // 將請(qǐng)求作為POST執(zhí)行,并解析結(jié)果。 Document post() throws IOException; // 執(zhí)行請(qǐng)求。獲取內(nèi)容包含響應(yīng)碼等 Connection.Response execute() throws IOException; // 將請(qǐng)求方法設(shè)置為使用GET或POST。默認(rèn)為GET Connection method(Connection.Method method); // 創(chuàng)建一個(gè)新請(qǐng)求,使用此Connection作為會(huì)話狀態(tài)并初始化連接設(shè)置(然后可以獨(dú)立于返回的Connection.request對(duì)象) Connection newRequest(); // 設(shè)置要提取的請(qǐng)求URL。協(xié)議必須是HTTP或HTTPS Connection url(URL url); Connection url(String url); // 設(shè)置頭部信息 Connection header(String name, String value); Connection headers(Map<String, String> headers); // 發(fā)出請(qǐng)求的用戶信息 Connection userAgent(String userAgent); // 先前網(wǎng)頁(yè)的地址,當(dāng)前請(qǐng)求網(wǎng)頁(yè)緊隨其后,即來(lái)路 Connection referrer(String referrer); // 設(shè)置用于此請(qǐng)求的HTTP代理。設(shè)置為null禁用以前設(shè)置的代理。 Connection proxy(Proxy proxy); Connection proxy(String host, int port); // 設(shè)置總請(qǐng)求超時(shí)時(shí)間。如果發(fā)生超時(shí)SocketTimeoutException將被拋出。默認(rèn)超時(shí)為30秒(30000ms)。零超時(shí)被視為無(wú)限超時(shí)。 // 注意,此超時(shí)指定連接時(shí)間和讀取完整響應(yīng)時(shí)間的組合最長(zhǎng)持續(xù)時(shí)間 Connection timeout(int millis); // 在關(guān)閉連接和截?cái)噍斎胫?,設(shè)置從(未壓縮)連接讀取到正文的最大字節(jié)數(shù)(即正文內(nèi)容將被修剪)。 // 默認(rèn)最大值為2MB。最大大小為0被視為無(wú)限量(僅受機(jī)器上可用內(nèi)存的限制)。 Connection maxBodySize(int bytes); // 設(shè)置是否遵循服務(wù)器重定向的連接。默認(rèn)為true Connection followRedirects(boolean followRedirects); // 將連接配置為在發(fā)生HTTP錯(cuò)誤時(shí)不引發(fā)異常(4xx-5xx,例如404或500)。默認(rèn)為false;,如果遇到錯(cuò)誤,將引發(fā)IOException。 // 如果設(shè)置為true,響應(yīng)將填充錯(cuò)誤正文,狀態(tài)消息將反映錯(cuò)誤。 Connection ignoreHttpErrors(boolean ignoreHttpErrors); // 分析響應(yīng)時(shí)忽略文檔的Content-Type。默認(rèn)為false,未識(shí)別的內(nèi)容類型將引發(fā)IOException。(例如,為了防止試圖解析JPEG二進(jìn)制圖像而產(chǎn)生垃圾。)設(shè)置為true可強(qiáng)制解析嘗試,而不管內(nèi)容類型如何。 Connection ignoreContentType(boolean ignoreContentType); // 設(shè)置自定義SSL套接字工廠 Connection sslSocketFactory(SSLSocketFactory var1); // 添加請(qǐng)求數(shù)據(jù)參數(shù)。請(qǐng)求參數(shù)在GET的請(qǐng)求查詢字符串中發(fā)送,在POST的請(qǐng)求正文中發(fā)送。一個(gè)請(qǐng)求可能有多個(gè)同名值。 Connection data(String key, String value); // 添加輸入流作為請(qǐng)求數(shù)據(jù)參數(shù)。 Connection data(String key, String filename, InputStream inputStream); // 添加輸入流作為請(qǐng)求數(shù)據(jù)參數(shù)。對(duì)于GET,沒(méi)有影響,但對(duì)于POST,這將上載輸入流。filename為文件名,不是路徑 Connection data(String key, String filename, InputStream InputStream, String contentType); Connection data(Collection<Connection.KeyVal> data); Connection data(Map<String, String> data); Connection data(String... keyvals); // 獲取此密鑰的數(shù)據(jù)KeyVal(如果有) Connection.KeyVal data(String var1); // 設(shè)置要在請(qǐng)求中發(fā)送的cookie Connection cookie(String name, String value); Connection cookies(Map<String, String> cookies); // 獲取此連接使用的cookie存儲(chǔ) Connection cookieStore(CookieStore cookieStore); // 提供自定義或預(yù)先填充的CookieStore,用于此連接發(fā)出的請(qǐng)求。 CookieStore cookieStore(); // 提供在分析文檔響應(yīng)時(shí)使用的備用解析器 Connection parser(Parser parser); // 設(shè)置請(qǐng)求的數(shù)據(jù)字符集,默認(rèn)x-www-form-urlencoded Connection postDataCharset(String charset); // 設(shè)置連接請(qǐng)求 Connection request(Connection.Request var1); // 設(shè)置POST(或PUT)請(qǐng)求主體 Connection requestBody(String body); // 獲取與此連接關(guān)聯(lián)的請(qǐng)求對(duì)象 Connection.Request request(); // 設(shè)置連接的響應(yīng) Connection response(Connection.Response response); // 執(zhí)行請(qǐng)求后,獲取響應(yīng)。 Connection.Response response();
Element(元素)類
org.jsoup.nodes.Element extends Node
Elements 對(duì)象提供了一系列類似于 DOM 的方法來(lái)查找元素,抽取并處理其中的數(shù)據(jù)。
查找元素
// 通過(guò) id 來(lái)查找元素
public Element getElementById(String id)
// 通過(guò)標(biāo)簽來(lái)查找元素
public Elements getElementsByTag(String tag)
// 通過(guò)類選擇器來(lái)查找元素
public Elements getElementsByClass(String className)
// 通過(guò)屬性名稱來(lái)查找元素,例如查找?guī)в?href 元素的標(biāo)簽
public Elements getElementsByAttribute(String key)
// 獲取兄弟元素。如果元素沒(méi)有兄弟元素,則返回一個(gè)空列表
public Elements siblingElements()
// 獲取第一個(gè)兄弟元素
public Element firstElementSibling()
// 獲取最后一個(gè)兄弟元素
public Element lastElementSibling()
// 獲取下一個(gè)兄弟元素
public Element nextElementSibling()
// 獲取上一個(gè)兄弟元素
public Element previousElementSibling()
// 獲取此節(jié)點(diǎn)的父節(jié)點(diǎn)
public Element parent()
// 獲取此節(jié)點(diǎn)的所有子節(jié)點(diǎn)
public Elements children()
// 獲取此節(jié)點(diǎn)的指定子節(jié)點(diǎn)
public Element child(int index)
// 使用 CSS 選擇器查找元素
public Elements select(String cssQuery)獲取元素?cái)?shù)據(jù)
在獲得文檔對(duì)象并且指定查找元素后,就可以獲取元素中的數(shù)據(jù)。
注:這些訪問(wèn)器方法都有相應(yīng)的 setter 方法來(lái)更改數(shù)據(jù)。
// 獲取單個(gè)屬性值 public String attr(String key) // 獲取所有屬性值 public Attributes attributes() // 設(shè)置屬性值 public Element attr(String key, String value) // 獲取文本內(nèi)容 public String text() // 設(shè)置文本內(nèi)容 public Element text(String value) // 獲取元素內(nèi)的 HTML 內(nèi)容 public String html() // 設(shè)置元素內(nèi)的 HTML 內(nèi)容 public Element html(String value) // 獲取元素外 HTML 內(nèi)容 public String outerHtml() // 獲取數(shù)據(jù)內(nèi)容(例如:script 和 style 標(biāo)簽) public String data() // 獲得 id 值(例如:<p id="goods">衣服</p>) public String id() // 檢查這個(gè)元素是否含有一個(gè)類選擇器(不區(qū)分大小寫(xiě)) public boolean hasClass(String className) // 獲得第一個(gè)類選擇器值 public String className() // 獲得所有的類選擇器值 public Set<String>classNames() // 獲取元素標(biāo)簽 public Tag tag() // 獲取元素標(biāo)簽名(例如:`<p>`、`<div>` 等) public String tagName()
修改數(shù)據(jù)
在解析了一個(gè) Document 對(duì)象之后,可能想修改其中的某些屬性值,并把它輸出到前臺(tái)頁(yè)面或保存到其他地方,jsoup 對(duì)此提供了一套非常簡(jiǎn)便的接口(支持鏈?zhǔn)綄?xiě)法)。
設(shè)置屬性的值
以下方法當(dāng)針對(duì) Element 對(duì)象操作時(shí),只有一個(gè)元素會(huì)受到影響。當(dāng)針對(duì) Elements 對(duì)象進(jìn)行操作時(shí),可能會(huì)影響到多個(gè)元素。
// 設(shè)置標(biāo)簽的屬性值 public Element attr(String key, String value) // 刪除標(biāo)簽 public Element removeAttr(String key) // 增加類選擇器選項(xiàng) public Element addClass(String className) // 刪除對(duì)應(yīng)的類選擇器 public Element removeClass(String className)
代碼示例:
Document doc = Jsoup.connect("http://csdn.com").get();
// 復(fù)數(shù),Elements
Elements elements = doc.getElementsByClass("text");
// 單數(shù),Element
Element element = elements.first();
// 復(fù)數(shù)對(duì)象,所有 class="text" 的元素都將受到影響
elements.attr("name","goods");
// 單數(shù)對(duì)象,只有一個(gè)元素會(huì)受到影響(鏈?zhǔn)綄?xiě)法)
element.attr("name","shop").addClass("red");修改元素的 HTML 內(nèi)容
可以使用 Element 中的 HTML 設(shè)置方法,具體如下:
// 在末尾追加 HTML 內(nèi)容 public Element append(String html) // 在開(kāi)頭追加 HTML 內(nèi)容 public Element prepend(String html) // 在匹配元素內(nèi)部添加 HTML 文本。這個(gè)方法將先清除元素中的 HTML 內(nèi)容,然后用傳入的 HTML 代替 public Element html(String value) // 對(duì)元素包裹一個(gè)外部 HTML 內(nèi)容,將元素置于新增的內(nèi)容中間 public Element wrap(String value)
示例代碼:
Document doc = Jsoup.connect("http://csdn.com").get();
Element div = doc.select("div").first();
div.html("<p>csdn</p>");
div.prepend("<p>a</p>");
div.append("<p>good</p>");
// 輸出:<div"> <p>a</p> <p>csdn</p> <p>good</p> </div>
Element span = doc.select("span").first();
span.wrap("<li><a href='...'></a></li>");
// 輸出: <li><a href="..."> <span>csdn</span> </a></li>修改元素的文本內(nèi)容
對(duì)于傳入的文本,如果含有像 <, > 等這樣的字符,將以文本處理,而非 HTML。
// 清除元素內(nèi)部的 HTML 內(nèi)容,然后用提供的文本代替 public Element text(String text) // 在元素后添加文本節(jié)點(diǎn) public Element prepend(String first) // 在元素前添加文本節(jié)點(diǎn) public Element append(String last)
示例代碼:
// <div></div>
Element div = doc.select("div").first();
div.text(" one ");
div.prepend(" two ");
div.append(" three ");
// 輸出: <div> two one three </div>基本使用
獲取文檔(Document)
獲得文檔對(duì)象 Document 一共有 4 種方法,分別對(duì)應(yīng)不同的獲取方式。
從URL中加載文檔對(duì)象(常用)
使用 Jsoup.connect(String url).get() 方法獲?。ㄖ恢С?http 和 https 協(xié)議):
Document doc = Jsoup.connect("http://csdn.com/").get();
String title = doc.title();connect(String url)方法創(chuàng)建一個(gè)新的 Connection 并通過(guò).get()或者.post()方法獲得數(shù)據(jù)。- 如果從該URL獲取 HTML 時(shí)發(fā)生錯(cuò)誤,便會(huì)拋出 IOException,應(yīng)適當(dāng)處理。
Connection 接口還提供一個(gè)方法鏈來(lái)解決特殊請(qǐng)求,可以在發(fā)送請(qǐng)求時(shí)帶上請(qǐng)求的頭部參數(shù)。示例代碼:
Document doc = Jsoup.connect("http://csdn.com")
.data("query", "Java")
.userAgent("Mozilla")
.cookie("auth", "token")
.timeout(8000)
.post();可以使用 execute() 方法獲得完整的響應(yīng)對(duì)象和響應(yīng)碼:
// 獲得響應(yīng)對(duì)象
Connection.Response response = Jsoup.connect("http://csdn.com").execute();
// 獲取狀態(tài)碼
int code = response.statusCode();從本地文件中加載文檔對(duì)象
可以使用靜態(tài)的 Jsoup.parse(File in, String charsetName) 方法從文件中加載文檔。其中 in 表示路徑,charsetName 表示編碼方式。示例代碼:
File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8");從字符串文本中加載文檔對(duì)象
使用靜態(tài)的 Jsoup.parse(String html) 方法可以從字符串文本中獲得文檔對(duì)象 Document 。示例代碼:
String html = "<html><head><title>First parse</title></head>" + "<body><p>Parsed HTML into a doc.</p></body></html>"; Document doc = Jsoup.parse(html);
從 <body> 片斷中獲取文檔對(duì)象
使用 Jsoup.parseBodyFragment(String html) 方法,示例代碼:
String html = "<p>Lorem ipsum.</p>"; Document doc = Jsoup.parseBodyFragment(html); // doc 此時(shí)為:<body> <p>Lorem ipsum.</p></body> Element body = doc.body();
- parseBodyFragment 方法創(chuàng)建一個(gè)新的文檔,并插入解析過(guò)的 HTML 到 body 元素中。
- 雖然使用正常的 Jsoup.parse(String html) 方法,通常也能得到相同的結(jié)果,但是明確將用戶輸入作為 body 片段處理是個(gè)更好的方式。
- Document.body() 方法能夠取得文檔 body 元素的所有子元素,與 doc.getElementsByTag(“body”) 相同。
解析文檔對(duì)象并獲取數(shù)據(jù)一共有 2 種方式,分別為 DOM方式、CSS 選擇器方式,可以選擇一種自己喜歡的方式去獲取數(shù)據(jù),效果一樣。
DOM 方式
將 HTML 解析成一個(gè) Document 之后,就可以使用類似于 DOM 的方法進(jìn)行操作。
常用方法詳見(jiàn) Element(元素)類 API
示例代碼:
// 獲取 csdn 首頁(yè)所有的鏈接
Document doc = Jsoup.connect("http://csdn.com").get();
Elements elements = doc.getElementsByTag("body");
Elements contents = elements.first().getElementsByTag("a");
for (Element content : contents) {
String linkHref = content.attr("href");
String linkText = content.text();
}CSS 選擇器方式
可以使用類似于 CSS 選擇器的語(yǔ)法來(lái)查找和操作元素,常用的方法為 select(String cssQuery)
示例代碼:
Document doc = Jsoup.connect("http://csdn.com").get();
// 獲取帶有 href 屬性的 a 元素
Elements elements = doc.select("a[href]");
for (Element content : elements) {
String linkHref = content.attr("href");
String linkText = content.text();
}select()方法在Document、Element或Elements對(duì)象中都可以使用,而且是上下文相關(guān)的,因此可實(shí)現(xiàn)指定元素的過(guò)濾,或者采用鏈?zhǔn)皆L問(wèn)。select()方法將返回一個(gè)Elements集合,并提供一組方法來(lái)抽取和處理結(jié)果。
select(String cssQuery) 方法參數(shù)簡(jiǎn)介
tagname:通過(guò)標(biāo)簽查找元素,例如通過(guò) “a” 來(lái)查找<a>標(biāo)簽。#id:通過(guò) ID 查找元素,比如通過(guò)#logo查找<p id="logo">.class:通過(guò) class 名稱查找元素,比如通過(guò).titile查找<p class="titile">ns|tag:通過(guò)標(biāo)簽在命名空間查找元素,比如使用fb|name來(lái)查找<fb:name>[attribute]:利用屬性查找元素,比如通過(guò)[href]查找<a href="...">[^attribute]:利用屬性名前綴來(lái)查找元素,比如:可以用[^data-]來(lái)查找?guī)в?HTML5 dataset屬性的元素[attribute=value]:利用屬性值來(lái)查找元素,比如:[width=500][attribute^=value],[attribute$=value],[attribute*=value]:利用匹配屬性值開(kāi)頭、結(jié)尾或包含屬性值來(lái)查找元素,比如通過(guò)[href*=/path/]來(lái)查找<a href="a/path/c.html">[attribute~=regex]:利用屬性值匹配正則表達(dá)式來(lái)查找元素- 比如通過(guò)
img[src~=(?i)\.(png|jpe?g)]來(lái)匹配所有的png 或者 jpg、jpeg 格式的圖片 *:通配符,匹配所有元素
參數(shù)屬性組合使用
el#id:元素 + ID,比如:div#logoel.class:元素 + class,比如:div.mastheadel[attr]:元素 + class,比如:a[href]匹配所有帶有 href 屬性的 a 元素- 任意組合,比如:
a[href].highlight匹配所有帶有 href 屬性且 class=“highlight” 的 a 元素。 ancestor child:查找某個(gè)元素下子元素- 比如:可以用
.body p查找在 “body” 元素下的所有 p 元素 parent > child:查找某個(gè)父元素下的直接子元素- 比如:可以用
div.content > p查找p元素,也可以用body > *查找 body 標(biāo)簽下所有直接子元素 siblingA + siblingB:查找在 A 元素之前第一個(gè)同級(jí)元素 B,比如:div.head + divsiblingA ~ siblingX:查找 A 元素之前的同級(jí) X 元素,比如:h1 ~ pel, el, el:多個(gè)選擇器組合,查找匹配任一選擇器的唯一元素,例如:div.masthead, div.logo
特殊參數(shù):偽選擇器
:lt(n):查找哪些元素的同級(jí)索引值(它的位置在 DOM 樹(shù)中是相對(duì)于它的父節(jié)點(diǎn))小于 n- 比如:
td:lt(3)表示小于三列的元素 :gt(n):查找哪些元素的同級(jí)索引值大于n,比如:div p:gt(2)表示哪些 div 中有包含 2 個(gè)以上的 p 元素:eq(n):查找哪些元素的同級(jí)索引值與n相等,比如:form input:eq(1)表示包含一個(gè) input 標(biāo)簽的 Form元素:has(seletor):查找匹配選擇器包含元素的元素,比如:div:has(p)表示哪些 div 包含了 p 元素:not(selector):查找與選擇器不匹配的元素,比如:div:not(.logo)表示不包含 class=logo 元素的所有 div 列表:contains(text):查找包含給定文本的元素,搜索不區(qū)分大不寫(xiě),比如:p:contains(jsoup):containsOwn(text):查找直接包含給定文本的元素(不包含任何它的后代):matches(regex):查找哪些元素的文本匹配指定的正則表達(dá)式,比如:div:matches((?i)login):matchesOwn(regex):查找直接包含文本匹配指定正則表達(dá)式的元素(不包含任何它的后代)
注意:上述偽選擇器索引是從 0 開(kāi)始的,即第一個(gè)元素索引值為 0,第二個(gè)元素 index 為 1 等
其他功能
一些常用數(shù)據(jù)的獲取
從 HTML 獲取標(biāo)題
Document document = Jsoup.parse( new File("C:/Users/xyz/Desktop/yiibai-index.html"), "utf-8");
System.out.println(document.title());獲取 HTML 頁(yè)面的 Fav 圖標(biāo)
假設(shè) favicon 圖像將是 HTML 文檔的 <head> 部分中的第一個(gè)圖像
String favImage = "Not Found";
try {
Document document = Jsoup.parse(new File("C:/Users/zkpkhua/Desktop/yiibai-index.html"), "utf-8");
Element element = document.head().select("link[href~=.*\\.(ico|png)]").first();
if (element == null) {
element = document.head().select("meta[itemprop=image]").first();
if (element != null) {
favImage = element.attr("content");
}
} else {
favImage = element.attr("href");
}
} catch (IOException e) {
e.printStackTrace();
}
System.out.println(favImage);獲取 HTML 頁(yè)面中的所有鏈接
try {
Document document = Jsoup.parse(new File("C:/Users/zkpkhua/Desktop/yiibai-index.html"), "utf-8");
Elements links = document.select("a[href]");
for (Element link : links) {
System.out.println("link : " + link.attr("href"));
System.out.println("text : " + link.text());
}
} catch (IOException e) {
e.printStackTrace();
}獲取 HTML 頁(yè)面中的所有圖像
try {
Document document = Jsoup.parse(new File("C:/Users/zkpkhua/Desktop/yiibai-index.html"), "utf-8");
Elements images = document.select("img[src~=(?i)\\.(png|jpe?g|gif)]");
for (Element image : images) {
System.out.println("src : " + image.attr("src"));
System.out.println("height : " + image.attr("height"));
System.out.println("width : " + image.attr("width"));
System.out.println("alt : " + image.attr("alt"));
}
} catch (IOException e) {
e.printStackTrace();
}獲取 URL 的元信息
元信息包括 Google 等搜索引擎用來(lái)確定網(wǎng)頁(yè)內(nèi)容的索引為目的。它們以 HTM L頁(yè)面的 HEAD 部分中的一些標(biāo)簽的形式存在。
try {
Document document = Jsoup.parse(new File("C:/Users/zkpkhua/Desktop/yiibai-index.html"), "utf-8");
String description = document.select("meta[name=description]").get(0).attr("content");
System.out.println("Meta description : " + description);
String keywords = document.select("meta[name=keywords]").first().attr("content");
System.out.println("Meta keyword : " + keywords);
} catch (IOException e) {
e.printStackTrace();
}在 HTML 頁(yè)面中獲取表單屬性
在網(wǎng)頁(yè)中獲取表單輸入元素非常簡(jiǎn)單。 使用唯一 ID 查找 FORM 元素; 然后找到該表單中存在的所有 INPUT 元素。
Document doc = Jsoup.parse(new File("c:/temp/yiibai-index.html"),"utf-8");
Element formElement = doc.getElementById("loginForm");
Elements inputElements = formElement.getElementsByTag("input");
for (Element inputElement : inputElements) {
String key = inputElement.attr("name");
String value = inputElement.attr("value");
System.out.println("Param name: " + key + " \nParam value: " + value);
}相對(duì)路徑轉(zhuǎn)絕對(duì)路徑
- 在 HTML 元素中,URLs 經(jīng)常寫(xiě)成相對(duì)于文檔位置的相對(duì)路徑,如:
<a href="/download">...</a>。
當(dāng)使用 .attr(String key) 方法來(lái)取得 a 元素的 href 屬性時(shí),它將直接返回在 HTML 源碼中指定的值。
- 如果需要取得一個(gè)絕對(duì)路徑,有兩種方式:
- 方式1:在屬性名前加
abs:前綴,就可以返回包含根路徑的 URL 地址attr("abs:href") - 方式2:使用 absUrl(String key) 方法
- 方式1:在屬性名前加
示例場(chǎng)景
問(wèn)題描述:
有一個(gè)包含相對(duì) URLs 路徑的 HTML 文檔,現(xiàn)在需要將這些相對(duì)路徑轉(zhuǎn)換成絕對(duì)路徑的URLs
解決方式:
- 確保在解析文檔時(shí)有指定
base URI路徑。 - 然后使用
abs:屬性前綴來(lái)取得包含base URI的絕對(duì)路徑。
示例代碼:
Document doc = Jsoup.connect("http://www.open-open.com").get();
Element link = doc.select("a").first();
String relHref = link.attr("href");
// 輸出:/
String absHref = link.attr("abs:href");
// 輸出:http://www.open-open.com/消除不受信任的HTML (防止XSS攻擊)
- 假設(shè)在應(yīng)用程序中,想顯示用戶提交的 HTML 片段。
例如用戶可以在評(píng)論框中放入 HTML 內(nèi)容。 這可能會(huì)導(dǎo)致非常嚴(yán)重的問(wèn)題,如果允許直接顯示此 HTML。 用戶可以在其中放入一些惡意腳本,并將用戶重定向到另一個(gè)臟網(wǎng)站。
- 為了清理這個(gè) HTML,Jsoup 提供
Jsoup.clean()方法。
此方法期望 HTML 格式的字符串,并將返回清潔的 HTML。
要執(zhí)行此任務(wù),Jsoup 使用白名單過(guò)濾器。 jsoup 白名單過(guò)濾器通過(guò)解析輸入 HTML(在安全的沙盒環(huán)境中)工作,然后遍歷解析樹(shù),只允許將已知安全的標(biāo)簽和屬性(和值)通過(guò)清理后輸出。
它不使用正則表達(dá)式,這對(duì)于此任務(wù)是不合適的。
清潔器不僅用于避免 XSS,還限制了用戶可以提供的元素的范圍:可以使用文本,強(qiáng)元素,但不能構(gòu)造 div 或表元素。
示例場(chǎng)景
- 問(wèn)題描述:
在某些網(wǎng)站中經(jīng)常會(huì)提供用戶評(píng)論的功能,但是有些不懷好意的用戶,會(huì)搞一些腳本到評(píng)論內(nèi)容中,而這些腳本可能會(huì)破壞整個(gè)頁(yè)面的行為,更嚴(yán)重的是獲取一些機(jī)要信息,此時(shí)需要清理該 HTML,以避免跨站腳本攻擊(XSS)。
- 解決方式:
使用 clean() 方法清除惡意代碼,但需要指定一個(gè)配置的 Safelist(舊版本中是 Whitelist),通常使用 Safelist.basic() 即可。
Safelist 的工作原理是將輸入的 HTML 內(nèi)容單獨(dú)隔離解析,然后遍歷解析樹(shù),只允許已知的安全標(biāo)簽和屬性輸出。
示例代碼:
String unsafe = "<p><a οnclick='attack()'>Link</a></p>";
String safe = Jsoup.clean(unsafe, Safelist.basic());
// 輸出: <p><a >Link</a></p>注:
jsoup 的 Safelist 不僅能夠在服務(wù)器端對(duì)用戶輸入的 HTML 進(jìn)行過(guò)濾,只輸出一些安全的標(biāo)簽和屬性,還可以限制用戶可以輸入的標(biāo)簽范圍。
jsoup 使用代理
示例代碼:
Connection.Response execute = Jsoup.connect("http://csdn.net/")
.proxy("12.12.12.12", 1080) // 使用代理
.execute();到此這篇關(guān)于jsoup 框架的使用小結(jié)的文章就介紹到這了,更多相關(guān)jsoup使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
每天練一練Java函數(shù)與算法Math函數(shù)總結(jié)與字符串轉(zhuǎn)換整數(shù)
這篇文章主要介紹了Java函數(shù)與算法Math函數(shù)總結(jié)與字符串轉(zhuǎn)換整數(shù),每天練一練,水平在不知不覺(jué)中提高,需要的朋友快過(guò)來(lái)看看吧2021-08-08
java圖片滑動(dòng)驗(yàn)證(登錄驗(yàn)證)原理與實(shí)現(xiàn)方法詳解
這篇文章主要介紹了java圖片滑動(dòng)驗(yàn)證(登錄驗(yàn)證)原理與實(shí)現(xiàn)方法,結(jié)合實(shí)例形式詳細(xì)分析了java圖片滑動(dòng)登錄驗(yàn)證的相關(guān)原理、實(shí)現(xiàn)方法與操作技巧,需要的朋友可以參考下2019-09-09
Springcloud Alibaba超詳細(xì)使用詳解
SpringCloudAlibaba是一款優(yōu)秀的微服務(wù)架構(gòu),在市面上有著廣泛的應(yīng)用,這篇文章介紹了SpringCloudAlibaba的一些基本使用,適合初學(xué)者,希望能夠給大家?guī)?lái)幫助2024-08-08
springboot配置項(xiàng)目啟動(dòng)后自動(dòng)打開(kāi)瀏覽器訪問(wèn)項(xiàng)目方式
這篇文章主要介紹了springboot配置項(xiàng)目啟動(dòng)后自動(dòng)打開(kāi)瀏覽器訪問(wèn)項(xiàng)目方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-01-01
Java-Redis-Redisson分布式鎖的功能使用及實(shí)現(xiàn)
這篇文章主要介紹了Java-Redis-Redisson-分布式鎖的功能使用及實(shí)現(xiàn),本文通過(guò)實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2022-08-08
Java子類對(duì)象的實(shí)例化過(guò)程分析
這篇文章主要介紹了Java子類對(duì)象的實(shí)例化過(guò)程,結(jié)合具體實(shí)例形式分析了java子類對(duì)象的實(shí)例化的步驟、原理、實(shí)現(xiàn)方法,需要的朋友可以參考下2019-09-09
SpringBoot如何使用MyBatisPlus逆向工程自動(dòng)生成代碼
本文介紹如何使用SpringBoot、MyBatis-Plus進(jìn)行逆向工程自動(dòng)生成代碼,并結(jié)合Swagger3.0實(shí)現(xiàn)API文檔的自動(dòng)生成和訪問(wèn),通過(guò)詳細(xì)步驟和配置,確保Swagger與SpringBoot版本兼容,并通過(guò)配置文件和測(cè)試類實(shí)現(xiàn)代碼生成和Swagger文檔的訪問(wèn)2024-12-12

