Parsed HTML into a doc.
"; Document doc = Jsoup.parse(html); ``` > **说明** > > `parse(String html, String baseUri)` 这方法能够将输入的 HTML 解析为一个新的文档 (Document），参数 baseUri 是用来将相对 URL 转成绝对 URL，并指定从哪个网站获取文档。如这个方法不适用，你可以使用 `parse(String html)` 方法来解析成 HTML 字符串如上面的示例。 > > 只要解析的不是空字符串，就能返回一个结构合理的文档，其中包含(至少) 一个 head 和一个 body 元素。 > > 一旦拥有了一个 Document，你就可以使用 Document 中适当的方法或它父类 `Element`和`Node`中的方法来取得相关数据。 ### 解析一个 body 片断 **问题** 假如你有一个 HTML 片断 (比如. 一个 `div` 包含一对 `p` 标签; 一个不完整的 HTML 文档) 想对它进行解析。这个 HTML 片断可以是用户提交的一条评论或在一个 CMS 页面中编辑 body 部分。 **办法** 使用`Jsoup.parseBodyFragment(String html)`方法. ``` String html = "Lorem ipsum.
"; Document doc = Jsoup.parseBodyFragment(html); Element body = doc.body(); ``` > **说明** > > `parseBodyFragment` 方法创建一个空壳的文档，并插入解析过的 HTML 到`body`元素中。假如你使用正常的 `Jsoup.parse(String html)` 方法，通常你也可以得到相同的结果，但是明确将用户输入作为 body 片段处理，以确保用户所提供的任何糟糕的 HTML 都将被解析成 body 元素。 > > `Document.body()` 方法能够取得文档 body 元素的所有子元素，与 `doc.getElementsByTag("body")`相同。 #### 保证安全 Stay safe 假如你可以让用户输入 HTML 内容，那么要小心避免跨站脚本攻击。利用基于 `Whitelist` 的清除器和 `clean(String bodyHtml, Whitelist whitelist)`方法来清除用户输入的恶意内容。 ### 从 URL 加载一个文档 使用 `Jsoup.connect(String url)`方法 ```java Document doc = Jsoup.connect("http://example.com/").get(); ``` > **说明** > > `connect(String url)` 方法创建一个新的 `Connection`, 和 `get()` 取得和解析一个 HTML 文件。如果从该 URL 获取 HTML 时发生错误，便会抛出 IOException，应适当处理。 `Connection` 接口还提供一个方法链来解决特殊请求，具体如下： ```java Document doc = Jsoup.connect("http://example.com") .data("query", "Java") .userAgent("Mozilla") .cookie("auth", "token") .timeout(3000) .post(); ``` ### 从一个文件加载一个文档 可以使用静态 `Jsoup.parse(File in, String charsetName, String baseUri)` 方法 ```java File input = new File("/tmp/input.html"); Document doc = Jsoup.parse(input, "UTF-8", "http://example.com/"); ``` > **说明** > > `parse(File in, String charsetName, String baseUri)` 这个方法用来加载和解析一个 HTML 文件。如在加载文件的时候发生错误，将抛出 IOException，应作适当处理。 > > `baseUri` 参数用于解决文件中 URLs 是相对路径的问题。如果不需要可以传入一个空的字符串。 > > 另外还有一个方法`parse(File in, String charsetName)` ，它使用文件的路径做为 `baseUri`。 这个方法适用于如果被解析文件位于网站的本地文件系统，且相关链接也指向该文件系统。 ## 解析 ### 使用 DOM 方法来遍历一个文档 **问题** 你有一个 HTML 文档要从中提取数据，并了解这个 HTML 文档的结构。 **方法** 将 HTML 解析成一个`Document`之后，就可以使用类似于 DOM 的方法进行操作。示例代码： ```java 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(); } ``` **说明** `Elements` 这个对象提供了一系列类似于 DOM 的方法来查找元素，抽取并处理其中的数据。 具体如下： ####查找元素 - `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)` ####元素数据 - `attr(String key)`获取属性`attr(String key, String value)`设置属性 - `attributes()`获取所有属性 - `id()`, `className()` and `classNames()` - `text()`获取文本内容`text(String value)` 设置文本内容 - `html()`获取元素内 HTML`html(String value)`设置元素内的 HTML 内容 - `outerHtml()`获取元素外 HTML 内容 - `data()`获取数据内容（例如：script 和 style 标签) - `tag()` and `tagName()` ####操作 HTML 和文本 - `append(String html)`, `prepend(String html)` - `appendText(String text)`, `prependText(String text)` - `appendElement(String tagName)`, `prependElement(String tagName)` - `html(String value)` ### 使用选择器语法来查找元素 **问题** 你想使用类似于 CSS 或 jQuery 的语法来查找和操作元素。 **方法** 可以使用`Element.select(String selector)` 和 `Elements.select(String selector)` 方法实现： ```java 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元素 ``` > **说明** > > jsoup elements 对象支持类似于[CSS](http://www.w3.org/TR/2009/PR-css3-selectors-20091215/) (或[jquery](http://jquery.com/))的选择器语法，来实现非常强大和灵活的查找功能。. > > 这个`select` 方法在`Document`, `Element`,或`Elements`对象中都可以使用。且是上下文相关的，因此可实现指定元素的过滤，或者链式选择访问。 > > Select 方法将返回一个`Elements`集合，并提供一组方法来抽取和处理结果。 ####Selector 选择器概述 - `tagname`: 通过标签查找元素，比如：`a` - `ns|tag`: 通过标签在命名空间查找元素，比如：可以用 `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)]` - `*`: 这个符号将匹配所有元素 ####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` ####伪选择器 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 开始的，也就是说第一个元素索引值为 0，第二个元素 index 为 1 等 可以查看`Selector` API 参考来了解更详细的内容 ### 从元素抽取属性，文本和 HTML **问题** 在解析获得一个 Document 实例对象，并查找到一些元素之后，你希望取得在这些元素中的数据。 **方法** - 要取得一个属性的值，可以使用`Node.attr(String key)` 方法 - 对于一个元素中的文本，可以使用`Element.text()`方法 - 对于要取得元素或属性中的 HTML 内容，可以使用`Element.html()`, 或 `Node.outerHtml()`方法 示例： ```java String html = "An example link.
"; 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(); // "example" String linkInnerH = link.html(); // "example"//取得链接内的html内容 ``` > **说明** > > 上述方法是元素数据访问的核心办法。此外还其它一些方法可以使用： > > - `Element.id()` > - `Element.tagName()` > - `Element.className()` and `Element.hasClass(String className)` > > 这些访问器方法都有相应的 setter 方法来更改数据 **参见** - `Element`和`Elements`集合类的参考文档 - [URLs 处理](http://www.open-open.com/jsoup/working-with-urls.htm) - [使用 CSS 选择器语法来查找元素](http://www.open-open.com/jsoup/selector-syntax.htm) ### 处理 URLs **问题** 你有一个包含相对 URLs 路径的 HTML 文档，需要将这些相对路径转换成绝对路径的 URLs。 **方法** 1. 在你解析文档时确保有指定`base URI`，然后 2. 使用 `abs:` 属性前缀来取得包含`base URI`的绝对路径。代码如下： ```java 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 元素中，URLs 经常写成相对于文档位置的相对路径： `...`. 当你使用 `Node.attr(String key)` 方法来取得 a 元素的 href 属性时，它将直接返回在 HTML 源码中指定定的值。 > > 假如你需要取得一个绝对路径，需要在属性名前加 `abs:` 前缀。这样就可以返回包含根路径的 URL 地址`attr("abs:href")` > > 因此，在解析 HTML 文档时，定义 base URI 非常重要。 > > 如果你不想使用`abs:` 前缀，还有一个方法能够实现同样的功能 `Node.absUrl(String key)`。 ## 数据修改 ### 设置属性的值 **问题** 在你解析一个 `Document` 之后可能想修改其中的某些属性值，然后再保存到磁盘或都输出到前台页面。 **方法** 可以使用属性设置方法 `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"); ``` > **说明** > > 与`Element`中的其它方法一样，`attr` 方法也是返回当 `Element` (或在使用选择器是返回 `Elements`集合)。这样能够很方便使用方法连用的书写方式。比如： > > ``` > doc.select("div.masthead").attr("title", "jsoup").addClass("round-box"); > ``` ### 设置一个元素的 HTML 内容 **问题** 你需要一个元素中的 HTML 内容 **方法** 可以使用`Element`中的 HTML 设置方法具体如下： ```java Element div = doc.select("div").first(); // div.html("lorem ipsum
"); //lorem ipsum
First
");//在div前添加html内容 div.append("Last
");//在div之后添加html内容 // 添完后的结果:First
lorem ipsum
Last