/** * Convenient shortcut of {@link #parse(String)} that returns {@link EmailAddress} or {@code null}. */ public EmailAddress parseToEmailAddress(final String email) { final ParsedAddress parsedAddress = parse(email); if (!parsedAddress.isValid()) { return null; } return new EmailAddress(parsedAddress.getPersonalName(), parsedAddress.getLocalPart() + '@' + parsedAddress.getDomain()); }
/** * Adds a {@link EmailMessage}. * * @param text The text to add as a {@link String}. * @param mimeType The MIME type as a {@link String}. * @param encoding The encoding as a {@link String}. * @return this * @see #message(EmailMessage) */ public T message(final String text, final String mimeType, final String encoding) { return message(new EmailMessage(text, mimeType, encoding)); }
/** * Sets the FROM address by providing personal name and address. * * @param personalName personal name. * @param from email address. * @return this * @see #from(EmailAddress) */ public T from(final String personalName, final String from) { return from(new EmailAddress(personalName, from)); }
/** * Appends BCC address. * * @param personalName personal name. * @param bcc email address. * @return this * @see #bcc(EmailAddress) */ public Email bcc(final String personalName, final String bcc) { return bcc(new EmailAddress(personalName, bcc)); }
/** * Appends REPLY-TO address. * * @param personalName personal name. * @param replyTo email address. * @return this * @see #replyTo(EmailAddress) */ public T replyTo(final String personalName, final String replyTo) { return replyTo(new EmailAddress(personalName, replyTo)); }
/** * Adds {@link EmailAttachment}. Content ID will be set to {@code null}. * * @param attachment {@link EmailAttachment} to add. * @return this */ public T attachment(final EmailAttachment<? extends DataSource> attachment) { attachment.setContentId(null); return storeAttachment(attachment); }
/** * Adds a {@link EmailMessage}. * * @param text The text to add as a {@link String}. * @param mimeType The MIME type as a {@link String}. * @return this * @see #message(EmailMessage) */ public T message(final String text, final String mimeType) { return message(new EmailMessage(text, mimeType)); }
/** * Adds HTML message. * * @param html The HTML to add as a {@link String}. * @param encoding The encoding as a {@link String}. * @return this * @see #message(EmailMessage) */ public T htmlMessage(final String html, final String encoding) { return message(new EmailMessage(html, MimeTypes.MIME_TEXT_HTML, encoding)); }