zg手册 之 twisted 开发（1）-- twisted 框架介绍

异步非阻塞框架

twisted 是一个事件驱动的网络开发框架，使用 python 开发。

twisted 框架编写的服务器有几个基本的元素:

1. 应用程序对象(application)：管理应用程序资源的对象，一个应用程序可以管理多个service对象。

2. 服务(service)，服务对象启动监听的端口，

3. 协议工厂(factory)：当客户端连接到服务器时，用来创建协议对象。

4. 协议(protocol)：每个协议对象对应一个网络连接。协议类处理网络协议（如http，ftp，自定义协议等）

twisted 框架内部运行依赖的元素:

1. reactor：异步事件的主要循环处理类，负责监控事件，调用注册的回调函数提供服务。（在linux上主要使用epoll/select来实现）

2. defer: 异步回调序列，当序列被执行的时候，顺序执行注册的回调函数。

官方的一个例子

实现一个 echo server，创建文件 echoServ.py

#!/usr/bin/env python
# coding: utf-8

from twisted.internet.protocol import Protocol
from twisted.internet.protocol import Factory
from twisted.internet.endpoints import TCP4ServerEndpoint
from twisted.internet import reactor

class Echo(Protocol):
        '''协议类实现用户的服务协议，例如 http,ftp,ssh 等'''
        def __init__(self, factory):
                self.factory = factory

        def connectionMade(self):
                '''连接建立时被回调的方法'''
                self.factory.numProtocols = self.factory.numProtocols + 1
                self.transport.write("Welcome! There are currently %d open connections.\n" %
                                (self.factory.numProtocols,))

        def connectionLost(self, reason):
                '''连接关闭时被回调的方法'''
                self.factory.numProtocols = self.factory.numProtocols - 1

        def dataReceived(self, data):
                '''接收数据的函数，当有数据到达时被回调'''
                self.transport.write(data)


class EchoFactory(Factory):
        '''协议工厂类，当客户端建立连接的时候，创建协议对象，协议对象与客户端连接一一对应'''
        numProtocols = 0
        def buildProtocol(self, addr):
                return Echo(self)


if __name__ == '__main__':
        # 创建监听端口
        reactor.listenTCP(8007, EchoFactory())

        # 开始监听事件
        reactor.run()

运行服务程序

python echoServ.py

测试服务程序

telnet 127.0.0.1 8007

例子程序的说明

1. 协议类继承自 twisted.internet.protocol.Protocol，需实现 dataReceived 等方法。在协议类中实现应用协议。

2. 协议工厂继承自 twisted.internet.protocol.Factory，需实现 buildProtocol 方法。协议工厂负责实例化协议类，不应该保存于连接相关的状态信息。

3. transport 就是连接对象，通过它进行网络写数据。
   

使用 daemon 的方式运行程序

使用守护进程的方式运行服务，需要提供一个 tac 配置文件（这就是一个 python 文件，只是扩展名不同），并且在这个文件中需要创建一个应用程序对象，对象名必须是 application。

创建一个 echo.tac 文件

#!/usr/bin/env python
# coding: utf-8

from twisted.application import service, internet
from echoServ import EchoFactory

# 创建应用程序对象
application = service.Application('Echo 服务程序')

# 创建 service 对象
myServices = internet.TCPServer(8007, EchoFactory())

# 设置 application 为 service 的父元素
myservices.setServiceParent(application)

用守护进程方式运行服务

twistd -y echo.tac

停止服务

kill -15 pid

总结

上面就是 twisted 网络框架编写服务的基本方法，在框架内部有丰富的协议工厂，协议，可是很方便的实现简单的 http，ftp，ssh 等服务器程序。

后面我会介绍一些常用的功能的实现原理，例如：如何记录日志，客户端 http 异步请求的处理，defer 运行原理等。

原文链接: http://www.hopez.org/blog/9/1403349568