pull/89/head
yihua.huang 11 years ago
parent 44293cd894
commit 22c394e629

@ -8,21 +8,11 @@
</layout>
</appender>
<logger name="org.springframework" additivity="false">
<level value="warn" />
<appender-ref ref="stdout" />
</logger>
<logger name="org.apache" additivity="false">
<level value="warn" />
<appender-ref ref="stdout" />
</logger>
<logger name="net.sf.ehcache" additivity="false">
<level value="warn" />
<appender-ref ref="stdout" />
</logger>
<root>
<level value="info" />
<appender-ref ref="stdout" />

@ -1,4 +1,4 @@
WebMagic文档2.0版
WebMagic in Action
========
WebMagic是一个简单灵活、便于二次开发的爬虫框架。除了可以便捷的实现一个爬虫WebMagic还提供多线程功能以及基本的分布式功能。
@ -160,22 +160,22 @@ Intellij Idea默认自带Maven支持import项目时选择Maven项目即可。
## 3. 基本的爬虫
## 3. 基本的爬虫
### 3.1 实现PageProcessor
在WebMagic里实现一个基本的爬虫只需要编写一个类实现`PageProcessor`接口。这个类包含了抓取一个网站所需要的所有定制化信息。以之前的`GithubRepoPageProcessor`为例:
在WebMagic里实现一个基本的爬虫只需要编写一个类实现`PageProcessor`接口即可。这个类基本上包含了抓取一个网站,你需要写的所有代码。
以之前的`GithubRepoPageProcessor`为例我将PageProcessor的定制分为三个部分分别是爬虫的配置、页面元素的抽取和链接的发现。
```java
public class GithubRepoPageProcessor implements PageProcessor {
// 抓取网站的相关配置,包括编码、抓取间隔、重试次数等
// 部分一:抓取网站的相关配置,包括编码、抓取间隔、重试次数等
private Site site = Site.me().setRetryTimes(3).setSleepTime(1000);
@Override
// process是定制爬虫逻辑的核心接口在这里编写抽取逻辑
public void process(Page page) {
// 以下部分定义如何抽取页面信息,并保存下来
// 部分二:定义如何抽取页面信息,并保存下来
page.putField("author", page.getUrl().regex("https://github\\.com/(\\w+)/.*").toString());
page.putField("name", page.getHtml().xpath("//h1[@class='entry-title public']/strong/a/text()").toString());
if (page.getResultItems().get("name") == null) {
@ -184,7 +184,7 @@ public class GithubRepoPageProcessor implements PageProcessor {
}
page.putField("readme", page.getHtml().xpath("//div[@id='readme']/tidyText()"));
// 这一步从页面发现后续的url地址来抓取
// 部分三:从页面发现后续的url地址来抓取
page.addTargetRequests(page.getHtml().links().regex("(https://github\\.com/\\w+/\\w+)").all());
}
@ -206,22 +206,154 @@ public class GithubRepoPageProcessor implements PageProcessor {
}
```
#### 3.1.1 爬虫的配置
第一部分关于爬虫的配置包括编码、抓取间隔、超时时间、重试次数等也包括一些模拟的参数例如User Agent、cookie以及代理的设置我们会在第5章-“爬虫的配置”里进行介绍。在这里我们先简单设置一下重试次数为3次抓取间隔为一秒。
#### 3.1.2 页面元素的抽取
第二部分是爬虫的核心部分对于下载到的Html页面你如何从中抽取到你想要的信息WebMagic里主要使用了三种抽取技术XPath、正则表达式和CSS选择器。
1. XPath
XPath本来是用于XML中获取元素的一种查询语言但是用于Html也是比较方便的。例如
```java
page.getHtml().xpath("//h1[@class='entry-title public']/strong/a/text()")
```
这段代码使用了XPath它的意思是“查找所有class属性为'entry-title public'的h1元素并找到他的strong子节点的a子节点并提取a节点的文本信息”。
对应的Html是这样子的
![xpath-html](http://static.oschina.net/uploads/space/2014/0404/104607_Aqq8_190591.png)
2. CSS选择器
CSS选择器是与XPath类似的语言。如果大家做过前端开发肯定知道$('h1.entry-title')这种写法的含义。客观的说它比XPath写起来要简单一些但是如果写复杂一点的抽取规则就相对要麻烦一点。
3. 正则表达式
正则表达式则是一种通用的文本抽取语言。
```java
page.addTargetRequests(page.getHtml().links().regex("(https://github\\.com/\\w+/\\w+)").all());
```
这段代码就用到了正则表达式,它表示匹配所有"https://github.com/code4craft/webmagic"这样的链接。
XPath、CSS选择器和正则表达式的具体用法会在第4章“抽取工具详解”中讲到。
#### 3.1.3 链接的发现
有了处理页面的逻辑,我们的爬虫就接近完工了!
但是现在还有一个问题:一个站点的页面是很多的,一开始我们不可能全部列举出来,于是如何发现后续的链接,是一个爬虫不可缺少的一部分。
```java
page.addTargetRequests(page.getHtml().links().regex("(https://github\\.com/\\w+/\\w+)").all());
```
这段代码的分为两部分,`page.getHtml().links().regex("(https://github\\.com/\\w+/\\w+)").all()`用于获取所有满足"(https://github\\.com/\\w+/\\w+)"这个正则表达式的链接,`page.addTargetRequests()`则将这些链接加入到待抓取的队列中去。
### 3.2 使用Selectable的链式API
`Selectable`相关的链式API是WebMagic的一个核心功能。使用Selectable接口你可以直接完成页面元素的链式抽取也无需去关心抽取的细节。
在刚才的例子中可以看到page.getHtml()返回的是一个`Html`对象,它实现了`Selectable`接口。这个接口包含一些重要的方法,我将它分为两类:抽取部分和获取结果部分。
#### 3.2.1 抽取部分API
| 方法 | 说明 | 示例 |
| ------------ | ------------- | ------------ |
| xpath(String xpath) | 使用XPath选择 | html.xpath("//div[@class='title']") |
| \$(String selector) | 使用Css选择器选择 | html.\$("div.title") |
| \$(String selector,String attr) | 使用Css选择器选择 | html.\$("div.title","text") |
| css(String selector) | 功能同$()使用Css选择器选择 | html.css("div.title") |
| links() | 选择所有链接 | html.links() |
| regex(String regex) | 使用正则表达式抽取 | html.regex("\<div\>(.\*?)\</div>") |
| regex(String regex,int group) | 使用正则表达式抽取,并指定捕获组 | html.regex("\<div\>(.\*?)\</div>",1) |
| replace(String regex, String replacement) | 替换内容| html.replace("\<script>.\*\</script>","")|
这部分抽取API返回的都是一个`Selectable`接口意思是说抽取是支持链式调用的。下面我用一个实例来讲解链式API的使用。
例如我现在要抓取github上所有的Java项目这些项目可以在[https://github.com/search?l=Java&p=1&q=stars%3A%3E1&s=stars&type=Repositories](https://github.com/search?l=Java&p=1&q=stars%3A%3E1&s=stars&type=Repositories)搜索结果中看到。
为了避免抓取范围太宽,我指定只从分页部分抓取链接。这个抓取规则是比较复杂的,我会要怎么写呢?
![selectable-chain-ui](http://static.oschina.net/uploads/space/2014/0404/151454_2T01_190591.png)
首先看到页面的html结构是这个样子的
![selectable-chain](http://static.oschina.net/uploads/space/2014/0404/151632_88Oq_190591.png)
那么我可以先用CSS选择器提取出这个div然后在取到所有的链接。为了保险起见我再使用正则表达式限定一下提取出的URL的格式那么最终的写法是这样子的
```java
List<String> urls = page.getHtml().css("div.pagination").links().regex(".*/search/\?l=java.*").all();
```
然后我们可以把这些URL加到抓取列表中去
```java
List<String> urls = page.getHtml().css("div.pagination").links().regex(".*/search/\?l=java.*").all();
page.addTargetRequests(urls);
```
是不是比较简单除了发现链接Selectable的链式抽取还可以完成很多工作。我们会在第9章示例中再讲到。
#### 3.2.2 获取结果的API
当链式调用结束时我们一般都想要拿到一个字符串类型的结果。这时候就需要用到获取结果的API了。我们知道一条抽取规则无论是XPath、CSS选择器或者正则表达式总有可能抽取到多条元素。WebMagic对这些进行了统一你可以通过不同的API获取到一个或者多个元素。
| 方法 | 说明 | 示例 |
| ------------ | ------------- | ------------ |
| get() | 返回一条String类型的结果 | String link= html.links().get()|
| toString() | 功能同get()返回一条String类型的结果 | String link= html.links().toString()|
| all() | 返回所有抽取结果 | List<String> links= html.links().all()|
| match() | 是否有匹配结果 | if (html.links().match()){ xxx; }|
例如我们知道页面只会有一条结果那么可以使用selectable.get()或者selectable.toString()拿到这条结果。
这里selectable.toString()采用了toString()这个接口,是为了在输出以及和一些框架结合的时候,更加方便。因为一般情况下,我们都只需要选择一个元素!
selectable.all()则会获取到所有元素。
好了到现在为止在回过头看看3.1中的GithubRepoPageProcessor可能就觉得更加清晰了吧指定main方法已经可以看到抓取结果在控制台输出了。
### 3.3 保存结果
好了爬虫编写完成现在我们可能还有一个问题我如果想把抓取的结果保存下来要怎么做呢WebMagic用于保存结果的组件叫做`Pipeline`。例如我们通过“控制台输出结果”这件事也是通过一个内置的Pipeline完成的它叫做`ConsolePipeline`。那么我现在想要把结果用Json的格式保存下来怎么做呢我只需要将Pipeline的实现换成"JsonFilePipeline"就可以了。
```java
public static void main(String[] args) {
Spider.create(new GithubRepoPageProcessor())
//从"https://github.com/code4craft"开始抓
.addUrl("https://github.com/code4craft")
.addPipeline(new JsonFilePipeline("D:\webmagic\"))
//开启5个线程抓取
.thread(5)
//启动爬虫
.run();
}
```
这样子下载下来的文件就会保存在D盘的webmagic目录中了。
### 3.2 抽取内容(xpath, regex, css selector, jsonpath)
通过定制Pipeline我们还可以实现保存结果到文件、数据库等一系列功能。这个会在第7章“抽取结果的处理”中介绍。
### 3.3 发现链接
至此为止,我们已经完成了一个基本爬虫的编写,也具有了一些定制功能。
### 3.4 处理多个页面
<div style="page-break-after:always"></div>
## 4. 使用注解
## 4. 抽取工具详
### 4.1 抽取内容(xpath, regex, css selector, jsonpath)
### 4.1 XPath
### 4.2 发现链接
### 4.2 CSS选择器
### 4.3 处理多个页面
### 4.3 正则表达式
### 4.4 在POJO中实现复杂逻辑
### 4.4 JsonPath
## 5. 配置爬虫
@ -247,25 +379,25 @@ public class GithubRepoPageProcessor implements PageProcessor {
### 6.4 定期抓取
## 7. 管理URL
## 7. 抽取结果的处理
### 7.1 手动添加URL
### 7.1 输出到控制台
### 7.2 在URL中保存信息
### 7.2 保存到文件
### 7.3 几种URL管理方式
### 7.3 JSON格式输出
### 7.4 自己管理爬虫的URL
### 7.4 自定义持久化方式(mysql/mongodb…)
## 8. 抽取结果的处理
## 8. 管理URL
### 8.1 输出到控制台
### 8.1 手动添加URL
### 8.2 保存到文件
### 8.2 在URL中保存信息
### 8.3 JSON格式输出
### 8.3 几种URL管理方式
### 8.4 自定义持久化方式(mysql/mongodb…)
### 8.4 自己管理爬虫的URL
## 9. 实例

Loading…
Cancel
Save