EasyWebservice

Fast and easy RESTful api calls for android.

How to use

Add jitpack to repositories

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

then add library to dependencies

dependencies {
	        implementation 'com.github.ashkanpower:easywebservice:57955d45b2'
	}

Fast useage

  //{res : true, msg : "success"}
  new EasyWebservice("http://host.com/api/v1/test")
				.method(Method.POST) //default
				.addParam("id", 100) //adding params to body
				.call(new Callback.AB<Boolean, String>("res", "msg") { //should map response params
					@Override
					public void onSuccess(Boolean res, String msg) {
          
                                           //you can work with res and msg which are in json response
					}

					@Override
					public void onError(String error) {
          
                                          //if any error encountered
					}
				});

Object usage

If you have object in your response you should define that object

  //{ person : {id:10, name : "ashkan", lastname : "power"} }
  
  class Person {
    int id; //the same as object
    String name;
    String lastname;
  }
  
   new EasyWebservice("http://host.com/api/v1/person")
				.call(new Callback.A<Person>("person") { //should map response params
					@Override
					public void onSuccess(Person person) {
          
                   //the person object filled with response info
					}

					@Override
					public void onError(String error) {
          
                    //if any error encountered
					}
				});

array responses

EasyWebservice also handles array responses

["California", "New York", "LA", "Texas"]

new EasyWebservice("http://host.com/api/v1/cities")
				.call(new Callback.A<ArrayList<String>>() { //the mapping for root elements should be empty
					@Override
					public void onSuccess(ArrayList<String> cities) {
          
                   //work with the array
					}

					@Override
					public void onError(String error) {
          
                    //if any error encountered
					}
				});

More info

The callback group has 5 levels

Callback.A
Callback.AB
Callback.ABC
Callback.ABCD
Callback.ABCDE

which allows you to get JSON response up to 5 root attributes. the combination will be unlimited.