com.jalios.jcms
Class TypeTemplateEntry

java.lang.Object
  com.jalios.jcms.TypeTemplateEntry

All Implemented Interfaces:

TypeConstants, Comparable

public class TypeTemplateEntry
extends Object
implements TypeConstants, Comparable

This class contains info about Type's template.

Since:

jcms-6.0.0

Version:

$Revision: 20800$

Author:

Jean-Philippe Encausse

Nested Class Summary

static class

TypeTemplateEntry.LabelComparator

Field Summary

protected Map<String,String>	descriptionMap
protected boolean	isInternal
protected boolean	isPlugged
protected Map<String,String>	labelMap
protected String	name
protected String	path
static String	REVISION
protected String	usage
static String	USAGE_DISPLAY_BOX
static String	USAGE_DISPLAY_FULL
static String	USAGE_DISPLAY_FULL_PDA
static String	USAGE_DISPLAY_MODAL
static String	USAGE_DISPLAY_QUERY
static String	USAGE_DISPLAY_QUERY_PDA
static String	USAGE_EDIT
static String	USAGE_EDIT_FRONT
static String	USAGE_EDIT_MODAL
static String	USAGE_EDIT_POPUP

Fields inherited from interface com.jalios.jcms.TypeConstants

CHANGE_LEVEL_CLASS, CHANGE_LEVEL_JSP, CHANGE_LEVEL_NONE, DISPLAY_TPLT_TAG, EXTENSIONS_XML, FIELD_ELT, FIELD_NEW_MARK, FIELD_UPDATED_MARK, FIELDS_ELT, FILE_INDEX_LISTENER, LINK_INDEX_LISTENER, OLD_TYPES_DIR, PACKAGE_NAME, QUERY_TPLT_TAG, TAB_ELT, TABS_ELT, TEMPLATE_TAG, TEMPLATES_SUFFIX, TEMPLATES_TAG, TITLE_ELT, TYPE_ELT, TYPE_FORCE_UPDATE_MARK, TYPE_NEW_MARK, TYPE_UPDATED_MARK, TYPES_DIR, TYPES_XML

Constructor Summary

TypeTemplateEntry()
Default Constructor

Method Summary

String[]	checkIntegrity() Check the integrity of the template fields
int	compareTo(Object obj)
static void	convertTemplate(org.jdom.Element elm, boolean isPortlet) Convert the given JDOM Element representing a template declaration from JCMS 5.7.x to JCMS 6.0.x
static void	convertTemplate(File tmplFile) Convert the given File representing type's templates from JCMS 5.7.x to JCMS 6.0.x
static TypeTemplateEntry	decodeTemplate(org.jdom.Element itElm, String folderPath) Build a TypeTemplateEntry from the given JDom Element
static org.jdom.Element	encodeTemplate(TypeTemplateEntry tte) Build a JDom Element from the given TypeTemplateEntry
boolean	equals(Object obj)
String	getDescription(String userLang) Returns the description of the template for given user language
Map<String,String>	getDescriptionMap() Returns the map of descriptions.
String	getInternalName() Returns the full name of the template that will be stored in the store.xml
String	getLabel(String userLang) Returns the label of the template for given user language
Map<String,String>	getLabelMap() Returns the map of labels.
String	getName() Returns the name of the template this name must be unique for the type declaration.
String	getPath() Returns the path (e.g. jsp file) to the template.
String	getThumbnailPath() Returns the path to the thumbnail of this template or s.gif if it could not be found.
String	getThumbnailPath(int width, int height, String defaultImagePath) Retrieve the path to the thumbnail of this template in the specified dimension.
String	getUsage() Returns the usage of the template (e.g. full, query, pda, box, ...).
boolean	isInternal() Returns true if the template entry has been generated by JCMS without parsing an existing TypeElement.
boolean	isPlugged() Returns true if the template entry has been added by pluggin mechanism.
static TypeTemplateEntry	resolveDefaultTemplateEntry(Set<TypeTemplateEntry> tmplSet, String defaultUsage, String defaultPath) Returns a default TypeTemplateEntry in the given Set otherwise return a dummy template with the defaultUsage.
void	setDescription(String userLang, String value) Set the description for the given user language
void	setDescriptionMap(Map<String,String> descriptionMap) Set the descriptions for the given template.
void	setInternalName(String name) Set the name of the template this name must be unique for the type declaration.
void	setLabel(String userLang, String value) Set the label for the given user language
void	setLabelMap(Map<String,String> labelMap) Set the labels for the given template.
void	setPath(String path) Set the path of the template.
void	setPlugged(boolean plugged) Returns true if the template entry has been added by pluggin mechanism.
void	setUsage(String usage) Set the usage of the template (e.g. full, query, pda, box, ...).
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final String REVISION

See Also:

Constant Field Values

USAGE_DISPLAY_BOX

public static final String USAGE_DISPLAY_BOX

See Also:

Constant Field Values

USAGE_DISPLAY_FULL

public static final String USAGE_DISPLAY_FULL

See Also:

Constant Field Values

USAGE_DISPLAY_QUERY

public static final String USAGE_DISPLAY_QUERY

See Also:

Constant Field Values

USAGE_DISPLAY_MODAL

public static final String USAGE_DISPLAY_MODAL

See Also:

Constant Field Values

USAGE_DISPLAY_FULL_PDA

public static final String USAGE_DISPLAY_FULL_PDA

See Also:

Constant Field Values

USAGE_DISPLAY_QUERY_PDA

public static final String USAGE_DISPLAY_QUERY_PDA

See Also:

Constant Field Values

USAGE_EDIT

public static final String USAGE_EDIT

See Also:

Constant Field Values

USAGE_EDIT_FRONT

public static final String USAGE_EDIT_FRONT

See Also:

Constant Field Values

USAGE_EDIT_MODAL

public static final String USAGE_EDIT_MODAL

See Also:

Constant Field Values

USAGE_EDIT_POPUP

public static final String USAGE_EDIT_POPUP

See Also:

Constant Field Values

name

protected String name

usage

protected String usage

path

protected String path

labelMap

protected Map<String,String> labelMap

descriptionMap

protected Map<String,String> descriptionMap

isInternal

protected boolean isInternal

isPlugged

protected boolean isPlugged

Constructor Detail

TypeTemplateEntry

public TypeTemplateEntry()

Default Constructor

Method Detail

getName

public String getName()

Returns the name of the template this name must be unique for the type declaration.

Returns:

String the name of the template

getInternalName

public String getInternalName()

Returns the full name of the template that will be stored in the store.xml

Returns:

String the name of the template

setInternalName

public void setInternalName(String name)

Set the name of the template this name must be unique for the type declaration.

getPath

public String getPath()

Returns the path (e.g. jsp file) to the template. This path is not overrided by PluginPolicyFilter.

Returns:

String the path to the template file

setPath

public void setPath(String path)

Set the path of the template.

getUsage

public String getUsage()

Returns the usage of the template (e.g. full, query, pda, box, ...).

Returns:

String the usage of the template

setUsage

public void setUsage(String usage)

Set the usage of the template (e.g. full, query, pda, box, ...).

getLabel

public String getLabel(String userLang)

Returns the label of the template for given user language

Parameters:

userLang - the user language

Returns:

String the label

setLabel

public void setLabel(String userLang,
                     String value)

Set the label for the given user language

Parameters:

userLang - the user language

value - the label

getLabelMap

public Map<String,String> getLabelMap()

Returns the map of labels. Should only be used internally.

Returns:

Map of labels

setLabelMap

public void setLabelMap(Map<String,String> labelMap)

Set the labels for the given template. Should only be used internally.

Parameters:

labelMap - the Map of label

getDescription

public String getDescription(String userLang)

Returns the description of the template for given user language

Parameters:

userLang - the user language

Returns:

String the map description

setDescription

public void setDescription(String userLang,
                           String value)

Set the description for the given user language

Parameters:

userLang - the user language

value - the description

getDescriptionMap

public Map<String,String> getDescriptionMap()

Returns the map of descriptions. Should only be used internally.

Returns:

descriptions

setDescriptionMap

public void setDescriptionMap(Map<String,String> descriptionMap)

Set the descriptions for the given template. Should only be used internally.

Parameters:

descriptionMap - the map of description

isInternal

public boolean isInternal()

Returns true if the template entry has been generated by JCMS without parsing an existing TypeElement.

Returns:

true if it is generated.

isPlugged

public boolean isPlugged()

Returns true if the template entry has been added by pluggin mechanism.

Returns:

true if it has been plugged.

setPlugged

public void setPlugged(boolean plugged)

Returns true if the template entry has been added by pluggin mechanism.

getThumbnailPath

public String getThumbnailPath()

Returns the path to the thumbnail of this template or s.gif if it could not be found.

Returns:

String path to thumbnail or "s.gif"

getThumbnailPath

public String getThumbnailPath(int width,
                               int height,
                               String defaultImagePath)

Retrieve the path to the thumbnail of this template in the specified dimension.

If the thumbnail could not be created (no preview available for this template), the defaultImagePath is returned instead.

Warning : This method create a thumbnail when it does not exists, this process can be a little time consumming, make sure you do not need immediate response time when using it.

Parameters:

width - the width of the thumbnail to create/reuse

height - the height of the thumbnail to create/reuse

defaultImagePath - the default image path used if the thumbnail could not be created

Returns:

a path relative to the webapp root (e.g. "types/PortletRSS/th-60x45-doPortletRSSFullDisplay.jpg.jpg").

checkIntegrity

public String[] checkIntegrity()

Check the integrity of the template fields

Returns:

String list of errors or ""

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

compareTo

public int compareTo(Object obj)

Specified by:

compareTo in interface Comparable

resolveDefaultTemplateEntry

public static TypeTemplateEntry resolveDefaultTemplateEntry(Set<TypeTemplateEntry> tmplSet,
                                                            String defaultUsage,
                                                            String defaultPath)

Returns a default TypeTemplateEntry in the given Set otherwise return a dummy template with the defaultUsage. Warning ! do not check the usage of provided TypeTemplateEntry

Parameters:

tmplSet - a Set of TypeTemplateEntry (that may already refined on usage or null)

defaultUsage - the template usage

defaultPath - null or override the path of the dummy tte

Returns:

TypeTemplateEntry

Since:

jcms-6.0.1

convertTemplate

public static void convertTemplate(File tmplFile)
                            throws org.jdom.JDOMException,
                                   IOException

Convert the given File representing type's templates from JCMS 5.7.x to JCMS 6.0.x

Parameters:

tmplFile - the type's template file Type-template.xml

Throws:

org.jdom.JDOMException

IOException

convertTemplate

public static void convertTemplate(org.jdom.Element elm,
                                   boolean isPortlet)

Convert the given JDOM Element representing a template declaration from JCMS 5.7.x to JCMS 6.0.x

Parameters:

elm - JDOM Element with qname "template"

decodeTemplate

public static TypeTemplateEntry decodeTemplate(org.jdom.Element itElm,
                                               String folderPath)

Build a TypeTemplateEntry from the given JDom Element

Parameters:

itElm - a JDom Element

folderPath - path to the template file

encodeTemplate

public static org.jdom.Element encodeTemplate(TypeTemplateEntry tte)

Build a JDom Element from the given TypeTemplateEntry

Parameters:

tte - TypeTemplateEntry