(Android™) Encrypting/decrypting a data stream.

This example demonstrates how to encrypt (using a symmetric encryption algorithm such as AES, ChaCha20, Blowfish, RC2, 3DES, etc) a large amount of data. The data is passed in chunks to one of the encrypt methods: EncryptBytes, EncryptString, EncryptBytesENC, or EncryptStringENC, etc. The FirstChunk and LastChunk properties are used to indicate whether a chunk is the first, middle, or last in a stream to be encrypted. By default, both FirstChunk and LastChunk equal true -- meaning that the data passed is the entire amount.

Note: You may feed the data in chunks that are smaller than the block size of the encryption algorithm (AES and Twofish have a block size of 16 bytes. DES, 3DES, Blowfish, and RC2 have a block size of 8 bytes. ARC4 and ChaCha20 are streaming encryption algorithms and don't have a block size, but technically you can think of it as having a block size of 1 byte.)

Chilkat will buffer the data as required. If an amount of data smaller than the block size is passed such that the entire amount is buffered, then an empty string (or 0 bytes) is returned. The buffered data will be added to the data passed in subsequent calls. When the final data chunk is passed, it is padded to the encryption algorithm's block size (according to the PaddingScheme property) and the encryption is complete.

Decrypting in chunks is identical to encrypting in chunks.

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.

    CkCrypt2 crypt = new CkCrypt2();

    crypt.put_CryptAlgorithm("aes");
    crypt.put_CipherMode("cbc");
    crypt.put_KeyLength(128);

    crypt.SetEncodedKey("000102030405060708090A0B0C0D0E0F","hex");
    crypt.SetEncodedIV("000102030405060708090A0B0C0D0E0F","hex");

    crypt.put_EncodingMode("hex");
    String txt1 = "The quick brown fox jumped over the lazy dog.\r\n";
    String txt2 = "-\r\n";
    String txt3 = "Done.\r\n";

    CkStringBuilder sbEncrypted = new CkStringBuilder();

    // Encrypt the 1st chunk:
    // (don't worry about feeding the data to the encryptor in 
    // exact multiples of the encryption algorithm's block size.
    // Chilkat will buffer the data.)
    crypt.put_FirstChunk(true);
    crypt.put_LastChunk(false);
    sbEncrypted.Append(crypt.encryptStringENC(txt1));

    // Encrypt the 2nd chunk
    crypt.put_FirstChunk(false);
    crypt.put_LastChunk(false);
    sbEncrypted.Append(crypt.encryptStringENC(txt2));

    // Now encrypt N more chunks...
    // Remember -- we're doing this in CBC mode, so each call
    // to the encrypt method depends on the state from previous
    // calls...
    crypt.put_FirstChunk(false);
    crypt.put_LastChunk(false);
    int i;
    for (i = 0; i <= 4; i++) {
        sbEncrypted.Append(crypt.encryptStringENC(txt1));
        sbEncrypted.Append(crypt.encryptStringENC(txt2));
        }

    // Now encrypt the last chunk:
    crypt.put_FirstChunk(false);
    crypt.put_LastChunk(true);
    sbEncrypted.Append(crypt.encryptStringENC(txt3));

    Log.i(TAG, sbEncrypted.getAsString());

    // Now decrypt in one call.
    // (The data we're decrypting is both the first AND last chunk.)  
    crypt.put_FirstChunk(true);
    crypt.put_LastChunk(true);
    String decryptedText = crypt.decryptStringENC(sbEncrypted.getAsString());

    Log.i(TAG, decryptedText);

    // Note: You may decrypt in N chunks by setting the FirstChunk
    // and LastChunk properties prior to calling the Decrypt* methods

  }

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