API参考

API参考

提供者：Python世界：杜文山（https://www.360docs.net/doc/c37921856.html,/python）

这个文档描述了基础Zope对象集里的最常用接口。这些参考用于编写DTML、Perl和Python脚本，而这些脚本可以创建和操纵Zope对象。

１．AuthenticatedUser类

这个接口需要由用户确认后返回的对象来提供支持，并且这个接口用于访问控制。getUserName()

返回用户名称

●●许可——Always available（总是存在）

getId()

取得用户的ID。ID可以被用来（至少在Python中）从用户的UserDatabase中得到用户。

●●许可——Python only（只有Python）

getDatabasePath()

取得用户的UserDatabase中的物理路径。通过这个方法返回的路径，可以方便的用来取得用户数据库。

●●许可——Python only（只有Python）

hasRole(object, roles)

返回一个值，如果用户对于给定的对象拥有给定的角色，这个值才为真值，否则，它返回一个假值。

●●许可——Always available（总是存在）

getRoles()

返回用户在给定的object对象上的角色列表。

●●许可——Always available（总是存在）

２．DTMLDocument(ObjectManagerItem, PropertyManager) 类

一个DTML文档是一个包含和执行DTML代码的Zope对象。它用于呈现Web页面。

manage_edit(data, title)

更改DTML文档，用data替换它的内容，用title更改它的标题。

data参数可以是一个文件对象或一个字符串。

●●许可——Change DTML documents（更改DTML文档）

document_src()

返回DTML文档的没有被呈递的源文本。

●●许可——View management screens（观看管理屏幕）

__call__(client=None, REQUEST={}, RESPONSE=None, **kw)

调用一个DTML文档，从而引起文档执行其所包含的DTML代码。这个方法返回执行的结果，其可以是任何类型的对象。

要完成它的任务，DTML文档经常需要把各种名称解析成对象。例如，当代码<;dtml-var spam>;被执行时，DTML引擎试图解析名称spam。

要解析名称，文档必须被传递一个名称空间，在这个名称空间里查找这些名称。这个过程可以通过以下几种方式完成：

●●通过传递一个client对象——如果参数client被传递，那么名称作为

参数的属性来查找。

●●通过传递一个REQUEST映射——如果参数REQUEST被传递，那

么名称作为参数的数据项来查找。如果对象不是一个映射，当视图查找

一个名称时引发一个TypeError 错误。

●●通过传递关键字参数——名称和它们的值可以作为文档的关键字参

数来被传递。

一个DTML文档所被赋予的名称空间是这三个方法的混合物。你可以传递任意数量的参数或者根本就不传递参数。名称首先在关键字参数中查找，然后在client里，最后在映射里。

一个DTML文档本身可以作为一个client参数来传递它自己，除了在指定的client里查找名称，还可以在DTML文档本身里查找名称。

在一个名称空间里给一个DTML文档传递参数经常被认为是给文档提供一个关联。

DTML文档可以通过三种方式调用。

通过DTML

一个DTML文档可以通过另外一个DTML方法或文档来调用：

在这个例子里，文档aDTMLDocument 是通过另外一个DTML对象采用名称的方式来被调用的。调用方法传递的client参数值为this，REQUEST参数为当前的DTML名称空间。前边的代码等同于以下DTML 里的Python表达式中的用法：

通过Python

产品、外部方法和脚本可以采用相同的方式调用一个DTML文档，就像它们在DTML

里通过一个Python表达式调用一个DTML文档那样（如前边的例子所示）。

通过出版者（By the Publisher）

当从Zope获取一个DTML文档的URL时，DTML文档通过出版者被调用。REQUEST 对象作为文档的第二个参数被传递。

●●许可——View（观看）.

get_size()

返回字节形式的未被呈递的DTML文档的源文本的大小。

●●许可——View（观看）.

ObjectManager 构造器

manage_addDocument(id, title)

给当前的ObjectManager添加一个DTML 文本。

３．DTMLMethod(ObjectManagerItem) 类

DTML方法是一种Zope对象，它包含和执行DTML代码。它可以作为一个模板来显示其它的对象。它还可以存储一小段内容，这些内容可以被插入到其它的DTML文档或DTML 方法里。

DTML方法的id 通过document_id变量提供，title通过document_title变量提供。manage_edit(data, title)

更改DTML方法，用data替换它的内容，更改它的title。data参数可以是一个文件对象或一个字符串。

●●许可——Change DTML methods（更改DTML方法）。

document_src()

返回DTML方法的未被呈递的源文本。

●●许可——View management screens（观看管理屏幕）.

__call__(client=None, REQUEST={}, **kw)

调用一个DTML方法会引起这个方法执行它所包含的DTML代码。这个方法返回执行的结果，结果可以是任何类型的对象。

DTML方法要完成它的任务，它需要把各种名称解析成对象。例如，当代码<;dtml-var spam>;被执行时，DTML引擎试图解析名称spam。

要解析名称，方法必须被传递一个名称空间，在这个名称空间里查找它们。这个过程可以通过以下用几种方式完成：

●●通过传递一个client对象——如果传递了参数client，那么名称作为参数的

属性来查找。

●●通过传递一个REQUEST映射——如果传递了参数REQUEST，那么名称

作为参数的数据项来查找。如果对象不是一个映射，当试图查找一个名称时引

发一个TypeError错误。

●●通过传递关键字参数——名称和它们的值可以作为方法的关键字参数来

传递。

一个DTML方法所被赋予的名称空间是这三个方法的混合物。你可以传递任何数量的参数或者根本就不传递。名称首先在关键字参数中查找，然后在client里，最后在映射里。

不像DTML文档，DTML方法不在它们自己的实例字典里查找名称。

在一个名称空间里给一个DTML方法进行传递参数经常被认为是给文档提供一个关联。

DTML方法可以通过三种方式调用：

通过DTML

一个DTML方法可以通过另外一个DTML方法或文档来调用：

在这个例子里，方法aDTMLMethod是通过另外一个DTML对象采用名称的方式来被调用的。调用方法传递的client参数值为this，REQUEST参数为当前的DTML名称空间。前边的代码等同于以下DTML 里的Python表达式中的用法：

通过Python

产品、外部方法和脚本可以采用相同的方式调用一个DTML方法，就像它们在DTML 里通过一个Python表达式调用一个DTML方法那样（如图前边的例子所示）。

通过出版者（By the Publisher）

当从Zope获取一个DTML方法的URL时，DTML方法通过出版者被调用。REQUEST 对象作为方法的第二个参数被传递。

●●许可——View（观看）

get_size()

返回字节形式的未被呈递的DTML方法的源文本的大小。

●●许可——View（观看）

ObjectManager 构造器

manage_addDTMLMethod(id, title)

给当前的ObjectManager添加一个DTML 方法。

４．DateTime类

DateTime对象提供了一种以各种格式处理日期和时间的接口。DateTime还提供了日历

操作方法、日期和时间算法和格式化方法。

DateTime 对象表示时刻并且提供控制它的形式而又不影响对象绝对值的接口。

DateTime对象可以从形式多样的字符串或数字数据来创建，或者通过其它DateTime对象计算得到。DateTime可以把时间的格式转换成许多主要的时区的格式，还可以在一个给定时区的关联里创建DateTime对象。

DateTime对象提供一部分数字行为：

●●两个DateTime对象可以相减，从而获得两者间的时间差。

●●一个DateTime对象和一个正的或负的数字可以相加，从而获得一个新

DateTime对象，它是晚于输入的DateTime对象的某一天。

●●一个正的或负的数字和一个DateTime对象可以相加，从而获得一个新

DateTime对象，它是晚于输入的DateTime对象的某一天。

●●一个正的或负的数字可以从一个DateTime对象中减去，从而获得一个新

DateTime对象，它是早于输入的DateTime对象的某一天。

DateTime对象通过使用标准的int、long 和float 函数可以把从1901年1月1日以来的时间转换成整数、长整数和浮点数形式的天数。（兼容性注意：int、long 和float返回自从1901年以来的GMT天数，而不是按照本地时区计算的天数）。DateTime对象还可以访问以浮点数格式表示的值，它可以和Python的time 模块一起使用，前提是对象的值属于这个基于新纪元的time 模块的时间值的范围之内。

一个DateTime对象应该认为是不变的——所有转换和数字操作返回一个新的DateTime 对象而不是修改当前的对象。

一个DateTime对象总是按照UTC时间提供值，这表现在时区关联里的那些用来创建对象的参数。DateTime对象的方法返回基于时区关联的值。

注意如果没有指定时区，就在所有情况中使用本地时区来表示时间。

创建DateTime对象可以带有0到7个参数。

●●如果采用不带参数的方式调用函数，那么返回当前的日期或时间并且按照

本地时区表示。

●●如果采用带有一个字符串参数的方式调用函数，其中这个字符串代表时区

名称，那么返回表示当前时间的对象并且按照指定的时区表示。

●●如果采用带有唯一的字符串参数的方式调用函数，其中字符串表示一个有

效的date/time，那么就返回一个表示那个date/time的对象。作为一个普遍的惯

例，任何北美居民可以明确识别的date/time形式都是可接受的。（其中的原因

是：在北美，像2/1/1994这样的日期被认为是February 1, 1994，然而在世界上

的一些地方，它被认为是January 2, 1994。）一个date/time对象包含两个组件：

一个日期组件和一个可选的时间组件，由一个或多个空格分隔。如果时间组件

被忽略，则假定为12:00am。时区名称可以作为date/time字符串最后一个元素

被指定，任何可以被识别的时区名称被用于计算date/time值。（如果你用字符

串Mar 9, 1997 1:45pm US/Pacific 创建一个DateTime对象，它的值在本质上等

同于你在一台属于那个时区的机器上在指定的日期和时间time.time()所捕捉的

时间）：

e=DateTime("US/Eastern”)

# 返回当前的date/time对象, 以US/Eastern时区表示。

x=DateTime(“1997/3/9 1:45pm”)

# 返回指定的时间，以本地时区表示。

y=DateTime("Mar 9, 1997 13:45:00”)

# y 等于x

date组件由年、月和日的值组成。年的值必须为1位、2位或4位数的整数。如果使用1位或2位数，年被假设属于20世纪。月可以是

一个整数，从1到12，也可以是月的名称或月的缩写，其中一个句点

可以选择性的跟随在缩写后。日必须属于从1到该月的天数之间的整

数。年、月和日的值可以用句点、连字号、右箭号或空格分隔。在分隔

符周围允许使用额外的空格。年、月和日的值可以按照任何顺序给定，

只要能够区分出组件。如果所有这三个组件都是小于13的数字，那么

假定的顺序为月-日-年。

time组件由小时、分钟和秒的值组成，用冒号分隔。小时的值必须是一个0至23（包含0和23）之间的整数，分钟的值必须为0至59（包

含0和59）之间的整数。秒的值可以为0至59.999（包含0和59.999）

之间的整数。秒的值，或者分钟和秒的值，可以被忽略。时间可以跟随

大写或小写格式的am 或pm，其被假定为12小时制。

●●如果DateTime函数被调用时带有一个数字参数，这个数字被假定为浮点

数值，例如由time.time()返回的值。返回的DateTime对象显示了用本地时区表

示的time.time()的gmt值的浮点数。

●●如果函数调用时带有两个数字参数，那么第一个被认为是一个整数年，第

二个参数被认为是在本地时区关联中本年开始以来的天数偏移量。返回的

date/time值是用本地时区表示的给定年份开始以来的天数的给定偏移量。偏移

量可以是正数或负数。两位数的年被假定为20世纪当中的年份。

●●如果函数调用时带有两个参数——第一个以浮点数形式提供的参数表示

了在GMT里新纪元以来的秒数，就像那些由time.time()返回的数字，第二个

以字符串形式提供的参数指定一个可识别的时区。返回具有GMT时间值的

DateTime对象并按照给定时区形式表示。

import time

t=time.time()

now_east=DateTime(t,?US/Eastern?)

# 时间按照US/Eastern时区表示

now_west=DateTime(t,?US/Pacific?)

# 时间按照US/Pacific时区表示

# now_east == now_west

# 只是它们的表示法是不同的

●●如果函数调用时带有三个或更多的数字参数，那么第一个被认为是整数

年，第二个被认为是整数月，第三个被认为是整数天。如果结合在一起的值无

效，那么引发一个DateTimeError。两位数的年被认为是20世纪中的年份。第

4、5、6个参数分别指定小时、分钟和秒——小时和分钟应该为正整数，秒应

该为一个正的浮点数——所有这些如果没有给定则默认为0。可以给定一个可

选择的字符串，从而作为最后一个参数来表示时区（这个效果就好像是你已经

在一台位于指定时区中的机器上选定了time.time()的值。）

如果传递给DateTime构造器的字符串参数不能被解析，它引发一个DateTime.SyntaxError错误。无效的日期、时间或时区组件引发一个DateTime.DateTimeError 错误。

模块函数Timezones() 返回一个DateTime模块可识别的时区列表。时区名称识别是不区分大小写的。

strftime(format)

返回按照format格式提供的date/time字符串。

见Python中的time.strftime (https://www.360docs.net/doc/c37921856.html,/doc/current/lib/module-time.html) 函数。

dow()

返回整数型的星期的天数，星期日是0。

●●许可——Always available（总是存在）

aCommon()

●●许可——Always available（总是存在）

h_12()

返回12小时制的小时数。

●●许可——Always available（总是存在）

Mon_()

兼容性：见pMonth。

●●许可——Always available（总是存在）

HTML4()

按照符合HTML 4.0规范的格式返回对象，这个规范是ISO8601标准之一。

有关更多的信息，请见HTML 4.0规范（https://www.360docs.net/doc/c37921856.html,/TR/NOTE-datetime）。

日期输出格式为：YYYY-MM-DDTHH:MM:SSZ，其中T和Z是文本字符。时间为UTC （通用协调时间）时间。

●●许可——Always available（总是存在）

greaterThanEqualTo(t)

和其它DateTime对象或浮点数比较DateTime对象，比如由Python 的time 模块返回的数值。如果对象表示一个大于或等于指定的DateTime或time 模块风格的时间的date/time 对象，则返回真。通过比较长整数型的毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

dayOfYear()

返回按照对象所在时区表示的年的天数。

●●许可——Always available（总是存在）

lessThan(t)

与其它的DateTime对象或一个浮点数比较DateTime对象，比如由Pythontime 模块返回的数字。如果对象表示一个小于指定的DateTime或time 模块风格的时间的date/time对象，则返回真。通过比较长整数型毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

AMPM()

返回一个对象的最接近秒的时间字符串。

●●许可——Always available（总是存在）

isCurrentHour()

如果这个对象在所在时区中表示一个属于当前小时范围里的date/time对象，则返回真。

●●许可——Always available（总是存在）

Month()

返回完整的月份的名称。

●●许可——Always available（总是存在）

mm()

以两位数字符形式返回月份。

●●许可——Always available（总是存在）

ampm()

返回适当的时间修饰语（am或pm）。

●●许可——Always available（总是存在）

hour()

返回以24小时制表示的小时。

●●许可——Always available（总是存在）

aCommonZ()

返回以Mar 1, 1997 1:45 pm US/Eastern格式表示的对象值的字符串。

.

●●许可——Always available（总是存在）

Day_()

兼容性：见pDay。

●●许可——Always available（总是存在）

pCommon()

返回以Mar. 1, 1997 1:45 pm 格式表示的对象值的字符串。

●●许可——Always available（总是存在）

minute()

返回分钟。

●●许可——Always available（总是存在）

day()

返回以整数表示的天。

●●许可——Always available（总是存在）

earliestTime()

返回一个新的表示最早可能时间（全部按秒计算）的DateTime对象，它仍然属于对象所在时区中的当前天里边。

●●许可——Always available（总是存在）

Date()

返回对象的日期字符串。

●●许可——Always available（总是存在）

Time()

返回对象的最接近秒的时间字符串。

●●许可——Always available（总是存在）

isFuture()

如果这个对象表示一个晚于调用时间的date/time对象，则返回真。

●●许可——Always available（总是存在）

greaterThan(t)

和其它的DateTime对象或一个浮点数比较DateTime对象，比如由Pythontime 模块返回的数字。如果对象表示一个大于指定的DateTime或符合time 模块风格的时间的date/time 对象，则返回真。通过比较长整数型毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

TimeMinutes()

返回对象的时间字符串，不显示秒。

●●许可——Always available（总是存在）

yy()

返回以两位数字符表示的日历年。

●●许可——Always available（总是存在）

isCurrentDay()

如果对象在所在时区中表示一个属于当前天范围内的date/time对象，则返回真。

●●许可——Always available（总是存在）

dd()

返回以两位数字符形式表示的天。

●●许可——Always available（总是存在）

rfc822()

返回以RFC 822格式显示的日期。

●●许可——Always available（总是存在）

isLeapYear()

如果当前年（在对象所属时区中）是闰年则返回真

●●许可——Always available（总是存在）

fCommon()

返回一个以March 1, 1997 1:45 pm格式表示的对象值的字符串。

●●许可——Always available（总是存在）

isPast()

如果对象表示一个早于调用时间的date/time对象，则返回真。

●●许可——Always available（总是存在）

fCommonZ()

返回一个以March 1, 1997 1:45 pm格式表示的对象值的字符串。

●●许可——Always available（总是存在）

timeTime()

返回UTC中按照Python time模块所使用的格式以浮点数形式表示的date/time 。注意，采用那些拥有对于time模块来说没有含义的值的DateTime来创建date/time是可能的。

●●许可——Always available（总是存在）

toZone(z)

返回当前对象在指定的z时区中时的DateTime 。

●●许可——Always available（总是存在）

lessThanEqualTo(t)

和另外一个DateTime对象或一个浮点数比较DateTime对象，比如由Python time模块返回的数字。如果对象表示一个小于或等于指定的DateTime或time模块风格的时间的date/time，则返回真。通过比较长整数型毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

Mon()

兼容性：参见aMonth。

●●许可——Always available（总是存在）

parts()

返回包含对象的日历年、月、日、小时、分钟、秒和时区值的元组。

●●许可——Always available（总是存在）

isCurrentYear()

如果这个对象在所属时区中表示一个属于当前年范围以内的date/time对象，则返回真。

●●许可——Always available（总是存在）

PreciseAMPM()

返回对象的时间字符串。

●●许可——Always available（总是存在）

AMPMMinutes()

返回对象的时间字符串，不显示秒。

●●许可——Always available（总是存在）

equalTo(t)

和另外一个DateTime对象或一个浮点数比较DateTime对象，比如由Python time模块返回的数字。如果对象表示一个等于指定的DateTime或time模块风格时间的date/time，则返回真。通过比较长整数型毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

pDay()

返回星期的简短名称（带有句点）。

●●许可——Always available（总是存在）

notEqualTo(t)

和另外一个DateTime对象或一个浮点数比较DateTime对象，比如由Python time模块返回的数字。如果对象表示一个不等于指定的DateTime或time模块风格时间的date/time，则返回真。通过比较长整数型毫秒，它可以给出更为精确的结果。

●●许可——Always available（总是存在）

h_24()

返回24小时制的小时。

●●许可——Always available（总是存在）

pCommonZ()

返回以Mar. 1, 1997 1:45 pm US/Eastern格式表示的对象值的字符串。

●●许可——Always available（总是存在）

isCurrentMonth()

如果对象在所属的时区中表示一个属于当前月范围以内的date/time对象，则返回真。

●●许可——Always available（总是存在）

DayOfWeek()

兼容性：参见aDay。

●●许可——Always available（总是存在）

latestTime()

返回一个新的表示最迟可能时间（全部按秒计算）的DateTime对象，它仍然属于对象所在时区中的当前天范围。

●●许可——Always available（总是存在）

dow_1()

返回以整数表示的星期的天数，星期日为1。

●●许可——Always available（总是存在）

timezone()

返回对象的所属时区。

●●许可——Always available（总是存在）

year()

返回对象的日历年。

●●许可——Always available（总是存在）

PreciseTime()

返回对象的时间字符串。

●●许可——Always available（总是存在）

ISO()

●●许可——Always available（总是存在）

millis()

返回自从GMT新纪元以来的毫秒数。

●●许可——Always available（总是存在）

second()

返回秒

●●许可——Always available（总是存在）

month()

返回以整数表示的对象的月份。

●●许可——Always available（总是存在）

pMonth()

返回简写（带有句点）的月份名称。

●●许可——Always available（总是存在）

aMonth()

返回简写的月份名称。

●●许可——Always available（总是存在）

isCurrentMinute()

如果对象在所属时区中表示一个属于当前分钟范围以内的date/time对象，则返回真。

●●许可——Always available（总是存在）

Day()

返回星期中天的完整名称。

●●许可——Always available（总是存在）

aDay()

返回星期中天的简写名称。

●●许可——Always available（总是存在）５．ExternalMethod类

Web可调用函数，它们封装外部Python函数。

函数在一个外部文件里被定义。可以把这个文件看成是模块，但是它不是一个模块。它

不是直接被导入，而是被读入和求值。这个文件必须位于Zope安装目录中的Extensions子目录里，或者在一个产品目录的Extensions子目录里。

当前还不能导入位于Extensions目录中的Python模块，这应归于外部方法装载的方式。导入那些在Zope安装目录中的lib/python目录里发现的模块是可能的，或者是导入那些位于lib/python目录中的软件包里的模块。

manage_edit(title, module, function, REQUEST=None)

更改外部方法。

见manage_addExternalMethod中的参数模块和函数的描述。

注意，调用manage_edit 引起模块被有效地重新载入。这对于在调试期间查看更改的效果来说是有用的，但是对于那些依赖被共享的全局数据的函数来说，它会导致问题。

__call__(*args, **kw)

调用外部方法。

调用一个外部方法大致等同于用Python调用原始函数。位置和关键字参数像通常那样传递。注意，它不象通常的Python方法那样——self参数必须明确的被传递。如果属于以下情况，根据这个原则，如果属于以下情况，会导致一个例外：

●●提供的参数数量少于必需的参数数量。

●●函数的第一个参数的名称是self。

在这种情况下，第一个参数使用对象的上级URL。

ObjectManager 构造器

manage_addExternalMethod(id, title, module, function)

给一个ObjectManager添加一个外部方法。除了标准的用于创建对象的参数id 和title 外，还定义了以下的参数：

●●function——Python函数的名称。它可以是一个普通的Python函数或是一

个被绑定的方法。

●●module——包含函数的定义的文件名称。

模块通常位于Extensions目录，然而，文件名可以拥有一个产品前缀，用以显示它可以在一个产品目录里被找到。

例如，如果模块是ACMEWidgets.foo，那么就可以试试使用文件lib/python/Products/ACMEWidgets/Extensions/foo.py。如果失败了，那么就使用文件Extensions/ACMEWidgets.foo.py

６．File(ObjectManagerItem, PropertyManager) 类

文件是一种包含文件内容的Zope对象。通过Zope，一个文件对象可以被用来上载或下载文件信息。

在Zope里使用一个文件对象是容易的。最普通的用法是在一个Web页面里显示一个文件对象的内容。

一个更为复杂的例子是用来给用户呈现可以下载的文件对象。为了让用户能够下载文件，下一个例子显示了一个文件夹里的每个文件对象的链接：

• ”>

  id>

在这个例子里，absolute_url方法和id被用来创建当前ObjectManager中的所有文件对象的HTML超级链接列表。

参见ObjectManager的objectValues方法的细节。

getSize()

返回字节形式的文件大小。

●●许可——View（观看）

update_data(data, content_type=None, size=None)

用data更新文件的内容。

data参数必须为一个字符串。如果content_type没有提供，那么就不设置内容类型。如果没有提供size，那么文件的大小就从data中计算。

●●许可——Python only（只有Python）

getContentType()

返回文件的内容类型。

●●许可——View（观看）

ObjectManager构造器

manage_addFile(id, file="", title="", precondition="", content_type="")

添加一个新文件对象。

采用file文件内容创建一个新文件对象id。

７．Folder(ObjectManagerItem, ObjectManager, PropertyManager)类

文件夹是Zope中的一种通用容器对象。

文件夹是Zope里最常见的ObjectManager 子类。

ObjectManage 构造器

manage_addFolder(id, title)

给当前的ObjectManager添加一个文件夹。

●●许可——Add Folders

８．Image(File)类

Image是一种包含图像内容的Zope对象。通过Zope，一个Image对象可以被用来上载或下载图像信息。

图像对象有两个定义大小的属性，height 和width 。图像被上载的时，计算出这两个属性。对于Zope不能识别的图像类型，这些属性可能不被定义。

在Zope里使用一个Image对象是容易的。最普通的用法是在一个Web页面里显示一个Image对象的内容。通过DTML引用这个对象就可以实现：

它生成一个HTML IMG标记符，引用图像的URL。它等同于：

”>

你可以使用标记符方法更为精确的控制图像的显示方式。例如：

tag(height=None, width=None, alt=None, scale=0, xscale=0, yscale=0, **args)

这个方法返回一个包含HTML IMG标记符的字符串，它引用图像。

根据你的需要，可以选择提供height、width、alt、scale、xscale 和yscale参数，这些参数转换成HTML IMG标记符的属性。注意，默认提供height 和width，并且alt取自title_or_id方法。

可以通过提供关键字参数来支持其它的或未来的IMG标记符属性。例外情况是HTML 风格样式单标记符class。因为单词class是Python中的保留字，你必须代之以使用关键字参数css_class。这样就在处理img标记符时转换成一个class HTML标记符。

●●许可——View（观看）.

ObjectManager构造器

manage_addImage(id, file, title="", precondition="", content_type="")

添加一个新Image对象。

用file文件内容创建一个新Image对象id。

９．MailHost 类

MailHost（邮件主机）对象用作简单邮件传输协议(SMTP)服务器的适配器。MailHost 被用来通过DTML sendmail 标记符查找适合发送邮件的主机。

send(messageText, mto=None, mfrom=None, subject=None, encode=None)

发送一个电子邮件消息，参数为：

●●messageText——邮件消息的正文。

●●mto——消息接受者字符串或列表。

●●mfrom——消息发送者的地址。

●●subject——消息的主题。

●●encode——rfc822定义的消息编码。默认为None，则意味着没有进行编码。

有效的值为base64、quoted-printable 和uuencode 。

ObjectManager 构造器

manage_addMailHost(id, title="", smtp_host=None, localhost=localhost, smtp_port=25, timeout=1.0)

给一个ObjectManager添加一个MailHost对象。

10．ObjectManager类

ObjectManager包含其它的Zope对象。被包含的对象是ObjectManagerItems 。

要在一个ObjectManager内部创建一个对象，使用manage_addProduct ：

self.manage_addProduct[…OFSP?].manage_addFolder(id, titl e)

使用DTML，会是：

这个例子在当前的ObjectManager内部创建一个新文件夹。

manage_addProduct是一个映射，它提供对产品构造器方法的访问。它按照产品id编制索引。

构造器方法在产品初始化期间被注册，并且对于每个可以被添加的对象在API文档里都应该有注解。

objectItems(type=None)

这个方法返回（id，object）元组序列。

就像objectValues 和objectIds，它接受一个参数，或者为字符串，或者为一个列表，从而对一个给定meta_type或meta_types集合的对象限制结果。

每个元组的第一个元素是包含在ObjectManager中的对象的id，第二个元素是对象本身。例子：

id: ,

type:

There are no sub-objects.

●●许可——Access contents information（访问内容信息）。

superV alues(type)

这个方法返回一个包含在ObjectManager和所有它的双亲ObjectManager里的给定meta_type的对象列表。

type参数指定meta_type。它可以是一个字符串，从而指定一个meta_type，或者它可以是一个字符串列表，用来指定多个meta_type。

●●许可——Python only（只有Python）

objectV alues(type=None)

这个方法返回一个所被包含的对象序列。

就像objectItems 和objectIds，它接受一个参数，或者为字符串，或者为一个列表，从而对一个给定meta_type或meta_types集合的对象限制结果。

例子：

This is the icon for the: Folder
.

There are no Folders.

通过给objectValues方法传递一个meta_type来限制文件夹的结果。

●●许可——Access contents information（访问内容信息）

objectIds(type=None)

这个方法返回一个所被包含的对象的id的列表。

这是可选择的，你可以传递一个参数，从而指定用什么对象meta_types来限制要生成的结果。这个参数可以是一个字符串，指定一个meta_type，或者它可以是一个字符串列表，用以指定多个meta_type。

例子：

There are no sub-objects.

这段DTML代码显示所有被包含在当前ObjectManager里的对象的id 。

●●许可——Access contents information（访问内容信息）。11．ObjectManagerItem类

Zope对象可以被包含在ObjectManager里。几乎所有的可以通过Web管理的Zope对象都是ObjectManagerItem 。

ObjectManagerItem有这些实例属性：

●●title——对象的标题。这是一行描述对象的可选的字符串。

●●meta_type——对象类型的简短名称。这是显示在产品添加列表里的对象的

名称，并且用在按照类型过滤对象的时候。这个属性由对象的类提供并且不应

该直接来更改。

●●REQUEST——当前Web请求，这个对象自动获得，不需要设置。

getId()

返回对象的id。

id是对象在它的双亲ObjectManager中的唯一名称。它应该为一个字符串，并且它可以包含字母、数字、下划线、箭号、逗号和空格。

这个方法替代直接存储id属性。

●●许可——Always available（总是存在）

title_or_id()

如果title不为空，它返回标题；否则，它返回id。

●●许可——Always available（总是存在）

unrestrictedTraverse(path, default=None)

返回通过对象的给定path路径所获得的对象，方法在这些对象上被调用。这个方法不受限制，这是因为几乎没有执行安全检查。

如果对象没有被找到，那么返回默认的参数。

●●许可——Python only（只有Python）

absolute_url(relative=None)

返回对象的绝对URL。

如果提供的relative参数为true，那么返回的URL相对于站点对象。注意，如果使用虚拟主机，那么返回的路径是一个逻辑路径而不是一个物理路径。

●●许可——Always available（总是存在）

this()

返回当前对象。

它在两种情况中比较方便。第一，它提供一种在DTML表达式里指向一个对象的方式。

它的第二个用法是相当深奥的。它提供一种获取一个对象而不从它被获取的地方得到完整的关联。这是有用的，例如，你位于一个数据项方法的非数据项子对象里，你需要得到位于子对象的关联的外面的数据项。

●●许可——Always available（总是存在）

manage_workspace()

当一个用户在一个ObjectManager Contents视图或在Zope管理导航视图中选择一个数据项时调用这个Web方法。

●●许可——View management screens（观看管理屏幕）.

title_and_id()

如果title不为空，它返回title，其后为用括号扩起来的id。否则，它返回id。

●●许可——Always available（总是存在）

getPhysicalPath()

从根取得对象的路径，忽略虚拟主机。

●●许可——Always available（总是存在）

getPhysicalRoot()

返回顶级Zope应用程序对象。

●●许可——Python only（只有Python）

restrictedTraverse(path, default=None)

返回通过对象的给定path路径所获得的对象，方法在这些对象上被调用，随时执行安全检查。

如果一个对象没有被找到，那么返回默认的参数。

●●许可——Always available（总是存在）12．PropertyManager类

一个PropertyManager对象有一个键入的特征的集合，这些特征被称为属性。属性可以通过Web或DTML管理。

除了拥有类型，属性可以为可写或只读，并且它们可以有默认的值。

propertyItems()

返回（id，property）元组的列表。

●●许可——Access contents information（访问内容信息）

propertyV alues()

返回属性值列表。

●●许可——Access contents information（访问内容信息）

propertyMap()

返回一个映射元组，为属性给出元数据，元数据包括id、type 和mode。

●●许可——Access contents information（访问内容信息）

propertyIds()

返回属性id的列表。

●●许可——Access contents information（访问内容信息）

getPropertyType(id)

取得属性id的类型。如果此属性不存在它返回None。

●●许可——Access contents information（访问内容信息）

getProperty(id, d=None)

.

返回属性id的值。如果属性没有被找到，返回可选的第二个参数或返回None。

●●许可——Access contents information（访问内容信息）

hasProperty(id)

如果PropertyManager有属性id，则返回一个元组值。否则，它返回一个假值。

●●许可——Access contents information（访问内容信息）13．PropertySheet类

一个PropertySheet是一个用来组织和处理相关属性集的抽象。在概念上，它就像一个容器，其中包含了相关的属性和描述那些属性的元数据的集合。PropertySheet可以提供或不提供管理属性的Web界面。

xml_namespace()

返回一个名称空间字符串，对于这个属性集它可以被用作一个xml名称空间。如果对于一个给定属性单（特别是添加在ZClass定义里的属性单）没有默认的名称空间，它可以是一个空字符串。

●●许可——Python only（只有Python）

propertyItems()