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

Methods

Modifier and Type	Method and Description
FieldValue.Attribute	attribute() Returns the attribute of this Field Value.
boolean	booleanValue() Returns this field's value as a Boolean.
double	doubleValue() Returns this field's value as a Double.
boolean	equals(Object obj)
int	hashCode()
boolean	isNull() Returns true if this field's value is null, false otherwise.
long	longValue() Returns this field's value as a long.
List<FieldValue>	recordValue() Returns this field's value as a list of FieldValue.
List<FieldValue>	repeatedValue() Returns this field's value as a list of FieldValue.
String	stringValue() Returns this field's value as a String.
long	timestampValue() Returns this field's value as a long, representing a timestamp in microseconds since epoch (UNIX time).
String	toString()
Object	value() Returns this field's value as an Object.

Methods inherited from class java.lang.Object

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

Method Detail

attribute

public FieldValue.Attribute attribute()

Returns the attribute of this Field Value.

Returns:

FieldValue.Attribute.PRIMITIVE if the field is a primitive type (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.

value

public Object value()

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

stringValue

public String stringValue()

Returns this field's value as a String. This method should only be used if the corresponding field has primitive type (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

longValue

public long longValue()

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

doubleValue

public double doubleValue()

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

booleanValue

public boolean booleanValue()

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

timestampValue

public long timestampValue()

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

repeatedValue

public List<FieldValue> repeatedValue()

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. attribute() is FieldValue.Attribute.REPEATED).

Throws:

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

NullPointerException - if isNull() returns true

recordValue

public List<FieldValue> recordValue()

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. attribute() 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