com.jalios.jcms.policy
Interface ChannelPolicyFilter

All Superinterfaces:

Comparable, PluginComponent, PolicyFilter

All Known Implementing Classes:

BasicChannelPolicyFilter

public interface ChannelPolicyFilter
extends PolicyFilter

This class allow developers to put hooks to change channel mechanism behaviour. To get more information about the current request in hooks, the method Channel#getCurrentJcmsContext() must be called.

Since:

jcms-5.7.0

Version:

$Revision: 22357 $

Author:

Jean-Philippe Encausse

Field Summary

static String

REVISION

Method Summary

void	checkJAVAMetaTemplates(Map templateMap, String className, org.jdom.Element typeElt, boolean isExtension) This method is a Hook to generate custom JAVA templates for a given type or extension
void	checkJSPMetaTemplates(Map templateMap, String className, org.jdom.Element typeElt, boolean isExtension) This method is a Hook to generate custom JSP templates for a given type or extension
Data	getData(String id) Retrieve a Data from its id.

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface com.jalios.jcms.plugin.PluginComponent

init

Field Detail

REVISION

static final String REVISION

See Also:

Constant Field Values

Method Detail

checkJSPMetaTemplates

void checkJSPMetaTemplates(Map templateMap,
                           String className,
                           org.jdom.Element typeElt,
                           boolean isExtension)

This method is a Hook to generate custom JSP templates for a given type or extension

The templateMap contains the template file to generate.

• Keys: the name of the file to generate in Type folder
• Values: the name of the metatemplate file to use (in WEB-INF/template/ folder)

Parameters:

templateMap - The map of key/value = file/template

className - The classname of the processing type

typeElt - The XML Element of the processing type

isExtension - boolean true if the type is an Extension Called in private method com.jalios.jcms.TypeProcessor#generateTypeJSP(String, Element)

checkJAVAMetaTemplates

void checkJAVAMetaTemplates(Map templateMap,
                            String className,
                            org.jdom.Element typeElt,
                            boolean isExtension)

This method is a Hook to generate custom JAVA templates for a given type or extension

The templateMap contains the template file to generate.

• Keys: the name of the file (without .java extension)
• Values: the name of the metatemplate file to use (in WEB-INF/template/ folder)

Parameters:

templateMap - The map of key/value = file/template

className - The classname of the processing type

typeElt - The XML Element of the processing type

isExtension - boolean true if the type is an Extension Called in private method com.jalios.jcms.TypeProcessor#processTypes()

getData

Data getData(String id)

Retrieve a Data from its id.

This method is invoked only when JCMS internal method could not find any data associated with the specified id (and if no other ChannelPolicyFilter did return a Data).
May be invoked frequently !! Ensure high performance.

This hook can be implemented by plugins creating transient Data (e.g through QueryFilter).

Example :

  public Data getData(String id) {
    if (!id.startsWith("someprefix_") {
      return null;
    }
    // perform data retrieval (preferably using a internal cache on your side)
    // ...
  }
 

Parameters:

id - the id to look for (never null)

Returns:

a Data or null if no Data matching the specified id could be found

Since:

jcms-6.0