[Cronet] Upload support for async APIs

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

+// Copyright 2014 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;
+
+/**
+ * Interface with callbacks methods for UploadDataProviders.  All methods may
+ * be called synchronously or asynchronously, on any thread.
+ */
+public interface UploadDataSink {
+    /**
+     * Called by UploadDataProvider when a read succeeds.
+     * @param done For chunked uploads, true if this is the final read.  Ignored

[mef, 2015/02/02 17:45:11]

@param finalChunk

[xunjieli, 2015/02/02 18:25:42]

Done.

+     *     for non-chunked uploads.

[pauljensen, 2015/02/02 18:11:24]

This is not ignored for non-chunked uploads, it instead throws an exception if
true.

[xunjieli, 2015/02/02 18:25:41]

Done.

+     */
+    public void onReadSucceeded(boolean finalChunk);
+
+    /**
+     * Called by UploadDataProvider when a read fails.
+     * @param exception Exception passed on to the embedder.
+     */
+    public void onReadError(Exception exception);
+
+    /**
+     * Called by UploadDataProvider when a rewind succeeds.
+     */
+    public void onRewindSucceeded();
+
+    /**
+     * Called by UploadDataProvider when a rewind fails. or if rewiding uploads

[mef, 2015/02/02 17:45:11]

sp: rewinding

[xunjieli, 2015/02/02 18:25:42]

Done.

+     * is not supported.
+     * @param exception Exception passed on to the embedder.
+     */
+    public void onRewindError(Exception exception);
+}