Class Client

sdk/java/src/main/java/com/chain/http/Client.java:47–884

The Client object contains all information necessary to perform an HTTP request against a remote API. Typically, an application will have a client that makes requests to a Chain Core, and a separate Client that makes requests to an HSM server.

 * to an HSM server.
 */
public class Client {
  private AtomicInteger urlIndex;
  private List<URL> urls;
  private String accessToken;
  private OkHttpClient httpClient;

  // Used to create empty, in-memory key stores.
  private static final char[] DEFAULT_KEYSTORE_PASSWORD = "password".toCharArray();
  private static final MediaType JSON = MediaType.parse("application/json; charset=utf-8");
  private static String version = "dev"; // updated in the static initializer

  private static class BuildProperties {
    public String version;
  }

  static {
    InputStream in = Client.class.getClassLoader().getResourceAsStream("properties.json");
    if (in != null) {
      InputStreamReader inr = new InputStreamReader(in);
      version = Utils.serializer.fromJson(inr, BuildProperties.class).version;
    }
  }

  public Client(Builder builder) throws ConfigurationException {
    List<URL> urls = new ArrayList<>(builder.urls);
    if (urls.isEmpty()) {
      try {
        urls.add(new URL("http://localhost:1999"));
      } catch (MalformedURLException e) {
        throw new RuntimeException("invalid default development URL", e);
      }
    }

    this.urlIndex = new AtomicInteger(0);
    this.urls = urls;
    this.accessToken = builder.accessToken;
    this.httpClient = buildHttpClient(builder);
  }

  /**
   * Create a new http Client object using the default development host URL.
   */
  public Client() throws ChainException {
    this(new Builder());
  }

  /**
   * Create a new http Client object
   *
   * @param url the URL of the Chain Core or HSM
   */
  public Client(String url) throws ChainException {
    this(new Builder().setURL(url));
  }

  /**
   * Create a new http Client object
   *