/*
 * ====================================================================
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * 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.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of the Apache Software Foundation.  For more
 * information on the Apache Software Foundation, please see
 * <http://www.apache.org/>.
 *
 */

package org.apache.http.nio.protocol;

import java.io.IOException;
import java.util.concurrent.Future;

import org.apache.http.ConnectionReuseStrategy;
import org.apache.http.HttpException;
import org.apache.http.HttpHost;
import org.apache.http.HttpRequest;
import org.apache.http.HttpResponse;
import org.apache.http.concurrent.BasicFuture;
import org.apache.http.concurrent.FutureCallback;
import org.apache.http.nio.ContentDecoder;
import org.apache.http.nio.ContentEncoder;
import org.apache.http.nio.IOControl;
import org.apache.http.params.HttpParams;
import org.apache.http.protocol.HttpContext;
import org.apache.http.protocol.HttpProcessor;
import org.apache.http.util.Args;

Basic implementation of HttpAsyncRequestExecutionHandler that executes a single HTTP request / response exchange.
Type parameters:
  • <T> – the result type of request execution.
Since:4.2
Deprecated:(4.3) use BasicAsyncClientExchangeHandler.
/** * Basic implementation of {@link HttpAsyncRequestExecutionHandler} that executes * a single HTTP request / response exchange. * * @param <T> the result type of request execution. * @since 4.2 * * @deprecated (4.3) use {@link BasicAsyncClientExchangeHandler}. */
@Deprecated public class BasicAsyncRequestExecutionHandler<T> implements HttpAsyncRequestExecutionHandler<T> { private final HttpAsyncRequestProducer requestProducer; private final HttpAsyncResponseConsumer<T> responseConsumer; private final BasicFuture<T> future; private final HttpContext localContext; private final HttpProcessor httpPocessor; private final ConnectionReuseStrategy reuseStrategy; private volatile boolean requestSent; public BasicAsyncRequestExecutionHandler( final HttpAsyncRequestProducer requestProducer, final HttpAsyncResponseConsumer<T> responseConsumer, final FutureCallback<T> callback, final HttpContext localContext, final HttpProcessor httpPocessor, final ConnectionReuseStrategy reuseStrategy, final HttpParams params) { super(); Args.notNull(requestProducer, "Request producer"); Args.notNull(responseConsumer, "Response consumer"); Args.notNull(localContext, "HTTP context"); Args.notNull(httpPocessor, "HTTP processor"); Args.notNull(reuseStrategy, "Connection reuse strategy"); Args.notNull(params, "HTTP parameters"); this.requestProducer = requestProducer; this.responseConsumer = responseConsumer; this.future = new BasicFuture<T>(callback); this.localContext = localContext; this.httpPocessor = httpPocessor; this.reuseStrategy = reuseStrategy; } public BasicAsyncRequestExecutionHandler( final HttpAsyncRequestProducer requestProducer, final HttpAsyncResponseConsumer<T> responseConsumer, final HttpContext localContext, final HttpProcessor httpPocessor, final ConnectionReuseStrategy reuseStrategy, final HttpParams params) { this(requestProducer, responseConsumer, null, localContext, httpPocessor, reuseStrategy, params); } public Future<T> getFuture() { return this.future; } private void releaseResources() { try { this.responseConsumer.close(); } catch (final IOException ex) { } try { this.requestProducer.close(); } catch (final IOException ex) { } } @Override public void close() throws IOException { releaseResources(); if (!this.future.isDone()) { this.future.cancel(); } } @Override public HttpHost getTarget() { return this.requestProducer.getTarget(); } @Override public HttpRequest generateRequest() throws IOException, HttpException { return this.requestProducer.generateRequest(); } @Override public void produceContent( final ContentEncoder encoder, final IOControl ioControl) throws IOException { this.requestProducer.produceContent(encoder, ioControl); } @Override public void requestCompleted(final HttpContext context) { this.requestProducer.requestCompleted(context); this.requestSent = true; } @Override public boolean isRepeatable() { return false; } @Override public void resetRequest() { } @Override public void responseReceived(final HttpResponse response) throws IOException, HttpException { this.responseConsumer.responseReceived(response); } @Override public void consumeContent( final ContentDecoder decoder, final IOControl ioControl) throws IOException { this.responseConsumer.consumeContent(decoder, ioControl); } @Override public void failed(final Exception ex) { try { if (!this.requestSent) { this.requestProducer.failed(ex); } this.responseConsumer.failed(ex); } finally { try { this.future.failed(ex); } finally { releaseResources(); } } } @Override public boolean cancel() { try { final boolean cancelled = this.responseConsumer.cancel(); this.future.cancel(); releaseResources(); return cancelled; } catch (final RuntimeException ex) { failed(ex); throw ex; } } @Override public void responseCompleted(final HttpContext context) { try { this.responseConsumer.responseCompleted(context); final T result = this.responseConsumer.getResult(); final Exception ex = this.responseConsumer.getException(); if (ex == null) { this.future.completed(result); } else { this.future.failed(ex); } releaseResources(); } catch (final RuntimeException ex) { failed(ex); throw ex; } } @Override public T getResult() { return this.responseConsumer.getResult(); } @Override public Exception getException() { return this.responseConsumer.getException(); } @Override public HttpContext getContext() { return this.localContext; } @Override public HttpProcessor getHttpProcessor() { return this.httpPocessor; } @Override public ConnectionReuseStrategy getConnectionReuseStrategy() { return this.reuseStrategy; } @Override public boolean isDone() { return this.responseConsumer.isDone(); } }