DataSet

public final class DataSet extends Object
implements Parcelable Parcelable

Represents a fixed set of data points in a data type's stream from a particular data source. A data set usually represents data at fixed time boundaries, and can be used both for batch data insertion and as a result of read requests.

Here's a sample usage for populating a data source with activity data:

     DataType dataType = DataType.TYPE_ACTIVITY_SEGMENT;
     DataSet.Builder dataSetBuilder = DataSet.builder(dataSource);
     for (ActivitySegment segment : getActivitySegments()) {
       dataSetBuilder.add(DataPoint.builder(dataSource)
           .setTimeInterval(segment.getStartMillis(), segment.getEndTimeMillis(), MILLISECONDS))
           .setValues(segment.getActivity())
           .build());
     }
     DataSet dataSet = dataSetBuilder.build();
 

Nested Class Summary

class DataSet.Builder Builder used to create new data sets

Inherited Constant Summary

Public Method Summary

void
add(DataPoint dataPoint)
This method is deprecated. Build DataSet instances using the builder.
void
addAll(Iterable<DataPoint> dataPoints)
This method is deprecated. Build DataSet instances using the builder.
static DataSet.Builder
builder(DataSource dataSource)
Creates a new builder for a DataSet with the given dataSource.
static DataSet
create(DataSource dataSource)
Creates a new data set to hold data points for the given dataSource.
DataPoint
createDataPoint()
Creates an empty data point for this data set's data source.
boolean
equals(Object other)
List<DataPoint>
getDataPoints()
Returns the list of data points represented by this data set.
DataSource
getDataSource()
Returns the data source which this data set represents.
DataType
getDataType()
Returns the data type this data set represents.
int
boolean
isEmpty()
Returns whether this data set contains no data points.
String
void
writeToParcel(Parcel parcel, int flags)

Inherited Method Summary

Public Methods

public void add (DataPoint dataPoint)

This method is deprecated.
Build DataSet instances using the builder.

Adds a data point to this data set. The data points should be for the correct data type and data source, and should have its timestamp already set.

Throws
IllegalArgumentException If dataPoint has invalid data.

public void addAll (Iterable<DataPoint> dataPoints)

This method is deprecated.
Build DataSet instances using the builder.

Adds a list of data points to this data set in bulk. All data points should be for the correct data type and data source, and should have their timestamp already set.

public static DataSet.Builder builder (DataSource dataSource)

Creates a new builder for a DataSet with the given dataSource.

Throws
NullPointerException If specified data source is null.

public static DataSet create (DataSource dataSource)

Creates a new data set to hold data points for the given dataSource.

Data points with the matching data source can be created using createDataPoint(), and after having the values set added to the data set via add(DataPoint).

Throws
NullPointerException If specified data source is null.

public DataPoint createDataPoint ()

Creates an empty data point for this data set's data source. The new data point is not added to the data set by this method. After the data point is initialized, add(DataPoint) should be called.

public boolean equals (Object other)

public List<DataPoint> getDataPoints ()

Returns the list of data points represented by this data set. The data points will preserve the same order in which they were inserted.

Certain APIs that return a DataSet might insert data points in chronological order, but this isn't enforced.

public DataSource getDataSource ()

Returns the data source which this data set represents. All of the data points in the data set are from this data source.

public DataType getDataType ()

Returns the data type this data set represents. All of the data points in the data set are of this data type.

public int hashCode ()

public boolean isEmpty ()

Returns whether this data set contains no data points.

public String toString ()

public void writeToParcel (Parcel parcel, int flags)