Package de.uplanet.lucy.server.ixvalue
Interface IIxValue
-
public interface IIxValue
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description BigDecimalasBigDecimal()Returns a big decimal value.BigDecimalasBigDecimal(BigDecimal p_fallbackValue)Returns a big decimal value or the fallback value on an empty value.booleanasBoolean()Returns the a boolean value.booleanasBoolean(boolean p_bFallbackValue)Returns the boolean value or the fallback value on an empty value.DateasDate()Returns the date value.DateasDate(Date p_fallbackValue)Returns the date value or the fallback date for an empty value.doubleasDouble()Returns a double value.doubleasDouble(double p_dFallbackValue)Returns the value as an double or the fallback value on an empty value.intasInt()Returns a integer value.intasInt(int p_iFallbackValue)Returns a integer value or the fallback value on an empty value.longasLong()Returns a long value.longasLong(long p_lFallbackValue)Returns a long value or the fallback value on an empty value.StringasString()Returns the value as an stringStringasString(String p_strFallbackValue)Returns the value as an stringDateasTime()Returns the time value.DateasTime(Date p_fallback)Returns the time value or the fallback value on an empty value.TimestampasTimestamp()Returns a timestamp value.TimestampasTimestamp(Timestamp p_fallbackValue)Returns the timestamp value or the given fallback value for an empty value.de.uplanet.lucy.server.dataobjects.IValueHolder<?>asValueHolder()Returns the value as an value holder.de.uplanet.lucy.types.UP_TYPEgetType()Returns the type.ObjectgetValue()Returns the physical value.booleanhasValue()Returnstrueif the value is not empty or exits.booleanisPrimitive()Returnstrueon a primitive value type like integer or boolean.
-
-
-
Field Detail
-
EMPTY
static final IIxValue EMPTY
-
-
Method Detail
-
getType
de.uplanet.lucy.types.UP_TYPE getType()
Returns the type. For internal use only.- Returns:
- Returns the value type (not
null).
-
getValue
Object getValue()
Returns the physical value. Mostly an string value. For normal use cases, please use the methods, to get value.- Returns:
- Returns the value (could be
null).
-
asValueHolder
de.uplanet.lucy.server.dataobjects.IValueHolder<?> asValueHolder()
Returns the value as an value holder.- Returns:
- Converts a IIxValue to an value holder.
-
asBoolean
boolean asBoolean()
Returns the a boolean value.Cast Rules: String "0" = false "1" = true "true" = true "false" = false all other valuesfalseNumeric (int, long, double): 0 = false 1 = true other valuestrue(value != 0)- Returns:
- Returns the value as an boolean.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an boolean.
-
asBoolean
boolean asBoolean(boolean p_bFallbackValue)
Returns the boolean value or the fallback value on an empty value.Cast Rules: String "0" = false "1" = true "true" = true "false" = false all other valuesfalseNumeric (int, long, double): 0 = false 1 = true all other valuestrue(value != 0)- Parameters:
p_bFallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an boolean or the given fallback value if
hasValue()==false. - Throws:
IllegalArgumentException- Throws a runtime exception if the value cannot be casted to a boolean.
-
asDouble
double asDouble()
Returns a double value.Cast Rules: String Double.parseDouble(value) Numeric Types (double)value- Returns:
- Returns the value as an double.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an double.
-
asDouble
double asDouble(double p_dFallbackValue)
Returns the value as an double or the fallback value on an empty value.Cast Rules: String Double.parseDouble(value) Numeric: (double)value- Parameters:
p_dFallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an double or the fallback value if
hasValue()==false. - Throws:
IllegalArgumentException- Throws a runtime exception if the value cannot be casted to a double.
-
asInt
int asInt()
Returns a integer value.Cast Rules: String Integer.parseInteger(value) Numeric Types (int)value- Returns:
- Returns the value as an integer.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an integer.
-
asInt
int asInt(int p_iFallbackValue)
Returns a integer value or the fallback value on an empty value.Cast Rules: String Integer.parseInteger(value) Numeric Types (int)value Other types: String.valueOf(type) will check.- Parameters:
p_iFallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an integer or p_iFallbackValue if
hasValue()==false - Throws:
IllegalArgumentException- Throws a runtime exception if the value cannot be casted to a integer.
-
asLong
long asLong()
Returns a long value.Cast Rules: String Long.parseLong(value) Numeric Types (long)value- Returns:
- Returns the value as an long.
Throws an exception if
hasValue()==falseor the value type cannot be casted to an long.
-
asLong
long asLong(long p_lFallbackValue)
Returns a long value or the fallback value on an empty value.Cast Rules: String Long.parseLong(value) Numeric Types (long)value Other types: String.valueOf(type) will check.- Parameters:
p_lFallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an long or p_lFallbackValue if
hasValue()==false. - Throws:
IllegalArgumentException- Throws a runtime exception if the value cannot be casted to a long.
-
asTimestamp
Timestamp asTimestamp()
Returns a timestamp value.Value must be a date / timestamp type. No cast will be done.- Returns:
- Returns the value as an timestamp.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an timestamp.
-
asTimestamp
Timestamp asTimestamp(Timestamp p_fallbackValue)
Returns the timestamp value or the given fallback value for an empty value.Value must be a date / timestamp type. No cast will be done.- Parameters:
p_fallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an timestamp.
- Throws:
IllegalArgumentException- Throws a runtime exception if the value is not a date or timestamp value.
-
asDate
Date asDate()
Returns the date value.Value must be a date / time stamp / string type.- Returns:
- Returns the value as an date.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an date.
-
asDate
Date asDate(Date p_fallbackValue)
Returns the date value or the fallback date for an empty value.Value must be a date / time stamp / string type.- Parameters:
p_fallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an date.
- Throws:
IllegalArgumentException- Throws a runtime exception if the value is not a date or timestamp value.
-
asTime
Date asTime()
Returns the time value.Value must be a time / time stamp / string type.- Returns:
- Returns the value as an time.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an time.
-
asTime
Date asTime(Date p_fallback)
Returns the time value or the fallback value on an empty value.Value must be a time / time stamp / string type.- Returns:
- Returns the value as an time or the fallback value on an empty value.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()!=falseand the value type cannot be casted to an time.
-
asBigDecimal
BigDecimal asBigDecimal()
Returns a big decimal value.Cast Rules: String new BigDecimal(value) Numeric Types new BigDecimalvalue)- Returns:
- Returns the value as an big decimal or null if
hasValue()==false. - Throws:
IllegalArgumentException- Throws an exception ifhasValue()==falseor the value type cannot be casted to an big decimal.
-
asBigDecimal
BigDecimal asBigDecimal(BigDecimal p_fallbackValue)
Returns a big decimal value or the fallback value on an empty value.Cast Rules: String new BigDecimal(value) Numeric Types new BigDecimalvalue)- Parameters:
p_fallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an string or p_fallbackValue if
hasValue()==false. - Throws:
IllegalArgumentException- Throws a runtime exception if the value cannot be casted to a big decimal.
-
asString
String asString()
Returns the value as an stringCast Rules: Date values: A string representation of the date in theyyyy-MM-dd HH:mm:ssformat, calculated for the TimeZone UTC. Other Types: String.valueOf(type) will returned.- Returns:
- Returns the value as an string.
- Throws:
IllegalArgumentException- Throws an exception ifhasValue()==false.
-
asString
String asString(String p_strFallbackValue)
Returns the value as an stringCast Rules: Date values: A string representation of the date in theyyyy-MM-dd HH:mm:ssformat, calculated for the TimeZone UTC. Other Types: String.valueOf(type) will returned.- Parameters:
p_strFallbackValue- The fallback value used ifhasValue()==false.- Returns:
- Returns the value as an string or p_strFallbackValue if
hasValue()==false.
-
hasValue
boolean hasValue()
Returnstrueif the value is not empty or exits.- Returns:
- Returns
trueifgetValue()!= null otherwisefalsewill returned.
-
isPrimitive
boolean isPrimitive()
Returnstrueon a primitive value type like integer or boolean.- Returns:
- Returns
trueif the value represent an primitive type like a boolean, integer...
-
-