【转】jsoup的使用

 Jsoup的使用

 

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

     jsoup的主要功能如下：

从一个URL，文件或字符串中解析HTML；

使用DOM或CSS选择器来查找、取出数据；

可操作HTML元素、属性、文本；

jsoup是基于MIT协议发布的，可放心使用于商业项目。

  下载和安装：

maven安装方法：

把下面放入pom.xml下

<dependency>

<!-- jsoup HTML parser library @ http://jsoup.org/ -->

<groupId>org.jsoup</groupId>

<artifactId>jsoup</artifactId>

<version>1.5.2</version>

</dependency>

用jsoup解析html的方法如下：

解析url html方法

Document doc =Jsoup.connect("http://example.com")  .data("query","Java")
  .userAgent("Mozilla")
  .cookie("auth","token")
  .timeout(3000)
  .post();

从文件中解析的方法：

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

类试js  jsoup提供下面方法：

• getElementById(String id) 用id获得元素
• getElementsByTag(String tag) 用标签获得元素
• getElementsByClass(String className) 用class获得元素
• getElementsByAttribute(String key)  用属性获得元素

同时还提供下面的方法提供获取兄弟节点：

siblingElements(), firstElementSibling(), lastElementSibling();nextElementSibling(), previousElementSibling()

用下面方法获得元素的数据：

• attr(String key)  获得元素的数据
• attr(String key, String value) t设置元素数据
• attributes() 获得所以属性
• id(), className()  classNames() 获得id class得值
• text()获得文本值
• text(String value) 设置文本值
• html() 获取html
• html(String value)设置html
• outerHtml() 获得内部html
• data()获得数据内容
• tag()  获得tag 和 tagName() 获得tagname

操作html提供了下面方法：

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

通过类似jquery的方法操作html

File input =newFile("/tmp/input.html");Document doc =Jsoup.parse(input,"UTF-8","http://example.com/");Elements links = doc.select("a[href]");// a with hrefElements pngs = doc.select("img[src$=.png]");
  // img with src ending .pngElement masthead = doc.select("div.masthead").first();
  // div with class="masthead"Elements resultLinks = doc.select("h3.r > a");// direct a after h3

支持的操作有下面这些：

• tagname 操作tag
• ns|tag ns或tag
• #id  用id获得元素 
• .class 用class获得元素
• [attribute] 属性获得元素
• [^attr]: 以attr开头的属性
• [attr=value] 属性值为value
• [attr^=value], [attr$=value], [attr*=value] 
• [attr~=regex]正则
• *:所以的标签

选择组合

• el#id el和id定位
• el.class e1和class定位
• el[attr] e1和属性定位
• ancestor child ancestor下面的child

等等

抓取网站标题和内容及里面图片的事例：

1. public  void parse(String urlStr) {
2. // 返回结果初始化。
3. Document doc = null;
4. try {
5. doc = Jsoup
6. .connect(urlStr)
7. .userAgent(
8. "Mozilla/5.0 (Windows; U; Windows NT 5.1; zh-CN; rv:1.9.2.15)") // 设置User-Agent
9. .timeout(5000) // 设置连接超时时间
10. .get();
11. } catch (MalformedURLException e) {
12. log.error( e);
13. return ;
14. } catch (IOException e) {
15. if (e instanceof SocketTimeoutException) {
16. log.error( e);
17. return ;
18. }
19. if(e instanceof UnknownHostException){
20. log.error(e);
21. return ;
22. }
23. log.error( e);
24. return ;
25. }
26. system.out.println(doc.title());
27. Element head = doc.head();
28. Elements metas = head.select("meta");
29. for (Element meta : metas) {
30. String content = meta.attr("content");
31. if ("content-type".equalsIgnoreCase(meta.attr("http-equiv"))
32. && !StringUtils.startsWith(content, "text/html")) {
33. log.debug( urlStr);
34. return ;
35. }
36. if ("description".equalsIgnoreCase(meta.attr("name"))) {
37. system.out.println(meta.attr("content"));
38. }
39. }
40. Element body = doc.body();
41. for (Element img : body.getElementsByTag("img")) {
42. String imageUrl = img.attr("abs:src");//获得绝对路径
43. for (String suffix : IMAGE_TYPE_ARRAY) {
44. if(imageUrl.indexOf("?")>0){
45. imageUrl=imageUrl.substring(0,imageUrl.indexOf("?"));
46. }
47. if (StringUtils.endsWithIgnoreCase(imageUrl, suffix)) {
48. imgSrcs.add(imageUrl);
49. break;
50. }
51. }
52. }
53. }

这里重点要提的是怎么获得图片或链接的决定地址：

如上获得绝对地址的方法String imageUrl = img.attr("abs:src");//获得绝对路径 ，前面添加abs：jsoup就会获得决定地址；

想知道原因，咱们查看下源码，如下：

1. //该方面是先从map中找看是否有该属性key，如果有直接返回，如果没有检查是否
2. //以abs：开头
3. public String attr(String attributeKey) {
4. Validate.notNull(attributeKey);
5. if (hasAttr(attributeKey))
6. return attributes.get(attributeKey);
7. else if (attributeKey.toLowerCase().startsWith("abs:"))
8. return absUrl(attributeKey.substring("abs:".length()));
9. else return "";
10. }

接着查看absUrl方法：

1. /**
2. * Get an absolute URL from a URL attribute that may be relative (i.e. an <code>&lt;a href></code> or
3. * <code>&lt;img src></code>).
4. * <p/>
5. * E.g.: <code>String absUrl = linkEl.absUrl("href");</code>
6. * <p/>
7. * If the attribute value is already absolute (i.e. it starts with a protocol, like
8. * <code>http://</code> or <code>https://</code> etc), and it successfully parses as a URL, the attribute is
9. * returned directly. Otherwise, it is treated as a URL relative to the element's {@link #baseUri}, and made
10. * absolute using that.
11. * <p/>
12. * As an alternate, you can use the {@link #attr} method with the <code>abs:</code> prefix, e.g.:
13. * <code>String absUrl = linkEl.attr("abs:href");</code>
14. *
15. * @param attributeKey The attribute key
16. * @return An absolute URL if one could be made, or an empty string (not null) if the attribute was missing or
17. * could not be made successfully into a URL.
18. * @see #attr
19. * @see java.net.URL#URL(java.net.URL, String)
20. */
21. //看到这里大家应该明白绝对地址是怎么取的了
22. public String absUrl(String attributeKey) {
23. Validate.notEmpty(attributeKey);
24. String relUrl = attr(attributeKey);
25. if (!hasAttr(attributeKey)) {
26. return ""; // nothing to make absolute with
27. } else {
28. URL base;
29. try {
30. try {
31. base = new URL(baseUri);
32. } catch (MalformedURLException e) {
33. // the base is unsuitable, but the attribute may be abs on its own, so try that
34. URL abs = new URL(relUrl);
35. return abs.toExternalForm();
36. }
37. // workaround: java resolves '//path/file + ?foo' to '//path/?foo', not '//path/file?foo' as desired
38. if (relUrl.startsWith("?"))
39. relUrl = base.getPath() + relUrl;
40. URL abs = new URL(base, relUrl);
41. return abs.toExternalForm();
42. } catch (MalformedURLException e) {
43. return "";
44. }
45. }
46. }