org.testcontainers.containers

Class Neo4jContainer<S extends Neo4jContainer<S>>

java.lang.Object

org.testcontainers.containers.FailureDetectingExternalResource

org.testcontainers.containers.GenericContainer<S>

org.testcontainers.containers.Neo4jContainer<S>

Type Parameters:

S - "SELF" to be used in the withXXX methods.

All Implemented Interfaces:

java.lang.AutoCloseable, org.junit.rules.TestRule, org.testcontainers.containers.Container<S>, org.testcontainers.containers.ContainerState, org.testcontainers.containers.traits.LinkableContainer, org.testcontainers.containers.wait.strategy.WaitStrategyTarget, org.testcontainers.lifecycle.Startable

public class Neo4jContainer<S extends Neo4jContainer<S>>
extends org.testcontainers.containers.GenericContainer<S>

Testcontainer for Neo4j.

Nested Class Summary

Nested classes/interfaces inherited from class org.testcontainers.containers.GenericContainer

org.testcontainers.containers.GenericContainer.AbstractWaitStrategy

Nested classes/interfaces inherited from interface org.testcontainers.containers.Container

org.testcontainers.containers.Container.ExecResult

Field Summary

Fields inherited from class org.testcontainers.containers.GenericContainer

CONTAINER_RUNNING_TIMEOUT_SEC, containerId, containerName, dependencies, dockerClient, dockerDaemonInfo, INTERNAL_HOST_HOSTNAME, waitStrategy

Fields inherited from interface org.testcontainers.containers.ContainerState

STATE_HEALTHY

Constructor Summary

Constructors

Constructor and Description
Neo4jContainer() Creates a Testcontainer using the official Neo4j docker image.
Neo4jContainer(java.lang.String dockerImageName) Creates a Testcontainer using a specific docker image.

Method Summary

Modifier and Type	Method and Description
protected void	configure()
java.lang.String	getAdminPassword()
java.lang.String	getBoltUrl()
java.lang.String	getHttpsUrl()
java.lang.String	getHttpUrl()
java.util.Set<java.lang.Integer>	getLivenessCheckPortNumbers()
S	withAdminPassword(java.lang.String adminPassword) Sets the admin password for the default account (which is
S	withDatabase(org.testcontainers.utility.MountableFile graphDb) Copies an existing graph.db folder into the container.
S	withEnterpriseEdition() Configures the container to use the enterprise edition of the default docker image.
S	withNeo4jConfig(java.lang.String key, java.lang.String value) Adds Neo4j configuration properties to the container.
S	withoutAuthentication() Disables authentication.
S	withPlugins(org.testcontainers.utility.MountableFile plugins) Adds plugins to the given directory to the container.

Methods inherited from class org.testcontainers.containers.GenericContainer

addEnv, addExposedPort, addExposedPorts, addFileSystemBind, addFixedExposedPort, addFixedExposedPort, addLink, apply, canBeReused, containerIsCreated, containerIsStarted, containerIsStarted, containerIsStarting, containerIsStarting, containerIsStopped, containerIsStopping, copyFileFromContainer, createVolumeDirectory, dependsOn, dependsOn, doStart, equals, failed, fetchDockerDaemonInfo, finished, getBinds, getCommandParts, getContainerId, getContainerInfo, getContainerName, getCopyToFileContainerPathMap, getCreateContainerCmdModifiers, getDependencies, getDockerClient, getDockerDaemonInfo, getDockerImageName, getEnv, getEnvMap, getExposedPorts, getExtraHosts, getImage, getIpAddress, getLabels, getLinkedContainers, getLivenessCheckPort, getLivenessCheckPorts, getLogConsumers, getNetwork, getNetworkAliases, getNetworkMode, getPortBindings, getShmSize, getStartupAttempts, getStartupCheckStrategy, getTestHostIpAddress, getTmpFsMapping, getVolumesFroms, getWaitStrategy, getWorkingDirectory, hashCode, isPrivilegedMode, isShouldBeReused, logger, setBinds, setCommand, setCommand, setCommandParts, setCopyToFileContainerPathMap, setDockerImageName, setEnv, setExposedPorts, setExtraHosts, setImage, setLabels, setLinkedContainers, setLogConsumers, setNetwork, setNetworkAliases, setNetworkMode, setPortBindings, setPrivilegedMode, setShmSize, setStartupAttempts, setStartupCheckStrategy, setTmpFsMapping, setVolumesFroms, setWaitStrategy, setWorkingDirectory, start, starting, stop, succeeded, toString, waitingFor, waitUntilContainerStarted, withClasspathResourceMapping, withClasspathResourceMapping, withCommand, withCommand, withCopyFileToContainer, withCreateContainerCmdModifier, withEnv, withEnv, withExposedPorts, withExtraHost, withFileSystemBind, withImagePullPolicy, withLabel, withLabels, withLogConsumer, withMinimumRunningDuration, withNetwork, withNetworkAliases, withNetworkMode, withPrivilegedMode, withReuse, withSharedMemorySize, withStartupAttempts, withStartupCheckStrategy, withStartupTimeout, withTmpFs, withVolumesFrom, withWorkingDirectory

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.testcontainers.containers.Container

addFileSystemBind, followOutput, followOutput, self, withEnv, withFileSystemBind

Methods inherited from interface org.testcontainers.containers.ContainerState

copyFileFromContainer, copyFileToContainer, copyFileToContainer, execInContainer, execInContainer, getBoundPortNumbers, getContainerIpAddress, getCurrentContainerInfo, getFirstMappedPort, getLogs, getLogs, getMappedPort, isCreated, isHealthy, isRunning

Methods inherited from interface org.testcontainers.lifecycle.Startable

close

Constructor Detail

Neo4jContainer

public Neo4jContainer()

Creates a Testcontainer using the official Neo4j docker image.

Neo4jContainer

public Neo4jContainer(java.lang.String dockerImageName)

Creates a Testcontainer using a specific docker image.

Parameters:

dockerImageName - The docker image to use.

Method Detail

getLivenessCheckPortNumbers

public java.util.Set<java.lang.Integer> getLivenessCheckPortNumbers()

Specified by:

getLivenessCheckPortNumbers in interface org.testcontainers.containers.wait.strategy.WaitStrategyTarget

Overrides:

getLivenessCheckPortNumbers in class org.testcontainers.containers.GenericContainer<S extends Neo4jContainer<S>>

configure

protected void configure()

Overrides:

configure in class org.testcontainers.containers.GenericContainer<S extends Neo4jContainer<S>>

getBoltUrl

public java.lang.String getBoltUrl()

Returns:

Bolt URL for use with Neo4j's Java-Driver.

getHttpUrl

public java.lang.String getHttpUrl()

Returns:

URL of the transactional HTTP endpoint.

getHttpsUrl

public java.lang.String getHttpsUrl()

Returns:

URL of the transactional HTTPS endpoint.

withEnterpriseEdition

public S withEnterpriseEdition()

Configures the container to use the enterprise edition of the default docker image.

Please have a look at the Neo4j Licensing page. While the Neo4j Community Edition can be used for free in your projects under the GPL v3 license, Neo4j Enterprise edition needs either a commercial, education or evaluation license.

Returns:

This container.

withAdminPassword

public S withAdminPassword(java.lang.String adminPassword)

Sets the admin password for the default account (which is

neo4j

). A null value or an empty string disables authentication.

Parameters:

adminPassword - The admin password for the default database account.

Returns:

This container.

withoutAuthentication

public S withoutAuthentication()

Disables authentication.

Returns:

This container.

withDatabase

public S withDatabase(org.testcontainers.utility.MountableFile graphDb)

Copies an existing graph.db folder into the container. This can either be a classpath resource or a host resource. Please have a look at the factory methods in MountableFile.
If you want to map your database into the container instead of copying them, please use #withClasspathResourceMapping, but this will only work when your test does not run in a container itself.
Mapping would work like this:

      @Container
      private static final Neo4jContainer databaseServer = new Neo4jContainer<>()
          .withClasspathResourceMapping("/test-graph.db", "/data/databases/graph.db", BindMode.READ_WRITE);
 

Parameters:

graphDb - The graph.db folder to copy into the container

Returns:

This container.

withPlugins

public S withPlugins(org.testcontainers.utility.MountableFile plugins)

Adds plugins to the given directory to the container. If plugins denotes a directory, than all of that directory is mapped to Neo4j's plugins. Otherwise, single resources are copied over.
If you want to map your plugins into the container instead of copying them, please use #withClasspathResourceMapping, but this will only work when your test does not run in a container itself.

Parameters:

plugins -

Returns:

This container.

withNeo4jConfig

public S withNeo4jConfig(java.lang.String key,
                         java.lang.String value)

Adds Neo4j configuration properties to the container. The properties can be added as in the official Neo4j configuration, the method automatically translate them into the format required by the Neo4j container.

Parameters:

key - The key to configure, i.e. dbms.security.procedures.unrestricted

value - The value to set

Returns:

This container.

getAdminPassword

public java.lang.String getAdminPassword()

Returns:

The admin password for the neo4j account or literal null if auth is disabled.