com.gooddata.dataset

Class DatasetService

java.lang.Object

com.gooddata.AbstractService

com.gooddata.dataset.DatasetService

public class DatasetService
extends AbstractService

Service to work with datasets and manifests.

Nested Class Summary

Nested classes/interfaces inherited from class com.gooddata.AbstractService

AbstractService.OutputStreamResponseExtractor

Field Summary

Fields inherited from class com.gooddata.AbstractService

mapper, noopRequestCallback, restTemplate, WAIT_BEFORE_RETRY_IN_MILLIS

Constructor Summary

Constructors

Constructor and Description
DatasetService(org.springframework.web.client.RestTemplate restTemplate, DataStoreService dataStoreService)

Method Summary

Methods

Modifier and Type	Method and Description
DatasetManifest	getDatasetManifest(Project project, String datasetId) Obtains manifest from given project by given datasetId
Collection<Dataset>	listDatasets(Project project) Lists datasets in project.
FutureResult<Void>	loadDataset(Project project, DatasetManifest manifest, InputStream dataset) Loads dataset into platform.
FutureResult<Void>	loadDataset(Project project, String datasetId, InputStream dataset) Gets DatasetManifest (using getDatasetManifest(com.gooddata.project.Project, String) first and then calls loadDataset(com.gooddata.project.Project, DatasetManifest, java.io.InputStream)

Methods inherited from class com.gooddata.AbstractService

extractData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DatasetService

public DatasetService(org.springframework.web.client.RestTemplate restTemplate,
              DataStoreService dataStoreService)

Method Detail

getDatasetManifest

public DatasetManifest getDatasetManifest(Project project,
                                 String datasetId)

Obtains manifest from given project by given datasetId

Parameters:

project - project to which manifest belongs

datasetId - id of dataset

Returns:

manifest for dataset

Throws:

DatasetNotFoundException - when manifest can't be found (doesn't exist)

DatasetException - in case the API call failure

loadDataset

public FutureResult<Void> loadDataset(Project project,
                             DatasetManifest manifest,
                             InputStream dataset)

Loads dataset into platform. Uploads given dataset and manifest to staging area and triggers ETL pull. The call is asynchronous returning FutureResult to let caller wait for results. Uploaded files are deleted from staging area when finished.

Parameters:

project - project to which dataset belongs

manifest - dataset manifest

dataset - dataset to upload

Returns:

FutureResult of the task, which can throw DatasetException in case the ETL pull task fails

Throws:

DatasetException - if there is a problem to serialize manifest or upload dataset

loadDataset

public FutureResult<Void> loadDataset(Project project,
                             String datasetId,
                             InputStream dataset)

Gets DatasetManifest (using getDatasetManifest(com.gooddata.project.Project, String) first and then calls loadDataset(com.gooddata.project.Project, DatasetManifest, java.io.InputStream)

Parameters:

project - project to which dataset belongs

datasetId - datasetId to obtain a manifest

dataset - dataset to upload

Returns:

FutureResult of the task

listDatasets

public Collection<Dataset> listDatasets(Project project)

Lists datasets in project. Returns empty list in case there are no datasets.

Parameters:

project - project to list datasets in

Returns:

collection of datasets in project or empty list