Method Detail

• fetch

  com.google.common.base.Optional<T> fetch()

  Executes the request and returns the result, or absent if the object was not found.

• fetchAsync

  com.google.common.util.concurrent.ListenableFuture<com.google.common.base.Optional<T>> fetchAsync()

  Executes the request asynchronously and returns a future providing the result, or absent if not found.

• expand

  FetchRequest<T> expand(java.lang.String... paths)

  Requests Reference fields to be expanded in the returned objects. Expanded references contain full target objects they link to.

  As an illustration, here is how reference expansion looks at the underlying JSON transport level. Given a customer object:

  {
    "name": "John Doe"
    "customerGroup": {
      "typeId": "customer-group",
      "id": "7ba61480-6a72-4a2a-a72e-cd39f75a7ef2"
    }
  }

  This is what the result looks like when the path 'customerGroup' has been expanded:

  {
    "name": "John Doe"
    "customerGroup": {
      typeId: "customer-group",
      id: "7ba61480-6a72-4a2a-a72e-cd39f75a7ef2"
      obj: {
        "name": "Gold"
      }
    }
  }

  Parameters:

  paths - The paths to be expanded, such as 'customerGroup'