com.scantrust.mobile.android_api

Class NetworkCallback<T>

Object

com.scantrust.mobile.android_api.NetworkCallback<T>

Type Parameters:

T - the response body class

All Implemented Interfaces:

retrofit2.Callback<T>

public abstract class NetworkCallback<T>
extends Object
implements retrofit2.Callback<T>

An abstract class that pre-parses the Callback's Response and routes the server-provided errors to separate methods

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NetworkCallback.SpecificError Holds the details of a NetworkCallback.StNetworkException
static class	NetworkCallback.StNetworkException Describes what type of network error occurred

Constructor Summary

Constructors

Constructor and Description
NetworkCallback()

Method Summary

Modifier and Type	Method and Description
abstract void	onError(int httpStatusCode, String errorMessage, retrofit2.Call<T> call, Throwable t) Invoked when: a network exception occurred talking to the server an unexpected exception occurred creating the request or processing the response a generic error occurred
void	onFailure(retrofit2.Call<T> call, Throwable t)
void	onResponse(retrofit2.Call<T> call, retrofit2.Response<T> response)
abstract void	onSpecificError(NetworkCallback.StNetworkException networkException, int httpStatusCode, NetworkCallback.SpecificError error, retrofit2.Call<T> call, retrofit2.Response<T> response) Invoked when a 400 or 406 application level failure occurred
abstract void	onSuccess(retrofit2.Call<T> call, retrofit2.Response<T> response) Invoked for a successful response

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NetworkCallback

public NetworkCallback()

Method Detail

onSuccess

public abstract void onSuccess(retrofit2.Call<T> call,
                               retrofit2.Response<T> response)

Invoked for a successful response

Parameters:

call - The Call

response - The Response

onError

public abstract void onError(int httpStatusCode,
                             String errorMessage,
                             retrofit2.Call<T> call,
                             Throwable t)

Invoked when:

• a network exception occurred talking to the server
• an unexpected exception occurred creating the request or processing the response
• a generic error occurred

Parameters:

httpStatusCode - The http status code

errorMessage - An error message for this issue

call - The Call

t - The Throwable associated to the issue

onSpecificError

public abstract void onSpecificError(NetworkCallback.StNetworkException networkException,
                                     int httpStatusCode,
                                     NetworkCallback.SpecificError error,
                                     retrofit2.Call<T> call,
                                     retrofit2.Response<T> response)

Invoked when a 400 or 406 application level failure occurred

Parameters:

networkException - The failure type

httpStatusCode - The http status code

error - The failure details

call - The Call

response - The Response

onResponse

public final void onResponse(@NonNull
                             retrofit2.Call<T> call,
                             retrofit2.Response<T> response)

Specified by:

onResponse in interface retrofit2.Callback<T>

onFailure

public final void onFailure(@NonNull
                            retrofit2.Call<T> call,
                            Throwable t)

Specified by:

onFailure in interface retrofit2.Callback<T>