Method singletonBatchRequest

sdk/java/src/main/java/com/chain/http/Client.java:209–236

Perform a single HTTP POST request against the API for a specific action. Use this method if you want single-item semantics (creating single assets, building single transactions) but the API endpoint is implemented as a batch call. Because request bodies for batch calls do not share a consistent fo

(
      String action, Object body, final Type tClass, final Type eClass)

   * @throws ChainException
   */
  public <T> T singletonBatchRequest(
      String action, Object body, final Type tClass, final Type eClass) throws ChainException {
    ResponseCreator<T> rc =
        new ResponseCreator<T>() {
          public T create(Response response, Gson deserializer) throws ChainException, IOException {
            BatchResponse<T> batch = new BatchResponse<>(response, deserializer, tClass, eClass);

            List<APIException> errors = batch.errors();
            if (errors.size() == 1) {
              // This throw must occur within this lambda in order for APIClient's
              // retry logic to take effect.
              throw errors.get(0);
            }

            List<T> successes = batch.successes();
            if (successes.size() == 1) {
              return successes.get(0);
            }

            // We should never get here, unless there is a bug in either the SDK or
            // API code, causing a non-singleton response.
            throw new ChainException(
                "Invalid singleton response, request ID "
                    + batch.response().headers().get("Chain-Request-ID"));
          }
        };
    return post(action, body, rc);
  }

  /**
   * Returns the preferred base URL stored in the client.