Package com.jalios.jcms
Class TypeFieldEntry
- java.lang.Object
-
- com.jalios.jcms.TypeFieldEntry
-
- Direct Known Subclasses:
TitleTypeFieldEntry
public class TypeFieldEntry extends java.lang.ObjectThis class holds all informations of a type's field.- Author:
- Jean-Philippe Encausse, Olivier Jaquemet
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classTypeFieldEntry.DescriptionType
-
Field Summary
Fields Modifier and Type Field Description protected intabstractLengthprotected java.lang.Stringchooserprotected intcolsprotected java.lang.StringdataSourceprotected java.lang.StringdateFormatprotected java.lang.StringdbrColumnsprotected java.lang.StringdbrKeyColprotected java.lang.StringdbrLabelColprotected java.lang.StringdbrOrderByprotected java.lang.StringdbrTableprotected intdecimalsprotected java.util.HashMap<java.lang.String,java.lang.String>defaultTextMapprotected java.lang.StringdefaultValueprotected java.util.Map<java.lang.String,java.lang.String>descriptionMapprotected TypeFieldEntry.DescriptionTypedescriptionTypeprotected java.lang.Stringeditorprotected java.lang.String[]enumerateLabelsprotected java.util.HashMap<java.lang.String,java.lang.String[]>enumerateLabelsMapprotected booleanenumerateMLprotected java.lang.String[]enumerateValuesprotected booleanescapeHtmlprotected booleanfieldMLprotected booleanfieldWikiprotected java.lang.String[]gidsprotected booleanisAbstractprotected booleanisDataImageprotected booleanisDateOnlyprotected booleanisDisplayRootprotected booleanisEnumerateprotected booleanisExclusiveprotected booleanisHiddenprotected booleanisInlineprotected booleanisKeywordprotected booleanisOpenWindowprotected booleanisRequiredprotected booleanisResizeprotected booleanisSearchableprotected booleanisSuperprotected booleanisTextareaprotected booleanisTextfieldprotected booleanisTypeArrayprotected booleanisTypeBooleanprotected booleanisTypeBooleanArrayprotected booleanisTypeCategoryprotected booleanisTypeDataprotected booleanisTypeDataMVprotected booleanisTypeDateprotected booleanisTypeDateArrayprotected booleanisTypeDocumentprotected booleanisTypeDocumentMVprotected booleanisTypeDoubleprotected booleanisTypeDoubleArrayprotected booleanisTypeIntprotected booleanisTypeIntArrayprotected booleanisTypeListprotected booleanisTypeLongprotected booleanisTypeLongArrayprotected booleanisTypeMemberprotected booleanisTypeMemberMVprotected booleanisTypePrimitiveprotected booleanisTypePrimitiveArrayprotected booleanisTypePublicationprotected booleanisTypePublicationArrayprotected booleanisTypePublicationMVprotected booleanisTypeScalarprotected booleanisTypeSetprotected booleanisTypeStringprotected booleanisTypeStringArrayprotected booleanisTypeWorkspaceprotected booleanisTypeWorkspaceMVprotected booleanisWidgetprotected booleanisWysiwygprotected booleanisWysiwygInlineprotected java.util.Map<java.lang.String,java.lang.String>labelMapprotected intmaxlengthprotected java.lang.StringmaxResolutionprotected intmaxRowsprotected java.lang.NumbermaxValueprotected java.lang.NumberminValueprotected java.lang.Stringnameprotected java.lang.StringnameCapprotected java.util.Map<java.lang.String,java.lang.String>offLabelMapprotected java.util.Map<java.lang.String,java.lang.String>onLabelMapprotected intresizeHeightprotected intresizeWidthprotected java.lang.Stringrootprotected introwsprotected intsizeprotected java.lang.StringsuperTypesprotected java.lang.Stringtabprotected java.lang.StringtabGroupprotected java.lang.Stringtypeprotected java.lang.StringtypeShortprotected java.lang.Stringunitprotected java.lang.StringunitAfterprotected java.lang.StringunitBeforeprotected java.lang.StringwysiwygParamsprotected org.jdom.ElementxmlElt
-
Constructor Summary
Constructors Modifier Constructor Description protectedTypeFieldEntry()TypeFieldEntry(org.jdom.Element xmlElement)
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description booleanescapeHtml()Returns true if the HTML contained in this field must be escaped.intgetAbstractLength()Abstract/Summary lengthbooleangetBoolean(Data data)Gets the value of thisbooleanfield for the givenData.java.util.TreeSetgetCategory(Data data, Member mbr)Gets the value of the givenCategoryfield name for the givenData.java.lang.StringgetChooser()Return the internal "chooser" of this field.java.lang.StringgetCollectionTypeMapping()intgetCols()TextInput/TextArea columns number.ControlSettingsgetControlSettings()Control Settings of widget editor.java.lang.StringgetDataSource()SQLQuery/DBRecord/SQLResult: data source of this SQL related field.java.lang.StringgetDateFormat()DateChooser: date formatjava.lang.StringgetDbrColumns()DBRecord: columns to be listed for this DB record field (comma separated)java.lang.StringgetDbrKeyCol()DBRecord: primary key column of this DB record field.java.lang.StringgetDbrLabelCol()DBRecord: column used as label for this DB record fieldjava.lang.StringgetDbrOrderBy()DBRecord: ORDER BY SQL criteria DB record fieldjava.lang.StringgetDbrTable()DBRecord: table of this DB record field.intgetDecimals()Double decimals countjava.util.HashMap<java.lang.String,java.lang.String>getDefaultTextMap()Returns a copy of the language map of default value for this textual field.java.util.HashMap<java.lang.String,java.lang.String[]>getDefaultTextMapArray()Returns a copy of the language map of default value for this textual field.java.util.HashMap<java.lang.String,java.util.List<java.lang.String>>getDefaultTextMapList()Returns a copy of the language map of default value for this textual field.java.lang.StringgetDefaultTextString()Returns the default value (in the main language) of this textual field.java.lang.StringgetDefaultValue()Default value of field that can be expressed/converted into a string.java.lang.StringgetDescription()Deprecated.since jcms-5.7.0.java.lang.StringgetDescription(java.lang.String lang)Returns the localized description of this field.java.util.MapgetDescriptionMap()Returns the localized map of description of this field.TypeFieldEntry.DescriptionTypegetDescriptionType()Type of description to be used by widget:DescriptionType.NONEDescriptionType.TEXTDescriptionType.TOOLTIPdoublegetDouble(Data data)Gets the value of thisdoublefield for the givenData.java.lang.StringgetEditor()Return the internal editor type of this field.java.lang.String[]getEnumerateLabels()Enumerate: Labels of this enumerate field, e.g { "Red", "Green", "Blue"} for the default language of the type/site.java.util.HashMap<java.lang.String,java.lang.String[]>getEnumerateLabelsMap()Enumerate: Map of 'language to labels' for this enumerate field, e.g {{"en" -> { "Red", "Green", "Blue"}, "fr" -> ...java.lang.String[]getEnumerateValues()Enumerate: Possible values of this enumerate field, e.g { "00FF00", "00FF00", "0000FF"}.java.lang.StringgetFieldValueAsString(Data data, java.lang.String lang)Gets value of the field asStringfor field of the following type:intlongdoublebooleanStringjava.lang.StringgetFieldValueAsString(Data data, java.lang.String lang, boolean useDefault)Gets value of the field asStringfor field of the following type:intlongdoublebooleanStringjava.lang.String[]getFieldValueAsStringArray(Data data, java.lang.String lang)Gets value of the field asString[]for field of the following type:int[]long[]double[]boolean[]String[]ListSetjava.lang.String[]getFieldValueAsStringArray(Data data, java.lang.String lang, boolean useDefault)Gets value of the field asString[]for field of the following type:int[]long[]double[]boolean[]String[]ListSetjava.lang.String[]getGids()Member chooser: Group IDsintgetInt(Data data)Gets the value of thisintfield for the givenData.java.lang.StringgetLabel()Deprecated.since jcms-5.7.0.java.lang.StringgetLabel(java.lang.String lang)Returns the localized label of this field.java.util.MapgetLabelMap()Returns the Map of localized label of this field.longgetLong(Data data)Gets the value of thislongfield for the givenData.intgetMaxlength()TextInput maximum length.java.lang.StringgetMaxResolution()intgetMaxRows()SQLQuery/DBRecord/SQLResult: maximum row to be retrieved (0 means no limit)java.lang.NumbergetMaxValue()Returns the maximum value authorized for this number field (integer or decimal), if available.java.lang.String[]getMediaTypes()java.lang.NumbergetMinValue()Returns the mininum value authorized for this number field (integer or decimal), if available.java.lang.StringgetName()Java name of this field.java.lang.StringgetNameCap()Recapitalized java name of this field, (first letter capitalized).java.lang.ObjectgetObject(Data data)Gets the value of thisObjectfield for the givenData.java.lang.ObjectgetObject(Data data, java.lang.String lang)Gets the value of thisObjectfield for the givenData.java.lang.ObjectgetObject(Data data, java.lang.String lang, boolean useDefault)Gets the value of thisObjectfield for the givenData.java.lang.StringgetOffLabel(java.lang.String lang)Returns the localized offLabel for to this field.java.util.Map<java.lang.String,java.lang.String>getOffLabelMap()Boolean: false/OFF Label of a boolean field.java.lang.StringgetOnLabel(java.lang.String lang)Returns the localized onLabel for to this field.java.util.Map<java.lang.String,java.lang.String>getOnLabelMap()Boolean: true/ON Label of a boolean field.intgetResizeHeight()Returns the resize heightintgetResizeWidth()Returns the resize widthjava.lang.StringgetRoot()Categories: Root Category ID of this category fieldintgetRows()TextArea/WYSIWYG rows number.intgetSize()Enumerate: html Select size.java.lang.StringgetSuperTypes()Type: superTypesjava.lang.StringgetTab()Tab: tab name in which this field will be displayed.java.lang.StringgetTabGroup()TabGroup: group name for multivalued fields, all field having the same value will be display together.java.lang.StringgetType()Retrieve type of this field asString.java.lang.StringgetTypeShort()Short type of this field.java.lang.StringgetUnit()TextInput unit
e.g.java.lang.StringgetUnitAfter()TextInput unit, displayed after input.java.lang.StringgetUnitBefore()TextInput unit, displayed before input.java.lang.StringgetWysiwygConfigurationId()Returns the WYSIWYG configuration ID.java.lang.StringgetWysiwygParams()WYSIWYG toolbar options.org.jdom.ElementgetXmlElement()XML Parsing: jdom Element for this field.protected voidinitDefault()Init the default value.protected voidinitDescription()protected voidinitEnumerate()Init the enumerate values.voidinitType()protected voidinitUnits()Init the field unitsbooleanisAbstract()Abstract/Summary field?booleanisAnyLink()Is field's editor any type of link (i.e.booleanisCatEditor()Widget Type.booleanisCatTreeEditor()Widget Type.booleanisDataImage()Image field?booleanisDateChsr()Widget Type.booleanisDateOnly()DateChooser: use date only, or date and time?booleanisDBRecordChsr()Widget Type.booleanisDisplayRoot()Categories: Display RootbooleanisEnumerate()Enumerate.booleanisEnumerateML()Deprecated.this value might not reflect the proper translation status of the label list, you should now consider that enumerate label are always I18NedbooleanisExclusive()Categories: Exclusive.booleanisFieldML()booleanisFieldWiki()TextArea.booleanisGrpChsr()Widget Type.booleanisGrpEnum()Widget Type.booleanisHidden()Hidden field?booleanisInline()Inline boolean ?booleanisKeyword()Return true if the field display keywordsbooleanisLink()Is field's editor a link (as opposed to a chooser for example).booleanisMasterImageMap()Returns true if this field is the image field of an image map field.booleanisMbrChsr()Widget Type.booleanisMbrEnum()Widget Type.booleanisOpenWindow()Returns true if this is an URL field which must be open in a new window.booleanisRequired()Required field?booleanisResize()Returns true if this is an image field which must be resized.booleanisSearchable()Searchable fieldbooleanisSimpleString()booleanisSlaveImageMap()Returns true if this field is the text area field generated aside the real image field.
Warning: this field was not really saved in the type's xml, but is instead only created at JSP generation time.booleanisSQLQuery()Widget Type.booleanisSuper()booleanisTextarea()Textarea.booleanisTextfield()Textfield.booleanisTypeArray()booleanisTypeBoolean()Type: boolean?booleanisTypeBooleanArray()Type: boolean[]?booleanisTypeCategory()booleanisTypeCollection()booleanisTypeData()booleanisTypeDataMV()booleanisTypeDate()Type: Date?booleanisTypeDateArray()Type: Date[]?booleanisTypeDocument()Type: FileDocument? or DBFileDocument?booleanisTypeDocumentMV()Type: FileDocument MV? or DBFileDocument MV?booleanisTypeDouble()Type: double?booleanisTypeDoubleArray()Type: double[]?booleanisTypeInt()Type: int?booleanisTypeIntArray()Type: int[]?booleanisTypeList()booleanisTypeLong()Type: long?booleanisTypeLongArray()Type: long[]?booleanisTypeMember()booleanisTypeMemberMV()booleanisTypeMV()booleanisTypePrimitive()booleanisTypePrimitiveArray()booleanisTypePublication()Type: Publication?booleanisTypePublicationArray()Type: Publication[]?booleanisTypePublicationMV()Type: Publication MVbooleanisTypeScalar()booleanisTypeSet()booleanisTypeString()Type: String?booleanisTypeStringArray()Type: String[]?booleanisTypeWorkspace()booleanisTypeWorkspaceMV()booleanisUrl()URL.booleanisWidget()Is this field manage through a widgetbooleanisWysiwyg()Wysiwyg.booleanisWysiwygInline()Inline editing ?voidreloadI18N()Reload all I18N informations for this type field entry.protected voidresolveControlSettings()Find the right ControlSettingsjava.lang.StringtoString()booleantrim()Returns true if the value in this field must be trimmed when saved
-
-
-
Field Detail
-
xmlElt
protected final org.jdom.Element xmlElt
-
type
protected java.lang.String type
-
typeShort
protected java.lang.String typeShort
-
isTypeInt
protected boolean isTypeInt
-
isTypeIntArray
protected boolean isTypeIntArray
-
isTypeLong
protected boolean isTypeLong
-
isTypeLongArray
protected boolean isTypeLongArray
-
isTypeDouble
protected boolean isTypeDouble
-
isTypeDoubleArray
protected boolean isTypeDoubleArray
-
isTypeBoolean
protected boolean isTypeBoolean
-
isTypeBooleanArray
protected boolean isTypeBooleanArray
-
isTypePrimitive
protected boolean isTypePrimitive
-
isTypePrimitiveArray
protected boolean isTypePrimitiveArray
-
isTypeString
protected boolean isTypeString
-
isTypeStringArray
protected boolean isTypeStringArray
-
isTypeDate
protected boolean isTypeDate
-
isTypeDateArray
protected boolean isTypeDateArray
-
isTypeArray
protected boolean isTypeArray
-
isTypeList
protected boolean isTypeList
-
isTypeSet
protected boolean isTypeSet
-
isTypeScalar
protected boolean isTypeScalar
-
isTypePublication
protected boolean isTypePublication
-
isTypePublicationArray
protected boolean isTypePublicationArray
-
isTypePublicationMV
protected boolean isTypePublicationMV
-
isTypeDocument
protected boolean isTypeDocument
-
isTypeDocumentMV
protected boolean isTypeDocumentMV
-
isTypeMember
protected boolean isTypeMember
-
isTypeMemberMV
protected boolean isTypeMemberMV
-
isTypeData
protected boolean isTypeData
-
isTypeDataMV
protected boolean isTypeDataMV
-
isTypeWorkspace
protected boolean isTypeWorkspace
-
isTypeWorkspaceMV
protected boolean isTypeWorkspaceMV
-
isTypeCategory
protected boolean isTypeCategory
-
isEnumerate
protected boolean isEnumerate
-
isWidget
protected boolean isWidget
-
isWysiwyg
protected boolean isWysiwyg
-
isTextfield
protected boolean isTextfield
-
isTextarea
protected boolean isTextarea
-
labelMap
protected java.util.Map<java.lang.String,java.lang.String> labelMap
-
editor
protected java.lang.String editor
-
name
protected java.lang.String name
-
nameCap
protected java.lang.String nameCap
-
tab
protected java.lang.String tab
-
descriptionMap
protected java.util.Map<java.lang.String,java.lang.String> descriptionMap
-
descriptionType
protected TypeFieldEntry.DescriptionType descriptionType
-
isSuper
protected boolean isSuper
-
isRequired
protected boolean isRequired
-
isInline
protected boolean isInline
-
isWysiwygInline
protected boolean isWysiwygInline
-
isHidden
protected boolean isHidden
-
isAbstract
protected boolean isAbstract
-
abstractLength
protected int abstractLength
-
isDataImage
protected boolean isDataImage
-
isSearchable
protected boolean isSearchable
-
isKeyword
protected boolean isKeyword
-
fieldML
protected boolean fieldML
-
fieldWiki
protected boolean fieldWiki
-
cols
protected int cols
-
maxlength
protected int maxlength
-
rows
protected int rows
-
size
protected int size
-
enumerateLabels
protected java.lang.String[] enumerateLabels
-
enumerateValues
protected java.lang.String[] enumerateValues
-
enumerateLabelsMap
protected java.util.HashMap<java.lang.String,java.lang.String[]> enumerateLabelsMap
-
enumerateML
protected boolean enumerateML
-
dataSource
protected java.lang.String dataSource
-
maxRows
protected int maxRows
-
dbrTable
protected java.lang.String dbrTable
-
dbrKeyCol
protected java.lang.String dbrKeyCol
-
dbrColumns
protected java.lang.String dbrColumns
-
dbrLabelCol
protected java.lang.String dbrLabelCol
-
dbrOrderBy
protected java.lang.String dbrOrderBy
-
superTypes
protected java.lang.String superTypes
-
isDateOnly
protected boolean isDateOnly
-
dateFormat
protected java.lang.String dateFormat
-
wysiwygParams
protected java.lang.String wysiwygParams
-
tabGroup
protected java.lang.String tabGroup
-
onLabelMap
protected java.util.Map<java.lang.String,java.lang.String> onLabelMap
-
offLabelMap
protected java.util.Map<java.lang.String,java.lang.String> offLabelMap
-
unit
protected java.lang.String unit
-
unitAfter
protected java.lang.String unitAfter
-
unitBefore
protected java.lang.String unitBefore
-
decimals
protected int decimals
-
root
protected java.lang.String root
-
isExclusive
protected boolean isExclusive
-
isDisplayRoot
protected boolean isDisplayRoot
-
chooser
protected java.lang.String chooser
-
gids
protected java.lang.String[] gids
-
defaultValue
protected java.lang.String defaultValue
-
defaultTextMap
protected java.util.HashMap<java.lang.String,java.lang.String> defaultTextMap
-
isOpenWindow
protected boolean isOpenWindow
-
isResize
protected boolean isResize
-
resizeWidth
protected int resizeWidth
-
resizeHeight
protected int resizeHeight
-
escapeHtml
protected boolean escapeHtml
-
maxResolution
protected java.lang.String maxResolution
-
minValue
protected java.lang.Number minValue
-
maxValue
protected java.lang.Number maxValue
-
-
Method Detail
-
initType
public void initType()
-
reloadI18N
public void reloadI18N()
Reload all I18N informations for this type field entry. This includes : label, description, on & off label, default text, enumerate labels- Since:
- jcms-8.0.2
-
initEnumerate
protected void initEnumerate()
Init the enumerate values.
-
initUnits
protected void initUnits()
Init the field units
-
initDefault
protected void initDefault()
Init the default value.
-
resolveControlSettings
protected void resolveControlSettings()
Find the right ControlSettings
-
initDescription
protected void initDescription()
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
getXmlElement
public org.jdom.Element getXmlElement()
XML Parsing: jdom Element for this field.
Access, but do not modify.- Returns:
- the
Elementof this field.
-
getInt
public int getInt(Data data) throws java.lang.NoSuchFieldException
Gets the value of thisintfield for the givenData.- Parameters:
data- theDatafrom which to retrieve the field value.- Returns:
- the
intfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getIntFieldValue(String)
-
getLong
public long getLong(Data data) throws java.lang.NoSuchFieldException
Gets the value of thislongfield for the givenData.- Parameters:
data- theDatafrom which to retrieve the field value.- Returns:
- the
longfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getLongFieldValue(String)
-
getDouble
public double getDouble(Data data) throws java.lang.NoSuchFieldException
Gets the value of thisdoublefield for the givenData.- Parameters:
data- theDatafrom which to retrieve the field value.- Returns:
- the
doublefield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getDoubleFieldValue(String)
-
getBoolean
public boolean getBoolean(Data data) throws java.lang.NoSuchFieldException
Gets the value of thisbooleanfield for the givenData.- Parameters:
data- theDatafrom which to retrieve the field value.- Returns:
- the
booleanfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getBooleanFieldValue(String)
-
getCategory
public java.util.TreeSet getCategory(Data data, Member mbr) throws java.lang.NoSuchFieldException
Gets the value of the givenCategoryfield name for the givenData.- Parameters:
data- theDatafrom which to retrieve the field value.mbr- the member used to check rigth access to categories.- Returns:
- a
TreeSetofCategory - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getCategoryFieldValue(String, Member)
-
getObject
public java.lang.Object getObject(Data data) throws java.lang.NoSuchFieldException
Gets the value of thisObjectfield for the givenData.
If the field is multilingual, the default language will be used.
Do not retrieveCategoryfields, see #getCategory(Member).- Parameters:
data- theDatafrom which to retrieve the field value.- Returns:
- the
Objectfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getFieldValue(String)
-
getObject
public java.lang.Object getObject(Data data, java.lang.String lang) throws java.lang.NoSuchFieldException
Gets the value of thisObjectfield for the givenData.
If the field is multilingual, the given language will be used unless empty in which case value in default language is used.
Do not retrieveCategoryfields, see #getCategory(Member).- Parameters:
data- theDatafrom which to retrieve the field value.lang- the language (ISO 639: 2-letter codes) in which to retrieve the field value (used only for multilingual fields).- Returns:
- the
Objectfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- See Also:
Data.getFieldValue(String, String)
-
getObject
public java.lang.Object getObject(Data data, java.lang.String lang, boolean useDefault) throws java.lang.NoSuchFieldException
Gets the value of thisObjectfield for the givenData.
If the field is multilingual, the given language will be used.
Do not retrieveCategoryfields, see #getCategory(Member).- Parameters:
data- theDatafrom which to retrieve the field value.lang- the language (ISO 639: 2-letter codes) in which to retrieve the field value (used only for multilingual fields).useDefault- whether to use the publication main language if the field value is not available in the requested language (used only for multilingual fields).- Returns:
- the
Objectfield value - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.java.lang.NullPointerException- if the givenDatais null.- Since:
- jcms-10.0.2 / JCMS-7140
- See Also:
Data.getFieldValue(String, String)
-
getFieldValueAsString
public java.lang.String getFieldValueAsString(Data data, java.lang.String lang) throws java.lang.NoSuchFieldException
Gets value of the field asStringfor field of the following type:intlongdoublebooleanString
- Parameters:
data- the data from which to retrive the given fieldlang- the lang in which to retrieve the field if multilang- Returns:
- the value of this field as a
String, null if the field value cannot be converted to the typeString. - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.
-
getFieldValueAsString
public java.lang.String getFieldValueAsString(Data data, java.lang.String lang, boolean useDefault) throws java.lang.NoSuchFieldException
Gets value of the field asStringfor field of the following type:intlongdoublebooleanString
- Parameters:
data- the data from which to retrive the given fieldlang- the lang in which to retrieve the field if multilanguseDefault- whether to use the publication main language if the field value is not available in the requested language (used only for multilingual fields).- Returns:
- the value of this field as a
String, null if the field value cannot be converted to the typeString. - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.- Since:
- jcms-10.0.2 / JCMS-7140
-
getFieldValueAsStringArray
public java.lang.String[] getFieldValueAsStringArray(Data data, java.lang.String lang) throws java.lang.NoSuchFieldException
Gets value of the field asString[]for field of the following type:int[]long[]double[]boolean[]String[]ListSet
- Parameters:
data- the data from which to retrive the given fieldlang- the lang in which to retrieve the field, if field is multi-lang- Returns:
- the value of this field as a
String[], null if the field value cannot be converted to the typeString[]. - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.
-
getFieldValueAsStringArray
public java.lang.String[] getFieldValueAsStringArray(Data data, java.lang.String lang, boolean useDefault) throws java.lang.NoSuchFieldException
Gets value of the field asString[]for field of the following type:int[]long[]double[]boolean[]String[]ListSet
- Parameters:
data- the data from which to retrive the given fieldlang- the lang in which to retrieve the field, if field is multi-languseDefault- whether to use the publication main language if the field value is not available in the requested language (used only for multilingual fields).- Returns:
- the value of this field as a
String[], null if the field value cannot be converted to the typeString[]. - Throws:
java.lang.NoSuchFieldException- if the field was not found in the givenData.- Since:
- jcms-10.0.2 / JCMS-7140
-
getLabel
@Deprecated public java.lang.String getLabel()
Deprecated.since jcms-5.7.0.Returns the label of this field (localized in the main language).- Returns:
- the label of this field (localized in the main language).
- See Also:
getLabel(String)
-
getLabel
public java.lang.String getLabel(java.lang.String lang)
Returns the localized label of this field.- Parameters:
lang- the language- Returns:
- the localized label of this field.
- Since:
- jcms-5.7.0
-
getLabelMap
public java.util.Map getLabelMap()
Returns the Map of localized label of this field.- Returns:
- the Map of localized label of this field.
- Since:
- jcms-5.7.0
-
getName
public java.lang.String getName()
Java name of this field. e.g. "intro".- Returns:
- the java name of this field as a
String
-
getNameCap
public java.lang.String getNameCap()
Recapitalized java name of this field, (first letter capitalized). e.g. "Intro".- Returns:
- the recapitalized java name of this field as a
String
-
getDescription
@Deprecated public java.lang.String getDescription()
Deprecated.since jcms-5.7.0.Returns the description of this field (localized in the main language).- Returns:
- the description of this field (localized in the main language).
- See Also:
getDescription(String)
-
getDescription
public java.lang.String getDescription(java.lang.String lang)
Returns the localized description of this field.- Parameters:
lang- the language- Returns:
- the localized description of this field.
- Since:
- jcms-5.7.0
-
getDescriptionMap
public java.util.Map getDescriptionMap()
Returns the localized map of description of this field.- Returns:
- the localized map of description of this field.
- Since:
- jcms-5.7.0
-
getType
public java.lang.String getType()
Retrieve type of this field asString.
Can be one of these values:"int","int[]""long","long[]""double","double[]""boolean","boolean[]""String","String[]""java.util.Date","java.util.Date[]"
And also any types supported by JCMS (list not exhaustive):"com.jalios.jcms.Publication","com.jalios.jcms.Publication[]"and its subclasses"com.jalios.jcms.Content","com.jalios.jcms.Content[]"and its subclasses"com.jalios.jcms.portlet.PortalElement","com.jalios.jcms.portlet.PortalElement[]""com.jalios.jcms.Group","com.jalios.jcms.Group[]""com.jalios.jcms.Member","com.jalios.jcms.Member[]""java.util.TreeSet"(for Categories)
The value"super"marks the place (for the edit form) where the inherited field are located.- Returns:
- the type of this field as a
Stringor "super" if this field mark the place of inherited fields.
-
getTypeShort
public java.lang.String getTypeShort()
Short type of this field. e.g. if type is "String[]" or "List<String>", short type is "String".- Returns:
- the type of this field as a
Stringif any, or "super" if this field mark the place of inherited fields. - See Also:
getType()
-
getCollectionTypeMapping
public java.lang.String getCollectionTypeMapping()
-
isTypeInt
public boolean isTypeInt()
Type: int?- Returns:
- true if this field is an
int. - See Also:
getType()
-
isTypeIntArray
public boolean isTypeIntArray()
Type: int[]?- Returns:
- true if this field is an
int[]. - See Also:
getType()
-
isTypeLong
public boolean isTypeLong()
Type: long?- Returns:
- true if this field is an
long. - See Also:
getType()
-
isTypeLongArray
public boolean isTypeLongArray()
Type: long[]?- Returns:
- true if this field is an
long[]. - See Also:
getType()
-
isTypeDouble
public boolean isTypeDouble()
Type: double?- Returns:
- true if this field is an
double. - See Also:
getType()
-
isTypeDoubleArray
public boolean isTypeDoubleArray()
Type: double[]?- Returns:
- true if this field is an
double[]. - See Also:
getType()
-
isTypeBoolean
public boolean isTypeBoolean()
Type: boolean?- Returns:
- true if this field is an
boolean. - See Also:
getType()
-
isTypeBooleanArray
public boolean isTypeBooleanArray()
Type: boolean[]?- Returns:
- true if this field is an
boolean[]. - See Also:
getType()
-
isTypePrimitive
public boolean isTypePrimitive()
- Returns:
- true if the field's type is a primitive type
(
int,long,doubleorboolean). - See Also:
getType(),isTypeInt(),isTypeLong(),isTypeDouble(),isTypeBoolean()
-
isTypePrimitiveArray
public boolean isTypePrimitiveArray()
- Returns:
- true if the field's type is a primitive type
(
int[],long[],double[]orboolean[]). - See Also:
getType(),isTypeIntArray(),isTypeLongArray(),isTypeDoubleArray(),isTypeBooleanArray()
-
isTypeString
public boolean isTypeString()
Type: String?- Returns:
- true if this field is an
String. - See Also:
getType()
-
isTypeStringArray
public boolean isTypeStringArray()
Type: String[]?- Returns:
- true if this field is an
String[]. - See Also:
getType()
-
isTypeDate
public boolean isTypeDate()
Type: Date?- Returns:
- true if this field is an
Date. - See Also:
getType()
-
isTypeDateArray
public boolean isTypeDateArray()
Type: Date[]?- Returns:
- true if this field is an
Date[]. - See Also:
getType()
-
isTypeScalar
public boolean isTypeScalar()
- Returns:
- true if the field's type is a scalar of any possible type.
- See Also:
getType()
-
isTypeMV
public boolean isTypeMV()
- Returns:
- true if the field's type is a multivalued (array, List or Set) of any possible type.
- See Also:
getType()
-
isTypeArray
public boolean isTypeArray()
- Returns:
- true if the field's type is an array of any possible type.
- See Also:
getType()
-
isTypeList
public boolean isTypeList()
- Returns:
- true if the field's type is a List of any possible type.
- See Also:
getType()
-
isTypeSet
public boolean isTypeSet()
- Returns:
- true if the field's type is a Set of any possible type.
- See Also:
getType()
-
isTypeCollection
public boolean isTypeCollection()
- Returns:
- true if the field's type is a Collection (List or Set) of any possible type.
- See Also:
getType()
-
isTypeCategory
public boolean isTypeCategory()
- Returns:
- true if the field's type is "java.util.TreeSet" and editor is "category".
(field is a
TreeSetofCategory). - See Also:
getEditor(),getType()
-
isTypePublication
public boolean isTypePublication()
Type: Publication?- Returns:
- true if this field is a
Publication. - See Also:
getType()
-
isTypePublicationArray
public boolean isTypePublicationArray()
Type: Publication[]?- Returns:
- true if this field is a
Publication[]. - See Also:
getType()
-
isTypePublicationMV
public boolean isTypePublicationMV()
Type: Publication MV- Returns:
- true if this field is a
Publication[], aList<? extends Publication>orSet<? extends Publication>. - See Also:
getType()
-
isTypeDocument
public boolean isTypeDocument()
Type: FileDocument? or DBFileDocument?- Returns:
- true if this field is a
Document. - See Also:
getType()
-
isTypeDocumentMV
public boolean isTypeDocumentMV()
Type: FileDocument MV? or DBFileDocument MV?- Returns:
- true if this field is a
FileDocument[], aList<? extends FileDocument>orSet<? extends FileDocument>. - See Also:
getType()
-
isTypeData
public boolean isTypeData()
-
isTypeDataMV
public boolean isTypeDataMV()
-
isTypeMember
public boolean isTypeMember()
-
isTypeMemberMV
public boolean isTypeMemberMV()
-
isTypeWorkspace
public boolean isTypeWorkspace()
-
isTypeWorkspaceMV
public boolean isTypeWorkspaceMV()
-
isRequired
public boolean isRequired()
Required field?- Returns:
- true if this field is required, false otherwise
-
isInline
public boolean isInline()
Inline boolean ?- Returns:
- true if this field is displaying inline, false instead (vertical)
-
isWysiwygInline
public boolean isWysiwygInline()
Inline editing ?- Returns:
- true if this field is to be edited directly in the form, false otherwise (through a popup or such)
-
isHidden
public boolean isHidden()
Hidden field?- Returns:
- true if this field is hidden, false otherwise
-
isAbstract
public boolean isAbstract()
Abstract/Summary field?- Returns:
- true if this field is the summary for the type, false otherwise
-
getAbstractLength
public int getAbstractLength()
Abstract/Summary length- Returns:
- the length of the abstract
-
isDataImage
public boolean isDataImage()
Image field?- Returns:
- true if this field is the image for the type, false otherwise
-
isSearchable
public boolean isSearchable()
Searchable field- Returns:
- true if this field is searchable, false otherwise
-
isSimpleString
public boolean isSimpleString()
- Returns:
- true if this field's type is a
Stringor aString[]AND not an enumerate neither a wysywig. - See Also:
getType(),isEnumerate(),isWysiwyg()
-
isSuper
public boolean isSuper()
- Returns:
- true if this field is not really a field, but instead, the place (for the edit form) where the inherited field are located.
- See Also:
getType()
-
getEditor
public java.lang.String getEditor()
Return the internal editor type of this field.
Can be one of these values (list not exhaustive):"category""color""email""enumerate""image""media""password""query""textarea""textfield""url""wysiwyg""radio""check""list""combo""int","int[]""double","double[]""boolean","boolean[]""member","member[]""group","group[]""link","link[]""duration","duration[]""date","date[]""sqlquery","sqlquery[]""dbrecord","dbrecord[]"
- Returns:
- the field's editor as a
String
-
isLink
public boolean isLink()
Is field's editor a link (as opposed to a chooser for example). (UI related).- Returns:
- true if this field is a link
- See Also:
getEditor()
-
isAnyLink
public boolean isAnyLink()
Is field's editor any type of link (i.e. link or member or group).- Returns:
- true if this field is any type of link.
- Since:
- jcms-6.1.0
-
getChooser
public java.lang.String getChooser()
Return the internal "chooser" of this field.
Can be one of these values (list not exhaustive):"checkbox""combo""listbox""multilistbox""popup""tree"
- Returns:
- the chooser value of this field, if any, otherwise may return empty string or null.
-
isFieldML
public boolean isFieldML()
- Returns:
- true if this field a multi-language field.
-
getDefaultValue
public java.lang.String getDefaultValue()
Default value of field that can be expressed/converted into a string.- Returns:
- a
Stringwith the default value of this field.
-
getDefaultTextMap
public java.util.HashMap<java.lang.String,java.lang.String> getDefaultTextMap()
Returns a copy of the language map of default value for this textual field.- Returns:
- the language map of default value for this field. Returns an empty map if there is no default value.
- Since:
- jcms-5.7.3
-
getDefaultTextMapArray
public java.util.HashMap<java.lang.String,java.lang.String[]> getDefaultTextMapArray()
Returns a copy of the language map of default value for this textual field.- Returns:
- the language map of default value for this field. Returns an empty map if there is no default value.
- Since:
- jcms-10.0.0
-
getDefaultTextMapList
public java.util.HashMap<java.lang.String,java.util.List<java.lang.String>> getDefaultTextMapList()
Returns a copy of the language map of default value for this textual field.- Returns:
- the language map of default value for this field. Returns an empty map if there is no default value.
- Since:
- jcms-10.0.0
-
getDefaultTextString
public java.lang.String getDefaultTextString()
Returns the default value (in the main language) of this textual field.- Returns:
- the default value (in the main language) of this textual field. Returns null if there is no default value.
- Since:
- jcms-5.7.3
-
isUrl
public boolean isUrl()
URL.- Returns:
- true if field is a url field, false otherwise.
-
isFieldWiki
public boolean isFieldWiki()
TextArea.- Returns:
- true if field is a wiki field, false otherwise.
-
isWysiwyg
public boolean isWysiwyg()
Wysiwyg.- Returns:
- true if this field is a wysiwyg, false otherwise.
-
isTextfield
public boolean isTextfield()
Textfield.- Returns:
- true if this field is a textfield, false otherwise.
-
isTextarea
public boolean isTextarea()
Textarea.- Returns:
- true if this field is a textarea, false otherwise.
-
getCols
public int getCols()
TextInput/TextArea columns number.
(UI related)- Returns:
- the number of columns to use in the form textinput or textarea.
-
getMaxlength
public int getMaxlength()
TextInput maximum length.- Returns:
- the maximum length of a text input.
-
getRows
public int getRows()
TextArea/WYSIWYG rows number.
(UI related)- Returns:
- the number of rows to use in the form textarea or in a wysiwyg.
-
getUnit
public java.lang.String getUnit()
TextInput unit
e.g. "$"- Returns:
- the unit.
-
getUnitBefore
public java.lang.String getUnitBefore()
TextInput unit, displayed before input.
e.g. "$"- Returns:
- the unit displayed before a text input.
-
getUnitAfter
public java.lang.String getUnitAfter()
TextInput unit, displayed after input.
e.g. "km"- Returns:
- the unit displayed after a text input.
-
getDecimals
public int getDecimals()
Double decimals count- Returns:
- the decimals count for double fields.
-
getWysiwygParams
public java.lang.String getWysiwygParams()
WYSIWYG toolbar options.
Computed from xml field attribute toolbar[0-4]. e.g. : &toolbar0=open&toolbar1=open&toolbar2=open&toolbar3=open&toolbar4=hidden (UI related)- Returns:
- a string with wysiwyg toolbar options.
-
getWysiwygConfigurationId
public java.lang.String getWysiwygConfigurationId()
Returns the WYSIWYG configuration ID.- Returns:
- WYSIWYG configuration ID
-
getMediaTypes
public java.lang.String[] getMediaTypes()
-
isOpenWindow
public boolean isOpenWindow()
Returns true if this is an URL field which must be open in a new window.- Returns:
- true if this is an URL field which must be open in a new window.
- Since:
- jcms-6.1.0
-
isResize
public boolean isResize()
Returns true if this is an image field which must be resized.- Returns:
- true if this is an image field which must be resized.
- Since:
- jcms-6.1.0
-
getResizeWidth
public int getResizeWidth()
Returns the resize width- Returns:
- the resize width
- Since:
- jcms-6.1.0
-
getResizeHeight
public int getResizeHeight()
Returns the resize height- Returns:
- the resize height
- Since:
- jcms-6.1.0
-
escapeHtml
public boolean escapeHtml()
Returns true if the HTML contained in this field must be escaped.- Returns:
- true if the HTML contained in this field must be escaped.
- Since:
- jcms-6.1.0
-
trim
public boolean trim()
Returns true if the value in this field must be trimmed when saved- Returns:
- true to trim, false to keep as is
- Since:
- jcms-10.0.2
-
isSlaveImageMap
public boolean isSlaveImageMap()
Returns true if this field is the text area field generated aside the real image field.
Warning: this field was not really saved in the type's xml, but is instead only created at JSP generation time.- Returns:
- true if this field is the text area associated with the image map field.
-
isMasterImageMap
public boolean isMasterImageMap()
Returns true if this field is the image field of an image map field.- Returns:
- true if this field is the image field of an image map field.
-
getMinValue
public java.lang.Number getMinValue()
Returns the mininum value authorized for this number field (integer or decimal), if available.- Returns:
- the minimum value, or null if it was not defined for this field. Returns an Integer instance for integer field, or a Double instance for decimal fields.
-
getMaxValue
public java.lang.Number getMaxValue()
Returns the maximum value authorized for this number field (integer or decimal), if available.- Returns:
- the maximum value, or null if it was not defined for this field. Returns an Integer instance for integer field, or a Double instance for decimal fields.
-
getDataSource
public java.lang.String getDataSource()
SQLQuery/DBRecord/SQLResult: data source of this SQL related field.- Returns:
- the data source of the SQL field
-
getMaxRows
public int getMaxRows()
SQLQuery/DBRecord/SQLResult: maximum row to be retrieved (0 means no limit)- Returns:
- the maximum number of rows to be retrieved.
-
getDbrTable
public java.lang.String getDbrTable()
DBRecord: table of this DB record field.- Returns:
- the name of the SQL table used for this DB record field.
-
getDbrKeyCol
public java.lang.String getDbrKeyCol()
DBRecord: primary key column of this DB record field.- Returns:
- the name of primary key SQL column used for this DB record field.
-
getDbrColumns
public java.lang.String getDbrColumns()
DBRecord: columns to be listed for this DB record field (comma separated)- Returns:
- a
Stringwith comma separated SQL columns name SQL listed for this DB record field.
-
getDbrLabelCol
public java.lang.String getDbrLabelCol()
DBRecord: column used as label for this DB record field- Returns:
- a
Stringwith the SQL column name used a label for this DB record field
-
getDbrOrderBy
public java.lang.String getDbrOrderBy()
DBRecord: ORDER BY SQL criteria DB record field- Returns:
- a
Stringwith the ORDER BY SQL criteria for this DB record field
-
getSuperTypes
public java.lang.String getSuperTypes()
Type: superTypes- Returns:
- a
Stringwith the list of super types
-
isEnumerate
public boolean isEnumerate()
Enumerate.- Returns:
- true if this field a an enumerate.
-
getSize
public int getSize()
Enumerate: html Select size.
(UI related)- Returns:
- the size of a
selectin a html form.
-
getEnumerateLabels
public java.lang.String[] getEnumerateLabels()
Enumerate: Labels of this enumerate field, e.g { "Red", "Green", "Blue"} for the default language of the type/site.- Returns:
- a
String[]containing all labels for this field, or null if this field is not an enumerate
-
getEnumerateLabelsMap
public java.util.HashMap<java.lang.String,java.lang.String[]> getEnumerateLabelsMap()
Enumerate: Map of 'language to labels' for this enumerate field, e.g {{"en" -> { "Red", "Green", "Blue"}, "fr" -> ... }} for the default language of the type/site.- Returns:
- a
String[]containing all labels for this field, or null if this field is not an enumerate - Since:
- jcms-8.0.0
-
getEnumerateValues
public java.lang.String[] getEnumerateValues()
Enumerate: Possible values of this enumerate field, e.g { "00FF00", "00FF00", "0000FF"}.- Returns:
- a
String[]containing all values for this field, or null if this field is not an enumerate.
-
isEnumerateML
public boolean isEnumerateML()
Deprecated.this value might not reflect the proper translation status of the label list, you should now consider that enumerate label are always I18NedEnumerate: multilanguage.- Returns:
trueif this field has multilanguage labels (field contains labelList_en... etc).
-
isDateOnly
public boolean isDateOnly()
DateChooser: use date only, or date and time?- Returns:
- true if this field was specified to use date only (no time).
-
getDateFormat
public java.lang.String getDateFormat()
DateChooser: date format- Returns:
- the date format.
-
getRoot
public java.lang.String getRoot()
Categories: Root Category ID of this category field- Returns:
- a
Stringwith the ID of the root Category of this field
-
isDisplayRoot
public boolean isDisplayRoot()
Categories: Display Root- Returns:
- true if this Category field should display its root
-
isExclusive
public boolean isExclusive()
Categories: Exclusive.
(UI related)- Returns:
- true if only one category can be selected in html form, false otherwise.
-
getGids
public java.lang.String[] getGids()
Member chooser: Group IDs- Returns:
- a
String[]containing the jcms id of theGroupfrom which we chooseMember.
-
getOffLabelMap
public java.util.Map<java.lang.String,java.lang.String> getOffLabelMap()
Boolean: false/OFF Label of a boolean field. e.g. "No", "Disabled"- Returns:
Map{language, label} with the label to use for the false/off value of this boolean.
-
getOffLabel
public java.lang.String getOffLabel(java.lang.String lang)
Returns the localized offLabel for to this field.- Parameters:
lang- the language- Returns:
- the localized offLabel for to this field.
- Since:
- jcms-5.7.0
-
getOnLabelMap
public java.util.Map<java.lang.String,java.lang.String> getOnLabelMap()
Boolean: true/ON Label of a boolean field. e.g. "Yes", "Enabled"- Returns:
Map{language, label} with the label to use for the true/on value of this boolean.
-
getOnLabel
public java.lang.String getOnLabel(java.lang.String lang)
Returns the localized onLabel for to this field.- Parameters:
lang- the language- Returns:
- the localized onLabel for to this field.
- Since:
- jcms-5.7.0
-
getTab
public java.lang.String getTab()
Tab: tab name in which this field will be displayed.- Returns:
- a
Stringwith the name of the tab.
-
getTabGroup
public java.lang.String getTabGroup()
TabGroup: group name for multivalued fields, all field having the same value will be display together. (has nothing to do with Tab). e.g. Interview type has two multivalued fields, "questions" and "answers" with the same tabgroup, when switching to second value of "questions", we display the second value of "answers". (UI related)- Returns:
- name of group name
-
isWidget
public boolean isWidget()
Is this field manage through a widget- Returns:
- true if this field manage through a widget.
-
getControlSettings
public ControlSettings getControlSettings()
Control Settings of widget editor. seeControlSettings.- Returns:
ControlSettingsobject.
-
getDescriptionType
public TypeFieldEntry.DescriptionType getDescriptionType()
Type of description to be used by widget:DescriptionType.NONEDescriptionType.TEXTDescriptionType.TOOLTIP
- Returns:
- an int indicating what type of description will be display.
-
isMbrChsr
public boolean isMbrChsr()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.MEMBER / SelectorType.CHOOSER
-
isMbrEnum
public boolean isMbrEnum()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.MEMBER / SelectorType.SELECT
-
isGrpChsr
public boolean isGrpChsr()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.GROUP / SelectorType.CHOOSER
-
isGrpEnum
public boolean isGrpEnum()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.GROUP / SelectorType.SELECT
-
isDateChsr
public boolean isDateChsr()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.DATE
-
isCatEditor
public boolean isCatEditor()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.CATEGORY
-
isSQLQuery
public boolean isSQLQuery()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.SQLQUERY
-
isDBRecordChsr
public boolean isDBRecordChsr()
Widget Type.- Returns:
- true if the widget editor for this field is ControlType.DBRECORD
-
isCatTreeEditor
public boolean isCatTreeEditor()
Widget Type.- Returns:
- true if this field is not managed through widget editor but using a category tree editor
-
isKeyword
public boolean isKeyword()
Return true if the field display keywords- Returns:
- boolean true if
-
getMaxResolution
public java.lang.String getMaxResolution()
-
-