I_CmsResourceLoader

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> com >> opencms >> [ flex overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.opencms.flex
Interface I_CmsResourceLoader

All Known Implementing Classes:: CmsDumpLoader, CmsJspLoader, CmsXmlTemplateLoader

public interface I_CmsResourceLoader

This interface describes a resource loader for OpenCms, a class that can load a resource from the VFS, process it's contents and deliver the result to the user.

The I_CmsResourceLoader operates with Request and Response in much the same way as a standard Java web application.

The I_CmsResourceLoader is closely related to the com.opencms.launcher.I_CmsLauncher interface. In essence, both interfaces serve the same purpose. However, the I_ResourceLoader is much closer related to the standard Java Servlet API then the I_CmsLauncher, which makes it easier to understand for the novice OpenCms programmer. That way, a programmer will hopefully need less time to get productive with OpenCms.

This interface uses a standard servlet javax.servlet.http.HttpServletRequestWrapper / javax.servlet.http.HttpServletResponseWrapper that provide access to a special implementation of the javax.servlet.RequestDispatcher. The handling of the output written to the response is done by this dispatcher. The results are then passed back to OpenCms which will deliver them to the requesting user.

Since:: FLEX alpha 1
Version:: $Revision: 1.6.2.1 $

Field Summary

static java.lang.String C_LOADER_CACHENAME
          Name of FlexCache runtime property

static java.lang.String C_LOADER_CACHEPROPERTY
          The name of the VFS property that steers the caching

static java.lang.String C_LOADER_EXCEPTION_PREFIX
          Prefix for exception message that occurs in a loaded file

static java.lang.String C_LOADER_STREAMPROPERTY
          The name of the VFS property that steers the streaming

Method Summary

void destroy()
          Destroy this ResourceLoder

java.lang.String getResourceLoaderInfo()
          Return a String describing the ResourceLoader

void init(com.opencms.core.A_OpenCms openCms)
          Initialize the ResourceLoader.

void load(com.opencms.file.CmsObject cms, com.opencms.file.CmsFile file, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res)
          Basic top-page processing method for a I_CmsResourceLoader, this method is called if the page is called as a sub-element on a page not already loded with a I_CmsResourceLoader, which most often would be an I_CmsLauncher then.

void service(com.opencms.file.CmsObject cms, com.opencms.file.CmsResource file, javax.servlet.ServletRequest req, javax.servlet.ServletResponse res)
          Does the job of including the requested resource, this method is called directly if the element is called as a sub-element from another I_CmsResourceLoader.

Field Detail

C_LOADER_CACHEPROPERTY

public static final java.lang.String C_LOADER_CACHEPROPERTY

The name of the VFS property that steers the caching

See Also:: Constant Field Values

C_LOADER_STREAMPROPERTY

public static final java.lang.String C_LOADER_STREAMPROPERTY

The name of the VFS property that steers the streaming

See Also:: Constant Field Values

C_LOADER_CACHENAME

public static final java.lang.String C_LOADER_CACHENAME

Name of FlexCache runtime property

See Also:: Constant Field Values

C_LOADER_EXCEPTION_PREFIX

public static final java.lang.String C_LOADER_EXCEPTION_PREFIX

Prefix for exception message that occurs in a loaded file

See Also:: Constant Field Values

Method Detail

init

public void init(com.opencms.core.A_OpenCms openCms)

Initialize the ResourceLoader.

destroy

public void destroy()

Destroy this ResourceLoder

getResourceLoaderInfo

public java.lang.String getResourceLoaderInfo()

Return a String describing the ResourceLoader

load

public void load(com.opencms.file.CmsObject cms,
                 com.opencms.file.CmsFile file,
                 javax.servlet.http.HttpServletRequest req,
                 javax.servlet.http.HttpServletResponse res)
          throws javax.servlet.ServletException,
                 java.io.IOException

Basic top-page processing method for a I_CmsResourceLoader, this method is called if the page is called as a sub-element on a page not already loded with a I_CmsResourceLoader, which most often would be an I_CmsLauncher then.

service

public void service(com.opencms.file.CmsObject cms,
                    com.opencms.file.CmsResource file,
                    javax.servlet.ServletRequest req,
                    javax.servlet.ServletResponse res)
             throws javax.servlet.ServletException,
                    java.io.IOException

Does the job of including the requested resource, this method is called directly if the element is called as a sub-element from another I_CmsResourceLoader.