Table of Contents

Class: DTMLMethod Zope-2.2.1-src/lib/python/Products/OFSP/help/DTMLMethod.py

A DTML Method is a Zope object that contains and executes DTML code. It can act as a template to display other objects. It can also hold small pieces of content which are inserted into other DTML Documents or DTML Methods.

The DTML Method's id is available via the document_id variable and the title is available via the document_title variable.

Methods   
__call__
document_src
get_size
manage_edit
  __call__ 
__call__ (
        self,
        client=None,
        REQUEST={},
        **kw,
        )

Calling a DTMLMethod causes the Method to interpret the DTML code that it contains. The method returns the result of the interpretation, which can be any kind of object.

To accomplish its task, DTML Method often needs to resolve various names into objects. For example, when the code <dtml-var spam> is executed, the DTML engine tries to resolve the name spam.

In order to resolve names, the Method must be passed a namespace to look them up in. This can be done several ways:

  • By passing a client object -- If the argument client is passed, then names are looked up as attributes on the argument.

  • By passing a REQUEST mapping -- If the argument REQUEST is passed, then names are looked up as items on the argument. If the object is not a mapping, an TypeError will be raised when a name lookup is attempted.

  • By passing keyword arguments -- names and their values can be passed as keyword arguments to the Method.

The namespace given to a DTML Method is the composite of these three methods. You can pass any number of them or none at all. Names will be looked up first in the keyword argument, next in the client and finally in the mapping.

Unlike DTMLDocuments, DTMLMethods do not look up names in their own instance dictionary.

Passing in a namespace to a DTML Method is often referred to as providing the Method with a context.

DTML Methods are called three ways:

From DTML

A DTML Method can be called from another DTML Method or Document::

In this example, the Method aDTMLMethod is being called from another DTML object by name. The calling method passes the value this as the client argument and the current DTML names pace as the REQUEST argument. The above is identical to this following usage in a DTML Python expression:

              <dtml-var standard_html_header>
                <dtml-var "aDTMLMethod(_.None, _)">
              <dtml-var standard_html_footer>

From Python

Products, External Methods, and PythonMethods can call a DTML Method in the same way as calling a DTML Method from a Python expression in DTML; as shown in the previous example.

By the Publisher

When the URL of a DTML Method is fetched from Zope, the DTML Method is called by the publisher. The REQUEST object is passes as the second argument to the Method.

Permission

View

  document_src 
document_src ( self )

Returns the unrendered source text of the DTML Method.

Permission

View management screens

  get_size 
get_size ( self )

Returns the size of the unrendered source text of the DTML Method in bytes.

  manage_edit 
manage_edit (
        self,
        data,
        title,
        )

Change the DTML Method, replacing its contents with data and changing its title.

The data argument may be a file object or a string.

Permission

Change DTML Methods


Table of Contents

This document was automatically generated on Mon Sep 4 07:33:06 2000 by HappyDoc version r0_6