• -------------------------------------------------------------
  • ====================================

Jsoup(一)Jsoup详解(官方)

建站指南 dewbay 2年前 (2022-07-04) 1790次浏览 已收录 0个评论 扫描二维码
文章目录[隐藏]

一、Jsoup 概述

1.1、简介

    jsoup 是一款 Java 的 HTML 解析器,可直接解析某个 URL 地址、HTML 文本内容。它提供了一套非常省力的 API,
 可通过 DOM,CSS 以及类似于 jQuery 的操作方法来取出和操作数据。

1.2、Jsoup 的主要功能

    1)从一个 URL,文件或字符串中解析 HTML
    2)使用 DOM 或 CSS 选择器来查找、取出数据
    3)可操作 HTML 元素、属性、文本
    注意:jsoup 是基于 MIT 协议发布的,可放心使用于商业项目。

1.3、jsoup 的主要类层次结构

  Jsoup(一)Jsoup详解(官方)Jsoup(一)Jsoup详解(官方)

二、入门

2.1、解析和遍历一个 HTML 文档

  如何解析一个 HTML 文档:

String html = "<html><head><title>First parse</title></head>"
+ "<body><p>Parsed HTML into a doc.</p></body></html>";
Document doc = Jsoup.parse(html);
  其解析器能够尽最大可能从你提供的 HTML 文档来创见一个干净的解析结果,无论 HTML 的格式是否完整。比如它可以处理:
    1)没有关闭的标签

            <p>Lorem <p>Ipsum parses to <p>Lorem</p> <p>Ipsum</p>
    2)隐式标签

        它可以自动将 <td>Table data</td>包装成<table><tr><td>?
    3)创建可靠的文档结构

 html 标签包含 head 和 body,在 head 只出现恰当的元素

    2.2、一个文档的对象模型

        1)文档由多个 Elements 和 TextNodes 组成
        2)其继承结构如下:Document 继承 Element 继承 Node. TextNode 继承 Node.
        3)一个 Element 包含一个子节点集合,并拥有一个父 Element。他们还提供了一个唯一的子元素过滤列表。

三、输入

3.1、解析一个 HTML 字符串

  1)存在问题
    来自用户输入,一个文件或一个网站的 HTML 字符串,你可能需要对它进行解析并取其内容,或校验其格式是否完整,
    或想修改它。怎么办? jsoup 能够帮你轻松解决这些问题
  2)解决方法
          使用静态Jsoup.parse(String html) 方法或 Jsoup.parse(String html, String baseUri)

String html = "<html><head><title>First parse</title></head>"
  + "<body><p>Parsed HTML into a doc.</p></body></html>";
Document doc = Jsoup.parse(html);
    3)描述
            A:
                parse(String html, String baseUri) 这方法能够将输入的 HTML 解析为一个新的文档 (Document),参数 baseUri 是用来将相对 URL 转成绝对 URL,
      并指定从哪个网站获取文档。如这个方法不适用,你可以使用 parse(String html) 方法来解析成 HTML 字符串如上面的示例。
            B:
                只要解析的不是空字符串,就能返回一个结构合理的文档,其中包含(至少) 一个 head 和一个 body 元素。
            C:
                一旦拥有了一个 Document,你就可以使用 Document 中适当的方法或它父类 Element 和 Node 中的方法来取得相关数据。

3.2、解析一个 body 片断

  1)存在问题
          假如你有一个 HTML 片断 (比如. 一个 div 包含一对 p 标签; 一个不完整的 HTML 文档) 想对它进行解析。这个 HTML 片断可以是用户提交的一条评论
    或在一个 CMS 页面中编辑 body 部分。
  2)办法
       使用Jsoup.parseBodyFragment(String html)方法。

String html = "<div><p>Lorem ipsum.</p>";
Document doc = Jsoup.parseBodyFragment(html);
Element body = doc.body();
  3)说明
        A:
            parseBodyFragment 方法创建一个空壳的文档,并插入解析过的 HTML 到 body 元素中。假如你使用正常的 Jsoup.parse(String html) 方法,
   通常你也可以得到相同的结果,但是明确将用户输入作为 body 片段处理,以确保用户所提供的任何糟糕的 HTML 都将被解析成 body 元素。
        B:
            Document.body() 方法能够取得文档 body 元素的所有子元素,与 doc.getElementsByTag(“body”)相同。

3.3、从一个 URL 加载一个 Document

  1)存在问题
    你需要从一个网站获取和解析一个 HTML 文档,并查找其中的相关数据。
  2)解决方法
    使用 Jsoup.connect(String url)方法:

Document doc = Jsoup.connect("http://example.com/").get();
String title = doc.title();
    3)说明
        connect(String url) 方法创建一个新的 Connection, 和 get() 取得和解析一个 HTML 文件。如果从该 URL 获取 HTML 时发生错误,便会抛出 IOException,应适当处理。
        Connection 接口还提供一个方法链来解决特殊请求,具体如下:

  Document doc = Jsoup.connect("http://example.com";)
  .data("query", "Java")
  .userAgent("Mozilla")
  .cookie("auth", "token")
  .timeout(3000)
  .post();
        这个方法只支持 Web URLs (http 和 https 协议); 假如你需要从一个文件加载,可以使用 parse(File in, String charsetName) 代替。

3.4、从一个文件加载文档

  1)存在问题
    在本机硬盘上有一个 HTML 文件,需要对它进行解析从中抽取数据或进行修改。
  2)方法
    可以使用静态 Jsoup.parse(File in, String charsetName, String baseUri) 方法:

File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/";);
    3)说明
        A:
            parse(File in, String charsetName, String baseUri) 这个方法用来加载和解析一个 HTML 文件。如在加载文件的时候发生错误,将抛出 IOException,应作适当处理。
        B:
            baseUri 参数用于解决文件中 URLs 是相对路径的问题。如果不需要可以传入一个空的字符串。
        C:
            另外还有一个方法 parse(File in, String charsetName) ,它使用文件的路径做为 baseUri。 这个方法适用于如果被解析文件位于网站的本地文件系统,
    且相关链接也指向该文件系统。

四、数据抽取

4.1、使用 DOM 方法来遍历一个文档

  1)存在问题
    你有一个 HTML 文档要从中提取数据,并了解这个 HTML 文档的结构。
  2)方法
    将 HTML 解析成一个 Document 之后,就可以使用类似于 DOM 的方法进行操作。

File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/");

Element content = doc.getElementById("content");
Elements links = content.getElementsByTag("a");
for (Element link : links) {
  String linkHref = link.attr("href");
  String linkText = link.text();
}

3)说明

Elements 这个对象提供了一系列类似于 DOM 的方法来查找元素,抽取并处理其中的数据。具体如下:

A:查看元素

    getElementById(String id)
    getElementsByTag(String tag)
    getElementsByClass(String className)
    getElementsByAttribute(String key) (and related methods)
    Element siblings: siblingElements(), firstElementSibling(), lastElementSibling(); nextElementSibling(), previousElementSibling()
    Graph: parent(), children(), child(int index)

B:元素数据

    attr(String key)获取属性 attr(String key, String value)设置属性
    attributes()获取所有属性
    id(), className() and classNames()
    text()获取文本内容 text(String value) 设置文本内容
    html()获取元素内 HTMLhtml(String value)设置元素内的 HTML 内容
    outerHtml()获取元素外 HTML 内容
    data()获取数据内容(例如:script 和 style 标签)
    tag() and tagName()

C:操作 HTML 和文本

    append(String html), prepend(String html)
    appendText(String text), prependText(String text)
    appendElement(String tagName), prependElement(String tagName)
    html(String value)

4.2、使用选择器语法来查找元素

1)存在问题

你想使用类似于 CSS 或 jQuery 的语法来查找和操作元素。

2)方法

可以使用 Element.select(String selector) 和 Elements.select(String selector) 方法实现:

File input = new File("/tmp/input.html");
Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/");

Elements links = doc.select("a[href]"); //带有 href 属性的 a 元素
Elements pngs = doc.select("img[src$=.png]");
  //扩展名为.png 的图片

Element masthead = doc.select("div.masthead").first();
  //class 等于 masthead 的 div 标签

Elements resultLinks = doc.select("h3.r > a"); //在 h3 元素之后的 a 元素

3)说明

jsoup elements 对象支持类似于 CSS (或 jquery)的选择器语法,来实现非常强大和灵活的查找功能。.

这个 select 方法在 Document, Element,或 Elements 对象中都可以使用。且是上下文相关的,因此可实现指定元素的过滤,或者链式选择访问。

Select 方法将返回一个 Elements 集合,并提供一组方法来抽取和处理结果。

A:Selector 选择器概述

tagname: 通过标签查找元素,比如:a
ns|tag: 通过标签在命名空间查找元素,比如:可以用 fb|name 语法来查找 <fb:name> 元素
#id: 通过 ID 查找元素,比如:#logo
.class: 通过 class 名称查找元素,比如:.masthead
[attribute]: 利用属性查找元素,比如:[href]
[^attr]: 利用属性名前缀来查找元素,比如:可以用[^data-] 来查找带有 HTML5 Dataset 属性的元素
[attr=value]: 利用属性值来查找元素,比如:[width=500]
[attr^=value], [attr$=value], [attr*=value]: 利用匹配属性值开头、结尾或包含属性值来查找元素,比如:[href*=/path/]
[attr~=regex]: 利用属性值匹配正则表达式来查找元素,比如: img[src~=(?i)\.(png|jpe?g)]
*: 这个符号将匹配所有元素

B:Selector 选择器组合使用

el#id: 元素+ID,比如: div#logo
el.class: 元素+class,比如: div.masthead
el[attr]: 元素+class,比如: a[href]
任意组合,比如:a[href].highlight
ancestor child: 查找某个元素下子元素,比如:可以用.body p 查找在”body”元素下的所有 p 元素
parent > child: 查找某个父元素下的直接子元素,比如:可以用 div.content > p 查找 p 元素,也可以用 body > * 查找 body 标签下所有直接子元素
siblingA + siblingB: 查找在 A 元素之前第一个同级元素 B,比如:div.head + div
siblingA ~ siblingX: 查找 A 元素之前的同级 X 元素,比如:h1 ~ p
el, el, el:多个选择器组合,查找匹配任一选择器的唯一元素,例如:div.masthead, div.logo

C:伪选择器 selectors

:lt(n): 查找哪些元素的同级索引值(它的位置在 DOM 树中是相对于它的父节点)小于 n,比如:td:lt(3) 表示小于三列的元素
:gt(n):查找哪些元素的同级索引值大于 n,比如: div p:gt(2)表示哪些 div 中有包含 2 个以上的 p 元素
:eq(n): 查找哪些元素的同级索引值与 n 相等,比如:form input:eq(1)表示包含一个 input 标签的 Form 元素
:has(seletor): 查找匹配选择器包含元素的元素,比如:div:has(p)表示哪些 div 包含了 p 元素
:not(selector): 查找与选择器不匹配的元素,比如: div:not(.logo) 表示不包含 class=”logo” 元素的所有 div 列表
:contains(text): 查找包含给定文本的元素,搜索不区分大不写,比如: p:contains(jsoup)
:containsOwn(text): 查找直接包含给定文本的元素
:matches(regex): 查找哪些元素的文本匹配指定的正则表达式,比如:div:matches((?i)login)
:matchesOwn(regex): 查找自身包含文本匹配指定正则表达式的元素
注意:上述伪选择器索引是从 0 开始的,也就是

4.3、从元素抽取属性,本文和 HTML

1)存在问题

在解析获得一个 Document 实例对象,并查找到一些元素之后,你希望取得在这些元素中的数据。

2)方法

要取得一个属性的值,可以使用 Node.attr(String key) 方法
对于一个元素中的文本,可以使用 Element.text()方法
对于要取得元素或属性中的 HTML 内容,可以使用 Element.html(), 或 Node.outerHtml()方法

  String html = "<p>An <a href='http://example.com/'><b>example</b></a> link.</p>";
  Document doc = Jsoup.parse(html);//解析 HTML 字符串返回一个 Document 实现
  Element link = doc.select("a").first();//查找第一个 a 元素

  String text = doc.body().text(); // "An example link"//取得字符串中的文本
  String linkHref = link.attr("href"); // "http://example.com/"//取得链接地址
  String linkText = link.text(); // "example""//取得链接地址中的文本

  String linkOuterH = link.outerHtml(); 
      // "<a href="http://example.com"><b>example</b></a>"
  String linkInnerH = link.html(); // "<b>example</b>"//取得链接内的 html 内容

3)说明

上述方法是元素数据访问的核心办法。此外还其它一些方法可以使用:

1
2
3
Element.id()
Element.tagName()
Element.className() and Element.hasClass(String className)

这些访问器方法都有相应的 setter 方法来更改数据.

4.4、处理 URLs

1)存在问题

你有一个包含相对 URLs 路径的 HTML 文档,需要将这些相对路径转换成绝对路径的 URLs。

2)方法

在你解析文档时确保有指定 base URI,然后
使用 abs: 属性前缀来取得包含 base URI 的绝对路径。代码如下:

  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/"

3)说明

在 HTML 元素中,URLs 经常写成相对于文档位置的相对路径: <a href=”/download”>…</a>.

当你使用 Node.attr(String key) 方法来取得 a 元素的 href 属性时,它将直接返回在 HTML 源码中指定定的值。

假如你需要取得一个绝对路径,需要在属性名前加 abs: 前缀。这样就可以返回包含根路径的 URL 地址 attr(“abs:href”)

因此,在解析 HTML 文档时,定义 base URI 非常重要。

如果你不想使用 abs: 前缀,还有一个方法能够实现同样的功能 Node.absUrl(String key)。

4.5、实例程序:获取所有连链接

1)说明

这个示例程序将展示如何从一个 URL 获得一个页面。然后提取页面中的所有链接、图片和其它辅助内容。并检查 URLs 和文本信息。

2)运行下面程序需要执行一个 URLs 作为参数

package org.jsoup.examples;

import org.jsoup.Jsoup;
import org.jsoup.helper.Validate;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;

import java.io.IOException;

/**
 * Example program to list links from a URL.
 */
public class ListLinks {
    public static void main(String[] args) throws IOException {
        Validate.isTrue(args.length == 1, "usage: supply url to fetch");
        String url = args[0];
        print("Fetching %s...", url);

        Document doc = Jsoup.connect(url).get();
        Elements links = doc.select("a[href]");
        Elements media = doc.select("[src]");
        Elements imports = doc.select("link[href]");

        print("\nMedia: (%d)", media.size());
        for (Element src : media) {
            if (src.tagName().equals("img"))
                print(" * %s: <%s> %sx%s (%s)",
                        src.tagName(), src.attr("abs:src"), src.attr("width"), src.attr("height"),
                        trim(src.attr("alt"), 20));
            else
                print(" * %s: <%s>", src.tagName(), src.attr("abs:src"));
        }

        print("\nImports: (%d)", imports.size());
        for (Element link : imports) {
            print(" * %s <%s> (%s)", link.tagName(),link.attr("abs:href"), link.attr("rel"));
        }

        print("\nLinks: (%d)", links.size());
        for (Element link : links) {
            print(" * a: <%s>  (%s)", link.attr("abs:href"), trim(link.text(), 35));
        }
    }

    private static void print(String msg, Object... args) {
        System.out.println(String.format(msg, args));
    }

    private static String trim(String s, int width) {
        if (s.length() > width)
            return s.substring(0, width-1) + ".";
        else
            return s;
    }
}

3)查看结果

Fetching http://news.ycombinator.com/...

Media: (38)
 * img: <http://ycombinator.com/images/y18.gif> 18x18 ()
 * img: <http://ycombinator.com/images/s.gif> 10x1 ()
 * img: <http://ycombinator.com/images/grayarrow.gif> x ()
 * img: <http://ycombinator.com/images/s.gif> 0x10 ()
 * script: <http://www.co2stats.com/propres.php?s=1138>
 * img: <http://ycombinator.com/images/s.gif> 15x1 ()
 * img: <http://ycombinator.com/images/hnsearch.png> x ()
 * img: <http://ycombinator.com/images/s.gif> 25x1 ()
 * img: <http://mixpanel.com/site_media/images/mixpanel_partner_logo_borderless.gif> x (Analytics by Mixpan.)
 
Imports: (2)
 * link <http://ycombinator.com/news.css> (stylesheet)
 * link <http://ycombinator.com/favicon.ico> (shortcut icon)
 
Links: (141)
 * a: <http://ycombinator.com>  ()
 * a: <http://news.ycombinator.com/news>  (Hacker News)
 * a: <http://news.ycombinator.com/newest>  (new)
 * a: <http://news.ycombinator.com/newcomments>  (comments)
 * a: <http://news.ycombinator.com/leaders>  (leaders)
 * a: <http://news.ycombinator.com/jobs>  (jobs)
 * a: <http://news.ycombinator.com/submit>  (submit)
 * a: <http://news.ycombinator.com/x?fnid=JKhQjfU7gW>  (login)
 * a: <http://news.ycombinator.com/vote?for=1094578&dir=up&whence=%6e%65%77%73>  ()
 * a: <http://www.readwriteweb.com/archives/facebook_gets_faster_debuts_homegrown_php_compiler.php?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed%3A+readwriteweb+%28ReadWriteWeb%29&utm_content=Twitter>  (Facebook speeds up PHP)
 * a: <http://news.ycombinator.com/user?id=mcxx>  (mcxx)
 * a: <http://news.ycombinator.com/item?id=1094578>  (9 comments)
 * a: <http://news.ycombinator.com/vote?for=1094649&dir=up&whence=%6e%65%77%73>  ()
 * a: <http://groups.google.com/group/django-developers/msg/a65fbbc8effcd914>  ("Tough. Django produces XHTML.")
 * a: <http://news.ycombinator.com/user?id=andybak>  (andybak)
 * a: <http://news.ycombinator.com/item?id=1094649>  (3 comments)
 * a: <http://news.ycombinator.com/vote?for=1093927&dir=up&whence=%6e%65%77%73>  ()
 * a: <http://news.ycombinator.com/x?fnid=p2sdPLE7Ce>  (More)
 * a: <http://news.ycombinator.com/lists>  (Lists)
 * a: <http://news.ycombinator.com/rss>  (RSS)
 * a: <http://ycombinator.com/bookmarklet.html>  (Bookmarklet)
 * a: <http://ycombinator.com/newsguidelines.html>  (Guidelines)
 * a: <http://ycombinator.com/newsfaq.html>  (FAQ)
 * a: <http://ycombinator.com/newsnews.html>  (News News)
 * a: <http://news.ycombinator.com/item?id=363>  (Feature Requests)
 * a: <http://ycombinator.com>  (Y Combinator)
 * a: <http://ycombinator.com/w2010.html>  (Apply)
 * a: <http://ycombinator.com/lib.html>  (Library)
 * a: <http://www.webmynd.com/html/hackernews.html>  ()
 * a: <http://mixpanel.com/?from=yc>  ()

五、数据修改

5.1、设置属性值

1)存在问题

在你解析一个 Document 之后可能想修改其中的某些属性值,然后再保存到磁盘或都输出到前台页面。

2)方法

可以使用属性设置方法 Element.attr(String key, String value), 和 Elements.attr(String key, String value).

假如你需要修改一个元素的 class 属性,可以使用 Element.addClass(String className) 和 Element.removeClass(String className) 方法。

Elements 提供了批量操作元素属性和 class 的方法,比如:要为 div 中的每一个 a 元素都添加一个 rel=”nofollow” 可以使用如下方法:

doc.select(“div.comments a”).attr(“rel”, “nofollow”);

3)说明

与 Element 中的其它方法一样,attr 方法也是返回当 Element (或在使用选择器是返回 Elements 集合)。

这样能够很方便使用方法连用的书写方式。比如:

doc.select(“div.masthead”).attr(“title”, “jsoup”).addClass(“round-box”);

5.2、设置一个元素的 HTML 内容

1)存在问题

你需要一个元素中的 HTML 的内容

2)方法

可以使用 Element 中的 HTML 设置方法具体如下:

Element div = doc.select("div").first(); // <div></div>
div.html("<p>lorem ipsum</p>"); // <div><p>lorem ipsum</p></div>
div.prepend("<p>First</p>");//在 div 前添加 html 内容
div.append("<p>Last</p>");//在 div 之后添加 html 内容
// 添完后的结果: <div><p>First</p><p>lorem ipsum</p><p>Last</p></div>

Element span = doc.select("span").first(); // <span>One</span>
span.wrap("<li><a href='http://example.com/'></a></li>");
// 添完后的结果: <li><a href="http://example.com"><span>One</span></a></li>

3)说明

Element.html(String html) 这个方法将先清除元素中的 HTML 内容,然后用传入的 HTML 代替。
Element.prepend(String first) 和 Element.append(String last) 方法用于在分别在元素内部 HTML 的前面和后面添加 HTML 内容
Element.wrap(String around) 对元素包裹一个外部 HTML 内容。


露水湾 , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:Jsoup(一)Jsoup详解(官方)
喜欢 (0)
[]
分享 (0)
关于作者:
发表我的评论
取消评论

表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址