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 | |
| void |
addAll(Iterable<DataPoint>
dataPoints)
This method is deprecated. Build
DataSet
instances using
the builder.
|
| static DataSet.Builder | |
| static DataSet | |
| DataPoint |
createDataPoint()
Creates an empty data point for this data set's data source.
|
| boolean | |
| 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 |
hashCode()
|
| boolean |
isEmpty()
Returns whether this data set contains no data points.
|
| String |
toString()
|
| 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.