Package com.gooddata.sdk.service.warehouse

Class WarehouseService

java.lang.Object
com.gooddata.sdk.service.AbstractService
com.gooddata.sdk.service.warehouse.WarehouseService
public class WarehouseService extends AbstractService
Provide access to warehouse API - create, update, list and delete warehouses.

  • Field Details

    • SCHEMAS_TEMPLATE

      public static final org.springframework.web.util.UriTemplate SCHEMAS_TEMPLATE

    • SCHEMA_TEMPLATE

      public static final org.springframework.web.util.UriTemplate SCHEMA_TEMPLATE

    • WAREHOUSE_TEMPLATE

      public static final org.springframework.web.util.UriTemplate WAREHOUSE_TEMPLATE

    • USERS_TEMPLATE

      public static final org.springframework.web.util.UriTemplate USERS_TEMPLATE

  • Constructor Details

    • WarehouseService

      public WarehouseService(org.springframework.web.client.RestTemplate restTemplate, GoodDataSettings settings)
      Sets RESTful HTTP Spring template. Should be called from constructor of concrete service extending this abstract one.
      Parameters:
      restTemplate - RESTful HTTP Spring template
      settings - settings

  • Method Details

    • 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:
      com.gooddata.sdk.common.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:
      com.gooddata.sdk.common.GoodDataException - when Warehouse can't be accessed

    • listWarehouses

      public com.gooddata.sdk.common.collections.PageBrowser<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 PageBrowser.allItemsStream() ()} to iterate over all pages, or PageBrowser.getAllItems() ()} to load the entire list.
      Returns:
      PageBrowser first page of list of warehouse instances or empty list

    • listWarehouses

      public com.gooddata.sdk.common.collections.PageBrowser<Warehouse> listWarehouses(com.gooddata.sdk.common.collections.PageRequest startPage)
      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:
      startPage - page to be listed
      Returns:
      PageBrowser requested page of list of instances or empty list

    • listWarehouseUsers

      public com.gooddata.sdk.common.collections.PageBrowser<WarehouseUser> listWarehouseUsers(Warehouse warehouse)
      Lists warehouse users. Returns empty list in case there are no users. Use PageBrowser.allItemsStream() ()} to iterate over all pages, or PageBrowser.getAllItems() ()} to load the entire list.
      Parameters:
      warehouse - warehouse
      Returns:
      PageBrowser requested page of list of instances or empty list

    • listWarehouseUsers

      public com.gooddata.sdk.common.collections.PageBrowser<WarehouseUser> listWarehouseUsers(Warehouse warehouse, com.gooddata.sdk.common.collections.PageRequest startPage)
      Lists warehouse users, starting with specified page. Returns empty list in case there are no users. Use PageBrowser.allItemsStream() ()} to iterate over all pages, or PageBrowser.getAllItems() ()} to load the entire list.
      Parameters:
      warehouse - warehouse
      startPage - page to start with
      Returns:
      PageBrowser requested page of list of instances starting with startPage or empty list

    • 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

    • removeUserFromWarehouse

      public FutureResult<Void> removeUserFromWarehouse(WarehouseUser user)
      Remove given user from warehouse instance
      Parameters:
      user - to remove from warehouse
      Returns:
      empty future result
      Throws:
      WarehouseUserNotFoundException - when user for removal can't be found
      com.gooddata.sdk.common.GoodDataException - any other reason

    • updateWarehouse

      public Warehouse updateWarehouse(Warehouse toUpdate)
      Updates given Warehouse.
      Parameters:
      toUpdate - warehouse to be updated
      Returns:
      updated warehouse
      Throws:
      com.gooddata.sdk.common.GoodDataException - when update fails

    • listWarehouseSchemas

      public com.gooddata.sdk.common.collections.PageBrowser<WarehouseSchema> listWarehouseSchemas(Warehouse warehouse)
      list schemas for Warehouse
      Parameters:
      warehouse - to list schemas for
      Returns:
      PageBrowser pageable list of warehouse schemas

    • listWarehouseSchemas

      public com.gooddata.sdk.common.collections.PageBrowser<WarehouseSchema> listWarehouseSchemas(Warehouse warehouse, com.gooddata.sdk.common.collections.PageRequest startPage)
      list schemas for Warehouse
      Parameters:
      warehouse - to list schemas for
      startPage - page to be listed
      Returns:
      PageBrowser pageable list of warehouse schemas

    • getWarehouseSchemaByName

      public WarehouseSchema getWarehouseSchemaByName(Warehouse warehouse, String name)
      get warehouse schema by name
      Parameters:
      warehouse - to get schema for
      name - of schema
      Returns:
      warehouse schema

    • getWarehouseSchemaByUri

      public WarehouseSchema getWarehouseSchemaByUri(String uri)
      get warehouse schema by uri
      Parameters:
      uri - of schema
      Returns:
      warehouse schema

    • getDefaultWarehouseSchema

      public WarehouseSchema getDefaultWarehouseSchema(Warehouse warehouse)
      get default warehouse schema
      Parameters:
      warehouse - to get default schema for
      Returns:
      default warehouse schema