collective.saconnect 2.0.1

简介

此包提供了一个简单的控制面板和存储，用于SQLAlchemy连接字符串。它提供了一个表单，可以添加和删除命名连接，并提供GS导入和导出步骤来管理这些连接。

此包本身不提供SQLAlchemy集成；请使用如zope.sqlalchemy、collective.lead或pas.plugins.sqlalchemy之类的库。

示例用法

from zope.app.component.hooks import getSite
from collective.saconnect.interfaces import ISQLAlchemyConnectionStrings

saconnect = ISQLAlchemyConnectionStrings(getSite())
myconnection = saconnect['myidentifier']

ISQLAlchemyConnectionStrings 作为简单的字典使用，尽管它的键和值必须是简单的字符串。

要使用 GenericSetup 导入连接字符串，只需在你的配置文件中包含一个名为 saconnections.xml 的文件，其中包含顶层“connections”元素，并为每个连接包含一个具有名称和字符串属性的“connection”元素。

<?xml version="1.0"?>
<connections>
 <connection name="bar" string="sqlite:////path/to/bar.sqlite"/>
 <connection name="foo" string="oracle://username:password/tnsnamethere"/>
</connections>

要删除任何连接，请使用“remove”属性。

<?xml version="1.0"?>
<connections>
  <connection name="bar" remove=""/>
</connections>

如果你缓存了 SQLAlchemy 连接，你可能想监听 ISQLAlchemyConnectionStrings 的 IObjectModifiedEvent。该事件包括修改字符串的键，这样你就可以轻松地刷新你的数据库连接。

<subscriber
    handler=".mymodule.saconnectionUpdated"
    for="collective.saconnect.interfaces.ISQLAlchemyConnectionStrings
         zope.lifecycleevent.interfaces.IObjectModifiedEvent"
/>

def saconnectionUpdated(connections, event):
    if 'myconnectionstring' in event.descriptions:
        getUtility(IDatabase, u'myconnection').invalidate()

变更日志