// 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 org.chromium.net;

/**
 * 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(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(Exception exception);
}