Package oracle.kv.table
Class FieldValueFactory
java.lang.Object
oracle.kv.table.FieldValueFactory
Factory class to create FieldValue instance objects.
- Since:
- 4.0
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic BinaryValue
createBinary
(byte[] v) Creates a BinaryValue instance from its java representation.static BooleanValue
createBoolean
(boolean v) Creates a BooleanValue instance from its java representation.static DoubleValue
createDouble
(double v) Creates a DoubleValue instance from its java representation.static FloatValue
createFloat
(float v) Creates a FloatValue instance from its java representation.static IntegerValue
createInteger
(int v) Creates a IntegerValue instance from its java representation.static FieldValue
Creates a special FieldValue instance representing a JSON null value, which returns true fromFieldValue.isJsonNull()
.static LongValue
createLong
(long v) Creates a LongValue instance from its java representation.static NumberValue
createNumber
(double v) Creates a NumberValue instance from a double value.static NumberValue
createNumber
(float v) Creates a NumberValue instance from a float value.static NumberValue
createNumber
(int v) Creates a NumberValue instance from a int value.static NumberValue
createNumber
(long v) Creates a NumberValue instance from a long value.static NumberValue
Creates a NumberValue instance from a BigDecimal value.static StringValue
Creates a StringValue instance from its java representation.static TimestampValue
createTimestamp
(int year, int month, int day, int hour, int minute, int second, int fracSeconds, int precision) Creates a TimestampValue instance from date time components.static TimestampValue
createTimestamp
(String s, int precision) Creates a TimestampValue instance from a string in format ofTimestampDef.DEFAULT_PATTERN
.static TimestampValue
createTimestamp
(Timestamp v, int precision) Creates a TimestampValue instance from its java representation.static FieldValue
createValueFromJson
(Reader jsonReader) Creates a FieldValue instance from JSON input where the type is not known.static FieldValue
createValueFromJson
(String jsonString) Creates a FieldValue instance from JSON input where the type is not known.static FieldValue
createValueFromJson
(FieldDef type, InputStream jsonStream) Creates a new value from a JSON doc (which is given as an InputStream).static FieldValue
createValueFromJson
(FieldDef type, Reader jsonReader) Creates a new value from a JSON doc (which is given as a Reader).static FieldValue
createValueFromJson
(FieldDef type, String jsonString) Creates a new value from a JSON doc (which is given as a String).
-
Constructor Details
-
FieldValueFactory
public FieldValueFactory()
-
-
Method Details
-
createValueFromJson
Creates a FieldValue instance from JSON input where the type is not known. This method maps the JSON into a map (object) or array where the element type is JSON or one of the scalar types supporting JSON: INTEGER, LONG, FLOAT, DOUBLE, STRING, and BOOLEAN.- Parameters:
jsonString
- the JSON representation- Returns:
- a FieldValue
- Throws:
IllegalArgumentException
- if the input is not valid JSON or the input cannot be parsed, or it cannot be mapped into supported data types.- Since:
- 4.2
-
createValueFromJson
Creates a FieldValue instance from JSON input where the type is not known. This method maps the JSON into a map (object) or array where the element type is JSON or one of the scalar types supporting JSON: INTEGER, LONG, FLOAT, DOUBLE, STRING, and BOOLEAN.- Parameters:
jsonReader
- a Reader over JSON- Returns:
- a FieldValue
- Throws:
IllegalArgumentException
- if the input is not valid JSON or the input cannot be parsed, or it cannot be mapped into supported data types.IOException
- if the input is not valid JSON or the input cannot be parse, or it cannot be mapped into supported data types.- Since:
- 4.2
-
createValueFromJson
Creates a new value from a JSON doc (which is given as a String).
If type is RecordDef then:
(a) the JSON doc may have fields that do not appear in the record schema. Such fields are simply skipped.
(b) the JSON doc may be missing fields that appear in the record's schema. Such fields will remain unset in the record value. This meansRecordValue.get(String)
will return null andFieldValue.toJsonString(boolean)
will skip unset fields.
If type is BINARY then the value must be a base64 encoded value.
Note: This methods doesn't handle arbitrary JSON, it has to comply to the given type. Also, top level null is not supported.
- Parameters:
type
- the type definition of the instance.jsonString
- the JSON representation- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- for invalid documents
-
createValueFromJson
Creates a new value from a JSON doc (which is given as a Reader). If type is RecordDef then: (a) the JSON doc may have fields that do not appear in the record schema. Such fields are simply skipped. (b) the JSON doc may be missing fields that appear in the record's schema. Such fields will remain unset in the record value. If type is BINARY then the value must be a base64 encoded value. Note: This methods doesn't handle arbitrary JSON, it has to comply to the given type. Also, top level null is not supported.- Parameters:
type
- the type definition of the instance.jsonReader
- the JSON representation- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- for invalid documentsIOException
- for an invalid Reader
-
createValueFromJson
public static FieldValue createValueFromJson(FieldDef type, InputStream jsonStream) throws IOException Creates a new value from a JSON doc (which is given as an InputStream). If type is RecordDef then: (a) the JSON doc may have fields that do not appear in the record schema. Such fields are simply skipped. (b) the JSON doc may be missing fields that appear in the record's schema. Such fields will remain unset in the record value. If type is BINARY then the value must be a base64 encoded value. Note: This methods doesn't handle arbitrary JSON, it has to comply to the given type. Also, top level null is not supported.- Parameters:
type
- the type definition of the instance.jsonStream
- the JSON representation- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- for invalid documentsIOException
- for an invalid InputStream
-
createBinary
Creates a BinaryValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createBoolean
Creates a BooleanValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createDouble
Creates a DoubleValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createFloat
Creates a FloatValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createInteger
Creates a IntegerValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createLong
Creates a LongValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createNumber
Creates a NumberValue instance from a int value.- Parameters:
v
- the java value- Returns:
- the newly created instance
- Since:
- 4.4
-
createNumber
Creates a NumberValue instance from a long value.- Parameters:
v
- the java value- Returns:
- the newly created instance
- Since:
- 4.4
-
createNumber
Creates a NumberValue instance from a float value.- Parameters:
v
- the java value- Returns:
- the newly created instance
- Since:
- 4.4
-
createNumber
Creates a NumberValue instance from a double value.- Parameters:
v
- the java value- Returns:
- the newly created instance
- Since:
- 4.4
-
createNumber
Creates a NumberValue instance from a BigDecimal value.- Parameters:
v
- the java value- Returns:
- the newly created instance
- Since:
- 4.4
-
createJsonNull
Creates a special FieldValue instance representing a JSON null value, which returns true fromFieldValue.isJsonNull()
.- Returns:
- the newly created instance
- Since:
- 4.3
-
createString
Creates a StringValue instance from its java representation.- Parameters:
v
- the java value- Returns:
- the newly created instance
-
createTimestamp
Creates a TimestampValue instance from its java representation.- Parameters:
v
- the java valueprecision
- the precision of Timestamp value- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- if precision is invalid.
-
createTimestamp
Creates a TimestampValue instance from a string in format ofTimestampDef.DEFAULT_PATTERN
.- Parameters:
s
- the string valueprecision
- the precision of Timestamp value- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- if precision is invalid or the string is not in the format ofTimestampDef.DEFAULT_PATTERN
.
-
createTimestamp
public static TimestampValue createTimestamp(int year, int month, int day, int hour, int minute, int second, int fracSeconds, int precision) Creates a TimestampValue instance from date time components.- Parameters:
year
- the year, from -6383 to 9999.month
- the month of year, from 1 to 12day
- the day of month, from 1 to 31hour
- the hour of day, from 0 to 23minute
- the minute of hour, from 0 to 59second
- the second of minute, from 0 to 59fracSeconds
- the number of fractional seconds in the specified precision. e.g. if precision is 3, then fractional seconds can be a value within the range 0 ~ 999.precision
- the precision of Timestamp value- Returns:
- the newly created instance
- Throws:
IllegalArgumentException
- if precision is invalid or any component is invalid.
-