Como enviar e-mails com arquivos em anexo?

ADSRT.FAQ-1982

Existem várias formas de enviar e-mails com arquivos em anexo.
A forma mais simples é quando o e-mail é composto apenas por um arquivo. Neste caso use algo tipo:

ctx.sendMail(String to, String from, String subject, File file);

Se forem necessários vários arquivos, use:

ctx.sendMail(String to, String from, String subject, File[] files);

Se quiser um maior controle sobre o formato da mensagem, crie um objeto Multipart, anexe as partes da mensagem manualmente e depois envie este objeto. Ex:

Multipart mp = new MimeMultipart();
for (File f: files) {
    try {
        MimeBodyPart part = new MimeBodyPart();
        part.setFileName(f.getName());
        part.setDataHandler(new DataHandler(new FileDataSource(f)));
        mp.addBodyPart(part);
    } catch (MessagingException ex) {
        throw new AdsException(ex);
    }
}
sendMail(to, from, subject, mp, null);