This interface must be implemented by the classes that produce documents
encapsulating resources. These resource wrappers provide a way to call,
execute or otherwise access the data contained or generated by these
resources and transform it into data models that can be used
by the publishing framework for futher processing.
getDocument(javax.servlet.http.HttpServletRequest request)
This method is responsible to generate a DOM tree that
contains the generated data.
java.lang.String
getPath(javax.servlet.http.HttpServletRequest request)
Returns the path where the resource is found, or an empty string if
no path can be applied to the resource.
java.io.Reader
getStream(javax.servlet.http.HttpServletRequest request)
This method is responsible to provide an input stream to read
the data generated or contained by the resource mapped by
this document producer.
Methods inherited from interface org.apache.cocoon.framework.Actor
public java.io.Reader getStream(javax.servlet.http.HttpServletRequest request)
throws java.lang.Exception
This method is responsible to provide an input stream to read
the data generated or contained by the resource mapped by
this document producer. This stream is not guaranteed to be
buffered.
getDocument
public org.w3c.dom.Document getDocument(javax.servlet.http.HttpServletRequest request)
throws java.lang.Exception
This method is responsible to generate a DOM tree that
contains the generated data.
getPath
public java.lang.String getPath(javax.servlet.http.HttpServletRequest request)
Returns the path where the resource is found, or an empty string if
no path can be applied to the resource.
Warning, null values are not valid.