Package io.ebean.test.containers

Class CockroachContainer

java.lang.Object
io.ebean.test.containers.CockroachContainer
All Implemented Interfaces:
Container<CockroachContainer>
public class CockroachContainer extends Object
Commands for controlling a CockroachDB docker container.

  • Field Details

    • log

      protected static final System.Logger log

    • buildConfig

      protected final io.ebean.test.containers.BaseBuilder<?,?> buildConfig

    • config

      protected io.ebean.test.containers.InternalConfig config

    • commands

      protected final Commands commands

    • waitForConnectivityAttempts

      protected int waitForConnectivityAttempts

    • shutdownMode

      protected StopMode shutdownMode

    • usingContainerId

      protected boolean usingContainerId

    • usingRandomPort

      protected boolean usingRandomPort

    • removeOnExit

      protected boolean removeOnExit

  • Method Details

    • start

      public CockroachContainer start()
      Description copied from interface: Container
      Start and return the container.

      Throws an IllegalStateException if the container can not be started.

    • builder

      public static CockroachContainer.Builder builder(String version)
      Create a builder for CockroachContainer.

    • isDatabaseAdminReady

      protected boolean isDatabaseAdminReady()
      Return true when the database is ready to take admin commands.

    • isFastStartDatabaseExists

      protected boolean isFastStartDatabaseExists()

    • createDbPreConnectivity

      protected void createDbPreConnectivity()
      Create the database, schema and user via docker commands.

    • dropCreateDbPreConnectivity

      protected void dropCreateDbPreConnectivity()
      Drop and create the database, schema and user via docker commands.

    • createDatabase

      protected boolean createDatabase()

    • dropDatabaseIfExists

      protected boolean dropDatabaseIfExists()

    • isDatabaseReady

      public boolean isDatabaseReady()
      Wait for the 'database system is ready'

    • runProcess

      protected ProcessBuilder runProcess()
      Return the ProcessBuilder used to execute the container run command.

    • createDbPostConnectivity

      protected void createDbPostConnectivity()
      Create database, schema and user via JDBC .

    • dropCreateDbPostConnectivity

      protected void dropCreateDbPostConnectivity()
      Drop and create database, schema and user via JDBC .

    • startWithCreate

      public boolean startWithCreate()
      Start the container and wait for it to be ready.

      This checks if the container is already running.

      Returns false if the wait for ready was unsuccessful.

    • startWithDropCreate

      public boolean startWithDropCreate()
      Start with a drop and create of the database and user.

    • jdbcUrl

      public String jdbcUrl()
      Return the JDBC url to connect to this container.

    • createConnection

      public Connection createConnection() throws SQLException
      Create a connection to this database container.
      Throws:
      SQLException

    • startMaybe

      public boolean startMaybe()
      Description copied from interface: Container
      Start the container returning true if successful.
      Specified by:
      startMaybe in interface Container<C extends io.ebean.test.containers.DbContainer<C>>

    • startForMode

      protected boolean startForMode()
      Start with a mode of 'create', 'dropCreate' or 'container'.

      Expected that mode create will be best most of the time.

    • startContainerOnly

      public boolean startContainerOnly()
      Start the container only without creating database, user, extensions etc.

    • fastStart

      protected boolean fastStart()
      If we are using FastStartMode just check is the DB exists and if so assume it is all created correctly.

      This should only be used with Mode.Create and when the container is already running.

    • executeSqlFile

      protected void executeSqlFile(String dbUser, String dbName, String containerFilePath)

    • waitForDatabaseReady

      public boolean waitForDatabaseReady()
      Return true when the DB is ready for taking commands (like create database, user etc).

    • config

      public ContainerConfig config()
      Description copied from interface: Container
      Returns the container configuration.
      Specified by:
      config in interface Container<C extends Container<C>>

    • startOrThrow

      public void startOrThrow()
      Description copied from interface: Container
      Start the container or throw a IllegalStateException.
      Specified by:
      startOrThrow in interface Container<C extends Container<C>>

    • port

      public int port()
      Description copied from interface: Container
      Return the port this container is using.

      This is typically useful if the container was started with a random port and, we need to know what that port was.

      Specified by:
      port in interface Container<C extends Container<C>>

    • setDefaultContainerName

      protected void setDefaultContainerName()
      Set a default container name if not using random port.

    • isRunning

      public boolean isRunning()
      Description copied from interface: Container
      Return true if the container is running.
      Specified by:
      isRunning in interface Container<C extends Container<C>>

    • registerShutdownHook

      public void registerShutdownHook()
      Register a JVM Shutdown hook to stop the container with the given mode.

    • shutdownHook

      protected boolean shutdownHook(boolean started)

    • startWithConnectivity

      protected boolean startWithConnectivity()

    • stop

      public void stop()
      Stop using the configured stopMode of 'stop' or 'remove'.

      Remove additionally removes the container (expected use in build agents).

      Specified by:
      stop in interface Container<C extends Container<C>>

    • stopRemove

      public void stopRemove()
      Stop and remove the container effectively deleting the container.
      Specified by:
      stopRemove in interface Container<C extends Container<C>>

    • createProcessBuilder

      protected ProcessBuilder createProcessBuilder(List<String> args)

    • dockerRun

      protected List<String> dockerRun()

    • readUrlContent

      protected String readUrlContent(String url) throws IOException
      Return http GET content given the url.
      Throws:
      IOException