(Android™) REST Follow Redirects

Demonstrates how to follow a 302/303 redirect response.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkRest rest = new CkRest();

    boolean bTls = true;
    int port = 443;
    boolean bAutoReconnect = true;
    boolean success = rest.Connect("chilkatsoft.com",port,bTls,bAutoReconnect);
    if (success != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    // Send a POST to a URL that will respond with a 302 redirect..
    rest.AddQueryParam("firstName","John");
    rest.AddQueryParam("lastName","Doe");
    String responseText = rest.fullRequestFormUrlEncoded("POST","/echoPost302.asp");
    if (rest.get_LastMethodSuccess() != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    int statusCode = rest.get_ResponseStatusCode();

    // Examine the response status code
    if (statusCode < 300) {
        Log.i(TAG, "Not a redirect.");
        Log.i(TAG, responseText);
        return;
        }

    if (statusCode > 399) {
        Log.i(TAG, "Error response: Status code = " + String.valueOf(statusCode));
        Log.i(TAG, responseText);
        return;
        }

    Log.i(TAG, "Redirect status code = " + String.valueOf(statusCode));

    // The response header will contain a Location field with the redirect URL, such as this:
    // Location: http://www.chilkatsoft.com/echoPostFinal.asp

    // The response status code determines how the client should behave.
    // Here are some common possibilities:

    // 301: Moved Permanently
    // This and all future requests should be directed to the given URI.  (Keep the original HTTP method for the redirect.  In this case, the 
    // original request was a POST, so we POST to the redirect URL.)

    // 302: Found (aka Object Moved aka Moved Temporarily)
    // This is the most popular redirect code, but also an example of industrial practice contradicting the standard. HTTP/1.0 specification (RFC 1945 ) required the client
    // to perform a temporary redirect (the original describing phrase was Moved Temporarily), but popular browsers implemented it as a 303 See Other. Therefore, HTTP/1.1
    // added status codes 303 and 307 to disambiguate between the two behaviors. However, the majority of Web applications and frameworks still use the 302 status code
    // as if it were the 303.

    // 303: See Other
    // The response to the request can be found under another URI using a GET method. When received in response to a PUT, it should be assumed that the server has
    // received the data and the redirect should be issued with a separate GET message.

    // 307: Temporary Redirect
    // In this occasion, the request should be repeated with another URI, but future requests can still use the original URI. In contrast to 303, the request method
    // should not be changed when reissuing the original request. For instance, a POST request must be repeated using another POST request.

    Log.i(TAG, rest.responseHeader());

    CkUrl redirectUrl = rest.RedirectUrl();
    if (rest.get_LastMethodSuccess() == false) {
        Log.i(TAG, "No Location header found for redirect.");
        return;
        }

    // Prep for the redirect..
    rest.ClearAllParts();

    // Disconnect and re-connect.  
    // (This can be skipped if both the host and SSL/TLS conditions are the same.)
    rest.Disconnect(100);
    success = rest.Connect(redirectUrl.host(),redirectUrl.get_Port(),redirectUrl.get_Ssl(),bAutoReconnect);
    if (success != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    if ((statusCode == 301) or (statusCode == 307)) {
        // Redirect using a POST, sending the same params to the new destination
        rest.AddQueryParam("firstName","John");
        rest.AddQueryParam("lastName","Doe");
        responseText = rest.fullRequestFormUrlEncoded("POST",redirectUrl.path());
        if (rest.get_LastMethodSuccess() != true) {
            Log.i(TAG, rest.lastErrorText());
            return;
            }

        }

    if ((statusCode == 302) or (statusCode == 303)) {
        // Redirect using a GET, sending the query params found in the redirect URL.
        responseText = rest.fullRequestFormUrlEncoded("GET",redirectUrl.pathWithQueryParams());
        if (rest.get_LastMethodSuccess() != true) {
            Log.i(TAG, rest.lastErrorText());
            return;
            }

        }

    // Show the final status code and the response text.
    Log.i(TAG, "Final status code = " + String.valueOf(rest.get_ResponseStatusCode()));

    Log.i(TAG, "Final response text (HTML, XML, JSON, or whatever..)");
    Log.i(TAG, responseText);

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}