[Android] Add a Java version of net::test_server::EmbeddedTestServer.

net/test/android/javatests/src/org/chromium/net/test/EmbeddedTestServer.java

Index: net/test/android/javatests/src/org/chromium/net/test/EmbeddedTestServer.java
diff --git a/net/test/android/javatests/src/org/chromium/net/test/EmbeddedTestServer.java b/net/test/android/javatests/src/org/chromium/net/test/EmbeddedTestServer.java
new file mode 100644
index 0000000000000000000000000000000000000000..06ab79e6e4ced09ddfe856c000a0f00997c29f44
--- /dev/null
+++ b/net/test/android/javatests/src/org/chromium/net/test/EmbeddedTestServer.java
@@ -0,0 +1,111 @@
+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package org.chromium.net.test;
+
+import org.chromium.base.CalledByNative;
+import org.chromium.base.JNINamespace;
+
+import java.io.File;
+
+/**
+ * Java bindings for the native embedded test server.
+ *
+ * An example use:
+ *   EmbeddedTestServer s = new EmbeddedTestServer();
+ *   s.initializeNative();
+ *   s.serveFilesFromDirectory("/path/to/my/directory");
+ *   if (!s.initializeAndWaitUntilReady()) {
+ *       throw new SomeKindOfException("Unable to initialize EmbeddedTestServer.");
+ *   }
+ *
+ *   // serve requests...
+ *
+ *   s.shutdownAndWait();
+ *   s.destroy();
+ */
+@JNINamespace("net::test_server")
+public class EmbeddedTestServer {
+    private long mNativeEmbeddedTestServer;
+
+    /** Create an uninitialized EmbeddedTestServer. */
+    public EmbeddedTestServer() {}
+
+    /** Initialize the native EmbeddedTestServer object. */
+    public void initializeNative() {
+        if (mNativeEmbeddedTestServer == 0) nativeInit();
+        assert mNativeEmbeddedTestServer != 0;
+    }
+
+    /** Serve files from the provided directory.
+     *
+     *  @param directory The directory from which files should be served.
+     */
+    public void serveFilesFromDirectory(File directory) {
+        nativeServeFilesFromDirectory(mNativeEmbeddedTestServer, directory.getPath());
+    }
+
+    /** Serve files from the provided directory.
+     *
+     *  @param directoryPath The path of the directory from which files should be served.
+     */
+    public void serveFilesFromDirectory(String directoryPath) {
+        nativeServeFilesFromDirectory(mNativeEmbeddedTestServer, directoryPath);
+    }
+
+    /** Initialize the server.
+     *
+     *  Note that this should be called after handlers are set up, including any relevant calls
+     *  serveFilesFromDirectory.
+     *
+     *  @return Whether the server was successfully initialized.
+     */
+    public boolean initializeAndWaitUntilReady() {
+        return nativeInitializeAndWaitUntilReady(mNativeEmbeddedTestServer);
+    }
+
+    /** Get the full URL for the given relative URL.
+     *
+     *  @param relativeUrl The relative URL for which a full URL will be obtained.
+     *  @return The URL as a String.
+     */
+    public String getURL(String relativeUrl) {
+        return nativeGetURL(mNativeEmbeddedTestServer, relativeUrl);
+    }
+
+    /** Shutdown the server.
+     *
+     *  @return Whether the server was successfully shut down.
+     */
+    public boolean shutdownAndWaitUntilComplete() {
+        return nativeShutdownAndWaitUntilComplete(mNativeEmbeddedTestServer);
+    }
+
+    /** Destroy the native EmbeddedTestServer object. */
+    public void destroy() {
+        assert mNativeEmbeddedTestServer != 0;
+        nativeDestroy(mNativeEmbeddedTestServer);
+        assert mNativeEmbeddedTestServer == 0;
+    }
+
+    @CalledByNative
+    private void setNativePtr(long nativePtr) {
+        assert mNativeEmbeddedTestServer == 0;
+        mNativeEmbeddedTestServer = nativePtr;
+    }
+
+    @CalledByNative
+    private void clearNativePtr() {
+        assert mNativeEmbeddedTestServer != 0;
+        mNativeEmbeddedTestServer = 0;
+    }
+
+    private native void nativeInit();
+    private native void nativeDestroy(long nativeEmbeddedTestServerAndroid);
+    private native boolean nativeInitializeAndWaitUntilReady(long nativeEmbeddedTestServerAndroid);
+    private native boolean nativeShutdownAndWaitUntilComplete(long nativeEmbeddedTestServerAndroid);
+    private native String nativeGetURL(long nativeEmbeddedTestServerAndroid, String relativeUrl);
+    private native void nativeServeFilesFromDirectory(
+            long nativeEmbeddedTestServerAndroid, String directoryPath);
+}