com.digi.wva.device

Class HttpClient.ExpectEmptyCallback

java.lang.Object

com.digi.wva.device.HttpClient.HttpCallback

com.digi.wva.device.HttpClient.ExpectEmptyCallback

Enclosing class:

HttpClient

public abstract static class HttpClient.ExpectEmptyCallback
extends HttpClient.HttpCallback

Version of HttpClient.HttpCallback which expects the HTTP response body to be empty. Useful as a callback for requests which do not send a body back (such as performing the PUT requests for subscriptions, etc.).

Constructor Summary

Constructors

Constructor and Description
HttpClient.ExpectEmptyCallback()

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	onBodyNotEmpty(String body) Called when the HTTP response was considered successful (status code in the 200s), but the body was not empty.
void	onJsonParseError(JSONException error, String rawBody) Invoked when the HTTP request was successful, but the response body could not be parsed as a JSON object.
abstract void	onSuccess() Called when the HTTP response was successfully received from the WVA, and the response body was empty (as expected).
void	onSuccess(JSONObject response) Calls onBodyNotEmpty(String), with response.toString().

Methods inherited from class com.digi.wva.device.HttpClient.HttpCallback

onFailure

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpClient.ExpectEmptyCallback

public HttpClient.ExpectEmptyCallback()

Method Detail

onSuccess

public final void onSuccess(JSONObject response)

Calls onBodyNotEmpty(String), with response.toString().

This method is final so as to minimize user error.

Specified by:

onSuccess in class HttpClient.HttpCallback

Parameters:

response - the JSON object from the HTTP response

onBodyNotEmpty

public abstract void onBodyNotEmpty(String body)

Called when the HTTP response was considered successful (status code in the 200s), but the body was not empty.

Parameters:

body - the HTTP response body

onSuccess

public abstract void onSuccess()

Called when the HTTP response was successfully received from the WVA, and the response body was empty (as expected).

onJsonParseError

public final void onJsonParseError(JSONException error,
                    String rawBody)

Invoked when the HTTP request was successful, but the response body could not be parsed as a JSON object.

This class makes this method final to minimize user error, because this is the point where empty response bodies are handled (so as to call onSuccess()).

Overrides:

onJsonParseError in class HttpClient.HttpCallback

Parameters:

error - the JSONException raised while parsing the response body

rawBody - the body which could not be parsed as JSON