com.googlecode.kevinarpe.papaya.java_mail

Class EmailMessageTextAttachmentBuilderImp

java.lang.Object

com.googlecode.kevinarpe.papaya.java_mail.EmailMessageTextAttachmentBuilderImp

All Implemented Interfaces:

EmailMessageTextAttachmentBuilder

@FullyTested
public final class EmailMessageTextAttachmentBuilderImp
extends Object
implements EmailMessageTextAttachmentBuilder

Author:

Kevin Connor ARPE (kevinarpe@gmail.com) See: EmailMessageBuilderImpTest

See Also:

JavaMailSessionBuilderFactory.INSTANCE

Constructor Summary

Constructors

Constructor and Description
EmailMessageTextAttachmentBuilderImp(EmailMessageBuilder parentBuilder)

Method Summary

Modifier and Type	Method and Description
EmailMessageTextAttachmentBuilder	attachmentFileName(String attachmentFileName) This is the most common attachment type.
EmailMessageTextAttachmentBuilder	attachText(String text, EmailMessageAttachmentTextNewLine newLine, IsEmptyAllowed isEmptyAllowed) Converts text new-lines (if necessary), then adds new attachment to the parent builder.
EmailMessageTextAttachmentBuilder	attachTextFile(File filePath, Charset fileCharset, EmailMessageAttachmentTextNewLine newLine, IsEmptyAllowed isEmptyAllowed) Immediately reads the contents of the file as text, converts text new-lines (if necessary), then adds new attachment to the parent builder.
EmailMessageTextAttachmentBuilder	attachTextInputStream(InputStream inputStream, Charset inputStreamCharset, EmailMessageAttachmentTextNewLine newLine, IsEmptyAllowed isEmptyAllowed) Immediately reads the contents of the InputStream as text, converts text new-lines (if necessary), then adds new attachment to the parent builder.
EmailMessageTextAttachmentBuilder	customTextMimeSubType(String customTextMimeSubType) RARE: Sets the text MIME sub-type to a custom value.
EmailMessageTextAttachmentBuilder	inline() RARE: Sets the attachment type to EmailMessageAttachmentType.INLINE and clears the attachment file name.
EmailMessageBuilder	parent() Access the parent email message builder
EmailMessageTextAttachmentBuilder	textMimeSubType(TextMimeSubType textMimeSubType) Sets the text MIME sub-type to a common value -- text or plain.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EmailMessageTextAttachmentBuilderImp

public EmailMessageTextAttachmentBuilderImp(EmailMessageBuilder parentBuilder)

Method Detail

parent

public EmailMessageBuilder parent()

Access the parent email message builder

Specified by:

parent in interface EmailMessageTextAttachmentBuilder

attachmentFileName

public EmailMessageTextAttachmentBuilder attachmentFileName(String attachmentFileName)

This is the most common attachment type.

Sets the attachment type to EmailMessageAttachmentType.ATTACHMENT and sets the attachment file name.

Specified by:

attachmentFileName in interface EmailMessageTextAttachmentBuilder

Parameters:

attachmentFileName - only a file name -- does not include a parent path
Ex: "log.txt"

Returns:

self for fluent interface / method chaining

See Also:

EmailMessageTextAttachmentBuilder.inline()

inline

public EmailMessageTextAttachmentBuilder inline()

RARE: Sets the attachment type to EmailMessageAttachmentType.INLINE and clears the attachment file name.

Specified by:

inline in interface EmailMessageTextAttachmentBuilder

Returns:

self for fluent interface / method chaining

See Also:

EmailMessageTextAttachmentBuilder.attachmentFileName(String)

textMimeSubType

public EmailMessageTextAttachmentBuilder textMimeSubType(TextMimeSubType textMimeSubType)

Sets the text MIME sub-type to a common value -- text or plain.

For custom types, see: EmailMessageTextAttachmentBuilder.customTextMimeSubType(String).

Specified by:

textMimeSubType in interface EmailMessageTextAttachmentBuilder

Returns:

self for fluent interface / method chaining

See Also:

EmailMessageTextAttachmentBuilder.customTextMimeSubType(String)

customTextMimeSubType

public EmailMessageTextAttachmentBuilder customTextMimeSubType(String customTextMimeSubType)

RARE: Sets the text MIME sub-type to a custom value.

For common types, see EmailMessageTextAttachmentBuilder.textMimeSubType(TextMimeSubType).

Specified by:

customTextMimeSubType in interface EmailMessageTextAttachmentBuilder

Returns:

self for fluent interface / method chaining

See Also:

EmailMessageTextAttachmentBuilder.textMimeSubType(TextMimeSubType)

attachTextFile

public EmailMessageTextAttachmentBuilder attachTextFile(File filePath,
                                                        Charset fileCharset,
                                                        EmailMessageAttachmentTextNewLine newLine,
                                                        IsEmptyAllowed isEmptyAllowed)
                                                 throws Exception

Immediately reads the contents of the file as text, converts text new-lines (if necessary), then adds new attachment to the parent builder.

Implementation note: Regardless of fileCharset, the text is always re-encoded using StandardCharsets.UTF_8 before attachment. Why? In 2020, everything should be UTF-8!

Specified by:

attachTextFile in interface EmailMessageTextAttachmentBuilder

Parameters:

filePath - path to file with text

fileCharset - charset used to read text from filePath

newLine - for internal emails at large corporations, EmailMessageAttachmentTextNewLine.WINDOWS is probably most friendly towards Microsoft Windows and Microsoft Outlook users
When EmailMessageTextAttachmentBuilder.inline() is used, this option may be irrelevant. Multiple tests showed the new-lines for inline text on received emails to always be Microsoft Windows new-lines.

isEmptyAllowed - normally, use IsEmptyAllowed.NO

Returns:

self for fluent interface / method chaining

Throws:

Exception - on I/O exception
if isEmptyAllowed is IsEmptyAllowed.NO and the file is empty

See Also:

EmailMessageTextAttachmentBuilder.attachTextInputStream(InputStream, Charset, EmailMessageAttachmentTextNewLine, IsEmptyAllowed), EmailMessageTextAttachmentBuilder.attachText(String, EmailMessageAttachmentTextNewLine, IsEmptyAllowed)

attachTextInputStream

public EmailMessageTextAttachmentBuilder attachTextInputStream(InputStream inputStream,
                                                               Charset inputStreamCharset,
                                                               EmailMessageAttachmentTextNewLine newLine,
                                                               IsEmptyAllowed isEmptyAllowed)
                                                        throws Exception

Immediately reads the contents of the InputStream as text, converts text new-lines (if necessary), then adds new attachment to the parent builder.

Implementation note: Regardless of fileCharset, the text is always re-encoded using StandardCharsets.UTF_8 before attachment. Why? In 2020, everything should be UTF-8!

Specified by:

attachTextInputStream in interface EmailMessageTextAttachmentBuilder

Parameters:

inputStream - unlike most Java APIs, the input stream is closed after reading. This is the source or many hidden bugs!
See: InputStream.close()

inputStreamCharset - charset used to read text from inputStream

newLine - for internal emails at large corporations, EmailMessageAttachmentTextNewLine.WINDOWS is probably most friendly towards Microsoft Windows and Microsoft Outlook users
When EmailMessageTextAttachmentBuilder.inline() is used, this option may be irrelevant. Multiple tests showed the new-lines for inline text on received emails to always be Microsoft Windows new-lines.

isEmptyAllowed - normally, use IsEmptyAllowed.NO

Returns:

self for fluent interface / method chaining

Throws:

Exception - on I/O exception
if isEmptyAllowed is IsEmptyAllowed.NO and inputStream is empty

See Also:

EmailMessageTextAttachmentBuilder.attachTextFile(File, Charset, EmailMessageAttachmentTextNewLine, IsEmptyAllowed), EmailMessageTextAttachmentBuilder.attachText(String, EmailMessageAttachmentTextNewLine, IsEmptyAllowed)

attachText

public EmailMessageTextAttachmentBuilder attachText(String text,
                                                    EmailMessageAttachmentTextNewLine newLine,
                                                    IsEmptyAllowed isEmptyAllowed)

Converts text new-lines (if necessary), then adds new attachment to the parent builder.

Implementation note: Regardless of fileCharset, the text is always re-encoded using StandardCharsets.UTF_8 before attachment. Why? In 2020, everything should be UTF-8!

Specified by:

attachText in interface EmailMessageTextAttachmentBuilder

Parameters:

text - text for attachment

newLine - for internal emails at large corporations, EmailMessageAttachmentTextNewLine.WINDOWS is probably most friendly towards Microsoft Windows and Microsoft Outlook users
When EmailMessageTextAttachmentBuilder.inline() is used, this option may be irrelevant. Multiple tests showed the new-lines for inline text on received emails to always be Microsoft Windows new-lines.

isEmptyAllowed - normally, use IsEmptyAllowed.NO

Returns:

self for fluent interface / method chaining

See Also:

EmailMessageTextAttachmentBuilder.attachTextFile(File, Charset, EmailMessageAttachmentTextNewLine, IsEmptyAllowed), EmailMessageTextAttachmentBuilder.attachTextInputStream(InputStream, Charset, EmailMessageAttachmentTextNewLine, IsEmptyAllowed)