com.gooddata.warehouse

Class WarehouseService

java.lang.Object

com.gooddata.AbstractService

com.gooddata.warehouse.WarehouseService

public class WarehouseService
extends AbstractService

Provide access to warehouse API - create, update, list and delete warehouses.

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
WarehouseService(org.springframework.web.client.RestTemplate restTemplate, String warehouseHost, int warehousePort) Sets RESTful HTTP Spring template.

Method Summary

Modifier and Type	Method and Description
FutureResult<WarehouseUser>	addUserToWarehouse(Warehouse warehouse, WarehouseUser user) Add given user to given warehouse.
FutureResult<Warehouse>	createWarehouse(Warehouse warehouse) Create new warehouse.
Warehouse	getWarehouseById(String id) Get Warehouse identified by given id.
Warehouse	getWarehouseByUri(String uri) Get Warehouse identified by given uri.
PageableList<Warehouse>	listWarehouses() Lists Warehouses.
PageableList<Warehouse>	listWarehouses(Page page) Lists Warehouses.
PageableList<WarehouseUser>	listWarehouseUsers(Warehouse warehouse, Page page)
void	removeWarehouse(Warehouse warehouse) Delete Warehouse.
Warehouse	updateWarehouse(Warehouse toUpdate) Updates given Warehouse.

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

WarehouseService

public WarehouseService(org.springframework.web.client.RestTemplate restTemplate,
                        String warehouseHost,
                        int warehousePort)

Sets RESTful HTTP Spring template. Should be called from constructor of concrete service extending this abstract one.

Parameters:

restTemplate - RESTful HTTP Spring template

warehouseHost - host to connect warehouses

warehousePort - port to connect warehouses

Method Detail

createWarehouse

public FutureResult<Warehouse> createWarehouse(Warehouse warehouse)

Create new warehouse.

Parameters:

warehouse - warehouse to create

Returns:

created warehouse

removeWarehouse

public void removeWarehouse(Warehouse warehouse)

Delete Warehouse.

Parameters:

warehouse - to delete

getWarehouseByUri

public Warehouse getWarehouseByUri(String uri)

Get Warehouse identified by given uri.

Parameters:

uri - warehouse uri

Returns:

Warehouse

Throws:

GoodDataException - when Warehouse can't be accessed

getWarehouseById

public Warehouse getWarehouseById(String id)

Get Warehouse identified by given id.

Parameters:

id - warehouse id

Returns:

Warehouse

Throws:

GoodDataException - when Warehouse can't be accessed

listWarehouses

public PageableList<Warehouse> listWarehouses()

Lists Warehouses. Returns empty list in case there are no warehouses. Returns only first page if there's more instances than page limit. Use listWarehouses(Page) to get other pages.

Returns:

first page of list of warehouse instances or empty list

listWarehouses

public PageableList<Warehouse> listWarehouses(Page page)

Lists Warehouses. Returns empty list in case there are no warehouses. Returns requested page (by page limit and offset). Use listWarehouses() to get first page with default setting.

Parameters:

page - page to be listed

Returns:

requested page of list of instances or empty list

listWarehouseUsers

public PageableList<WarehouseUser> listWarehouseUsers(Warehouse warehouse,
                                                      Page page)

addUserToWarehouse

public FutureResult<WarehouseUser> addUserToWarehouse(Warehouse warehouse,
                                                      WarehouseUser user)

Add given user to given warehouse.

Parameters:

warehouse - warehouse the user should be added to

user - user to be added

Returns:

added user in warehouse

updateWarehouse

public Warehouse updateWarehouse(Warehouse toUpdate)

Updates given Warehouse.

Parameters:

toUpdate - warehouse to be updated

Returns:

updated warehouse

Throws:

GoodDataException - when update fails