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的iobjectmodifiedvent。 事件包括修改字符串的键，因此您可以轻松刷新数据库连接：

<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()

更改日志