repeson's Introduction

repeson

A JSON-RPC Client for Java. It uses the HttpClient of JDK11, so requests can be sent either blocking (synchronous) or not blocking (asynchronous)

How to use it

1. Adding the dependency to your project

<dependency>
  <groupId>com.emiperez.repeson</groupId>
  <artifactId>repeson</artifactId>
  <version>0.5.0</version>
</dependency>

2. Configuring the Transport

Currently only HTTP/HTTPS Transport has been developed.
Create a new HttpClient and Configure it with any HTTP related properties (Authentication, Proxy, Cookie Handler, SSL and so on)
Build a new HttpTransport and inject the HttpClient to it

Transport transport = HttpTransport.builder(httpClient).uri(uri).contentType(contentType).build();

3. Building the JsonRpcClient

JsonRpcClient jsonRpcClient = JsonRpcClient.builder()
					.transport(transport)
					.version(JsonRpcVersion.v2_0)
					.idGenerator(idGenerator)
					.build();

4.- Sending the Request and getting the Response

Synchronous or blocking:

JsonRpcResponse<Customer> r = jsonRpcClient.sendRequestWithDefaults("getcustomer", paramsPojo);
r.ifHasResultOrElse(customer -> System.out.println(customer.getName(),
								() -> System.out.println("No customer returned"));

or Asynchronous (not blocking)

CompletableFuture<Customer> cc = jsonRpcClient
  .sendRequestWithDefaultsAsync("getcustomer", paramsPojo)
  .thenApply(JsonRpcResponse::getResult);

If the returned Type uses Generics, for example; ArrayList<Customer>, to prevent the Type Erasure, a class file, that extends JsonRpcResponse must be created,

public class CustomerListResponse extends JsonRpcResponse<ArrayList<Customer>> {}

and passed as an argument to send methods:

CustomerListResponse r = jsonRpcClient.sendRequestWithDefaults("listcustomers", paramsPojo, 
								CustomerListResponse.class);
if (r.hasResult()) {
  ArrayList<Customer> cs = r.getResult();
  //Do whatever with cs
}

Recommend Projects