Android™

Viewing a Simple Three-Step Execution Plan

See more CURL Examples

This example demonstrates a straightforward, valid dependency chain that results in a three-step execution plan. The goal is not to execute the requests, but to inspect how the plan is constructed using ExaminePlan.

The target curl command requires {{order_id}}. A helper function is defined to produce order_id, but it depends on customer_id. Another helper function produces customer_id, which depends on account_name.

Because account_name is provided as a known input, the dependency chain can be fully resolved:

• customer_id is obtained from account_name
• order_id is obtained from customer_id
• The target curl command uses order_id

When ExaminePlan is called, it builds and returns a three-step execution plan showing the order in which each function would be executed.

Android™

// 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);

    boolean success = false;

    CkHttpCurl httpCurl = new CkHttpCurl();

    // The target curl command requires {{order_id}}.
    String targetCurl = "curl -X GET https://api.example.com/orders/{{order_id}}";

    // Define a helper function that produces order_id from customer_id.
    String fnName = "getOrderId";
    httpCurl.AddFunction(fnName,"curl -X GET https://api.example.com/order-id?customer={{customer_id}}");
    httpCurl.AddOutput(fnName,"order.id","order_id");

    // Define a helper function that produces customer_id from account_name.
    fnName = "getCustomerId";
    httpCurl.AddFunction(fnName,"curl -X GET https://api.example.com/customer-id?account={{account_name}}");
    httpCurl.AddOutput(fnName,"customer.id","customer_id");

    // Provide the starting known input.
    httpCurl.SetVar("account_name","acme");

    // Examine the execution plan without running any requests.
    CkJsonObject planJson = new CkJsonObject();
    planJson.put_EmitCompact(false);

    success = httpCurl.ExaminePlan(targetCurl,planJson);

    // Success is expected to be true.
    Log.i(TAG, "success = " + String.valueOf(success));

    Log.i(TAG, planJson.emit());

    // Expected result:
    // 
    // {
    //   "plan": [{
    //     "function": "getCustomerId",
    //     "inputs": ["account_name"],
    //     "outputs": ["customer_id"]
    //   },{
    //     "function": "getOrderId",
    //     "inputs": ["customer_id"],
    //     "outputs": ["order_id"]
    //   },{
    //     "function": "targetCurl",
    //     "inputs": ["order_id"],
    //     "outputs": []
    //   }]
    // }

  }

  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."
  }
}