org.asynchttpclient.AsyncCompletionHandler Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of async-http-client Show documentation
The Async Http Client (AHC) classes.
There is a newer version: LATEST_VERSION
/*
 * Copyright 2010 Ning, Inc.
 *
 * This program is licensed to you under the Apache License, version 2.0
 * (the "License"); you may not use this file except in compliance with the
 * License.  You may obtain a copy of the License at:
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
 * License for the specific language governing permissions and limitations
 * under the License.
 *
 */
package org.asynchttpclient;

import io.netty.handler.codec.http.HttpHeaders;
import org.asynchttpclient.handler.ProgressAsyncHandler;
import org.jetbrains.annotations.Nullable;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.io.File;
import java.io.InputStream;
import java.util.concurrent.Future;

/**
 * An {@link AsyncHandler} augmented with an {@link #onCompleted(Response)}
 * convenience method which gets called when the {@link Response} processing is
 * finished. This class also implements the {@link ProgressAsyncHandler}
 * callback, all doing nothing except returning
 * {@link AsyncHandler.State#CONTINUE}
 *
 * @param  Type of the value that will be returned by the associated
 *            {@link Future}
 */
public abstract class AsyncCompletionHandler implements ProgressAsyncHandler {

    private static final Logger LOGGER = LoggerFactory.getLogger(AsyncCompletionHandler.class);
    private final Response.ResponseBuilder builder = new Response.ResponseBuilder();

    @Override
    public State onStatusReceived(HttpResponseStatus status) throws Exception {
        builder.reset();
        builder.accumulate(status);
        return State.CONTINUE;
    }

    @Override
    public State onHeadersReceived(HttpHeaders headers) throws Exception {
        builder.accumulate(headers);
        return State.CONTINUE;
    }

    @Override
    public State onBodyPartReceived(HttpResponseBodyPart content) throws Exception {
        builder.accumulate(content);
        return State.CONTINUE;
    }

    @Override
    public State onTrailingHeadersReceived(HttpHeaders headers) throws Exception {
        builder.accumulate(headers);
        return State.CONTINUE;
    }

    @Override
    public final @Nullable T onCompleted() throws Exception {
        return onCompleted(builder.build());
    }

    @Override
    public void onThrowable(Throwable t) {
        LOGGER.debug(t.getMessage(), t);
    }

    /**
     * Invoked once the HTTP response processing is finished.
     *
     * @param response The {@link Response}
     * @return T Value that will be returned by the associated
     * {@link Future}
     * @throws Exception if something wrong happens
     */
    public abstract @Nullable T onCompleted(@Nullable Response response) throws Exception;

    /**
     * Invoked when the HTTP headers have been fully written on the I/O socket.
     *
     * @return a {@link AsyncHandler.State} telling to CONTINUE
     * or ABORT the current processing.
     */
    @Override
    public State onHeadersWritten() {
        return State.CONTINUE;
    }

    /**
     * Invoked when the content (a {@link File}, {@link String}) or
     * {@link InputStream} has been fully written on the I/O socket.
     *
     * @return a {@link AsyncHandler.State} telling to CONTINUE
     * or ABORT the current processing.
     */
    @Override
    public State onContentWritten() {
        return State.CONTINUE;
    }

    /**
     * Invoked when the I/O operation associated with the {@link Request} body as
     * been progressed.
     *
     * @param amount  The amount of bytes to transfer
     * @param current The amount of bytes transferred
     * @param total   The total number of bytes transferred
     * @return a {@link AsyncHandler.State} telling to CONTINUE
     * or ABORT the current processing.
     */
    @Override
    public State onContentWriteProgress(long amount, long current, long total) {
        return State.CONTINUE;
    }
}