Value range of the FormDataList data type
Using the input component FS_LIST lists can be entered and maintained. It returns a FormDataList object. This contains IdProvidingFormData objects.
Lists which are created by means of FS_LIST, DATASOURCE type INLINE, can be output via a $CMS_VALUE(...)$ instruction, e.g.
$CMS_VALUE(INDENTIFIER)$
Different methods can be applied to the resulting data type (FormDataList).
The data type FormDataList can also be looked up in the API documentation:
de.espirit.firstspirit.forms.FormDataList
Definition using the standard input components
The following standard input component returns an object of data type FormDataList:
Then, with the help of a $CMS_VALUE(...)$ instruction, methods can then be applied to this object:
$CMS_VALUE(IDENTIFIER.METHOD)$
Methods on FormDataList objects
The table below lists all methods which can be invoked on objects of data type FormDataList:
The object is generated by the following form objects: |
---|
FS_LIST |
Method name |
Return type |
Brief description |
Available since |
add(List) |
List |
|
|
add(Object) |
List |
|
|
add(int, Object) |
void |
|
|
addAll(Collection) |
boolean |
|
|
addAll(int, Collection) |
boolean |
|
|
clear |
void |
|
|
compareTo(Comparable) |
int |
|
|
contains(Object) |
boolean |
checks if the provided element is contained |
4.0.0 |
containsAll(Collection) |
boolean |
|
|
copy |
Collection |
make a (shallow) copy |
4.0.0 |
distinct(Lambda) |
Collection |
Output of a list of unique elements |
4.1 |
equals(Object) |
boolean |
|
|
filter(String) |
Object |
delivers a filtered collection, the last parameter converted to a lambda expression |
4.0.0 |
filter(Lambda) |
Object |
Filtering of list elements |
4.0.0 |
first |
Object |
|
|
fold(Lambda, Map) |
Object |
Summarizing values |
4.0.0 |
get(Range) |
Object |
|
|
get(int) |
Object |
|
|
getClass |
Class |
Class of the invoking object |
|
getProducer |
FormDataProducer |
|
|
hashCode |
int |
|
|
indexOf(Object) |
int |
|
|
isCase(Object) |
boolean |
|
|
isEmpty |
boolean |
Checks whether an expression is empty |
4.0.0 |
isNull |
boolean |
Checks whether an expression is null (zero) |
|
iterator |
Iterator |
|
|
last |
Object |
|
|
lastIndexOf(Object) |
int |
|
|
length |
int |
|
|
listIterator |
ListIterator |
|
|
listIterator(int) |
ListIterator |
|
|
map(String) |
Object |
delivers a mapped collection, the last parameter converted to a lambda expression |
4.0.0 |
map(Lambda) |
Object |
Output of list elements as collection |
4.0.0 |
max |
Object |
delivers the maximum element (only applicable if elements are compareable) |
4.0.0 |
max(Comparator) |
Object |
delivers the maximum element concerning to the given comparator |
4.0.0 |
max(Lambda) |
Object |
Filtering by the highest value |
4.0.0 |
min |
Object |
delivers the minimum element (only applicable if elements are compareable) |
4.0.0 |
min(Comparator) |
Object |
delivers the minimum element concerning to the given comparator |
4.0.0 |
min(Lambda) |
Object |
Filtering by the lowest value |
4.0.0 |
plus(Collection) |
Collection |
|
|
plus(Object) |
Collection |
adds the element to the collection (called for operator '+') |
4.0.0 |
print |
void |
|
|
print(Object) |
void |
|
|
remove(int) |
Object |
|
|
remove(Object) |
boolean |
|
|
removeAll(Collection) |
boolean |
|
|
retainAll(Collection) |
boolean |
|
|
reverse |
List |
|
|
set(int, Object) |
List |
|
|
set(String, Object) |
Object |
|
|
size |
int |
the number of contained elements |
4.0.0 |
sort |
List |
|
|
sort(String) |
List |
|
|
sort(Comparator) |
List |
|
|
sort(Lambda) |
List |
Sorting of list elements |
|
subList(int) |
List |
|
|
subList(int, int) |
List |
|
|
sublist(int) |
List |
|
|
sublist(int, int) |
List |
|
|
toArray |
Object[] |
|
|
toArray(Object[]) |
Object[] |
|
|
toJson |
String |
Convert to JSON string representtion (only handles Maps, Collections, Arrays, Numbers, and Strings) |
4.2.14 |
toString |
String |
|
|
toString(String) |
String |
Output of elements separated by delimiters as a string |
4.0.0 |
toString(String, String) |
String |
Short form for collection.map(attribute).toString(delimiter) |
4.0.0 |
type |
String |
|
|
add(List)
Method name |
Return type |
Available since |
add(List) |
List |
|
Overview
add(Object)
Method name |
Return type |
Available since |
add(Object) |
List |
|
Overview
add(int, Object)
Method name |
Return type |
Available since |
add(int, Object) |
void |
|
Overview
addAll(Collection)
Method name |
Return type |
Available since |
addAll(Collection) |
boolean |
|
Overview
addAll(int, Collection)
Method name |
Return type |
Available since |
addAll(int, Collection) |
boolean |
|
Overview
clear
Method name |
Return type |
Available since |
clear |
void |
|
Overview
compareTo(Comparable)
Method name |
Return type |
Available since |
compareTo(Comparable) |
int |
|
Overview
contains(Object)
checks if the provided element is contained
Method name |
Return type |
Available since |
contains(Object) |
boolean |
4.0.0 |
Overview
containsAll(Collection)
Method name |
Return type |
Available since |
containsAll(Collection) |
boolean |
|
Overview
copy
make a (shallow) copy
Method name |
Return type |
Available since |
copy |
Collection |
4.0.0 |
Overview
distinct(Lambda)
This method filters a collection and returns only the first occurrence relating to a lambda expression.
It can be used to eliminate or ignore duplicates of a list according to a given condition. For this reason, it can be used for glossaries or summaries, which can then serve linked, for example, as navigational element.
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
distinct(Lambda) |
Collection |
4.1 |
Overview
equals(Object)
Method name |
Return type |
Available since |
equals(Object) |
boolean |
|
Overview
filter(String)
delivers a filtered collection, the last parameter converted to a lambda expression
Method name |
Return type |
Available since |
filter(String) |
Object |
4.0.0 |
Overview
filter(Lambda)
If lists have several attributes per element (comparable with a dataset with several columns), the elements can be filtered by the individual attributes using the method .filter(Lambda).
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
filter(Lambda) |
Object |
4.0.0 |
Overview
first
Method name |
Return type |
Available since |
first |
Object |
|
Overview
fold(Lambda, Map)
This method folds the collection with the given lambda expression and start value.
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
fold(Lambda, Map) |
Object |
4.0.0 |
Overview
get(Range)
Method name |
Return type |
Available since |
get(Range) |
Object |
|
Overview
get(int)
Method name |
Return type |
Available since |
get(int) |
Object |
|
Overview
getClass
The .getClass() (in Bean syntax: .class) method returns the class of the invoking object (cf. java.lang.Class).
Invocation:
$CMS_VALUE(myString.class)$
$CMS_VALUE(myString.getClass())$
Output:
java.lang.String
Method name |
Return type |
Available since |
getClass |
Class |
|
Overview
getProducer
Overview
hashCode
Method name |
Return type |
Available since |
hashCode |
int |
|
Overview
indexOf(Object)
Method name |
Return type |
Available since |
indexOf(Object) |
int |
|
Overview
isCase(Object)
Method name |
Return type |
Available since |
isCase(Object) |
boolean |
|
Overview
isEmpty
The .isEmpty() (in Bean syntax: .isEmpty) method checks whether an expression or object is empty, e.g. storeElement.isEmpty(). The result of the semantic check depends on the expression or object, e.g. a character string is empty if it does not contain any characters. In the case of objects with complex values or objects, the object decides when it is empty. The data type DomElement for example always contains an empty document, thus it is never null. For this reason, checking an empty DOM editor input component by using the method .isNull()returns the value false, whereas checking the component with .isEmpty() would return the value true.
The method .isEmpty() returns a Boolean value as the check result. true is the check result if the expression or object is empty and false if not.
Method name |
Return type |
Available since |
isEmpty |
boolean |
4.0.0 |
Overview
isNull
The .isNull() (in Bean syntax: .isNull) method checks whether an expression or object is null , e.g. storeElement.isNull(). In the case of objects with complex values or objects, the object decides when it is null. The data type DomElement for example always contains an empty document, thus it is never null. For this reason, checking an empty DOM editor input component by using the method .isNull() returns the value false, whereas checking the component with .isEmpty() would return the value true.
The method .isNull() returns a Boolean value as the check result. true is the check result if the expression or object is null and false if not.
Method name |
Return type |
Available since |
isNull |
boolean |
|
Overview
iterator
Method name |
Return type |
Available since |
iterator |
Iterator |
|
Overview
last
Method name |
Return type |
Available since |
last |
Object |
|
Overview
lastIndexOf(Object)
Method name |
Return type |
Available since |
lastIndexOf(Object) |
int |
|
Overview
length
Method name |
Return type |
Available since |
length |
int |
|
Overview
listIterator
Method name |
Return type |
Available since |
listIterator |
ListIterator |
|
Overview
listIterator(int)
Method name |
Return type |
Available since |
listIterator(int) |
ListIterator |
|
Overview
map(String)
delivers a mapped collection, the last parameter converted to a lambda expression
Method name |
Return type |
Available since |
map(String) |
Object |
4.0.0 |
Overview
map(Lambda)
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
map(Lambda) |
Object |
4.0.0 |
Overview
max
delivers the maximum element (only applicable if elements are compareable)
Method name |
Return type |
Available since |
max |
Object |
4.0.0 |
Overview
max(Comparator)
delivers the maximum element concerning to the given comparator
Method name |
Return type |
Available since |
max(Comparator) |
Object |
4.0.0 |
Overview
max(Lambda)
This method delivers the maximum element concerning to the given comparator.
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
max(Lambda) |
Object |
4.0.0 |
Overview
min
delivers the minimum element (only applicable if elements are compareable)
Method name |
Return type |
Available since |
min |
Object |
4.0.0 |
Overview
min(Comparator)
delivers the minimum element concerning to the given comparator
Method name |
Return type |
Available since |
min(Comparator) |
Object |
4.0.0 |
Overview
min(Lambda)
This method delivers the minimum element concerning to the given comparator.
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
min(Lambda) |
Object |
4.0.0 |
Overview
plus(Collection)
Method name |
Return type |
Available since |
plus(Collection) |
Collection |
|
Overview
plus(Object)
adds the element to the collection (called for operator '+')
Method name |
Return type |
Available since |
plus(Object) |
Collection |
4.0.0 |
Overview
print
Method name |
Return type |
Available since |
print |
void |
|
Overview
print(Object)
Method name |
Return type |
Available since |
print(Object) |
void |
|
Overview
remove(int)
Method name |
Return type |
Available since |
remove(int) |
Object |
|
Overview
remove(Object)
Method name |
Return type |
Available since |
remove(Object) |
boolean |
|
Overview
removeAll(Collection)
Method name |
Return type |
Available since |
removeAll(Collection) |
boolean |
|
Overview
retainAll(Collection)
Method name |
Return type |
Available since |
retainAll(Collection) |
boolean |
|
Overview
reverse
Method name |
Return type |
Available since |
reverse |
List |
|
Overview
set(int, Object)
Method name |
Return type |
Available since |
set(int, Object) |
List |
|
Overview
set(String, Object)
Method name |
Return type |
Available since |
set(String, Object) |
Object |
|
Overview
size
the number of contained elements
Method name |
Return type |
Available since |
size |
int |
4.0.0 |
Overview
sort
Method name |
Return type |
Available since |
sort |
List |
|
Overview
sort(String)
Method name |
Return type |
Available since |
sort(String) |
List |
|
Overview
sort(Comparator)
Method name |
Return type |
Available since |
sort(Comparator) |
List |
|
Overview
sort(Lambda)
If lists have several attributes per element (comparable with a dataset with several columns), the elements can be sorted by the individual attributes using the method .sort(Lambda).
See page Mapping expressions (lambda).
Method name |
Return type |
Available since |
sort(Lambda) |
List |
|
Overview
subList(int)
Method name |
Return type |
Available since |
subList(int) |
List |
|
Overview
subList(int, int)
Method name |
Return type |
Available since |
subList(int, int) |
List |
|
Overview
sublist(int)
Method name |
Return type |
Available since |
sublist(int) |
List |
|
Overview
sublist(int, int)
Method name |
Return type |
Available since |
sublist(int, int) |
List |
|
Overview
toArray
Method name |
Return type |
Available since |
toArray |
Object[] |
|
Overview
toArray(Object[])
Method name |
Return type |
Available since |
toArray(Object[]) |
Object[] |
|
Overview
toJson
Convert to JSON string representtion (only handles Maps, Collections, Arrays, Numbers, and Strings)
Method name |
Return type |
Available since |
toJson |
String |
4.2.14 |
Overview
toString
Method name |
Return type |
Available since |
toString |
String |
|
Overview
toString(String)
The individual elements, e.g. of a list, can be output as string, separated by a delimiter which can be chosen freely.
Example:
$CMS_SET(myList, ["House","Key","Window"])$
$CMS_VALUE(myList.toString("; "))$
The elements of the list myList are output, separated each by semicolon and a space character:
House; Key; Window
Method name |
Return type |
Available since |
toString(String) |
String |
4.0.0 |
Overview
toString(String, String)
Short form for collection.map(attribute).toString(delimiter)
Method name |
Return type |
Available since |
toString(String, String) |
String |
4.0.0 |
Overview
type
Method name |
Return type |
Available since |
type |
String |
|
Overview