Java

Add a MIME Header Field

Demonstrates the Chilkat Mime.AddHeaderField method, which appends a new header field. The first argument is the field name and the second is the value. Existing fields with the same case-insensitive name are preserved, so this can create duplicates.

Background: MIME headers are ordered name/value lines, and some — Received, for instance — legitimately appear more than once. AddHeaderField is the tool for that: it always appends, never replacing an existing field of the same name. When you instead want exactly one field with a given name, use SetHeaderField, which replaces rather than accumulates.

Chilkat Java Downloads

Download Chilkat for Java

Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Mime;

public class ChilkatExample {

    public static void main(String[] args) {
        // Demonstrates the Mime.AddHeaderField method, which appends a new header field.  The 1st argument
        // is the field name and the 2nd is the value.  Existing fields with the same (case-insensitive)
        // name are preserved, so this can create duplicate fields.

        Mime mime = new Mime();

        String headers;
        try {
            mime.setBodyFromPlainText("Hello.");

            // Append header fields.  AddHeaderField does not replace existing fields of the same name.
            mime.addHeaderField("X-Custom-Header", "value1");

            mime.addHeaderField("X-Priority", "3");

            headers = mime.getEntireHead();
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        System.out.println(headers);
    }
}