Adding pause and unpause features.

src/main/java/com/amihaiemil/docker/Container.java

@@ -135,5 +135,21 @@ void remove(final boolean volumes, final boolean force, final boolean link)
      * @return Docker.
      */
     Docker docker();
+
+    /**
+     * Pause this container.
+     * @see <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerPause">Pause Container</a>
+     * @throws IOException If something goes wrong.
+     *  the expected one (204 NO CONTENT).
+     */
+    void pause() throws IOException;
+
+    /**
+     * Unpause this container.
+     * @see <a href="https://docs.docker.com/engine/api/v1.35/#operation/ContainerUnpause">Unpause Container</a>
+     * @throws IOException If something goes wrong.
+     *  the expected one (204 NO CONTENT).
+     */
+    void unpause() throws IOException;
 
 }

src/main/java/com/amihaiemil/docker/RtContainer.java

@@ -58,7 +58,7 @@ final class RtContainer extends JsonResource implements Container {
      * Docker API.
      */
     private final Docker docker;
-    
+
     /**
      * Ctor.
      * @param rep JsonObject representation of this Container.
@@ -188,16 +188,46 @@ public void remove(
             remove.releaseConnection();
         }
     }
-    
+
     @Override
     public Logs logs() {
         return new RtLogs(
             this, this.client, URI.create(this.baseUri.toString() + "/logs")
         );
     }
-    
+
     @Override
     public Docker docker() {
         return this.docker;
     }
+
+    @Override
+    public void pause() throws IOException {
+        final HttpPost pause = new HttpPost(
+                this.baseUri.toString() + "/pause"
+        );
+        try {
+            this.client.execute(
+                    pause,
+                    new MatchStatus(pause.getURI(), HttpStatus.SC_NO_CONTENT)
+            );
+        } finally {
+            pause.releaseConnection();
+        }
+    }
+
+    @Override
+    public void unpause() throws IOException {
+        final HttpPost unpause = new HttpPost(
+                this.baseUri.toString() + "/unpause"
+        );
+        try {
+            this.client.execute(
+                    unpause,
+                    new MatchStatus(unpause.getURI(), HttpStatus.SC_NO_CONTENT)
+            );
+        } finally {
+            unpause.releaseConnection();
+        }
+    }
 }

src/test/java/com/amihaiemil/docker/RtContainerITCase.java

@@ -42,7 +42,7 @@
  * @since 0.0.1
  */
 public final class RtContainerITCase {
-    
+
     /**
      * {@link RtContainer} can rename the Docker container it represents.
      * @throws Exception If something goes wrong.
@@ -139,6 +139,49 @@ private JsonObject containerJsonObject() {
         return json.build();
     }
 
+    /**
+     * {@link RtContainer} can pause Docker container it represents.
+     * @throws Exception If something goes wrong.
+     */
+    @Test
+    public void pauseContainer() throws Exception {
+        final Container container = new LocalDocker(
+                new File("/var/run/docker.sock")
+        ).containers().create("TestPause", this.containerJsonObject());
+        container.start();
+        container.pause();
+        MatcherAssert.assertThat(
+                this.pausedState(container),
+                new IsEqual<>(true)
+        );
+        container.stop();
+        container.remove();
+    }
+
+    /**
+     * {@link RtContainer} can unpause Docker container it represents.
+     * @throws Exception If something goes wrong.
+     */
+    @Test
+    public void unpauseContainer() throws Exception {
+        final Container container = new LocalDocker(
+                new File("/var/run/docker.sock")
+        ).containers().create("TestUnpause", this.containerJsonObject());
+        container.start();
+        container.pause();
+        MatcherAssert.assertThat(
+                this.pausedState(container),
+                new IsEqual<>(true)
+        );
+        container.unpause();
+        MatcherAssert.assertThat(
+                this.runningState(container),
+                new IsEqual<>(true)
+        );
+        container.stop();
+        container.remove();
+    }
+
     /**
      * Inspect Container and check running state.
      * @param container Docker Container.
@@ -150,4 +193,15 @@ private boolean runningState(final Container container) throws IOException {
             .getBoolean("Running");
     }
 
+    /**
+     * Inspect Container and check paused state.
+     * @param container Docker Container.
+     * @return Running state.
+     * @throws IOException If something goes wrong.
+     */
+    private boolean pausedState(final Container container) throws IOException {
+        return container.inspect().getJsonObject("State")
+                .getBoolean("Paused");
+    }
+
 }