<BODY BGCOLOR="white">

Cocoon API: Class DCPProcessor

Overview

Package

Class

Tree

Deprecated

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.cocoon.processor.dcp
Class DCPProcessor

java.lang.Object
  |
  +--org.apache.cocoon.framework.AbstractActor
        |
        +--org.apache.cocoon.processor.dcp.DCPProcessor

All Implemented Interfaces:: Actor, Changeable, Processor, Status

public class DCPProcessor
extends AbstractActor
implements Processor, Status

This class implements a DOM processor that expands XML documents replacing dynamic content generation processing instructions by the return value of user-supplied logic.

Version:: $Revision: 1.5 $ $Date: 2000/03/01 16:13:46 $
Author:: Ricardo Rocha

Fields inherited from class org.apache.cocoon.framework.AbstractActor

director

Constructor Summary

DCPProcessor()


Method Summary

java.lang.String getStatus()
          Returns information about the status of the implementing class.

boolean hasChanged(java.lang.Object context)
          This method is called by the cache system to evaluate the status of this changeable point for the given context (normally an HTTP request).

org.w3c.dom.Document process(org.w3c.dom.Document document, java.util.Dictionary parameters)
          This method scans a DOM tree replacing <?dcp?> processing instructions by dynamic content generated by user-supplied programs.

Methods inherited from class org.apache.cocoon.framework.AbstractActor

init

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.cocoon.framework.Actor

init

Constructor Detail

DCPProcessor

public DCPProcessor()

Method Detail

process

public org.w3c.dom.Document process(org.w3c.dom.Document document,
                                    java.util.Dictionary parameters)
                             throws java.lang.Exception

This method scans a DOM tree replacing <?dcp?> processing instructions by dynamic content generated by user-supplied programs. These programs are dynamically loaded according to directives contained in <?dcp-object?> processing instructions.

Specified by:: process in interface Processor

Parameters:: document - The document to be processed for dynamic content; parameters - The table of invocation environment variables to be used during processing
Returns:: The expanded document
Throws:: java.lang.Exception - When any error occurs during processing

hasChanged

public boolean hasChanged(java.lang.Object context)

This method is called by the cache system to evaluate the status of this changeable point for the given context (normally an HTTP request). Since even if the scripts didn't change we can't assume anything about it, this method is today left unimplemented (it always returns "true") but should call similar hooks inside the DCP components if available.

Specified by:: hasChanged in interface Changeable

getStatus

public java.lang.String getStatus()

Description copied from interface: Status

Returns information about the status of the implementing class. Note: this is use instead of the usual toString() method because some of these methods are declared final in some classes in JDK 1.1.

Specified by:: getStatus in interface Status