jus

JavaDocs

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

• java examples
• NEW android demo app
• android examples (old)
• volley to jus migration examples

Questions

StackOverflow with tag 'jus' or 'apptik'

Modules

• jus for Java - main jus library for java

• Reactive jus - RxJava support for jus

• HTTP Stacks

  • OkHttp = OkHttp Client Stack for jus
  • OkHttp3 = OkHttp3 Client Stack for jus
  • ApacheHttp = ApacheHttp Client Stack for jus
  • Netty = Netty Client Stack for jus

• Jus for Android

  • Android jus - jus optimized for Android

• Data serializers support and custom requests for jus

  • Gson - support for Gson
  • Jackson - support for Jackson
  • JJson - support for JustJson
  • Moshi - support for Moshi
  • Protobuf - support for Google Protobuf
  • SimpleXML - support for Simple
  • Wire - support for wire

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.