Android™
Android™
Execute an FTP Upload Plan
See more FTP Examples
Demonstrates the Chilkat Ftp2.PutPlan method, which executes a previously created upload plan. The first argument is the plan text and the second is the local path of a completion log that records each successful operation.
Note: The local paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.
Background: The completion log is what makes plan execution resumable: each successful upload is recorded, so if a run is interrupted, re-executing the same plan skips the operations already logged and continues where it left off — invaluable for a large transfer over a flaky connection. The plan's stored absolute remote paths are used regardless of the current remote directory, so execution is independent of session state.
Chilkat Android™ Downloads
// 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;
// Demonstrates the Ftp2.PutPlan method, which executes a previously created upload plan. The 1st
// argument is the plan text and the 2nd is the local path of a completion log.
CkFtp2 ftp = new CkFtp2();
ftp.put_Hostname("ftp.example.com");
ftp.put_Username("myFtpLogin");
// Normally you would not hard-code the password in source. You should instead obtain it
// from an interactive prompt, environment variable, or a secrets vault.
ftp.put_Password("myPassword");
success = ftp.Connect();
if (success == false) {
Log.i(TAG, ftp.lastErrorText());
return;
}
success = ftp.ChangeRemoteDir("public_html");
if (success == false) {
Log.i(TAG, ftp.lastErrorText());
return;
}
// Load a plan that was previously created with CreatePlan.
CkStringBuilder sbPlan = new CkStringBuilder();
success = sbPlan.LoadFile("qa_output/upload_plan.txt","utf-8");
if (success == false) {
Log.i(TAG, sbPlan.lastErrorText());
return;
}
String plan = sbPlan.getAsString();
// Execute the plan. Each successful operation is recorded in the completion log, which lets an
// interrupted run be resumed without repeating completed uploads. The plan uses its stored
// absolute remote paths even if the current remote directory has changed.
success = ftp.PutPlan(plan,"qa_output/upload_done.log");
if (success == false) {
Log.i(TAG, ftp.lastErrorText());
return;
}
Log.i(TAG, "Upload plan executed.");
success = ftp.Disconnect();
if (success == false) {
Log.i(TAG, ftp.lastErrorText());
return;
}
}
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."
}
}