Containers API

Containers API:

final Docker docker = ...;
final Containers containers = docker.containers();

• Iterate Running Containers
• Iterate All Containers
• Multiple Create Methods
• Filter Containers

Iterate Running Containers

You can iterate over all of the running containers like this:

for(final Container running : containers) {
//...
}

Iterate All Containers

You can iterate over all containers like this:

for(final Container running : containers.all()) {
//...
}

Multiple Create Methods

You can create a Container by giving it the image's String name or by giving it a whole JsonObject config object while specifying a name for it or not.

final Container c1 = containers.create("hello-world")
final Container c2 = containers.create("containerName", "hello-world")
final Container c3 = containers.create(JsonObject)
final Container c4 = containers.create("containerName", JsonObject)

Of course, if you need a running Container, a more elegant solution is to use the Images API to pull an Image and run the container from it:

final Image img = ...;
final Container container = img.run();

Filter Containers

You can use the filter(Map) method to filter the Containers:

final Containers original = docker.containers;
final Containers filtered = original.filter(...);//multiple calls to filter will use all specified filters.
for(final Container ctn : filtered.all()) {
    //filtered containers here
}