RyanCrawler

以Jsoup为请求/下载模块，重构部分底层，重构请求载入结构，重写参数注入方式，嵌入部分增强功能，优化I/O流，可对单个请求定制化，并支持下载功能。

以JsoupXpath为解析模块，重构解析结构，重写函数、轴、操作符解析方式提高性能和易读性，缓存语法树，移除部分华而不实的功能，增强Xpath语法模块，且支持在筛选结果中继续XPath筛选 doc.xpath("xpath").xpath("xpath")

快速开始

public class Demo implements Processor {
	private CrawlerSite cr = CrawlerSite.create()
		.userAgent("Mozilla/5.0  (Macintosh;Intel Mac OS X 10_12_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.71 Safari/537.36")
		.ignoreContentType(true)
		.timeOut(1000)//超时时间
		.setFilePath("/Users/Rui_Statham/Downloads");// 如果填写该路径，则会默认下载访问过的页面到该页面
	public CrawlerSite getSite() {
		return cr;
	} 
	public static void main(String[] args) throws IOException {
		Response res = PageProcessor.create(new Demo()).url("https://www.baidu.com/s?wd=Java").execute();// 执行请求
		Document doc = res.parse();// 格式化doc							  doc.xpath("//div[@id='content_left']/div[position()<4]/h3/a/@href");
	}
}

请求模块

因请求模块基于Jsoup重构，为兼容原生Jsoup保留大部分API(保留95%以上)，固可参考Jsoup API；

解析模块

语法

支持标准Xpath语法（支持谓语嵌套），支持全部常用函数，支持全部常用轴，去掉了一些标准里面华而不实的函数和轴，下面会具体介绍。语法可以参考http://www.w3school.com.cn/xpath/index.asp

关于使用Xpath的一些注意事项

非常不建议直接粘贴Firefox或chrome里生成的Xpath，这些浏览器在渲染页面会根据标准自动补全一些标签，如table标签会自动加上tbody标签，这样生成的Xpath路径显然不是最通用的，所以很可能就取不到值。所以，要使用Xpath并感受Xpath的强大以及他所带来便捷与优雅最好就是学习下Xpath的标准语法，这样应对各种问题才能游刃有余，享受Xpath的真正威力！

特别说明

RyanCrawler解析模块支持以下几种写法：

原生Jsoup写法：doc.select("div#id div.class:last");

现在的写法：doc.xpath("//*[@id='id']/div[class='class']/div[last()]");

现在的写法： doc.xpath("//*[@id='id']").select("div.class").xpath("//div[last]");

现在的写法2：doc.getElementById("id").select("div.class").xpath("//div[last]");

Xpath部分示例

http://www.cnblogs.com/ 为例
//a/@href;
//div[@id='paging_block']/div/a[text()='Next >']/@href;
//div[@id='paging_block']/div/a[text()*='Next']/@href;
//h1/text();
//h1/allText();
//h1//text();
//div/a;
//div[@id='post_list']/div[position()<3]/div/h3/allText();
//div[@id='post_list']/div[first()]/div/h3/allText();
//div[@id='post_list']/div[1]/div/h3/allText();
//div[@id='post_list']/div[last()]/div/h3/allText();//查找评论大于1000的条目（当然只是为了演示复杂xpath了，谓语中可以各种嵌套，这样才能测试的更全面嘛）
//div[@id='post_list']/div[./div/div/span[@class='article_view']/a/num()>1000]/div/h3/allText();//轴支持
//div[@id='post_list']/div[self::div/div/div/span[@class='article_view']/a/num()>1000]/div/h3/allText();
//div[@id='post_list']/div[2]/div/p/preceding-sibling::h3/allText();
//div[@id='post_list']/div[2]/div/p/preceding-sibling::h3/allText()|//div[@id='post_list']/div[1]/div/h3/allText();

函数

解析器扩展函数

contains(arga,argb)这个函数暂时不支持，可以用*=取代contains() 例：//div[text()*='next']

轴

扩展轴

操作符

操作符扩展