Interface GetItemApi

All Known Implementing Classes:
Table

public interface GetItemApi
A Table-centric GetItem API.

In general, all getter methods in this library incur no network. GetItemApi is the only exception due to the fact that the web service API is indistinguishable from a Java getter method.

  • Method Details

    • getItemOutcome

      GetItemOutcome getItemOutcome(PrimaryKey primaryKey)
      Retrieves an item and the associated information by primary key. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(KeyAttribute... primaryKeyComponents)
      Retrieves an item and the associated information by primary key when the primary key is a hash-only key. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(String hashKeyName, Object hashKeyValue)
      Retrieves an item and the associated information by primary key when the primary key is a hash-only key. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(String hashKeyName, Object hashKeyValue, String rangeKeyName, Object rangeKeyValue)
      Retrieves an item and the associated information by primary key when the primary key consists of both a hash-key and a range-key. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(PrimaryKey primaryKey, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item and the associated information using projection expression. Incurs network access.
      Parameters:
      projectionExpression - projection expression, example: "a.b , c[0].e"
      nameMap - actual values for the attribute-name place holders; can be null if there is no attribute-name placeholder.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(String hashKeyName, Object hashKeyValue, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item and the associated information via the specified hash key using projection expression. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItemOutcome

      GetItemOutcome getItemOutcome(String hashKeyName, Object hashKeyValue, String rangeKeyName, Object rangeKeyValue, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item and the associated information via the specified hash key and range key using projection expression. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItem

      Item getItem(String hashKeyName, Object hashKeyValue, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item via the specified hash key using projection expression. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(String hashKeyName, Object hashKeyValue, String rangeKeyName, Object rangeKeyValue, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item via the specified hash key and range key using projection expression. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItemOutcome

      GetItemOutcome getItemOutcome(GetItemSpec spec)
      Retrieves an item and the associated information by specifying all the details. Incurs network access.
      Returns:
      the (non-null) result of item retrieval.
    • getItem

      Item getItem(PrimaryKey primaryKey)
      Retrieves an item by primary key; or null if the item doesn't exist. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(KeyAttribute... primaryKeyComponents)
      Retrieves an item by primary key. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(String hashKeyName, Object hashKey)
      Retrieves an item by primary key when the primary key is a hash-only key. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(String hashKeyName, Object hashKeyValue, String rangeKeyName, Object rangeKeyValue)
      Retrieves an item by primary key when the primary key consists of both a hash-key and a range-key. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(PrimaryKey primaryKey, String projectionExpression, Map<String,String> nameMap)
      Retrieves an item using projection expression. Incurs network access.
      Parameters:
      projectionExpression - projection expression, example: "a.b , c[0].e"
      nameMap - actual values for the attribute-name place holders; can be null if there is no attribute-name placeholder.
      Returns:
      the retrieved item; or null if the item doesn't exist.
    • getItem

      Item getItem(GetItemSpec spec)
      Retrieves an item by specifying all the details. Incurs network access.
      Returns:
      the retrieved item; or null if the item doesn't exist.