42 lines
1.3 KiB
Java
42 lines
1.3 KiB
Java
|
// Copyright 2015 The Chromium Authors
|
||
|
|
// Use of this source code is governed by a BSD-style license that can be
|
||
|
|
// found in the LICENSE file.
|
||
|
|
|
||
|
|
package android.net.http;
|
||
|
|
|
||
|
|
import androidx.annotation.NonNull;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Defines callbacks methods for {@link UploadDataProvider}. All methods may be called synchronously
|
||
|
|
* or asynchronously, on any thread.
|
||
|
|
*/
|
||
|
|
public abstract class UploadDataSink {
|
||
|
|
/**
|
||
|
|
* Called by {@link UploadDataProvider} when a read succeeds.
|
||
|
|
*
|
||
|
|
* @param finalChunk For chunked uploads, {@code true} if this is the final read. It must be
|
||
|
|
* {@code false} for non-chunked uploads.
|
||
|
|
*/
|
||
|
|
public abstract void onReadSucceeded(boolean finalChunk);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by {@link UploadDataProvider} when a read fails.
|
||
|
|
*
|
||
|
|
* @param exception Exception passed on to the embedder.
|
||
|
|
*/
|
||
|
|
public abstract void onReadError(@NonNull Exception exception);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by {@link UploadDataProvider} when a rewind succeeds.
|
||
|
|
*/
|
||
|
|
public abstract void onRewindSucceeded();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by {@link UploadDataProvider} when a rewind fails, or if rewinding uploads is not
|
||
|
|
* supported.
|
||
|
|
*
|
||
|
|
* @param exception Exception passed on to the embedder.
|
||
|
|
*/
|
||
|
|
public abstract void onRewindError(@NonNull Exception exception);
|
||
|
|
}
|