EasyVolley

Android Volley Wrapper library to make networking easy, flexible and better.

Purpose

Installation

GRADLE

dependencies {

compile 'com.github.asifmujteba:easyvolley:0.9.+' 
}
 

Usage

• Initialize and do global configurations using EasyVolley class once on application start and dispose in the end, preferably by extending Applcation class.

EasyVolley.initialize(getApplicationContext());
 

EasyVolley.dispose();
  

Performing Http Requests

EasyVolley.withGlobalQueue()

  .load(URL_COMES_HERE)

  .asJsonObject()

  .setSubscriber(OBJECT_REFERENCE_HERE) // Once this object unsubscribes the request is cancelled and no callbacks are called

  .setCallback(new ASFRequestListener<JsonObject>() {

@Override

public void onSuccess(JsonObject response) {

 // DO_SOMETHING_HERE

}

@Override

public void onFailure(Exception e) {

 // SO_SOMETHING_HERE

}

  
}
)

  .start();
 

Subscription Mechanism

Call .setSubscriber(OBJECT_REFERENCE_HERE) on a request to attach it against the object passed. i-e, Pass the activity here.

And call EasyVolley.unSubscribe(OBJECT_REFERENCE_HERE); when the request is longer needed i-e, In onDestroy() method of Activity.

This will ensure that requests are cancelled and callbacks are not called after the activity has been destroyed.

Performing Image Requests

• Ability to set callbacks on image load or directly load it into an ImageView
• Ability to set image width, height and different scale types.

EasyVolley.withGlobalQueue()

  .load(url)

  .asBitmap()

  .setMaxWidth(WIDTH_HERE) // OPTIONAL

  .setMaxHeight(HEIGHT_HERE) // OPTIONAL

  .setScaleType(SCALE_TYPE_HERE) // OPTIONAL

  .setCallback(...) // OPTIONAL

  .into(IMAGE_VIEW_HERE) // OPTIONAL

  .start();
 

Managing Request Queues

By default EasyVolley creates a global Request Queue to process all requests. We can also create new request queues if needed.

EasyVolley.withNewQueue(getApplicationContext()) 

Setting Headers

EasyVolley.withGlobalQueue()

  .load(URL_COMES_HERE)

  .addHeader(KEY1_HERE, VALUE1_HERE)

  .addHeader(KEY2_HERE, VALUE2_HERE)

  ... 

Adding Get/Post Parameters

EasyVolley.withGlobalQueue()

  .load(URL_COMES_HERE)

  .addParam(KEY1_HERE, VALUE1_HERE)

  .addParam(KEY2_HERE, VALUE2_HERE)

  ... 

Request Caching

• Cache uses least recently used technique to limit memory size.
• By defaut all requests are cached in memory and disk as well. (caching http requests directly in memory in addition to images really fastens the User experience especially for fast scrolling scenarios)
• Http headers, Get parameters, Post body digest are all taken into consideration for effiecient caching

Coming Soon / TODO

Author

License