sqlalchemy钩子

1. 基本概念

• Sqlalchemy: python Orm框架

• Session: sqlalchemy通过session和数据库进行交互, 用法是定义Session类(链接数据库)，实例session对象

• Events: Session和数据库交互过程中发生的各种事件, sqlalchemy包含一个事件API，该API发布了很多钩子; e.g.create transaction; flush; commit etc.

• State: 发生不同的SessionEvents之后的Session状态

2. 基本实现

• session实现: 定义Session类，然后实例化一个对象

>>> from sqlalchemy.orm import sessionmaker
>>> Session = sessionmaker(bind=engine)
>>> session = Session()

# engine: 引擎，定义了链接的数据库

• events实现: 事件注册，定义参数

from sqlalchemy.event import listen
from sqlalchemy.pool import Pool

def my_on_connect(dbapi_con, connection_record):
    print("New DBAPI connection:", dbapi_con)

listen(Pool, 'connect', my_on_connect)

3. Event

• Event Registration(事件注册): 通过api的方法listen()或者lister_for()装饰器来监听事件的发生。这两个方法接受三个参数：监听目标，拦截事件的标识符，自定义的监听的方法。位置参数和关键字参数只支持特殊类型的事件，可以指定事件函数的接口，或者提供关于给定事件的说明。事件的名字和一个相关监听器的标识参数，该参数是一个类的绑定的方法，例如PoolEvents.connect()的文档说该事件的名字为’connect’，并且用户自定义的监听方法应该接受两个位置参数。

from sqlalchemy.event import listen
from sqlalchemy.pool import Pool

def my_on_connect(dbapi_con, connection_record):
    print("New DBAPI connection:", dbapi_con)

listen(Pool, 'connect', my_on_