uWSGI RPC栈¶
uWSGI包含了一个快速、简单、平稳跨平台的RPC栈。
虽然，你或许会爱上这个子系统，但是，答应我，只在你需要的时候才用它，好吗？对于绝大部分常见，有大量更适合的高层次RPC技术可以用。
也就是说，uWSGI RPC子系统闪光点在于它的性能和内存使用。例如，如果你需要将一个请求的负载拆分到多个服务器上，那么uWSGI RPC是个不错的选择，因为它允许你不怎么费力就可以卸载任务。
它最大的限制在于它的“无类型”方法。
RPC函数可以接收多达254个参数。每个参数必须是一个字符串，最大大小为16位 (65535字节)，而返回值必须是一个字符串 (这次是64位，所以这不是一个实际的限制)。
警告
64位响应长度只在uWSGI 1.9.20中实现，较老的版本则是16位响应长度限制。
注解
RPC函数以二进制字符串的形式接收参数，所以每个RPC可导出函数必须假设每个参数都是一个字符串。每个RPC函数返回一个0或者拥有更多字符的二进制字符串。
所以，如果你需要“优雅的”或者强类型，那么就看看其他的吧 (或者，在uWSGI RPC之上自己处理，或许……)。
从1.9起，RPC子系统就是完全异步友好型的，因此，你可以把它跟gevent和Coro::AnyEvent等一起使用。
通过实例学习¶
让我们从一个简单的RPC调用开始，这个调用从 10.0.0.1:3031 到 10.0.0.2:3031 。
所以，让我们导出 .2 上的一个”hello”函数
import uwsgi
def hello_world():
return "Hello World"
uwsgi.register_rpc("hello", hello_world)
这使用了 uwsgi.register_rpc() 来声明一个名为”hello”的函数，以备导出。我们会用 --socket :3031 启动这个服务器。
在调用者那端，在 10.0.0.1 之上，让我们声明这个世界（第二个）最简单的WSGI应用。
import uwsgi
def application(env, start_response):
start_response('200 Ok', [('Content-Type', 'text/html')])
return uwsgi.rpc('10.0.0.2:3031', 'hello')
就这样！
你需要Perl？¶
或者也许你想要从单个perl脚本中调用一个RPC函数？
那么，比方说，Lua呢？¶
很高兴你问了。如果你想要导出Lua中的函数，简单这样：
function hello_with_args(arg1, arg2)
return 'args are '..arg1..' '..arg2
end
uwsgi.register_rpc('hellolua', hello_with_args)
而在你的Python WSGI应用中：
import uwsgi
def application(env, start_response):
start_response('200 Ok', [('Content-Type', 'text/html')]
return uwsgi.rpc('10.0.0.2:3031', 'hellolua', 'foo', 'bar')
本地进行RPC¶
本地进行RPC听起来可能有点蠢，但如果你需要从Python调用一个Lua函数，并且使用绝对最少的开销，那么uWSGI RPC就是你的人啦。
如果你想要调用定义在同一台服务器（由同一个master管理，等）上的RPC，只需设置 uwsgi.rpc 的第一个参数为None或者nil，或者使用方便函数 uwsgi.call() 。
从内部路由子系统进行RPC¶
RPC插件导出了一堆内部路由动作：
- rpc 调用指定的rpc函数，并将响应发送给客户端
- rpcnext/rpcblob 调用指定的rpc函数，发送响应给客户端，并继续执行下一条规则
- rpcret 调用指定的rpc函数，并将其返回值当成动作返回码 (next, continue, goto ...)
[uwsgi]
route = ^/foo rpc:hello ${REQUEST_URI} ${REMOTE_ADDR}
; call on remote nodes
route = ^/multi rpcnext:[email protected]:3031
route = ^/multi rpcnext:[email protected]:3031
route = ^/multi rpcnext:[email protected]:3031
从nginx进行RPC¶
由于Nginx支持对发送到上游uWSGI服务器的uwsgi包的低层次操作，所以你可以直接通过它进行RPC。疯了！
location /call {
uwsgi_modifier1 173;
uwsgi_modifier2 1;
uwsgi_param hellolua foo
uwsgi_param bar ""
uwsgi_pass 10.0.0.2:3031;
uwsgi_pass_request_headers off;
uwsgi_pass_request_body off;
}
大小为0的字符串将会被uWSGI数组解析器忽略，所以当参数数目+function_name不是偶数的时候，你可以安全使用它们。
Modifier2被设为1，来通知接收到了原始字符串 (在这个例子中，是HTTP响应)。否则，RPC子系统会将输出封装到一个uwsgi协议包中，而nginx还没智能到读取它们。