Expose startNetLog / stopNetLog from HttpUrlRequestFactory.

components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java

Index: components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java
diff --git a/components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java b/components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java
index a500fd7f3510781bda33ec093190f29d01ed104a..bebd87288b3e3d912e66106052dd9a69a1117546 100644
--- a/components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java
+++ b/components/cronet/android/java/src/org/chromium/net/HttpUrlRequestFactory.java
@@ -59,6 +59,20 @@ public abstract class HttpUrlRequestFactory {
             int requestPriority, Map<String, String> headers,
             WritableByteChannel channel, HttpUrlRequestListener listener);
 
+    /**
+     * Starts NetLog logging to a file named |fileName| in the
+     * application temporary directory. |fileName| must not be empty. Log level
+     * is LOG_ALL_BUT_BYTES. If the file exists it is truncated before starting.

[mmenke, 2014/09/29 18:53:19]

If we're going to document the log level, we should explicitly set it as well
(I'm changing the default level of the NetLogLogger in another CL to hide
cookies and the like, and am thinking I won't update users of the NetLogLogger,
on the assumption if they don't set it, they're fine with the default value).

[mef, 2014/09/29 21:21:24]

I'm fine with not documenting the log level, although we should mention that it
may contain some PII.

[mmenke, 2014/09/29 21:24:30]

Great, let's do that for now, then.

I wonder if it's better to include the cookies by default or not - admittedly,
we don't even have an on-disk cookie store hooked up yet, but worth thinking
about the typical use case, or if we should just expose the option to the
embedder.

[mef, 2014/09/29 22:25:09]

Done.

+     * If actively logging the call is ignored.
+     */
+    public abstract void startNetLogToFile(String fileName);
+
+    /**
+     * Stops NetLog logging and flushes file to disk. If a logging session is
+     * not in progress this call is ignored.
+     */
+    public abstract void stopNetLog();
+
     private static HttpUrlRequestFactory createChromiumFactory(
             Context context, HttpUrlRequestFactoryConfig config) {
         HttpUrlRequestFactory factory = null;