DataSet

public final class DataSet extends AbstractSafeParcelable
implements 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 = DataTypes.ACTIVITY_SEGMENT;
     DataSet dataSet = DataSet.create(dataSource);
     for (ActivitySegment segment : getActivitySegments()) {
       dataSet.add(dataSet.createDataPoint()
           .setTimeInterval(segment.getStartMillis(), segment.getEndTimeMillis(), MILLISECONDS))
           .setValues(segment.getActivity()));
     }
 

Inherited Constant Summary

Public Method Summary

void
add(DataPoint dataPoint)
Adds a data point to this data set.
void
addAll(Iterable<DataPoint> dataPoints)
Adds a list of data points to this data set in bulk.
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)

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)

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 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.

Returns
  • true if this data set has no data points, false otherwise.

public String toString ()

public void writeToParcel (Parcel parcel, int flags)