前言
RSclient是实现Rserve通信的R语言客户端程序，对于统计人员使用RSclient调用Rserve运行R语言脚本，感觉会很奇怪。但对于实际应用架构来说却是很有帮助的，不仅可以统一Rserve的接口，还可以从架构上实现R语言的跨虚拟机的分步式程序设计。
目录
- Rserve和RSclient介绍
- Rserve系统环境
- RSclient安装
- RSclient的API
- RSclient使用
- 两个客户端同时访问
1. Rserve和RSclient介绍
Rserve介绍
Rserve是一个基于TCP/IP协议的，允许R语言与其他语言通信的C/S结构的程序，支持C/C++,Java,PHP,Python,Ruby,Nodejs等。 Rserve提供远程连接，认证，文件传输等功能。我们可以设计R做为后台服务，处理统计建模，数据分析，绘图等的任务。
Rserve的使用请参考文章：R语言服务器程序 Rserve详解, Rserve与Java的跨平台通信
RSclient介绍
RSclient是Rserve客户端的R语言实现，通过RSclient可以访问Rserve服务器实例。
官方介绍：http://www.rforge.net/RSclient/
2. Rserve系统环境
服务器系统环境
- Linux: Ubuntu 12.04.2 LTS 64bit
- R: 3.0.1 x86_64-pc-linux-gnu
- Rserve: Rserve v1.7-1
启动Rserve服务器
~ R CMD Rserve
~ ps -aux|grep Rserve
conan 28339 0.0 1.2 116292 25240 ? Ss 22:31 0:00 /usr/lib/R/bin/Rserve
~ netstat -ntlp|grep Rserve
tcp 0 0 0.0.0.0:6311 0.0.0.0:* LISTEN 28339/Rserve
Rserve环境
- IP: 192.168.1.201，允许远程访问
- 端口: 6311
- 登陆认证: 用户名:conan, 密码:conan
- 字符编码: utf-8
~ R CMD Rserve --RS-settings
Rserve v1.7-1
config file: /etc/Rserv.conf
working root: /tmp/Rserv
port: 6311
local socket: [none, TCP/IP used]
authorization required: yes
plain text password: allowed
passwords file: [none]
allow I/O: yes
allow remote access: yes
control commands: yes
interactive: yes
max.input buffer size: 262144 kB
3. RSclient安装
客户端环境，远程访问
- Win7 64bit
- R: 3.0.1 x86_64-w64-mingw32/x64 b4bit
RSclient安装和加载
~ R
> install.packages("RSclient")
> library(RSclient)
4. RSclient的API
RSclient的API分为两组，Rclient(旧版本)和RCC(新版本)。
Rclient 旧版本API：函数名是大小写连写的
RSassign RSattach RSclose
RSconnect RSdetach RSeval RSevalDetach
RShowDoc RSiteSearch RSlogin RSserverEval
RSserverSource RSshutdown RSclient::
RCC 新版本API：函数名以.分隔的
RS.assign RS.authkey RS.close RS.collect
RS.connect RS.eval RS.eval.qap RS.login
RS.oobCallbacks RS.server.eval RS.server.shutdown RS.server.source
RS.switch
我主要介绍新版本API的使用
客户端操作函数
- RS.connect: 创建与Rserve的连接
- RS.close: 关闭与Rserve的连接
- RS.login: 登陆认证
- RS.authkey: 设置认证时加密算法
- RS.eval: 在Rserve远程执行R语句
- RS.eval.qap: 远程执行R语句，使用Rserve QAP序列化对象代替本地对象
- RS.collect: 等待异步执行的eval的结果，一起返回
- RS.assign: 远程执行赋值
- RS.switch: 协议转换，从QAP1到TLS QAP1
- RS.oobCallbacks: 回调函数, 通过OOB_SEND函数和OOB_MSG函数中执行
服务器管理函数：Rserve启动时，需要设置–RS-enable-control
- RS.server.eval: 服务器控制函数，执行脚步
- RS.server.shutdown: 服务器控制函数，关闭服务器
- RS.server.source: 服务器控制函数，执行服务器端本地文件
5. RSclient的使用
~ R
> library(RSclient)
#建立连接
> conn<-RS.connect(host="192.168.1.201")
> conn
Rserve QAP1 connection 0x000000000445cd60 (socket 308, queue length 0)
#登陆认证
> RS.login(conn,"conan","conan",authkey=RS.authkey(conn))
[1] TRUE
#执行脚本
> RS.eval(conn,rnorm(5))
[1] -2.6762608 1.4435144 -0.4298395 -0.7046573 -1.4056073
#设置变量
> RS.assign(conn,"xx",99)
raw(0)
> RS.eval(conn,xx-55)
[1] 44
#同步执行
> RS.eval(conn,head(rnorm(10000000)),wait=TRUE)
[1] -4.20217390 0.22353317 -1.70256992 0.30053213 -0.01427486 -0.70522254
#异步执行
> RS.eval(conn,head(rnorm(10000000)),wait=FALSE)
NULL
> RS.collect(conn)
[1] -0.2814752 0.3215521 -1.0978825 -0.8534461 -0.2459560 -0.4804882
#关闭连接
> RS.close(conn)
NULL
> conn
Closed Rserve connection 0x000000000445cc80
6. 两个客户端同时访问
客户端A
~ R
library(RSclient)
conn<-RS.connect(host="192.168.1.201")
RS.login(conn,"conan","conan",authkey=RS.authkey(conn))
RS.assign(conn,"A",1234)
> RS.eval(conn,A)
[1] 1234
> RS.eval(conn,getwd())
[1] "/tmp/Rserv/conn29039"
客户端B
~ R
library(RSclient)
conn<-RS.connect(host="192.168.1.201")
RS.login(conn,"conan","conan",authkey=RS.authkey(conn))
RS.assign(conn,"B",5678)
> RS.eval(conn,B)
[1] 5678
> RS.eval(conn,ls())
[1] "B"
> RS.eval(conn,getwd())
[1] "/tmp/Rserv/conn29040"
我们看到A,B两个客户端建立接口后，服务器端的Rserve会在两个单独的空间运行。因此，A,B两个客户端的访问是独立的。
在客户端A，设置服务器全局变量
> RS.server.eval(conn, "G<-999") :
command failed with status code 0x48: access denied
注：出现拒绝访问的错误，虽然我们已经打开了--RS-enable-control，还是有错误，不知道是不是Rserve的bug。
通过RSclient，我们就可以远程连接Rserve。如果大家发散一下想法，就可以通过Rserve和RSclient构建一个纯R的分步式计算环境。
作者介绍：
张丹，R语言中文社区专栏特邀作者，《R的极客理想》系列图书作者，民生银行大数据中心数据分析师，前况客创始人兼CTO。
10年IT编程背景，精通R ,Java, Nodejs 编程，获得10项SUN及IBM技术认证。丰富的互联网应用开发架构经验，金融大数据专家。个人博客 http://fens.me， Alexa全球排名70k。
著有《R的极客理想-工具篇》、《R的极客理想-高级开发篇》，合著《数据实践之美》，新书《R的极客理想-量化投资篇》(即将出版)。
《R的极客理想-工具篇》京东购买快速通道：https://item.jd.com/11524750.html
《R的极客理想-高级开发篇》京东购买快速通道：https://item.jd.com/11731967.html
《数据实践之美》京东购买快速通道：https://item.jd.com/12106224.html
