com.google.cloud.bigquery

Class FieldValue

java.lang.Object

com.google.cloud.bigquery.FieldValue

All Implemented Interfaces:

Serializable

public class FieldValue
extends Object
implements Serializable

Google BigQuery Table Field Value class. Objects of this class represent values of a BigQuery Table Field. A list of values forms a table row. Tables rows can be gotten as the result of a query or when listing table data.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FieldValue.Attribute The field value's attribute, giving information on the field's content type.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
FieldValue.Attribute	getAttribute() Returns the attribute of this Field Value.
boolean	getBooleanValue() Returns this field's value as a Boolean.
byte[]	getBytesValue() Returns this field's value as a byte array.
double	getDoubleValue() Returns this field's value as a Double.
long	getLongValue() Returns this field's value as a long.
List<FieldValue>	getRecordValue() Returns this field's value as a list of FieldValue.
List<FieldValue>	getRepeatedValue() Returns this field's value as a list of FieldValue.
String	getStringValue() Returns this field's value as a String.
long	getTimestampValue() Returns this field's value as a long, representing a timestamp in microseconds since epoch (UNIX time).
Object	getValue() Returns this field's value as an Object.
int	hashCode()
boolean	isNull() Returns true if this field's value is null, false otherwise.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getAttribute

public FieldValue.Attribute getAttribute()

Returns the attribute of this Field Value.

Returns:

FieldValue.Attribute.PRIMITIVE if the field is a primitive type (Field.Type.bytes(), Field.Type.bool(), Field.Type.string(), Field.Type.floatingPoint(), Field.Type.integer(), Field.Type.timestamp()) or is null. Returns FieldValue.Attribute.REPEATED if the corresponding field has (Field.Mode.REPEATED) mode. Returns FieldValue.Attribute.RECORD if the corresponding field is a Field.Type.record(Field...) type.

isNull

public boolean isNull()

Returns true if this field's value is null, false otherwise.

getValue

public Object getValue()

Returns this field's value as an Object. If isNull() is true this method returns null.

getStringValue

public String getStringValue()

Returns this field's value as a String. This method should only be used if the corresponding field has primitive type (Field.Type.bytes(), Field.Type.bool(), Field.Type.string(), Field.Type.floatingPoint(), Field.Type.integer(), Field.Type.timestamp()).

Throws:

ClassCastException - if the field is not a primitive type

NullPointerException - if isNull() returns true

getBytesValue

public byte[] getBytesValue()

Returns this field's value as a byte array. This method should only be used if the corresponding field has primitive type (Field.Type.bytes().

Throws:

ClassCastException - if the field is not a primitive type

NullPointerException - if isNull() returns true

IllegalStateException - if the field value is not encoded in base64

getLongValue

public long getLongValue()

Returns this field's value as a long. This method should only be used if the corresponding field has Field.Type.integer() type.

Throws:

ClassCastException - if the field is not a primitive type

NumberFormatException - if the field's value could not be converted to Integer

NullPointerException - if isNull() returns true

getDoubleValue

public double getDoubleValue()

Returns this field's value as a Double. This method should only be used if the corresponding field has Field.Type.floatingPoint() type.

Throws:

ClassCastException - if the field is not a primitive type

NumberFormatException - if the field's value could not be converted to Double

NullPointerException - if isNull() returns true

getBooleanValue

public boolean getBooleanValue()

Returns this field's value as a Boolean. This method should only be used if the corresponding field has Field.Type.bool() type.

Throws:

ClassCastException - if the field is not a primitive type

IllegalStateException - if the field's value could not be converted to Boolean

NullPointerException - if isNull() returns true

getTimestampValue

public long getTimestampValue()

Returns this field's value as a long, representing a timestamp in microseconds since epoch (UNIX time). This method should only be used if the corresponding field has Field.Type.timestamp() type.

Throws:

ClassCastException - if the field is not a primitive type

NumberFormatException - if the field's value could not be converted to Long

NullPointerException - if isNull() returns true

getRepeatedValue

public List<FieldValue> getRepeatedValue()

Returns this field's value as a list of FieldValue. This method should only be used if the corresponding field has Field.Mode.REPEATED mode (i.e. getAttribute() is FieldValue.Attribute.REPEATED).

Throws:

ClassCastException - if the field has not Field.Mode.REPEATED mode

NullPointerException - if isNull() returns true

getRecordValue

public List<FieldValue> getRecordValue()

Returns this field's value as a list of FieldValue. This method should only be used if the corresponding field has Field.Type.record(Field...) type (i.e. getAttribute() is FieldValue.Attribute.RECORD).

Throws:

ClassCastException - if the field is not a Field.Type.record(Field...) type

NullPointerException - if isNull() returns true

toString

public String toString()

Overrides:

toString in class Object

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object