org.dc.riot.lol.rx.service.interfaces.RetrofitCaller Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of lol-api-rxjava Show documentation

Service library for League of Legends API

There is a newer version: 1.0.5

package org.dc.riot.lol.rx.service.interfaces;

import java.io.IOException;

import org.dc.riot.lol.rx.service.error.HttpException;

import retrofit.Call;
import retrofit.Response;

/**
 * {@link Call} unpacking helper
 * 
 * @author Dc
 * @since 1.0.0
 *
 * @param 
 */
@FunctionalInterface
interface RetrofitCaller {

	public static boolean DEBUG = false;
	static final Object PRINT_LOCK = new Object();

	/**
	 * Make a single Retrofit call
	 * @return {@link Call} object
	 */
	Call call();

	/**
	 * @param caller caller to wrap
	 * @return deserialized JSON object
	 * @throws IOException network issue
	 * @throws HttpException - any non 2XX response code
	 */
	static  T processCall(final RetrofitCaller caller) throws IOException, HttpException {
		Call call = caller.call();
		Response response = call.execute();
		switch (response.code()) {
		case 200:
			return response.body();
		case 204:
			// a code 204 means that the request was good, the server has no response
			return response.body();		// should be null
		default:
			throw new HttpException(response.code(), response.headers().toMultimap());
		}
	}

	/**
	 * @param caller caller to wrap
	 * @param passCodes special error codes that callers may want to process
	 * @return deserialized JSON object
	 * @throws IOException network issue
	 * @throws HttpException - any non 2XX response code
	 */
	static  T processCall(final RetrofitCaller caller, T defaultValue, int... passCodes) throws IOException, HttpException {
		Call call = caller.call();
		Response response = call.execute();
		switch (response.code()) {
		case 200:
			return response.body();
		case 204:
			return null;
		default:
			if (passCodes != null) {
				for (int code : passCodes) {
					if (code == response.code()) {
						return defaultValue;
					}
				}
			}

			throw new HttpException(response.code(), response.headers().toMultimap());
		}
	}
	
	/**
	 * @param caller caller to wrap
	 * @param completer any custom processing that needs to happen on the received object
	 * 			before returning to calling code 
	 * @return json object
	 * @throws IOException network issue
	 * @throws HttpException any non 2XX response code
	 */
	static  T processCall(final RetrofitCaller caller, final Completer completer) throws IOException, HttpException {
		T t = processCall(caller);
		return completer.fill(t);
	}
}