com.jalios.jcms
Class TypeTemplateEntry

java.lang.Object
  extended by 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.
 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.
 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.
 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


Copyright © 2001-2010 Jalios SA. All Rights Reserved.