org.testcontainers.containers

Interface ContainerState

All Known Subinterfaces:

Container<SELF>, WaitStrategyTarget

All Known Implementing Classes:

FixedHostPortGenericContainer, GenericContainer, SocatContainer, VncRecordingContainer

public interface ContainerState

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	STATE_HEALTHY

Method Summary

Modifier and Type	Method and Description
default void	copyFileFromContainer(java.lang.String containerPath, java.lang.String destinationPath) Copies a file which resides inside the container to user defined directory
default <T> T	copyFileFromContainer(java.lang.String containerPath, ThrowingFunction<java.io.InputStream,T> function) Streams a file which resides inside the container
default void	copyFileToContainer(MountableFile mountableFile, java.lang.String containerPath) Copies a file or directory to the container.
default void	copyFileToContainer(Transferable transferable, java.lang.String containerPath) Copies a file to the container.
default Container.ExecResult	execInContainer(java.nio.charset.Charset outputCharset, java.lang.String... command) Run a command inside a running container, as though using "docker exec".
default Container.ExecResult	execInContainer(java.lang.String... command) Run a command inside a running container, as though using "docker exec", and interpreting the output as UTF8.
default java.util.List<java.lang.Integer>	getBoundPortNumbers()
default java.lang.String	getContainerId()
com.github.dockerjava.api.command.InspectContainerResponse	getContainerInfo()
default java.lang.String	getContainerIpAddress() Get the IP address that this container may be reached on (may not be the local machine).
default com.github.dockerjava.api.command.InspectContainerResponse	getCurrentContainerInfo()
java.util.List<java.lang.Integer>	getExposedPorts()
default java.lang.Integer	getFirstMappedPort() Get the actual mapped port for a first port exposed by the container.
default java.lang.String	getHost() Get the host that this container may be reached on (may not be the local machine).
default java.lang.String	getLogs()
default java.lang.String	getLogs(OutputFrame.OutputType... types)
default java.lang.Integer	getMappedPort(int originalPort) Get the actual mapped port for a given port exposed by the container.
default java.util.List<java.lang.String>	getPortBindings()
default boolean	isCreated()
default boolean	isHealthy()
default boolean	isRunning()

Field Detail

STATE_HEALTHY

static final java.lang.String STATE_HEALTHY

See Also:

Constant Field Values

Method Detail

getContainerIpAddress

default java.lang.String getContainerIpAddress()

Get the IP address that this container may be reached on (may not be the local machine).

Returns:

an IP address

See Also:

getHost()

getHost

default java.lang.String getHost()

Get the host that this container may be reached on (may not be the local machine).

Returns:

a host

isRunning

default boolean isRunning()

Returns:

is the container currently running?

isCreated

default boolean isCreated()

Returns:

is the container created?

isHealthy

default boolean isHealthy()

Returns:

has the container health state 'healthy'?

getCurrentContainerInfo

default com.github.dockerjava.api.command.InspectContainerResponse getCurrentContainerInfo()

getFirstMappedPort

default java.lang.Integer getFirstMappedPort()

Get the actual mapped port for a first port exposed by the container. Should be used in conjunction with getHost().

Returns:

the port that the exposed port is mapped to

Throws:

java.lang.IllegalStateException - if there are no exposed ports

getMappedPort

default java.lang.Integer getMappedPort(int originalPort)

Get the actual mapped port for a given port exposed by the container. Should be used in conjunction with getHost().

Parameters:

originalPort - the original TCP port that is exposed

Returns:

the port that the exposed port is mapped to, or null if it is not exposed

getExposedPorts

java.util.List<java.lang.Integer> getExposedPorts()

Returns:

the exposed ports

getPortBindings

default java.util.List<java.lang.String> getPortBindings()

Returns:

the port bindings

getBoundPortNumbers

default java.util.List<java.lang.Integer> getBoundPortNumbers()

Returns:

the bound port numbers

getLogs

default java.lang.String getLogs()

Returns:

all log output from the container from start until the current instant (both stdout and stderr)

getLogs

default java.lang.String getLogs(OutputFrame.OutputType... types)

Parameters:

types - log types to return

Returns:

all log output from the container from start until the current instant

getContainerId

default java.lang.String getContainerId()

Returns:

the id of the container

getContainerInfo

com.github.dockerjava.api.command.InspectContainerResponse getContainerInfo()

Returns:

the container info

execInContainer

default Container.ExecResult execInContainer(java.lang.String... command)
                                      throws java.lang.UnsupportedOperationException,
                                             java.io.IOException,
                                             java.lang.InterruptedException

Run a command inside a running container, as though using "docker exec", and interpreting the output as UTF8.

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

java.lang.InterruptedException

See Also:

ExecInContainerPattern.execInContainer(com.github.dockerjava.api.command.InspectContainerResponse, String...)

execInContainer

default Container.ExecResult execInContainer(java.nio.charset.Charset outputCharset,
                                             java.lang.String... command)
                                      throws java.lang.UnsupportedOperationException,
                                             java.io.IOException,
                                             java.lang.InterruptedException

Run a command inside a running container, as though using "docker exec".

Throws:

java.lang.UnsupportedOperationException

java.io.IOException

java.lang.InterruptedException

See Also:

ExecInContainerPattern.execInContainer(com.github.dockerjava.api.command.InspectContainerResponse, Charset, String...)

copyFileToContainer

default void copyFileToContainer(MountableFile mountableFile,
                                 java.lang.String containerPath)

Copies a file or directory to the container.

Parameters:

mountableFile - file or directory which is copied into the container

containerPath - destination path inside the container

copyFileToContainer

default void copyFileToContainer(Transferable transferable,
                                 java.lang.String containerPath)

Copies a file to the container.

Parameters:

transferable - file which is copied into the container

containerPath - destination path inside the container

copyFileFromContainer

default void copyFileFromContainer(java.lang.String containerPath,
                                   java.lang.String destinationPath)
                            throws java.io.IOException,
                                   java.lang.InterruptedException

Copies a file which resides inside the container to user defined directory

Parameters:

containerPath - path to file which is copied from container

destinationPath - destination path to which file is copied with file name

Throws:

java.io.IOException - if there's an issue communicating with Docker or receiving entry from TarArchiveInputStream

java.lang.InterruptedException - if the thread waiting for the response is interrupted

copyFileFromContainer

default <T> T copyFileFromContainer(java.lang.String containerPath,
                                    ThrowingFunction<java.io.InputStream,T> function)

Streams a file which resides inside the container

Parameters:

containerPath - path to file which is copied from container

function - function that takes InputStream of the copied file