Class FlociContainer

java.lang.Object
io.ebean.test.containers.FlociContainer
All Implemented Interfaces:
Container<FlociContainer>
public class FlociContainer extends Object
Floci container that supports AWS SDK v2. 

    FlociContainer container = FlociContainer.builder("latest")
      // .port(4566)
      // .image("hectorvent/floci:latest")
      .build();

    container.start();

    AwsSDKv2 sdk = container.sdk2();
    var amazonDynamoDB = sdk.dynamoDBClient();
    createTable(amazonDynamoDB);

  • Field Details

    • 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

  • Constructor Details

    • FlociContainer

      public FlociContainer(FlociContainer.Builder builder)
      Create the container using the given config.

  • Method Details

    • start

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

      Throws an IllegalStateException if the container can not be started.

    • builder

      public static FlociContainer.Builder builder(String version)
      Create a builder for FlociContainer given the Floci image version.

    • sdk

      public AwsSDKv2 sdk()
      Return the AWS v2 SDK compatible helper that provides API for DynamoDB client, SnsClient, SqsClient etc.

    • sdk2

      public AwsSDKv2 sdk2()
      Return the AWS v2 SDK compatible helper that provides API for DynamoDB client, SnsClient, SqsClient etc.

    • endpoint

      public URI endpoint()
      Return the endpoint as URI.

    • endpointUrl

      public String endpointUrl()
      Return the endpoint as String.

    • awsRegion

      public String awsRegion()
      Return the AWS region.

    • runProcess

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

    • config

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

    • startMaybe

      public boolean startMaybe()
      Description copied from interface: Container
      Start the container returning true if successful.
      Specified by:
      startMaybe 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