RCurl_Guide_中英对译.doc

引言： --入门重点：3 * 3 .第一个3 (3个函数) ..getURL ..getForm ..postForm .第二个3 (3组参数) ..curl handle’s options ..request’s options ..write function --特别说明 .RCurl 和 Libcurl库 选项(request’s options)间的关联 Duncan Temple Lang Department of Statistics, UC Davis 概览 RCurl包提供了一种高级的用R与HTTP servers交流的套件。最简单的，它允许我们下载URLs，用不同的方式提交表单和组装HTTP requests。它支持HTTPS(安全HTTP)；用passwords句柄认证；并可用FTP下载文件。同时它也句柄请求中的转义字符，二进制数据和文件上传。用户可用重写或附加HTTP request的header信息来订制对话。HTTP server返回的response被当作流来处理，并自动句柄编码为组块。当request里的默认机制简单地返回文本时，我们可以指定S函数去处理接收到的response，重定向它或用应用中的指定方式处理它。 所有这些都可以用R来写。我们可以用socket连接来写发给HTTP服务器的request和接收response。为了支持HTTPS，我们要添加SSL连接。想实现RCurl的功能，我们需要实现HTTP协议。这牵扯到正确并弹性地写HTTP headers，转义字符，二进制文件等等。想提交表单，我们要通过计算字串边界、创建结构化内容元素来组装request的body。简单的说，将会有大量要做的工作和潜在的错误。相较于用R来做，RCurl使用一个已经实现并广泛使用的C库 - libcurl来做到这些。这样做有几个好处: . libcurl经过了足够的测试并且容易对接。另外，它在很多平台上可用并且bugs已经被标识并修复了。 . libcurl被许多人和应用使用，这就意味着它支持在各种环境下的常用特性。 . libcurl是用C写的，因此够快。 不好的就是，libcurl很难被拓展。我们只能希望用hooks to customize requests来满足我们的需求。我们可以期望已经有人碰到了这些拓展性问题并且已经反馈给了libcurl的设计者。 R已经提供了下载URIs的方法，比如 download.url 和连接构造器，比如 url 。自从libcurl库实现请求和连接的数据结构变得不透明以后，用它来满足R里的一下特殊需求就变得困难了。尤其是，很难把它和S (R and S-Plus)里的连接合并。类似的，也很难把它整合到R的event-loop里，也就不能监听输入ing和把连接放到后台了。libucrul如果支持线程且R也支持线程了也许会解决这个问题。 Overview The RCurl package provides high-level facilities in R to communicate with HTTP servers. Simply, it allows us to download URLs, submit forms in different ways, and generally compose HTTP requests. It supports HTTPS, the secure HTTP; handles authentication using passwords; and can use FTP to download files. It also handles escaping characters in requests, binary data, and file uploads. Users can override or provide additional headers in the HTTP request in order to customize the communication. The response from the HTTP server is processed as a stream and chunk encoding automatically handled. While the default mechanism simply returns the text from a request, one can specify S functions to process the response as it is received, redirecting it or process