1.zope 适配器

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

###适配器
from zope.component import adapts
from zope.interface import implements, Interface, Attribute

class IDesk(Interface):
    """A frontdesk will register object's details"""

    def register():
        """Register object's details"""

class IGuest(Interface):
    name = Attribute("Name of guest")
    place= Attribute("Place of guest")

class Guest(object):
    implements(IGuest)
    def __init__(self, name, place):
        self.name = name
        self.place = place

class FrontDeskNG(object):
    #对应 IDesk 的适配器
    implements(IDesk) #实现接口

    #适配器适用于IGuest对象
    adapts(IGuest)
    def __init__(self, guest):
        self.guest = guest

    def register(self):
        guest = self.guest
        next_id = get_next_id()
        bookings_db[next_id] = {
            'name' : guest.name,
            'place': guest.place,
            'phone': guest.phone
        }

jack = Guest("Jack", "Bangalore")

#jack_frontdesk = FrontDeskNG(jack)

#被xx适配
#print IDesk.providedBy(jack_frontdesk)

#使用适配器组件之前,必须在组件注册表中注册该适配器

#在使用一个适配器组件之前，你必须在一个也被称作站点管理器的组件注册表中注册该适配器。
#通常情况下，站点管理器是属于一个站点的。站点和站点管理器在开发Zope 3应用的时候会更重要，
#现在你只需要了解全局站点和全局站点管理器（或者叫组件注册表）就可以了。
#全局站点管理器是保存在内存之中，而局部站点管理器是持久化的。

#在注册组件之前,首先需要获得全局站点管理器:
from zope.component import getGlobalSiteManager
gsm = getGlobalSiteManager()

#适配器注册成组件,需要调用组件注册表的 registerAdapter 方法。
#第一个参数是适配器的类或者工厂
#第二个参数是一个由多个适配者（adaptee 也就是适配器所适配的对象）所组成的tuple
#第三个参数是由该适配器组件所实现的接口
#第四个参数是个可选参数，提供了该适配器的名称
#如果给出了适配器名称，那么该适配器就是一个已命名适配器，如果没有给出适配器名称，
#那么该参数默认为一个空字符串（ '' ）
#注：
gsm.registerAdapter(FrontDeskNG, (IGuest,), IDesk, 'ng')

#上面的组件注册流程中，我们给出了适配者（adaptee）的接口和适配器所提供的接口，
# 不过由于在适配器的实现中已经给定了这些细节，注册的时候完全没有必要再次指定这些参数，
# 事实上，我们完全可以像下面这样注册这个适配器:

gsm.registerAdapter(FrontDeskNG, name='ng')

#局部组件是持久化组件，而全局组件是保存在内存之中。
#全局组件是根据应用的设置进行注册的，
#而局部组件是在应用启动的时候从数据库中加载到内存的。

#查询适配器
from zope.component import getAdapter, queryAdapter
#从组件注册表中获取已注册的组件是通过 zope.component 包中的两个函数来完成的。
#一个是 getAdapter 另一个是 queryAdapter 。两个函数都接受相同的参数，
#不过如果无法找到组件，那么 getAdapter 会抛出 ComponentLookupError ，
#而 queryAdapter 会返回 None 。

#在上一节中，我们以'ng'为名字注册了一个组件，这个组件提供了 IDesk 接口，
#并且适配于房客对象（适配者 adaptee）。

#下面就是如何获取一个既适配于 jack 对象的接口（ IGuest ），
#又提供了 IDesk 接口，同时被命名为 ng 的组件的例子。
#在这里， getAdapter 和 queryAdapter 的作用是一致的:

print getAdapter(jack, IDesk, 'ng')

print queryAdapter(jack, IDesk, 'ng')

#第一个参数是适配者（adaptee），然后是组件应该提供的接口，最后是适配器组件的名字。

#如果我们试图查找一个有相同的接口和适配者（adaptee）但是使用一个没有被注册过的名字的组件，
#那么查询会失败

#print getAdapter(jack, IDesk, 'not-exists')
print queryAdapter(jack, IDesk, 'not-exists')

#在查找失败的时候，getAdapter 抛出一个 ComponentLookupError 异常，
#而 queryAdapter 返回 None

#第三个参数，也就是组件的注册名，是可选项。如果没有提供第三个参数，
#那么这个参数默认为空字符串。由于之前我们没有用空字符串注册组件，
#getAdapter 会抛出 ComponentLookupError ，类似的，
#queryAdapter 会返回 None

print queryAdapter(jack, IDesk)

##在这一节中，我们学习了如何注册一个简单适配器和如何从组件注册表中获取这个适配器。
##这类适配器被称为简单适配器是因为它只适配于一个适配者（adaptee）。
##如果一个适配器适配于多个适配者（adaptee），那么这个适配器被称为多重适配器。

####**利用接口来获取适配器

#我们可以利用接口来直接获取适配器，不过这种方式只能获取未命名简单适配器。
#第一个参数是适配者（adaptee），第二个参数是一个关键字参数，
#如果适配器查找失败，那么就会返回第二个参数:

print IDesk(jack, alternate='default-output')
print IDesk(jack, 'default-output')

#如果没有给出第二个参数，那么会抛出 TypeError
#print IDesk(jack)
#下面我们采用无命名方式来注册 FrontDeskNG:

gsm.registerAdapter(FrontDeskNG)

print "xxxxxxxx"
print IDesk(jack)

###4.5适配器模式
##在Zope组件架构中的适配器概念和《设计模式》一书中的经典 适配器模式 是非常类似的；
#但是，ZCA中的适配器的设计应用目标要比 适配器模式 广泛的多。
# 适配器模式的目的是把一个类的接口转换为客户需要的另一个接口，
# 这可以使得本来不兼容的几个类在一起工作。但是在《设计模式》一书中的“设计动机”一节中，
# GoF提到：“通常情况下，适配器需要负责提供适配类没有提供的功能”。
# ZCA的适配器更多的着眼于为适配对象（适配者 adaptee）增加功能而不是创建新的接口。
# ZCA的适配器允许适配器类对象通过增加方法的方式来扩展功能

#但是在下面一句话中，我使用了“适配对象”来替代“适配类”。
#这是因为GoF在书中描述了根据实现不同区分的两种适配器，一种是 类适配器
#另一种则是 对象适配器 。类适配器采用多重继承来把一个接口适配为另外一个，
#而对象适配器依赖于对象组合来完成适配。

#ZCA的适配器采用了对象适配器模式，并且采用委托（delegation）模式作为组合机制。
#GoF的面向对象设计第二原则就是：“倾向于对象组合而不是类继承”.

#ZCA适配器的主要优势就是在于明确组件的接口和组件注册表。
#ZCA的适配器组件都在组件注册表中进行过注册，客户对象可以在需要的时候根据名字和接口来查找这些适配器。