jsoup的elements類

jsoup的Elements類

1、簡介

該類是位於select包下，直接繼承自Object，全部實現的接口有Cloneable, Iterable<Element>, Collection<Element>, List<Element>

類聲明：public class Elements extends Object implements List<Element>, Cloneable

可使用Element.select(String) 方法去獲得Elements 對象。

 

2、構造方法

一、public Elements()  默認構造方法
二、public Elements(int initialCapacity) 指定一個初始容量建立一個Elements對象。

三、public Elements(Collection<Element> elements)  使用已知元素集建立一個Elements對象。

四、public Elements(List<Element> elements)  使用已知元素的List集合建立一個Elements對象。

五、public Elements(Element... elements) 使用已知元素的可變參數列表建立一個Elements對象。

 

3、方法詳細

一、public Elements clone()  克隆

二、public String attr(String attributeKey) 根據鍵獲得第一個匹配的元素（匹配即爲有這個屬性）。

三、public boolean hasAttr(String attributeKey)   元素集中存在任何一個元素匹配（有這屬性）則返回true。

四、public Elements attr(String attributeKey, String attributeValue) 將 全部匹配attributeKey鍵的元素的值設置爲attributeValue。

五、public Elements removeAttr(String attributeKey)  移除元素集中任何一個匹配的元素

六、public Elements addClass(String className)  將className增長到每個匹配的元素的class屬性上。

七、public Elements removeClass(String className)  從每個匹配的元素上移除該className

八、public Elements toggleClass(String className)   對每個匹配的元素的class屬性上進行反轉。（有則移除，沒有則新增）。

九、public boolean hasClass(String className)  檢測是否有任何一個匹配的元素在class屬性有給定的className值。

十、public String val()  獲得第一個匹配元素的表單的值。

十一、public Elements val(String value)   對每個匹配的元素設置表單值。

十二、public String text()  獲得全部匹配元素文本的綜合。該方法在某些狀況下會獲得重複數據。

1三、public boolean hasText() 檢測是否有文本內容

1四、public String html()  獲得全部匹配元素的內部html的綜合。

1五、public String outerHtml()  獲得全部匹配元素的外部html的綜合。

1六、public String toString()  獲得全部匹配元素的外部html的綜合。

1七、public Elements tagName(String tagName)  更新每一個匹配元素的tag name.   如想把每一個<i>變成<em>，能夠這樣：doc.select("i").tagName("em");

1八、public Elements html(String html)  設置每一個匹配元素的內部html。

1九、public Elements prepend(String html)   將指定html增長到每一個匹配元素的內部html開頭。

20、public Elements append(String html)   將指定html增長到每一個匹配元素的內部html末尾。

2一、public Elements before(String html)   在每一個匹配元素的外部html前面插入指定html。

2二、public Elements after(String html)   在每一個匹配元素的外部html後面插入指定html。

2三、public Elements wrap(String html)  用指定html包裝每一個匹配的元素。

例如，對於這個html：<p><b>This</b> is <b>Jsoup</b></p>，執行這個包裝：doc.select("b").wrap("<i></i>")後就變成：<p><i><b>This</b></i> is <i><b>jsoup</b></i></p>

2四、public Elements unwrap()   移除匹配的元素但保留他們的內容。示例：<div><font>One</font> <font><a href="/">Two</a></font></div>   執行 doc.select("font").unwrap()   變成：<div>One <a href="/">Two</a></div>
2五、public Elements empty()  清空每一個匹配元素的內容。示例：<div><p>Hello <b>there</b></p> <p>now</p></div>  執行doc.select("p").empty()  變成<div><p></p> <p></p></div>

2六、public Elements remove()  從DOM樹中移除匹配的元素。示例：<div><p>Hello</p> <p>there</p> <img /></div>   執行doc.select("p").remove()後 變成<div> <img /></div>

2七、public Elements select(String query)  根據query選擇器查詢匹配的元素集。

2八、public Elements not(String query)  移除匹配選擇器的元素集   返回過濾後的元素集。

2九、public Elements eq(int index)  根據index獲得匹配的元素

30、public boolean is(String query)  檢測是否有一個元素匹配給定的選擇器。

3一、public Elements parents()   獲得匹配元素集的全部父類元素和祖先元素集

3二、public Element first()  獲得第一個匹配的元素

3三、public Element last()   獲得最後一個匹配的元素

3四、public Elements traverse(NodeVisitor nodeVisitor)  對被查詢的元素執行一次深度優先的遍歷。

3五、public int size()  元素集的長度。

3六、public boolean isEmpty()   檢測是否爲空

3七、public boolean contains(Object o)  檢測是否包含指定對象

3八、public Iterator<Element> iterator()   獲得迭代器對象

3九、public Object[] toArray()  將元素集轉換爲數組

40、public <T> T[] toArray(T[] a) 

4一、public boolean add(Element element)  新增元素

4二、public boolean remove(Object o)  移除指定元素

4三、public boolean containsAll(Collection<?> c)  參照java中的List或Collection用法.

4四、public boolean addAll(Collection<? extends Element> c)  參照java中的List或Collection用法.

4五、public boolean addAll(int index, Collection<? extends Element> c)  參照java中的List或Collection用法.

4六、public boolean removeAll(Collection<?> c)     參照java中的List或Collection用法.

4七、public boolean retainAll(Collection<?> c)  參照java中的List或Collection用法.

4八、public void clear() 清空元素集

4九、public Element get(int index)  根據索引獲得指定元素

50、public Element set(int index, Element element)  根據索引設置指定元素

5一、public void add(int index, Element element) 在指定位置增長元素

5二、public Element remove(int index)  移除指定位置的元素

5三、public int indexOf(Object o)  獲得指定元素的索引（第一次出現的位置）

5四、public int lastIndexOf(Object o) 獲得指定元素最後一次出現的位置。

5五、public ListIterator<Element> listIterator() 具體參照List<Element>

5六、public ListIterator<Element> listIterator(int index)  具體參照List<Element>

5七、public List<Element> subList(int fromIndex, int toIndex)  根據起始點獲得子集