org.apache.cocoon
Class Engine

java.lang.Object
  |
  +--org.apache.cocoon.Engine
All Implemented Interfaces:
Defaults

public class Engine
extends java.lang.Object
implements Defaults

The Cocoon publishing engine. This class implements the engine that does all the document processing.

Version:
$Revision: 1.34 $ $Date: 2000/09/16 16:04:30 $
Author:
Stefano Mazzocchi, Robin Green

Fields inherited from interface org.apache.cocoon.Defaults
BROWSERS_PROP, CACHE_DEFAULT, CACHE_PROP, COCOON_FORMAT_PI, COCOON_PROCESS_PI, DEFAULT_BROWSER, ERROR_INTERNALLY, FORMATTER_PROP, HOME, INIT_ARG, INTERPRETER_PROP, LOG, LOG_LEVEL, LOOPS, NAME, OUTPUTTING, PARSER_DEFAULT, PARSER_PROP, PROCESSOR_PROP, PRODUCER_PROP, PROFILER_DEFAULT, PROFILER_PROP, PROPERTIES, SHOW_STATUS, STATUS_URL, STATUS_URL_DEFAULT, STORE_DEFAULT, STORE_PROP, STYLESHEET_PI, TRANSFORMER_DEFAULT, TRANSFORMER_PROP, VERSION, WHOLE_REQUEST, YEAR
 
Method Summary
static Engine getInstance()
          This is the getInstance() version that should be used by anything other than the Cocoon servlet itself.
static Engine getInstance(Configurations confs, java.lang.Object context)
          This will return a new instance of the Engine class, and handle pooling of instances.
 java.util.Hashtable getStatus()
          Returns an hashtable of parameters used to report the internal status.
 void handle(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          This method is called to start the processing when calling the engine from the Cocoon servlet.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static Engine getInstance(Configurations confs,
                                 java.lang.Object context)
                          throws java.lang.Exception
This will return a new instance of the Engine class, and handle pooling of instances. In this implementation, one instance is created per servlet context. This replaces using the constructor directly, because now the Cocoon servlet can initialize the Engine, and other servlets and classes can use the same engine, in order to funnel requests through Cocoon.
Parameters:
confs - - Configuration file information
context - - Object to use for Servlet Context
Returns:
Engine - instance to operate on
Throws:
java.lang.Exception - - when things go awry

getInstance

public static Engine getInstance()
                          throws java.lang.Exception
This is the getInstance() version that should be used by anything other than the Cocoon servlet itself. This assumes that the engine has been set up and is ready to be used. If this is called before the instance has been correctly created, it throws an exception.
Returns:
Engine - instance to operate on

handle

public void handle(javax.servlet.http.HttpServletRequest request,
                   javax.servlet.http.HttpServletResponse response)
            throws java.lang.Exception
This method is called to start the processing when calling the engine from the Cocoon servlet.

getStatus

public java.util.Hashtable getStatus()
Returns an hashtable of parameters used to report the internal status.


Copyright © 1999-2000 Apache Software Foundation. All Rights Reserved.