Java

Set Uncommon Email Options

Demonstrates the Chilkat Email.UncommonOptions property, a catch-all for uncommon needs. It defaults to the empty string and should typically remain empty. Recognized keywords include NoBccHeader (do not add the Bcc MIME header for BCC addresses — which must be set before calling AddBcc or AddMultipleBcc) and NO_FORMAT_FLOWED (do not automatically add format=flowed to a Content-Type header). This example sets NoBccHeader.

Background: Long-lived libraries accumulate rare, situational tweaks that do not each deserve their own property. Chilkat gathers these into a single keyword-driven UncommonOptions string. NoBccHeader is a good example: normally a Bcc header is generated (and stripped at send time), but certain workflows want it omitted entirely. Only documented keywords have any effect — unrecognized text is ignored — so leave this empty unless a specific compatibility need arises.

Chilkat Java Downloads

Download Chilkat for Java

Java

import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    //  Demonstrates the Email.UncommonOptions property, a catch-all for uncommon needs.
    //  It defaults to empty and should usually remain empty.  Recognized keywords include
    //  "NoBccHeader" (do not add the Bcc MIME header) and "NO_FORMAT_FLOWED".

    CkEmail email = new CkEmail();
    email.put_Subject("UncommonOptions example");
    email.put_From("alice@example.com");

    //  Do not add the Bcc MIME header for BCC recipients.  This keyword must be set
    //  before calling AddBcc or AddMultipleBcc.
    email.put_UncommonOptions("NoBccHeader");

    email.AddBcc("Joe","joe@example.com");

    System.out.println("UncommonOptions = " + email.uncommonOptions());
  }
}