Class MailpitTestResourceProvider

java.lang.Object

io.micronaut.testresources.testcontainers.AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

io.micronaut.testresources.mailpit.MailpitTestResourceProvider

All Implemented Interfaces:

io.micronaut.core.order.Ordered, TestResourcesResolver, ToggableTestResourcesResolver

public class MailpitTestResourceProvider
extends AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

A test resource provider which will spawn a Mailpit test container.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MailpitTestResourceProvider.MailpitContainer	A Mailpit container with configured SMTP and UI container ports.

Nested classes/interfaces inherited from class AbstractTestContainersProvider

AbstractTestContainersProvider.ContainerCommand

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_IMAGE
static final String	DISPLAY_NAME
static final String	JAVAMAIL_SMTP_AUTH
static final String	JAVAMAIL_SMTP_HOST
static final String	JAVAMAIL_SMTP_PORT
static final String	JAVAMAIL_SMTP_STARTTLS
static final String	MAILPIT_API_URL
static final String	MAILPIT_UI_URL
static final String	SIMPLE_NAME

Fields inherited from interface io.micronaut.core.order.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Fields inherited from interface TestResourcesResolver

TEST_RESOURCES_PROPERTY

Constructor Summary

Constructors

Constructor	Description
MailpitTestResourceProvider()

Method Summary

Modifier and Type	Method	Description
protected MailpitTestResourceProvider.MailpitContainer	createContainer(org.testcontainers.utility.DockerImageName imageName, Map<String,Object> requestedProperties, Map<String,Object> testResourcesConfig)	Creates the test container.
protected String	getDefaultImageName()	Returns the default image name.
String	getDisplayName()	Returns a display name for a test resources resolver, used for debugging purposes.
List<String>	getRequiredProperties(String expression)	Returns the list of properties which should be read before resolving an expression: this can be used if the resolver itself needs some configuration properties.
List<String>	getResolvableProperties(Map<String, Collection<String>> propertyEntries, Map<String,Object> testResourcesConfig)	Returns the list of properties that this resolver is able to support.
protected String	getSimpleName()	Returns the name of the resource resolver, for example "kafka" or "mysql".
protected Optional<String>	resolveProperty(String propertyName, MailpitTestResourceProvider.MailpitContainer container)
protected Optional<String>	resolveWithoutContainer(String propertyName, Map<String,Object> properties, Map<String,Object> testResourcesConfig)	Lets a resolver provide a value for the requested property without triggering the creation of a test container.
protected boolean	shouldAnswer(String propertyName, Map<String,Object> requestedProperties, Map<String,Object> testResourcesConfig)	Determines if this resolver can resolve the requested property.

Methods inherited from class AbstractTestContainersProvider

configureContainer, executeInContainer, getContainerOwnerKey, getContainerQuery, getDefaultStartupTimeout, getName, getOrder, prepareContainer, resolve, resolveProperty, stringOrNull

Methods inherited from class Object

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

Methods inherited from interface TestResourcesResolver

getId, getRequiredPropertyEntries

Methods inherited from interface ToggableTestResourcesResolver

isEnabled

Field Details

JAVAMAIL_SMTP_HOST

public static final String JAVAMAIL_SMTP_HOST

See Also:

• Constant Field Values

JAVAMAIL_SMTP_PORT

public static final String JAVAMAIL_SMTP_PORT

See Also:

• Constant Field Values

JAVAMAIL_SMTP_AUTH

public static final String JAVAMAIL_SMTP_AUTH

See Also:

• Constant Field Values

JAVAMAIL_SMTP_STARTTLS

public static final String JAVAMAIL_SMTP_STARTTLS

See Also:

• Constant Field Values

MAILPIT_UI_URL

public static final String MAILPIT_UI_URL

See Also:

• Constant Field Values

MAILPIT_API_URL

public static final String MAILPIT_API_URL

See Also:

• Constant Field Values

DEFAULT_IMAGE

public static final String DEFAULT_IMAGE

See Also:

• Constant Field Values

DISPLAY_NAME

public static final String DISPLAY_NAME

See Also:

• Constant Field Values

SIMPLE_NAME

public static final String SIMPLE_NAME

See Also:

• Constant Field Values

Constructor Details

MailpitTestResourceProvider

public MailpitTestResourceProvider()

Method Details

getResolvableProperties

public List<String> getResolvableProperties(Map<String, Collection<String>> propertyEntries,
 Map<String,Object> testResourcesConfig)

Description copied from interface: TestResourcesResolver

Returns the list of properties that this resolver is able to support. The property entries map is a map which keys are the property entries retrieved from calling TestResourcesResolver.getRequiredPropertyEntries() and values are those property entries resolved.

Parameters:

propertyEntries - the property entries

testResourcesConfig - the test resources configuration

Returns:

the list of properties

getRequiredProperties

public List<String> getRequiredProperties(String expression)

Description copied from interface: TestResourcesResolver

Returns the list of properties which should be read before resolving an expression: this can be used if the resolver itself needs some configuration properties.

Parameters:

expression - the expression which needs to be resolved.

Returns:

the list of configuration properties this resolver requires

getDisplayName

public String getDisplayName()

Description copied from interface: TestResourcesResolver

Returns a display name for a test resources resolver, used for debugging purposes.

Returns:

the display name

createContainer

protected MailpitTestResourceProvider.MailpitContainer createContainer(org.testcontainers.utility.DockerImageName imageName,
 Map<String,Object> requestedProperties,
 Map<String,Object> testResourcesConfig)

Description copied from class: AbstractTestContainersProvider

Creates the test container.

Specified by:

createContainer in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

Parameters:

imageName - the docker image name

requestedProperties - the resolved properties

testResourcesConfig - the test resources configuration

Returns:

a container

resolveProperty

protected Optional<String> resolveProperty(String propertyName,
 MailpitTestResourceProvider.MailpitContainer container)

Specified by:

resolveProperty in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

getSimpleName

protected String getSimpleName()

Description copied from class: AbstractTestContainersProvider

Returns the name of the resource resolver, for example "kafka" or "mysql".

Specified by:

getSimpleName in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

Returns:

the name of the resolver

shouldAnswer

protected boolean shouldAnswer(String propertyName,
 Map<String,Object> requestedProperties,
 Map<String,Object> testResourcesConfig)

Description copied from class: AbstractTestContainersProvider

Determines if this resolver can resolve the requested property. It is used in order to make sure that a "Postgres" resolver wouldn't provide a value if the requested container type is for MySQL, for example.

Overrides:

shouldAnswer in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

Parameters:

propertyName - the property to resolve

requestedProperties - the resolved properties

testResourcesConfig - the test resources configuration

Returns:

if this resolver should answer

resolveWithoutContainer

protected Optional<String> resolveWithoutContainer(String propertyName,
 Map<String,Object> properties,
 Map<String,Object> testResourcesConfig)

Description copied from class: AbstractTestContainersProvider

Lets a resolver provide a value for the requested property without triggering the creation of a test container. This can be used in case a resolver wants to check existing containers first.

Overrides:

resolveWithoutContainer in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

Parameters:

propertyName - the name of the property to resolve

properties - the properties used to resolve

testResourcesConfig - the test resources configuration

Returns:

a resolved property

getDefaultImageName

protected String getDefaultImageName()

Description copied from class: AbstractTestContainersProvider

Returns the default image name.

Specified by:

getDefaultImageName in class AbstractTestContainersProvider<MailpitTestResourceProvider.MailpitContainer>

Returns:

the default image name.