14.1.1   数据库适配器(DA)

Zope支持现有的很多种关系数据库， 如商业的Oracle、DB2、SQLSever、InterBase等， 还有开源实现的PostgreSQL、 MySQL等， 还有一种是Zope自带的以Python语言实现的Gadfly关系数据库。

Zope使用称为 数据库适配器 (Database Adapter)的对象作为与实际的关系数据库的接口， 不同的关系数据库有不同的连接适配器， 为了从Zope中访问关系数据库，你需要下载安装相应的数据库连接适配器产品。

同时还因为连接适配器产品就是给关系数据库和Zope之间建立一座桥梁， 它的内部是直接使用这个关系数据库的Python编程访问接口， 你还需要给Python安装与你要连接的数据库相应的Python访问接口。 一般在数据库软件供应商的网站上可以下载到相应的Python访问接口软件包。

上表中所列出的只是一些最常用的关系数据库， 并且在Zope网站上已有很多人贡献的数据库连接适配器产品。 即使某种数据库尚没有相应的数据库连接适配器， 只要它有相应的Python语言编程接口也很容易将这种适配器写出来。

另一方面，还有像ODBC这样的由众多商业、开源数据库支持的跨平台的数据库工业标准协议也被Zope所支持， 也就是说即使你使用的数据库没有相应的Zope上的连接适配器，但只要它是支持ODBC标准的， 那么也可以使用ODBC连接适配器来连接你的关系数据库。

值得一提的是这个Gadfly关系数据库是用Python编写的。 它内置在Zope中，用来做演示或处理小批量的数据。 它很快，但是不适用于处理大量数据，因为它把所有的数据都读入内存来处理。 关于Gadfly本身可以在Chordate的网站上获得更多的情况。

14.1.2   连接到MySQL数据库

连接关系数据库的另一个概念是连接字符串。 除了Gadfly，其它关系数据库都是Zope的外部扩展。 连接外部的关系数据库都需要使用连接字符串。

下面以常见的MySQL为例说明连接字符串。

在给Python安装好python-mysqldb并给Zope安装了ZMySQLDA这个Zope产品之后， 启动至Zope管理界面上在添加下拉列表中可以看到 Z MySQL Database Connection 这一项， 选择这个项后会出现如图14.1的界面：

图 14.1 MySQL 数据库连接

图中可以看到MySQL数据库使用的连接字符串格式是:

[+/-]database[@host[:port]] [user [password [unix_socket]]]

这个字符串格式中以 [] 引用的部分表示是可选的部分。 如最典型的情况是:

database user password

这指定了数据库名称和连接所使用的用户名密码信息， 对应着在本地运行的Mysql数据库，并且运行在Mysql的标准端口上。

其它可选的参数分别用于不同的目的：

连接字符串是与关系数据库连接的一个必需的信息， 其它关系数据库也使用与MySQL类似的连接字符串。 这里使用到MySQL的例子只是为了说明在Zope中配置连接一个关系数据库是很简单的。 在这个界面上单击Add按钮就是添加了连接对象， 这是一个Zope中的对象，本章稍后会详细介绍它的用途。

14.1.3   Gadfly数据库连接对象

本章后面的例子将以Gadfly配置为例，因为这种关系数据库配置起来最为简单， 在你没有部署关系数据库的情况下也可以试验Zope支持关系数据库的强大功能。 同时因为Gadfly数据库是内置于Zope运行的，它是不需要连接字符串的， 这样也给本章讲述的重点是操纵数据库简化了许多操作， 避免因为数据库本身可能存在的问题影响了运行本章示例的结果。

从Zope根目录的添加列表中选择 Z Gadfly Database Connection 来添加一个 Gadfly 数据库连接。 这会进入到一个与上面的添加MySQL适配器类似的表单页面中。 在这里输入 id 为 Gadfly_database_connection ， 并选择 Data Source 为 demo ，点击 Add 按钮。 这样就增加了一个 Gadfly 数据库连接。

单击新建的数据库连接对象，看到的是它的状态页。 从本页可以知道你是否连接到了数据库（有一个按钮控制数据库的连接和断开）。 一般情况下，Zope会自动连接到数据源。某些情况下，你可能想到手工控制数据库的连接。 对Gadfly来说，它是把所有数据都加载到内存中，断开连接没有什麽意义， 但是对于外部的数据库，就有必要手工控制它们的连接。

下一页是属性页，如图14.2所示。 该页显示数据源和连接对象的其他一些属性。 "Title" 属性是一般Zope对象都有的，可以保持为空， 这里比较有用的是数据源属性和是否立即连接属性。 当你想把数据源换成另外一个时，就会用到数据源属性， 下面的 "Connect Immediately" 属性控制了是否立即连上数据库。

图 14.2 属性页

14.1.4   测试数据库连接

在测试页可以测试你的数据库连接。在该页，你可以直接输入SQL语句操作你的数据库。 该页用来测试数据库，同时运行SQL语句（比如创建一个表）。 此处不宜输入过多的SQL语句。SQL语句要放在ZSQL方法中，本章后面将作讲解。

让我们在数据库中创建一个表以便展示本章的例子。测试页允许直接输入SQL语句操作数据库。 你可以在测试页输入SQL创建数据表，创建名为employees的表使用如下SQL语句:

CREATE TABLE employees
(
  emp_id INTEGER,
  first  VARCHAR,
  last   VARCHAR,
  salary FLOAT
)

单击提交按钮运行这条SQL语句。Zope会返回一个验证页告诉你什么SQL在运行和可能的结果。 此处创建表的SQL会因你的数据库不同而各异。 数据库建表的确切语句，请参考你的具体的数据库提供商的文档。 还需要注意的是有些数据库如MySQL在客户端操作时需要一个分号结尾， 但是这里在测试标签页中不需要分号。

这个SQL语句将在Gadfly数据库中新建一个名为employees的表。 该表有四列：emp_di,first,last,salary。 一列是员工的id，这是标志员工的唯一号码。 接着的两列类型是VARCHAR，该类型和字符串类似。 salary列的类型是FLOAT，即浮点数。不同的数据库提供不同的数据类型，参考相关文档查看你的数据库支持的数据类型。

为了保证员工号是唯一的，需要为表创建一个索引。在测试页输入下面的SQL语句:

CREATE UNIQUE INDEX emp_id ON employees
(
  emp_id
)

现在你有了一个表并且创建了一个索引，要验证你的表，转到浏览页。该页显示了数据库的表和它们的模式。 在这里，你可以看到一个employees表。假如点击了前边的“加号”，该表会展开，显示出四列：emp_id,first,last,salary。 如图14.3所示：

图 14.3 浏览数据连接

当创建多表复杂SQL应用时，这是非常有用的，各表的结构一目了然。但不是所有的数据库都支持表的浏览。

注意， 一个Zope连接对象只对应一个用户连接关系数据库， 如果你想要连接多个数据库， 或者使用不同用户连接到一个数据库， 都需要使用多个数据库连接对象。

14.2.1   DTML简介

ZSQL的目的是为了创建动态的SQL语句， 在Zope中，ZSQL的这种动态特性是使用DTML技术来实现的。 因此这一节先对DTML技术作一个简单介绍。

DTML全称为动态模板标记语言(Dynamic Template Markup Language)， 它适合于生成各种类型的文本结构。 但DTML技术现在已经过时了，在生成xhtml结构化文本的领域已经由页面模板(zpt)技术所取代， 只在少数需要生成非xhtml文本的领域，如动态生成css文件，动态生成SQL语句等， 仍然在使用着DTML技术。前面章节中，我们知道，Plone的css文件全部采用DTML生成。 这里简单对DTML技术进行介绍。

在Zope的添加选择框中，可添加两种DTML对象，分别是DTML Method和DTML Document，但DTML Document已经过时，我们一般使用DTML Method对象。

如图所示是一个DTML方法(DTML Method)的编辑表单：

图 14.4 DTML方法

在DTML中包含两种标记：单一标记与区块标记。 单一标记由一个标记及小于(<)、大于(>)符号组成，例如var标记就是一种单一标记:

<dtml-var parrot>

单一标记不需要替var作结束的动作。这一句的意思是替换成parrot变量的内容。 上面的语句，还可以简化如下书写:

&dtml-cockatiel;

区块标记则由两个标记组成，其中一个开启此区块，另一个用以关闭区块，而内容夹在二者之间。 开启标记启动这个区块，而结束标记将之结束。 “结束标记”与“开启标记”的名字相同，但是“结束标记”的前面会加一个斜线(/)，这跟HTML、 XML的习惯相同。

让我们看一个使用DTML生成的css文件片段示例:

<dtml-with happy_logo.jpeg>
background: <dtml-var darkColor> url("<dtml-var id>");
width: <dtml-var width>px;
height: <dtml-var height>px;
</dtml-with>

这里引入了dtml-with这个区块标记。 dtml-with用于指定一个新的名字空间，表示优先从with所指明的对象(happy_logo.jpeg)上读取属性。 后面的几个dtml-var标记中，id、width、height都是对象"happy_logo.jpeg"的属性， 因此直接从"happy_logo.jpeg"对象上读取。

其他Plone会使用的DTML标记，还包括dmtl-in。dmtl-in表示循环，和tal:repeat的功效类似，这里就不多介绍了。

14.2.2   添加ZSQL方法对象

下面创建一个名为hire_employee的ZSQL方法用来给employees表添加一条新纪录。 当雇佣新员工时调用这个方法在employees表中插入新员工的记录。

同样是从ZMI管理界面的添加列表中选择 "Z SQL Method" 转到ZSQL方法的添加表单页， 如图14.5所示：

图 14.5 ZSQL方法的添加页

同新建其它对象一样，你要为ZSQL方法指定id和title，只有id是必需的。 另外，需要为ZSQL方法指定一个数据库连接对象。 因为这里只创建了一个Gadfly连接对象，因此在Connection Id中只一个可选项。 以hire_employee为id，以Gadfly_database_connection为连接对象新建一个ZSQL方法。

接下来你可以给ZSQL方法指定参数。就像脚本一样，ZSQL方法能接受参数。 参数用来构造SQL语句。本例中要指定四个参数：员工号，名字，姓氏和员工的薪水。 在参数框中输入 emp_id first last salary ，参数可以各自写在一行上，也可以都写在一行中，中间用空格分开。 参数也可以像Script (Python)一样使用默认参数值。例如：emp_id=100表示emp_id的缺省值是100。

最后的文本框里输入查询模板。此处包含的是调用ZSQL时执行的SQL语句。在此处输入下面的SQL语句:

INSERT INTO employees (emp_id,first,last,salary) VALUES
(
  <dtml-sqlvar emp_id type="int">,
  <dtml-sqlvar first  type="string">,
  <dtml-sqlvar last   type="string">,
  <dtml-sqlvar salary type="float">
)

注意到这里就使用了DTML语句，使用设置了type属性的dtml-sqlvar来引用emp_id等变量。 这里的dtml-sqlvar的作用与dtml-var类似，但提供了更多SQL功能特性，下文会详细解释。

这里对ZSQL的语法作简单介绍就是：

• 它是一种生成的SQL语句的语言，因此其主体结构是以SQL为基础

• 执行参数放在DTML标记中:

  <dtml-sql* parameter prop="propvalue">
  

  其中的parameter就是在ZSQL的参数上声明的参数， dtml的部分有dtml-sqlvar,dtml-sqltest,dtml-sqlgroup几种形式， 针对这几种形式有不同的属性="属性值"，本章后面会分别介绍。

因此，假如emp_id=42,first='Bob',last='Uncle',salary=50000.00,这里生成的SQL将会是:

INSERT INTO employees (emp_id,first,last,salary) VALUES
(42,'Bob','Uncle',50000.00)

新建ZSQL方法有三个按钮选择。Add按钮将新建ZSQL方法并返回该对象的文件夹。 Add and Edit按钮将新建ZSQL方法并进入此方法的编辑页。 Add and Test按钮新建ZSQL方法后会自动转到测试页，可以在这里测试新建的ZSQL方法。 现在单击添加按钮新建一个ZSQL方法。

现在你创建了插入新员工记录的ZSQL方法，还需要一个ZSQL方法来查询员工。 以list_all_employees为id新建一个ZSQL方法。不需要参数，SQL语句如下:

SELECT * FROM employees

这条简单的SQL语句会返回employees表中的所有记录。

14.2.3   测试ZSQL方法

现在你有了两个ZSQL方法：一个用来插入新员工，另一个用来显示数据库中所有的员工。 让我们测试一下这两个方法：先插入一些新员工，然后罗列出他们。进入hire_employee方法的测试页， 如图14.6所示。

图 14.6 hire_employee的测试页

在这里可以看到一个有四个输入框的表单，对应ZSQL方法的四个参数。 Zope根据ZSQL方法的四个参数自动生成了这个表单。 hire_employee方法有四个参数，所以Zope生成了一个四个输入框的表单。 输入一个员工号42，名字Bob，姓氏McBob和薪水50000.00测试这个方法。 单击Submit Query按钮，你将看到测试的结果。

结果显示本语句不返回任何对象。这是因为hire_employee方法只是插入记录，不进行任何选择，不返回任何记录。 同时你可以看到查询模板生成的SQL语句。同期望的一样，sqlvar DTML将四个参数插入了要执行的SQL语句。 反复测试这个SQL方法可以将多个员工的信息插入数据库中。

为了验证数据是否插入到表中，选择list_all_employees ZSQL方法并进入它的测试页。 测试这个方法不需要输入，因为它没有参数。 直接点击Submit Query提交查询：

图 14.7 list_all_employees的测试页

这个方法返回employees表的内容。 虽然你添加的记录或许与这不一样，但可以看到一个类似的结果。 你加入的新员工都被显示出来了。

14.2.4   使用ZSQL方法的更多SQL功能

ZSQL是一种DTML扩展而来的技术，它在DTML的基础上扩展了一些专用于构造复杂SQL查询的标记， 有sqlvar,sqltest,sqlgroup这三个，下面我们将分别学习。

SELECT * FROM employees WHERE emp_id=<dtml-var emp_id>

"12; DROP TABLE employees"

SELECT * FROM employees WHERE emp_id=12; DROP TABLE employees

SELECT * FROM employees WHERE emp_id=<dtml-sqlvar emp_id type="int">

SELECT * FROM employees WHERE <dtml-sqltest salary op="gt" type="float">

SELECT * FROM employees WHERE salary>10000

name in ("Bob","Billy")

results = context.test_zsql(name=["Bob", "Billy"])

<dtml-sqltest name type="string" op="like">

name like 'Mc%'

SELECT * FROM employees WHERE <dtml-sqltest emp_id op="gt" type="int">

<tal:rep repeat="item python:here.employee_by_id(emp_id=42)">
  <h1><span tal:replace="item/last" />, <span tal:replace="item/first" /></h1>

  <p><span tal:replace="item/first" />'s employee id is <span tal:replace="item/emp_id" />.
  <span tal:replace="item/first" /> makes <span tal:replace="python: '$%.2f' % item.salary" />
  per year.</p>
</tal:rep>

## Script (Python) "join_name"
##parameters=id
##
for result in context.employee_by_id(emp_id=id):
  return result.last + ', ' + result.first

SELECT * FROM employees

SELECT * FROM employees WHERE (salary>10000.00)
SELECT * FROM employees WHERE（salary>10000.00 and first in ('Jane','Cheetach','Guido'))
SELECT * FROM employees WHERE（first='Old' and last='McDonald')

SELECT * FROM employees
<dtml-sqlgroup where>
  <dtml-sqltest salary op="gt" type="float" optional>
<dtml-and>
  <dtml-sqltest first op="eq" type="string" multiple optional>
<dtml-and>
  <dtml-sqltest last op="eq" type="string" multiple optional>
</dtml-sqlgroup>

SELECT * FROM employees
<dtml-sqlgroup where>
  <dtml-sqlgroup>
    <dtml-sqltest first op="like" type="string">
  <dtml-and>
    <dtml-sqltest last op="like" type="string">
  </dtml-sqlgroup>
<dtml-or>
  <dtml-sqltest salary op="gt" type="float">
</dtml-sqlgroup>

SELECT * FROM employees
where (
( first like 'A%'
and
last like 'Smith'
)
or
salary > 20000.0
)

14.3.1   在Script(Python)中调用ZSQL方法

ZSQL方法的作用是从数据库中获得数据，它在程序中一般充当着数据源的角色， 它们本身是一类型的称之为可调用的对象， 可以在任何需要的地方如页面模板或其它Script (Python)中使用ZSQL方法来调用它的查询结果。

如这是一个在Script中的简单应用:

## Script (Python) "test_data"

results = context.list_all_employees()
for r in results:
    print r.emp_id, r.last, r.first, r.salary
    # more process on result object

return printed

经过Test标签页执行可以看到输出结果:

30 Five John 3.0
47 kljIJ noth 2000.0
42 Mc Bob Bob 50000.0
38 Stallman Jaudy 3000.0
58 Iuc Renc -3000.0
56 bdfbWRG gbfvb 347

这个例子中可以看到，在其中应用了ZSQL方法list_all_employees， 对它的调用与调用函数的方式相类似，也与直接以Python的对象上的方法调用是一样的。

同时还可以看到，这个ZSQL方法的调用返回的对象类似于Python的列表， 列表中的每一个对象上面都有以数据库表结构字段为关键字的属性。

查询关系数据库中返回的是记录的序列。记录也称为“行”。 因为SQL查询结果总是记录集，即使只有一条记录，返回的也是一个仅仅包含一条记录的记录集。 因此ZSQL方法总是返回记录集，不管记录集是空还是只有一条记录。

一条记录也称为‘返回对象’。可以把它想成是一条记录映射的Zope对象。该对象的属性对应数据表的模式。

‘记录对象’和其它的Zope对象最重要的一条区别是：‘记录对象’不会是长久的Zope对象。 记录对象生命周期很短，一旦它返回了结果就会消亡。下次调用ZSQL方法时将得到新建的记录对象。

在本章稍后会对这个返回的对象所支持的所有特性作详细的说明。

14.3.2   直接指定参数调用ZSQL方法

如果你的ZSQL方法像hire_employee是有参数的，在这里还可以像普通的Python传参数的方式一样来调用， 例如，要在程序中使用hire_employee向数据库插入数据，可以这样操作:

## Script (Python) "test_insert"

from random import randint

result = context.hire_employee(emp_id=randint(0, 10),
                  first='Andy', last='Stallman', salary=4000.00)
for row in result:
  for col in row:
    print col

return printed

在这里的代码中使用了random模块的randint函数，是为了在插入数据时使用随机的emp_id， 因为数据库中已创建了这是一个UNIQUE index，在多次插入数据时要保持emp_id是不同的。 如果刚好出现了两个随机值是相同的，数据库会报告冲突。

现在可以在Script(Python)的Test标签页上测试运行，但你发现单击Test标签页去几乎没有任何变化， 这是因为这里的print打印语句没有输出，虽然上一个list_employees有很多的输出， 但这里是对数据库插入操作，数据库确实没有没有返回任何数据。 反复多测试几次，0至9这10个数字很快就会有相同的了，于是报告了emp_id不唯一的冲突。

14.3.3   在页面模板中调用ZSQL方法

在Script(Python)中可以打印ZSQL方法的查询结果但功能有限，如果你希望有更漂亮的网页界面效果应该使用页面模板。

这是使用页面模板的一个例子:

<ul>
  <li tal:repeat="item here/list_all_employees">
    <span tal:replace="item/emp_id" />:
    <span tal:replace="item/last" />, <span tal:replace="item/first" />
    makes <span tal:replace="python: '$%.2f' % item.salary" /> a year.
  </li>
</ul>

测试运行它，这个页面模板将生成类似于如下的HTML输出，当然你的数据库中的数据也可以更少或更多:

<ul>
  <li>
    30: Five, John
    makes $3.00 a year.
  </li>
  <li>
    47: kljIJ, noth
    makes $2000.00 a year.
  </li>
  <li>
    27: fJIWEF, fljklhkLKJ
    makes $340.00 a year.
  </li>
</ul>

这里可以看到，在页面模板中调用它与调用其它Script(Python)也是一样的， 在Zope中对于所有可调用对象的调用都是一样的，如果可调用对象是有参数的(如有参数的ZSQL方法)， 那你就不能直接使用路径表达式了，可以使用Python表达式来向其传入参数。

14.3.4   使用Z Search Interface生成用户界面

在对ZSQL方法list_employees进行测试时可以看到，Zope为你自动生成了表格。 你可以使用页面模板定制一个输入界面，并使用更好的表格或其它页面形式来显示结果给你的用户。 但Zope有一种生成简单的查询界面的方法，就是使用 Z Search Interface 。

从添加下拉列表中选择Z Search Interface，可以看到一个输入界面，在Searchable Objects上选择 hire_employee ， 在Report Id上填入 hireEmployeeReport ，在Search Input Id上填入 hireEmployeeForm ， 并选中Generate Page Templates，单击Add按钮。

这将在当前工作目录中增加两个页面模板，hireEmployeeForm用于输入界面，hireEmployeeReport用于报告输出。

选择新建的hireEmployeeForm并进入其View页，输入一个新员工的employee_id,名字，姓氏，薪水并提交表单。 Zope返回页显示：“这个查询无返回数据”。 这是因为Z Search Interface生成的返回页要显示ZSQL方法的返回对象，而hire_employee方法不返回任何对象， 它只把员工的信息插入表中。 因此我们修改hireEmployeeReport页面模板以便返回更直观的信息。

打开hireEmployeeReport就会发现，这段页面模板真的很复杂。 它用来自动生成序列元素的表格。但这里不需要这些，可以全部删除，改成简单的:

<html>
<head>
  <tal:dummy define="dummy here/hire_employee" />
</head>
<body>
  <p><a href="listEmployees">list</a></p>
  <p><a href="hireEmployeeForm">Back</a></p>
</body>
</html>

这里可以看到在head标记内，使用tal定义了一个dummy变量，但下文中并未使用到。 这是因为hire_employee方法的调用结果是无输出的，不需要其返回值， 这里使用定义语句只是为了要调用一次这个hire_employee方法。

还有一个问题就是hire_employee方法是有参数的，这些参数是如何传入的呢？ 这就需要查看hireEmployeeForm的内容了，打开它可以看到其中有一个form结构，其action是hireEmployeeReport， 还有代表各个参数的input域，name正好就是hire_employee所需要的参数。 也就是说用户在提交hireEmployeeForm页面表单时，将执行hireEmployeeReport页面模板， 根据Zope发布原理一章的表单变量自动转换知识可以知道这些input会自动转换为参数调用形式交给hire_employee方法。

现在你已经有了雇佣员工的全部用户界面。使用Zope的安全策略，可以授权给特定的用户来使用这些方法。 使用Z Search Interface生成的表单/返回界面也可以方便地修改成你所需要的形式。

14.4.1   查询结果对象上的其他方法

除了上面例子中用到的操作，还有一些也很常用：

• len(result): 调用Python的内置函数len返回结果对象的长度， 可以把这个结果就看作对象列表，因此使用len是必然的， 它返回查询结果的行数，如:

  result = context.list_all_employees()
  print len(result)
  

• result.names(): 返回列的标题列表如:

  ['EMP_ID', 'SALARY', 'LAST', 'FIRST']
  

  这个方法返回的是字符串的列表。

• result.tuples(): 返回一个tuple的列表，如:

  [(43, 'Bob', 'Roberts', 50000),
   (101, 'Cheeta', 'leCat', 100000),
   (99, 'Jane', 'Junglewoman', 100001)]
  

• result.dictionaries(): 将结果变换成字典的列表形式返回:

  ## Script (Python)
  
  result = context.list_all_employees()
  print result.dictionary()
  
  return printed
  

  它返回的结果是查询数据的字典形式的列表:

  [{'emp_id': 42, 'first': 'Bob','last': 'Roberts', 'salary': 50000},
   {'emp_id': 101, 'first: 'Cheeta', 'last': 'leCat', 'salary': 100000},
   {'emp_id': 99, 'first': 'Jane', 'last': 'Junglewoman', 'salary': 100001}]
  

• result.data_dictionary(): 这个返回的结果也是字典形式，如在这个Script (Python)中:

  ## Script (Python)
  
  result = context.list_all_employees()
  print result.data_dictionary()
  
  return printed
  

  可以返回如下形式的结果:

  {'EMP_ID': {'width': None, 'null': None, 'type': 's', 'name': 'EMP_ID'},
   'SALARY': {'width': None, 'null': None, 'type': 's', 'name': 'SALARY'},
   'LAST':   {'width': None, 'null': None, 'type': 's', 'name': 'LAST'},
   'FIRST':  {'width': None, 'null': None, 'type': 's', 'name': 'FIRST'}}
  

  实际的是Python打印一个字典值时会将它打印在一行上，这里对它作了简单的格式化。

  可以看到，它返回的结果字典是仅包含表头字段的，但它比 names 方法返回了更多的信息： 它的结果还包含了各个字段的SQL属性，即宽度，可否为空，类型值，然后是表中的列名。

• result.asRDB(): 以一种类似于数据表格的形式输出，如在这个Script (Python)中将它打印出来:

  ## Script (Python)
  
  result = context.list_all_employees()
  print result.asRDB()
  
  return printed
  

  显示结果:

  EMP_ID  SALARY  LAST    FIRST
  Nones   Nones   Nones   Nones
  30      3.0     Five    John
  47      2000.0  kljIJ   noth
  42      50000.0 Mc Bob  Bob
  38      3000.0  Stallman         Jaudy
  58      -3000.0 Iuc     Renc
  56      347     bdfbWRG gbfvb
  

  因为打印的结果总是纯文本的，即text/plain而非text/html， 你可以仔细看一下浏览器上的页面源代码，可以发现的是这个页面使用的是跳格字符(Tab)输出而非空格， 一般的浏览器会将跳格字符解释为8个空格，但存在有不同的解释情况， 因此这个函数只用来将结果输出为一段纯文本。如果要显示在html中，最好是使用pre标记包含起来。

• result[0][1]: 结果值也可以按照二维列表的形式来索引， 这个语句返回查询结果的第0行，第1列数据，在这里是数字3.0。 这种形式在表结构变化时会有不同的含义，故需要谨慎使用。

14.4.2   ZSQL的高级控制项

可对查询结果进行缓存，以提高查询性能。

在Zope管理界面中任意选中一个ZSQL方法，可以看到有Advanced标签页，打开可以看到下图14.8所示。

图 14.8 ZSQL 方法的高级控制项

其中有几个参数很有用：

• Connection Hook : 指定一个可调用对象在连接时调用，它应该返回一个字符串以指明去连接哪一个 数据库连接对象，如果这个参数保持为空则使用这个ZSQL方法的Edit页面中所指定的连接。
• Maximum rows to retrieve : 这里控制每次请求最多获取多少对象，也就是关系数据库中表的行数， 有些关系数据库支持返回行数限定的语法，也有些不支持，但你总可以在这里设置强制的限制值。
• Maximum results to cache : 最多缓存的数据量，缓存的结果会使Zope占用更多的内存， 在这里你可以设置一个最高限制值。
• Maximum time (sec) to cache : 缓存时间，如果这个值设为非零，ZSQL方法会将结果缓存这个指定的时间， 在缓存的时间内对这个ZSQL方法的重复请求将使用缓存的结果，而只有过期时的请求才会再次连接到关系数据库去操作， 可以想到的是这个值对于那些修改较少而查询很多的数据库很有用，这能在一定程度上减轻数据库的负担。 把这个值设置为0则禁用缓存。

下面的一栏是 "Class Name" 和 "Class File" 可以设置绑定结果的类， 但这是在Script (Python)技术诞生以前使用的，现在这项功能也很少用到了，在以后的Zope版本中将被废弃。

14.4.3   事务(Transaction)

事务特性是可以一次取消的一组操作，要么被成功应用，要么在失败的情况下就什么也不做， 而不会出现组操作中只有部分被应用的情况，它保证了数据的一致完整性。

在前面的ZODB章节中已经看到Zope本身也是支持事务特性的， 如今大多数关系数据库都支持事务处理的功能，Zope会将它连接到Zope的事务功能上。 这保证了从Zope至关系数据库的数据的一致性。 因而不管在使用ZODB数据库还是使用ZODB与关系数据库混合的方式，Zope都能保证所有数据是一致且完整的。