Add pre- and post-processing for request and response.

Author: Noor Dawod

library/src/main/java/com/loopj/android/http/AsyncHttpRequest.java

@@ -33,7 +33,7 @@
 /**
  * Internal class, representing the HttpRequest, done in asynchronous manner
  */
-public class AsyncHttpRequest implements PreProcessInterface, Runnable {
+public class AsyncHttpRequest implements Runnable {
     private final AbstractHttpClient client;
     private final HttpContext context;
     private final HttpUriRequest request;
@@ -51,8 +51,26 @@ public AsyncHttpRequest(AbstractHttpClient client, HttpContext context, HttpUriR
         this.responseHandler = responseHandler;
     }
 
-    @Override
-    public void onPreProcess() {
+    /**
+     * This method is called once by the system when the request is about to be
+     * processed by the system. The library makes sure that a single request
+     * is pre-processed only once.
+     *
+     * @param request The request to pre-process
+     */
+    public void onPreProcessRequest(AsyncHttpRequest request) {
+        // default action is to do nothing...
+    }
+
+    /**
+     * This method is called once by the system when the request has been fully
+     * sent, handled and finished. The library makes sure that a single request
+     * is post-processed only once.
+     *
+     * @param request The request to post-process
+     */
+    public void onPostProcessRequest(AsyncHttpRequest request) {
+        // default action is to do nothing...
     }
 
     @Override
@@ -64,7 +82,7 @@ public void run() {
         // Carry out pre-processing for this request only once.
         if (!isRequestPreProcessed) {
             isRequestPreProcessed = true;
-            onPreProcess();
+            onPreProcessRequest(this);
         }
 
         if (isCancelled()) {
@@ -97,13 +115,21 @@ public void run() {
             responseHandler.sendFinishMessage();
         }
 
+        if (isCancelled()) {
+            return;
+        }
+
+        // Carry out post-processing for this request.
+        onPostProcessRequest(this);
+
         isFinished = true;
     }
 
     private void makeRequest() throws IOException {
         if (isCancelled()) {
             return;
         }
+
         // Fixes #115
         if (request.getURI().getScheme() == null) {
             // subclass of IOException so processed in the caller
@@ -112,12 +138,27 @@ private void makeRequest() throws IOException {
 
         HttpResponse response = client.execute(request, context);
 
-        if (!isCancelled() && responseHandler != null) {
+        if(isCancelled()) {
+            return;
+        }
+
+        if (responseHandler != null) {
             // Carry out pre-processing for this response.
-            responseHandler.onPreProcess();
+            responseHandler.onPreProcessResponse(responseHandler, response);
+
+            if(isCancelled()) {
+                return;
+            }
 
             // The response is ready, handle it.
             responseHandler.sendResponseMessage(response);
+
+            if(isCancelled()) {
+                return;
+            }
+
+            // Carry out post-processing for this response.
+            responseHandler.onPostProcessResponse(responseHandler, response);
         }
     }
 

library/src/main/java/com/loopj/android/http/AsyncHttpResponseHandler.java

@@ -219,7 +219,12 @@ public void onFinish() {
     }
 
     @Override
-    public void onPreProcess() {
+    public void onPreProcessResponse(ResponseHandlerInterface instance, HttpResponse response) {
+        // default action is to do nothing...
+    }
+
+    @Override
+    public void onPostProcessResponse(ResponseHandlerInterface instance, HttpResponse response) {
         // default action is to do nothing...
     }
 

library/src/main/java/com/loopj/android/http/ResponseHandlerInterface.java

@@ -27,7 +27,7 @@
 /**
  * Interface to standardize implementations
  */
-public interface ResponseHandlerInterface extends PreProcessInterface {
+public interface ResponseHandlerInterface {
 
     /**
      * Returns data whether request completed successfully
@@ -127,4 +127,24 @@ public interface ResponseHandlerInterface extends PreProcessInterface {
      * @return boolean if the ResponseHandler is running in synchronous mode
      */
     boolean getUseSynchronousMode();
+
+    /**
+     * This method is called once by the system when the response is about to be
+     * processed by the system. The library makes sure that a single response
+     * is pre-processed only once.
+     *
+     * @param instance An instance of this response object
+     * @param response The response to pre-processed
+     */
+    void onPreProcessResponse(ResponseHandlerInterface instance, HttpResponse response);
+
+    /**
+     * This method is called once by the system when the request has been fully
+     * sent, handled and finished. The library makes sure that a single response
+     * is post-processed only once.
+     *
+     * @param instance An instance of this response object
+     * @param response The response to post-process
+     */
+    public void onPostProcessResponse(ResponseHandlerInterface instance, HttpResponse response);
 }