Flexible and Easy HTTP/REST Communication library for Java and Android
Switch branches/tags
Clone or download
Latest commit 8a37a21 Feb 6, 2017

README.md

jus

JavaDocs

Build Status Join the chat at https://gitter.im/apptik/jus StackExchange Stories in Ready

Jus is a flexible and easy HTTP/REST client library for Java and Android.

  • it is like Volley but much easier
  • it is like Retrofit but infinitely more flexible

Jus is inspired by the flexibility, modularity and transparency of Google's Volley Library and the extreme simplicity of declarative API mapping of Retrofit.

Like Volley the main thing where Requests are executed is the RequestQueue.

RequestQueue queue = Jus.newRequestQueue();

and then Requests can be added to the Queue:

queue.add(new Request<String>(
                        Request.Method.GET,
                        HttpUrl.parse(BeerService.fullUrl),
                        new Converters.StringResponseConverter())
                        .addResponseListener((r) -> out.println("RESPONSE: " + r))
                        .addErrorListener((e) -> out.println("ERROR: " + e))
        );

Anther option similarly to Retrofit is to map Java Interface to an API.

public interface BeerService {
    @GET("locquery/{user}/{q}")
    Request<String> getBeer(
            @Path("user") String user,
            @Path("q") String q);
}

Then create the Service Instance:

RetroProxy retroJus = new RetroProxy.Builder()
            .baseUrl(BeerService.baseUrl)
            .requestQueue(queue)
            .addConverterFactory(new BasicConverterFactory())
            .build();

    BeerService beerService = retroJus.create(BeerService.class);

And execute a request:

beerService.getBeer(BeerService.userString, "777")
                .addResponseListener((r) -> out.println("RESPONSE: " + r))
                .addErrorListener((e) -> out.println("ERROR: " + e.networkResponse));

Download

Find the latest JARs or grab via Maven:

<dependency>
  <groupId>io.apptik.comm</groupId>
  <artifactId>jus-XXX</artifactId>
  <version>0.6.9</version>
</dependency>

or Gradle:

compile 'io.apptik.comm:jus-XXX:0.6.9'

Downloads of the released versions are available in Sonatype's releases repository.

Snapshots of the development versions are available in Sonatype's snapshots repository.

Jus requires at minimum Java 7 or Android SDK 15.

Examples

Questions

StackOverflow with tag 'jus' or 'apptik'

Modules

  • jus for Java - main jus library for java Maven Central VersionEye

  • Reactive jus - RxJava support for jus Maven Central VersionEye

  • HTTP Stacks

    • OkHttp = OkHttp Client Stack for jus Maven Central VersionEye
    • OkHttp3 = OkHttp3 Client Stack for jus Maven Central VersionEye
    • ApacheHttp = ApacheHttp Client Stack for jus Maven Central VersionEye
    • Netty = Netty Client Stack for jus Maven Central VersionEye
  • Jus for Android

  • Data serializers support and custom requests for jus

Licence

Copyright (C) 2016 AppTik Project

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.