Package net.bugreaper.modules.email

Class Email.EmailBuilder

java.lang.Object

net.bugreaper.modules.email.allure.AllureStepBuilder<Email.EmailBuilder>

net.bugreaper.modules.email.Email.EmailBuilder

All Implemented Interfaces:

EmailBuilderInt

Enclosing class:

Email

public static class Email.EmailBuilder
extends AllureStepBuilder<Email.EmailBuilder>
implements EmailBuilderInt

Fluent builder for constructing complex emails.

Supports:

• Multiple attachments
• Multiple To, Cc. Bcc, ReplyTo
• Custom headers or tags

Constructor Summary

Constructors

Constructor	Description
EmailBuilder(jakarta.mail.Session session, String subject, String body)

Method Summary

Modifier and Type	Method	Description
Email.EmailBuilder	addAttach(String name, String filePath)	Adds an attachment using automatic content type detection.
Email.EmailBuilder	addBcc(String email)	Adds a "BCC" (blind carbon copy) recipient.
Email.EmailBuilder	addCc(String email)	Adds a "CC" (carbon copy) recipient.
Email.EmailBuilder	addHeader(String key, String value)	Adds a custom header in <key> format.
Email.EmailBuilder	addReplyTo(String email)	Adds a "Reply-To" address.
Email.EmailBuilder	addTags(String tag)	Adds a tag to the aggregated X-Tags header.
Email.EmailBuilder	addTo(String email)	Adds a "TO" recipient.
void	send()	Builds and sends the email.
Email.EmailBuilder	setFrom(String email)	Set a "FROM" sender.

Methods inherited from class net.bugreaper.modules.email.allure.AllureStepBuilder

startStep, step, stopStepFailed, stopStepSuccess

Methods inherited from class java.lang.Object

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

Constructor Details

EmailBuilder

public EmailBuilder(jakarta.mail.Session session,
 String subject,
 String body)

Method Details

setFrom

public Email.EmailBuilder setFrom(String email)

Description copied from interface: EmailBuilderInt

Set a "FROM" sender.

Specified by:

setFrom in interface EmailBuilderInt

Parameters:

email - sender email address

Returns:

this builder instance for chaining

addTo

public Email.EmailBuilder addTo(String email)

Description copied from interface: EmailBuilderInt

Adds a "TO" recipient.

This method can be called multiple times to add multiple recipients.

Specified by:

addTo in interface EmailBuilderInt

Parameters:

email - recipient email address

Returns:

this builder instance for chaining

addCc

public Email.EmailBuilder addCc(String email)

Description copied from interface: EmailBuilderInt

Adds a "CC" (carbon copy) recipient.

CC recipients are visible to all other recipients.

This method can be called multiple times to add multiple carbon copies.

Specified by:

addCc in interface EmailBuilderInt

Parameters:

email - CC email address

Returns:

this builder instance for chaining

addBcc

public Email.EmailBuilder addBcc(String email)

Description copied from interface: EmailBuilderInt

Adds a "BCC" (blind carbon copy) recipient.

BCC recipients are hidden from other recipients.

This method can be called multiple times to add multiple blind carbon copies.

Specified by:

addBcc in interface EmailBuilderInt

Parameters:

email - BCC email address

Returns:

this builder instance for chaining

addReplyTo

public Email.EmailBuilder addReplyTo(String email)

Description copied from interface: EmailBuilderInt

Adds a "Reply-To" address.

If multiple addresses are added, all will be included in the Reply-To header.

Specified by:

addReplyTo in interface EmailBuilderInt

Parameters:

email - reply-to email address

Returns:

this builder instance for chaining

addAttach

public Email.EmailBuilder addAttach(String name,
 String filePath)

Description copied from interface: EmailBuilderInt

Adds an attachment using automatic content type detection.

Specified by:

addAttach in interface EmailBuilderInt

Parameters:

name - file name as it will appear in the email

filePath - path to the file in test resources

Returns:

this builder instance for chaining

addTags

public Email.EmailBuilder addTags(String tag)

Description copied from interface: EmailBuilderInt

Adds a tag to the aggregated X-Tags header.

Multiple calls will accumulate values into a single header:

 X-Tags: tag1,tag2,tag3
 

Specified by:

addTags in interface EmailBuilderInt

Parameters:

tag - tag value

Returns:

this builder instance for chaining

addHeader

public Email.EmailBuilder addHeader(String key,
 String value)

Description copied from interface: EmailBuilderInt

Adds a custom header in <key> format.

Example:

 addHeader("X-env", "qa") → X-env: qa
 

Specified by:

addHeader in interface EmailBuilderInt

Parameters:

key - header key

value - header value

Returns:

this builder instance for chaining

send

public void send()

Description copied from interface: EmailBuilderInt

Builds and sends the email.

Specified by:

send in interface EmailBuilderInt