README.md

mutiny

This module provides support to use Mutiny classes with julian-http-client. Mutiny is a event driven, reactive library for Java.

Install

Maven

<dependency>
    <groupId>com.github.ljtfreitas.julian-http-client</groupId>
    <artifactId>julian-http-client-mutiny</artifactId>
    <version>${julian-http-client-version}</version>
</dependency>

Gradle

dependencies {
    implementation("com.github.ljtfreitas.julian-http-client:julian-http-client-mutiny:$julianHttpClientVersion")
}

That's it. So, let's to the code.

Usage

julian-http-client supports Uni and Multi types.

import com.github.ljtfreitas.julian.contract.Body;
import com.github.ljtfreitas.julian.contract.GET;
import com.github.ljtfreitas.julian.contract.POST;
import com.github.ljtfreitas.julian.contract.Path;

import io.smallrye.mutiny.Uni;
import io.smallrye.mutiny.Multi;

@Path("/person")
interface PersonApi {

    @POST
    Uni<Void> create(@Body("text/plain") String bodyAsText);

    @GET("/{personId}")
    Unit<Person> get(@Path int personId);

    @GET
    Multi<Person> getAllPersons();
}

Just be careful to use Multi because deserialization process will try to read the response body as a collection of values. So, if we want to get a single value from HTTP response (a single json document, for example), we must to use Uni; in case we expect a list of values (a json array, for example), we must to use Multi.

Failures can be handled using the regular Uni and Multi methods.