Value range of the Entity data type
Datasets can be maintained in the tables of the Content Store. These datasets can be output and further processed in FirstSpirit. In addition, there are several input components in which one or several datasets can be selected.
A dataset is represented by the Entity data type. On the one hand the dataset includes the individual columns with their values and on the other meta information, e.g. the last editor.
For further information on the Entity data type, see API documentation: de.espirit.firstspirit.access.or.schema.Entity
Methods on Entity objects
The table below lists all methods which can be invoked on objects of data type Entity.
Method name |
Return type |
Brief description |
Available since |
clear |
void |
|
|
compute(Object, BiFunction) |
Object |
|
|
computeIfAbsent(Object, Function) |
Object |
|
|
computeIfPresent(Object, BiFunction) |
Object |
|
|
containsKey(Object) |
boolean |
|
|
containsValue(Object) |
boolean |
|
|
copy |
Entity |
Copies this entity. |
4.0.55 |
copyFrom(Entity) |
void |
Copy the values of the given entity to this entity. |
4.0.17 |
copyOf(Map) |
Map |
|
|
entry(Object, Object) |
Map$Entry |
|
|
entrySet |
Set |
|
|
equals(Object) |
boolean |
|
|
forEach(BiConsumer) |
void |
|
|
get(Set) |
Set |
|
|
get(Collection) |
List |
|
|
get(String) |
Object |
Value of a key |
|
get(Object) |
Object |
|
|
get(String, String) |
Object |
|
|
getAttributeNames |
Collection |
Return a collection of the attributes declared for this entity. |
4.0.17 |
getClass |
Class |
Class of the invoking object |
|
getDataset(TableTemplate) |
Dataset |
Dataset erhalten |
|
getDataset(String) |
Dataset |
|
|
getEditor |
User |
The last user of the content store data |
|
getEntityType |
EntityType |
Return the type of this entity. |
4.0.17 |
getGid |
UUID |
Returns the gid of this entity, if the session supports gids and the gid is already created, else null. |
5.0.100 |
getId |
Object |
|
|
getIdentifier |
Identifier |
Return the identifier of this entity. |
4.0.17 |
getKeyValue |
KeyValue |
Return the business key of this entity or null if this entity is in state NEW. |
4.0.17 |
getLastChange |
Date |
|
|
getList(String) |
List |
Return the value of the specified list attribute ("to N relation"). |
4.0.55 |
getOrDefault(Object, Object) |
Object |
|
|
getReleasedBy |
User |
|
|
getSession |
Session |
Returns the session which was used to create or retrieve this entity. |
4.0.17 |
getState |
Entity$PersistentState |
Return the state of this entity. |
4.0.17 |
getValue(String) |
Object |
Return the value of the attribute specified by the given name. |
4.0.17 |
getValue(Attribute) |
Object |
Return the value of the given attribute or null. |
4.0.17 |
hashCode |
int |
|
|
isCase(Object) |
boolean |
|
4.2.14 |
isEmpty |
boolean |
Checks whether an expression is empty |
|
isNull |
boolean |
Checks whether an expression is null (zero) |
|
isReleased |
boolean |
Return true if this entity is released else false. |
4.0.17 |
isValid |
boolean |
Return true if this entity is valid else false. |
4.0.17 |
keySet |
Set |
|
|
merge(Object, Object, BiFunction) |
Object |
|
|
of |
Map |
|
|
of(Object, Object) |
Map |
|
|
of(Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
|
ofEntries(Map$Entry[]) |
Map |
|
|
print |
void |
|
|
put(Object, Object) |
Object |
|
|
putAll(Map) |
void |
|
|
putIfAbsent(Object, Object) |
Object |
|
|
refresh |
void |
Refresh the content of this entity with the one stored in the database. |
4.0.24 |
remove(Object) |
Object |
|
|
remove(Object, Object) |
boolean |
|
|
replace(Object, Object) |
Object |
|
|
replace(Object, Object, Object) |
boolean |
|
|
replaceAll(BiFunction) |
void |
|
|
rollback |
void |
Revert all attribute changes. |
4.0.17 |
rollbackWithRelations |
void |
Reset all changes, including relations (i.e. this may rollback delete operations of entities which has been set in relation to this entity). |
4.0.416 |
set(String, Object) |
Object |
|
|
set(Object, Object) |
Map |
|
|
setValue(String, Object) |
void |
Set the value of the attribute with name to the given value. |
4.0.17 |
setValue(Attribute, Object) |
void |
Set the value of the attribute attribute to value. |
4.0.17 |
size |
int |
Number of the key/value pairs |
|
toJSON |
String |
Convert to a JSON-compatible string representation including necessary quotes and escaping for immediate use. Handles Maps, Collections, Arrays, Numbers, Strings, Boolean, Date, and JsonElement. A date instance will be converted to an ISO-8601 formatted date string. Any object other than above will be converted using its 'toString()' value. |
5.2.11 |
toString |
String |
|
|
type |
String |
|
|
values |
Collection |
|
|
clear
Method name |
Return type |
Available since |
clear |
void |
|
Overview
compute(Object, BiFunction)
Method name |
Return type |
Available since |
compute(Object, BiFunction) |
Object |
|
Overview
computeIfAbsent(Object, Function)
Method name |
Return type |
Available since |
computeIfAbsent(Object, Function) |
Object |
|
Overview
computeIfPresent(Object, BiFunction)
Method name |
Return type |
Available since |
computeIfPresent(Object, BiFunction) |
Object |
|
Overview
containsKey(Object)
Method name |
Return type |
Available since |
containsKey(Object) |
boolean |
|
Overview
containsValue(Object)
Method name |
Return type |
Available since |
containsValue(Object) |
boolean |
|
Overview
copy
Copies this entity.
Method name |
Return type |
Available since |
copy |
Entity |
4.0.55 |
Overview
copyFrom(Entity)
Copy the values of the given entity to this entity.
Method name |
Return type |
Available since |
copyFrom(Entity) |
void |
4.0.17 |
Overview
copyOf(Map)
Method name |
Return type |
Available since |
copyOf(Map) |
Map |
|
Overview
entry(Object, Object)
Method name |
Return type |
Available since |
entry(Object, Object) |
Map$Entry |
|
Overview
entrySet
Method name |
Return type |
Available since |
entrySet |
Set |
|
Overview
equals(Object)
Method name |
Return type |
Available since |
equals(Object) |
boolean |
|
Overview
forEach(BiConsumer)
Method name |
Return type |
Available since |
forEach(BiConsumer) |
void |
|
Overview
get(Set)
Method name |
Return type |
Available since |
get(Set) |
Set |
|
Overview
get(Collection)
Method name |
Return type |
Available since |
get(Collection) |
List |
|
Overview
get(String)
A map contains key/value pairs. The .get(String) method can be used to determine the value of the transferred key.
If a map contains the following key/value pairs:
1st pair: key="Max", value="Mustermann"
2nd pair: key="Franz", value="Meier"
3rd pair: key="Peter", value="Müller"
results in the invocation
MAP.get("Franz")
for return of a character string (cf. java.lang.String ) with the content
Meier
Method name |
Return type |
Available since |
get(String) |
Object |
|
Overview
get(Object)
Method name |
Return type |
Available since |
get(Object) |
Object |
|
Overview
get(String, String)
Method name |
Return type |
Available since |
get(String, String) |
Object |
|
Overview
getAttributeNames
Return a collection of the attributes declared for this entity.
Method name |
Return type |
Available since |
getAttributeNames |
Collection |
4.0.17 |
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
getDataset(TableTemplate)
You can use this method to determine in a template a Dataset from an Entity (which, for example, is generated by the contentSelect function.
This method expects the input of a reference name of the respective table template in quotation marks.
Example:
$CMS_FOR(_entity, cs_press_releases)$
$CMS_SET(_dataset, _entity.getDataset("products.product"))$
$-- ... --$
$CMS_END_FOR$
Here cs_press_releases is the variable / identifier of the contentSelect function, products.product is the reference name of the table template.
Alternatively, the following notation can be used. In this case, the conversion already takes place when the FOR loop is called.
$CMS_FOR(_dataset, cs_press_releases.map(entity->entity.getDataset("products.product")))$
$-- ... --$
$CMS_END_FOR$
If the Dataset cannot be determined, null is returned.
Method name |
Return type |
Available since |
getDataset(TableTemplate) |
Dataset |
|
Overview
getDataset(String)
Method name |
Return type |
Available since |
getDataset(String) |
Dataset |
|
Overview
getEditor
The .getEditor() returns the last user of the content store data. The returned User object can be used to output information about the user, e.g. abbreviation, name, etc.
Method name |
Return type |
Available since |
getEditor |
User |
|
Overview
getEntityType
Return the type of this entity.
Method name |
Return type |
Available since |
getEntityType |
EntityType |
4.0.17 |
Overview
getGid
Returns the gid of this entity, if the session supports gids and the gid is already created, else null.
Method name |
Return type |
Available since |
getGid |
UUID |
5.0.100 |
Overview
getId
Method name |
Return type |
Available since |
getId |
Object |
|
Overview
getIdentifier
Return the identifier of this entity.
Method name |
Return type |
Available since |
getIdentifier |
Identifier |
4.0.17 |
Overview
getKeyValue
Return the business key of this entity or null if this entity is in state NEW.
Method name |
Return type |
Available since |
getKeyValue |
KeyValue |
4.0.17 |
Overview
getLastChange
Method name |
Return type |
Available since |
getLastChange |
Date |
|
Overview
getList(String)
Return the value of the specified list attribute ("to N relation").
Method name |
Return type |
Available since |
getList(String) |
List |
4.0.55 |
Overview
getOrDefault(Object, Object)
Method name |
Return type |
Available since |
getOrDefault(Object, Object) |
Object |
|
Overview
getReleasedBy
Method name |
Return type |
Available since |
getReleasedBy |
User |
|
Overview
getSession
Returns the session which was used to create or retrieve this entity.
Method name |
Return type |
Available since |
getSession |
Session |
4.0.17 |
Overview
getState
Return the state of this entity.
Overview
getValue(String)
Return the value of the attribute specified by the given name.
Method name |
Return type |
Available since |
getValue(String) |
Object |
4.0.17 |
Overview
getValue(Attribute)
Return the value of the given attribute or null.
Method name |
Return type |
Available since |
getValue(Attribute) |
Object |
4.0.17 |
Overview
hashCode
Method name |
Return type |
Available since |
hashCode |
int |
|
Overview
isCase(Object)
Method name |
Return type |
Available since |
isCase(Object) |
boolean |
4.2.14 |
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 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 |
|
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
isReleased
Return true if this entity is released else false.
Method name |
Return type |
Available since |
isReleased |
boolean |
4.0.17 |
Overview
isValid
Return true if this entity is valid else false.
Method name |
Return type |
Available since |
isValid |
boolean |
4.0.17 |
Overview
keySet
Method name |
Return type |
Available since |
keySet |
Set |
|
Overview
merge(Object, Object, BiFunction)
Method name |
Return type |
Available since |
merge(Object, Object, BiFunction) |
Object |
|
Overview
of
Method name |
Return type |
Available since |
of |
Map |
|
Overview
of(Object, Object)
Method name |
Return type |
Available since |
of(Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)
Method name |
Return type |
Available since |
of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Map |
|
Overview
ofEntries(Map$Entry[])
Method name |
Return type |
Available since |
ofEntries(Map$Entry[]) |
Map |
|
Overview
print
Method name |
Return type |
Available since |
print |
void |
|
Overview
put(Object, Object)
Method name |
Return type |
Available since |
put(Object, Object) |
Object |
|
Overview
putAll(Map)
Method name |
Return type |
Available since |
putAll(Map) |
void |
|
Overview
putIfAbsent(Object, Object)
Method name |
Return type |
Available since |
putIfAbsent(Object, Object) |
Object |
|
Overview
refresh
Refresh the content of this entity with the one stored in the database.
Method name |
Return type |
Available since |
refresh |
void |
4.0.24 |
Overview
remove(Object)
Method name |
Return type |
Available since |
remove(Object) |
Object |
|
Overview
remove(Object, Object)
Method name |
Return type |
Available since |
remove(Object, Object) |
boolean |
|
Overview
replace(Object, Object)
Method name |
Return type |
Available since |
replace(Object, Object) |
Object |
|
Overview
replace(Object, Object, Object)
Method name |
Return type |
Available since |
replace(Object, Object, Object) |
boolean |
|
Overview
replaceAll(BiFunction)
Method name |
Return type |
Available since |
replaceAll(BiFunction) |
void |
|
Overview
rollback
Revert all attribute changes.
Method name |
Return type |
Available since |
rollback |
void |
4.0.17 |
Overview
rollbackWithRelations
Reset all changes, including relations (i.e. this may rollback delete operations of entities which has been set in relation to this entity).
Method name |
Return type |
Available since |
rollbackWithRelations |
void |
4.0.416 |
Overview
set(String, Object)
Method name |
Return type |
Available since |
set(String, Object) |
Object |
|
Overview
set(Object, Object)
Method name |
Return type |
Available since |
set(Object, Object) |
Map |
|
Overview
setValue(String, Object)
Set the value of the attribute with name to the given value.
Method name |
Return type |
Available since |
setValue(String, Object) |
void |
4.0.17 |
Overview
setValue(Attribute, Object)
Set the value of the attribute attribute to value.
Method name |
Return type |
Available since |
setValue(Attribute, Object) |
void |
4.0.17 |
Overview
size
The .size() (in Bean syntax: .size) method returns the number of the key/value pairs in a map.
The returned object is an integer (see java.lang.Integer).
Method name |
Return type |
Available since |
size |
int |
|
Overview
toJSON
Convert to a JSON-compatible string representation including necessary quotes and escaping for immediate use. Handles Maps, Collections, Arrays, Numbers, Strings, Boolean, Date, and JsonElement. A date instance will be converted to an ISO-8601 formatted date string. Any object other than above will be converted using its 'toString()' value.
Method name |
Return type |
Available since |
toJSON |
String |
5.2.11 |
Overview
toString
Method name |
Return type |
Available since |
toString |
String |
|
Overview
type
Method name |
Return type |
Available since |
type |
String |
|
Overview
values
Method name |
Return type |
Available since |
values |
Collection |
|
Overview