[Cronet] Upload support for async APIs

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

+// 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;
+
+/**
+ * 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.

[pauljensen, 2015/02/12 17:15:40]

UploadDataProvider should probably be in {@link }
true and false and Exception should probably be in {@code }

[xunjieli, 2015/02/12 20:56:28]

Done.

+     * @param finalChunk For chunked uploads, true if this is the final read.
+     *     It must be false for non-chunked uploads.
+     */
+    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 rewinding uploads
+     * is not supported.
+     * @param exception Exception passed on to the embedder.
+     */
+    public void onRewindError(Exception exception);
+}