Interface ICustomTimestampField
-
- All Superinterfaces:
ICustomField<Date>
public interface ICustomTimestampField extends ICustomField<Date>
- See Also:
ICustomField
- API:
- This is a public API.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description boolean
compareAndSet(Date expectedValue, Date newValue)
Sets the givennewValue
if the current value of the field is equal to theexpectedValue
otherwise the value is not set.Date
getOrDefault(Date defaultValue)
Gets the value of the custom field or the provideddefaultValue
if no value has been set.Date
getOrNull()
Gets the value of the custom field or null/default.void
set(Date value)
Sets the value of the field.
-
-
-
Method Detail
-
getOrNull
Date getOrNull()
Gets the value of the custom field or null/default.Examples:
String branchOffice = ivy.task.customFields().stringField("branchOffice").getOrNull();
- Specified by:
getOrNull
in interfaceICustomField<Date>
- Returns:
- value or null
- See Also:
ICustomField.getOrDefault(Object)
,ICustomField.get()
- API:
- This public API is available in IvyScript and Java. It has the visibility NOVICE.
-
getOrDefault
Date getOrDefault(Date defaultValue)
Gets the value of the custom field or the provideddefaultValue
if no value has been set.Examples:
String branchOffice = ivy.task.customFields().stringField("branchOffice").getOrDefault("Luzern");
- Specified by:
getOrDefault
in interfaceICustomField<Date>
- Parameters:
defaultValue
- the value that is returned if no value has been set on the field- Returns:
- value or defaultValue if not value has been set
- See Also:
ICustomField.getOrNull()
,ICustomField.get()
- API:
- This public API is available in IvyScript and Java. It has the visibility NOVICE.
-
set
void set(Date value)
Sets the value of the field.
Set of
null
has the same effect asICustomField.delete()
.Examples:
ivy.task.customFields().stringField("branchOffice").set("Zug");
- Specified by:
set
in interfaceICustomField<Date>
- Parameters:
value
- new value of the field- See Also:
ICustomField.compareAndSet(Object, Object)
,ICustomField.delete()
- API:
- This public API is available in IvyScript and Java. It has the visibility NOVICE.
-
compareAndSet
boolean compareAndSet(Date expectedValue, Date newValue)
Sets the given
newValue
if the current value of the field is equal to theexpectedValue
otherwise the value is not set.This is an atomic operation. During the read of the current value and the set of the new value parallel transactions are blocked and cannot change the value in the meantime.
Setting of a
null
has the same effect asICustomField.delete()
. Expecting anull
value means that thenewValue
is only set if currently no value is set.Examples:
boolean successful = ivy.task.customFields().stringField("salesState").compareAndSet("FirstContact", "OfferSent");
- Specified by:
compareAndSet
in interfaceICustomField<Date>
- Parameters:
expectedValue
- the expected valuenewValue
- the new value- Returns:
- true if the new value was set otherwise false
- API:
- This public API is available in IvyScript and Java. It has the visibility NOVICE.
-
-