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)  根据起始点获得子集