foolscap实现rpc（二）

Tubs: Foolscap服务

上面的程序我们定义了Referenceable的对象,也就是说,为外界访问这个对象提供了基础,但是外界要如何才能访问这个对象呢?换句话说,就是如何发布这个Referenceable对象的问题?Tubs被设计来完成这个功能,只要你创建一个Tub,然后告诉这个Tub需要监听的TCP端口,然后以一个便于你记忆的名字注册Referenceable对象到这个容器;若是要访问一个远程引用对象(RemoteReference)，那么你创建Tub,然后获取一个名称的RemoteReference；

   个人认为，这个还是万变不离其宗，所有的CS模型中，无非就是socket的bind、listen、connect、accept、write和read等过程；任何封装的库都是将这些更低层的抽象化；

         Tub是twisted中的一个服务子类，既然是服务就必须在启动之后才能为外界所使用。一般的流程是：创建一个Tub，附加到parent service或application对象。一旦顶层的applicat ion对象启动之后，Tub将会开始监听任何你请求的网络端口上。当Tub关闭时，将会停止监听并丢弃任何已经建立的链接。若您没有可以附着的parent service，可以在Tub上直接使用startService和stopService。

         注意：在Tub的startService被调用之前，是不会发生任何网络活动的。这就是说，任何在Tub启动之前的getReference或connectTo请求将会被延迟直到Tub服务启动。若程序忘记启动Tub服务，这些请求将不会被服务。但是在twisted.log文件中将会记录下来，以便于开发者发现这种问题。

让Tub远程可访问

为了让你的Referenceables可用，你必须首先让你的Tub可用。三个部分：赋予一个ID，监听一个端口，再给这个端口一些信息（协议/主机名/端口值，使得外部能更好访问）。

   一般说来，Tub将生成自己的ID，就是TubID，通过创建SSL公钥证书，然后hash成随机查看字符串。这是Tub的主要识别标志：所有其他仅仅是location hint，就是用来说明如何访问Tub。TubID被附着到公钥上，允许FURLs安全引用（意味着没有第三方能导致你连接到错误的引用）。你也可以在已存在的证书上创建一个Tub，这就是一个Tub可以在不同的执行中持有同一个ID。

   创建一个UnauthenticatedTub，它的TubID为空。连接和托管到一个unauthenticated Tubs不需要pyOpenSSL库，但是不提供隐私、认证、连接重定向和监听端口共享功能。指向unauthenticated Tubs的FURLs有很显著的格式（以pbu:开头），来区别于authenticated Tubs。Foolscap默认是使用authenticated Tubs。

   让Tub监听一个TCP端口就和调用listenOn一样简单。最简单的字符串是“tcp:12345”，监听所有接口上的端口12345。使用“tcp:12345:interface=127.0.0.1”将会只监听本地接口，只能让本机的其他进程访问。

   Tub需要被告知怎样才能访问它，因此能知道放置host和port到FURLs。这个location是简单的“host:port”形式，使用hostname机器上打开的TCP端口。Foolscap不能猜测hostname，特别是存在NAT盒或端口映射设备时。若你的机器能直接使用“myhost.example.com”在网上访问，那么你可能需要以下的例子：

from foolscap.api import Tub

tub = Tub()

tub.listenOn(“tcp:12345”)

tub.setLocation(“myhost.example.com:12345”)

注册Referenceable对象

一旦Tub有一个监听者和一个location，你可以发布Referenceable对象，只需要一个名称并且注册：

 furl = tub.registerReference(myserver, “math-service”)

跟踪一个远程引用对象

在客户端，你也需要创建一个Tub，即使你不需要实现（listenOn、setLocation、registerReference）序列，除非你需要发布Referenceables。使用getReference来获取其他人发布的对象引用：

from foolscap.api import Tub

 

tub = Tub()

tub.startService()

d = tub.getReference(“pb://ABCD@myhost.example.com:12345/match-service”)

def gotReference(remote):

         print “Got the RemoteReference:”, remote

def gotErr(err):

         print “err:”, err

d.addCallbacks(gotReference, gotErr)

getReference返回一个延迟的对象Deferred，在RemoteReference连接到名叫FURL的远程Referenceable上。若一个连接可用，那么会使用这个已经存在的连接，那么返回的是已存在的RemoteReference。

   getReference请求会排队直到Tub启动，下面的例子也是这样，但是最后不要忘记调用tub.startService（），否则你的程序不会运行而是一直等待：

from foolscap.api import Tub

 

tub = Tub()

d = tub.getReference(“pb://ABCD@myhost.example.com:12345/match-service”)

def gotReference(remote):

         print “Got the RemoteReference:”, remote

def gotErr(err):

         print “err:”, err

d.addCallbacks(gotReference, gotErr)

tub.startService()