jodd.mail

Class EmailAttachmentBuilder

java.lang.Object

jodd.mail.EmailAttachmentBuilder

public class EmailAttachmentBuilder
extends java.lang.Object

Helper class for convenient EmailAttachment creation.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EmailAttachmentBuilder() Only allow instantiation from EmailAttachment class

Method Summary

Modifier and Type	Method and Description
EmailAttachment<jakarta.mail.util.ByteArrayDataSource>	buildByteArrayDataSource() Creates EmailAttachment.
EmailAttachment<jakarta.activation.FileDataSource>	buildFileDataSource(java.lang.String messageId, java.io.File attachmentStorage) Creates EmailAttachment.
EmailAttachmentBuilder	content(byte[] bytes) Uses null contentType.
EmailAttachmentBuilder	content(byte[] bytes, java.lang.String contentType) Creates new ByteArrayDataSource and then calls content(DataSource).
EmailAttachmentBuilder	content(java.io.File file) Creates new FileDataSource and then calls content(DataSource)
EmailAttachmentBuilder	content(java.io.InputStream inputStream, java.lang.String contentType) Creates new ByteArrayDataSource and then calls content(DataSource).
EmailAttachmentBuilder	content(java.lang.String fileName)
<T extends jakarta.activation.DataSource> EmailAttachmentBuilder	content(T dataSource) Sets the DataSource.
EmailAttachmentBuilder	contentId(java.lang.String contentId) Sets content ID.
EmailAttachmentBuilder	embeddedMessage(EmailMessage targetMessage) Sets target EmailMessage.
EmailAttachmentBuilder	inline(boolean isInline) Sets whether EmailAttachment is inline.
EmailAttachmentBuilder	name(java.lang.String name) Sets file name.
protected java.lang.String	resolveContentType(java.lang.String contentType) Resolves content type from all data.
protected EmailAttachmentBuilder	setContentIdFromNameIfMissing() Set content ID if it is missing.

Methods inherited from class java.lang.Object

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

Constructor Detail

EmailAttachmentBuilder

protected EmailAttachmentBuilder()

Only allow instantiation from EmailAttachment class

Method Detail

name

public EmailAttachmentBuilder name(java.lang.String name)

Sets file name.

Parameters:

name - File name to set.

Returns:

this

contentId

public EmailAttachmentBuilder contentId(java.lang.String contentId)

Sets content ID.

Parameters:

contentId - content ID of EmailAttachment.

Returns:

this

inline

public EmailAttachmentBuilder inline(boolean isInline)

Sets whether EmailAttachment is inline.

Parameters:

isInline - true for inline.

Returns:

this

embeddedMessage

public EmailAttachmentBuilder embeddedMessage(EmailMessage targetMessage)

Sets target EmailMessage.

Parameters:

targetMessage - Target EmailMessage.

Returns:

this

content

public <T extends jakarta.activation.DataSource> EmailAttachmentBuilder content(T dataSource)

Sets the DataSource. Common DataSources include ByteArrayDataSource and FileDataSource.

Parameters:

dataSource - DataSource

Returns:

this

content

public EmailAttachmentBuilder content(java.io.InputStream inputStream,
                                      java.lang.String contentType)
                               throws java.io.IOException

Creates new ByteArrayDataSource and then calls content(DataSource).

Parameters:

inputStream - InputStream

contentType - content type from EmailAttachment.

Returns:

this

Throws:

java.io.IOException - if ByteArrayDataSource cannot be created from InputStream

See Also:

content(DataSource)

content

public EmailAttachmentBuilder content(byte[] bytes,
                                      java.lang.String contentType)

Creates new ByteArrayDataSource and then calls content(DataSource).

Parameters:

bytes - array of bytes

contentType - content type from EmailAttachment.

Returns:

this

See Also:

content(DataSource)

content

public EmailAttachmentBuilder content(byte[] bytes)

Uses null contentType.

See Also:

content(byte[], String)

content

public EmailAttachmentBuilder content(java.io.File file)

Creates new FileDataSource and then calls content(DataSource)

Parameters:

file - File

Returns:

this

See Also:

content(DataSource)

content

public EmailAttachmentBuilder content(java.lang.String fileName)

Parameters:

fileName - String representing file name.

Returns:

this

See Also:

content(File)

buildByteArrayDataSource

public EmailAttachment<jakarta.mail.util.ByteArrayDataSource> buildByteArrayDataSource()
                                                                                throws MailException

Creates EmailAttachment.

Returns:

EmailAttachment.

Throws:

MailException - if issue with DataSource.

buildFileDataSource

public EmailAttachment<jakarta.activation.FileDataSource> buildFileDataSource(java.lang.String messageId,
                                                                              java.io.File attachmentStorage)
                                                                       throws MailException

Creates EmailAttachment.

Returns:

EmailAttachment.

Throws:

MailException - if issue with DataSource.

setContentIdFromNameIfMissing

protected EmailAttachmentBuilder setContentIdFromNameIfMissing()

Set content ID if it is missing.

Returns:

this

See Also:

contentId(String)

resolveContentType

protected java.lang.String resolveContentType(java.lang.String contentType)

Resolves content type from all data.

Parameters:

contentType - Content type if we know it. null is fine to use.

Returns:

content type