/*
 * ====================================================================
 * 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.impl.nio;

import java.io.IOException;

import javax.net.ssl.SSLContext;
import javax.net.ssl.SSLException;

import org.apache.http.HttpRequestFactory;
import org.apache.http.impl.DefaultHttpRequestFactory;
import org.apache.http.impl.nio.reactor.SSLIOSession;
import org.apache.http.impl.nio.reactor.SSLIOSessionHandler;
import org.apache.http.impl.nio.reactor.SSLMode;
import org.apache.http.nio.NHttpServerIOTarget;
import org.apache.http.nio.NHttpServiceHandler;
import org.apache.http.nio.reactor.IOEventDispatch;
import org.apache.http.nio.reactor.IOSession;
import org.apache.http.nio.util.ByteBufferAllocator;
import org.apache.http.nio.util.HeapByteBufferAllocator;
import org.apache.http.params.HttpParams;
import org.apache.http.protocol.ExecutionContext;
import org.apache.http.util.Args;

Default implementation of IOEventDispatch interface for SSL (encrypted) server-side HTTP connections.
Since:4.0
Deprecated:(4.2) use SSLServerIOEventDispatch
/** * Default implementation of {@link IOEventDispatch} interface for SSL * (encrypted) server-side HTTP connections. * * @since 4.0 * * @deprecated (4.2) use {@link org.apache.http.impl.nio.ssl.SSLServerIOEventDispatch} */
@Deprecated public class SSLServerIOEventDispatch implements IOEventDispatch { private static final String SSL_SESSION = "SSL_SESSION"; protected final NHttpServiceHandler handler; protected final SSLContext sslcontext; protected final SSLIOSessionHandler sslHandler; protected final HttpParams params;
Creates a new instance of this class to be used for dispatching I/O event notifications to the given protocol handler using the given SSLContext. This I/O dispatcher will transparently handle SSL protocol aspects for HTTP connections.
Params:
  • handler – the server protocol handler.
  • sslContext – the SSL context.
  • sslHandler – the SSL handler.
  • params – HTTP parameters.
/** * Creates a new instance of this class to be used for dispatching I/O event * notifications to the given protocol handler using the given * {@link SSLContext}. This I/O dispatcher will transparently handle SSL * protocol aspects for HTTP connections. * * @param handler the server protocol handler. * @param sslContext the SSL context. * @param sslHandler the SSL handler. * @param params HTTP parameters. */
public SSLServerIOEventDispatch( final NHttpServiceHandler handler, final SSLContext sslContext, final SSLIOSessionHandler sslHandler, final HttpParams params) { super(); Args.notNull(handler, "HTTP service handler"); Args.notNull(sslContext, "SSL context"); Args.notNull(params, "HTTP parameters"); this.handler = handler; this.params = params; this.sslcontext = sslContext; this.sslHandler = sslHandler; }
Creates a new instance of this class to be used for dispatching I/O event notifications to the given protocol handler using the given SSLContext. This I/O dispatcher will transparently handle SSL protocol aspects for HTTP connections.
Params:
  • handler – the server protocol handler.
  • sslContext – the SSL context.
  • params – HTTP parameters.
/** * Creates a new instance of this class to be used for dispatching I/O event * notifications to the given protocol handler using the given * {@link SSLContext}. This I/O dispatcher will transparently handle SSL * protocol aspects for HTTP connections. * * @param handler the server protocol handler. * @param sslContext the SSL context. * @param params HTTP parameters. */
public SSLServerIOEventDispatch( final NHttpServiceHandler handler, final SSLContext sslContext, final HttpParams params) { this(handler, sslContext, null, params); }
Creates an instance of HeapByteBufferAllocator to be used by HTTP connections for allocating ByteBuffer objects.

This method can be overridden in a super class in order to provide a different implementation of the ByteBufferAllocator interface.

Returns:byte buffer allocator.
/** * Creates an instance of {@link HeapByteBufferAllocator} to be used * by HTTP connections for allocating {@link java.nio.ByteBuffer} objects. * <p> * This method can be overridden in a super class in order to provide * a different implementation of the {@link ByteBufferAllocator} interface. * * @return byte buffer allocator. */
protected ByteBufferAllocator createByteBufferAllocator() { return HeapByteBufferAllocator.INSTANCE; }
Creates an instance of DefaultHttpRequestFactory to be used by HTTP connections for creating HttpRequest objects.

This method can be overridden in a super class in order to provide a different implementation of the HttpRequestFactory interface.

Returns:HTTP request factory.
/** * Creates an instance of {@link DefaultHttpRequestFactory} to be used * by HTTP connections for creating {@link org.apache.http.HttpRequest} * objects. * <p> * This method can be overridden in a super class in order to provide * a different implementation of the {@link HttpRequestFactory} interface. * * @return HTTP request factory. */
protected HttpRequestFactory createHttpRequestFactory() { return DefaultHttpRequestFactory.INSTANCE; }
Creates an instance of DefaultNHttpServerConnection based on the given IOSession.

This method can be overridden in a super class in order to provide a different implementation of the NHttpServerIOTarget interface.

Params:
  • session – the underlying SSL I/O session.
Returns:newly created HTTP connection.
/** * Creates an instance of {@link DefaultNHttpServerConnection} based on the * given {@link IOSession}. * <p> * This method can be overridden in a super class in order to provide * a different implementation of the {@link NHttpServerIOTarget} interface. * * @param session the underlying SSL I/O session. * * @return newly created HTTP connection. */
protected NHttpServerIOTarget createConnection(final IOSession session) { return new DefaultNHttpServerConnection( session, createHttpRequestFactory(), createByteBufferAllocator(), this.params); }
Creates an instance of SSLIOSession decorating the given IOSession.

This method can be overridden in a super class in order to provide a different implementation of SSL I/O session.

Params:
  • session – the underlying I/O session.
  • sslContext – the SSL context.
  • sslHandler – the SSL handler.
Returns:newly created SSL I/O session.
/** * Creates an instance of {@link SSLIOSession} decorating the given * {@link IOSession}. * <p> * This method can be overridden in a super class in order to provide * a different implementation of SSL I/O session. * * @param session the underlying I/O session. * @param sslContext the SSL context. * @param sslHandler the SSL handler. * @return newly created SSL I/O session. */
protected SSLIOSession createSSLIOSession( final IOSession session, final SSLContext sslContext, final SSLIOSessionHandler sslHandler) { return new SSLIOSession(session, sslContext, sslHandler); } @Override public void connected(final IOSession session) { final SSLIOSession sslSession = createSSLIOSession( session, this.sslcontext, this.sslHandler); final NHttpServerIOTarget conn = createConnection( sslSession); session.setAttribute(ExecutionContext.HTTP_CONNECTION, conn); session.setAttribute(SSL_SESSION, sslSession); this.handler.connected(conn); try { sslSession.bind(SSLMode.SERVER, this.params); } catch (final SSLException ex) { this.handler.exception(conn, ex); sslSession.shutdown(); } } @Override public void disconnected(final IOSession session) { final NHttpServerIOTarget conn = (NHttpServerIOTarget) session.getAttribute(ExecutionContext.HTTP_CONNECTION); if (conn != null) { this.handler.closed(conn); } } @Override public void inputReady(final IOSession session) { final NHttpServerIOTarget conn = (NHttpServerIOTarget) session.getAttribute(ExecutionContext.HTTP_CONNECTION); final SSLIOSession sslSession = (SSLIOSession) session.getAttribute(SSL_SESSION); try { if (sslSession.isAppInputReady()) { conn.consumeInput(this.handler); } sslSession.inboundTransport(); } catch (final IOException ex) { this.handler.exception(conn, ex); sslSession.shutdown(); } } @Override public void outputReady(final IOSession session) { final NHttpServerIOTarget conn = (NHttpServerIOTarget) session.getAttribute(ExecutionContext.HTTP_CONNECTION); final SSLIOSession sslSession = (SSLIOSession) session.getAttribute(SSL_SESSION); try { if (sslSession.isAppOutputReady()) { conn.produceOutput(this.handler); } sslSession.outboundTransport(); } catch (final IOException ex) { this.handler.exception(conn, ex); sslSession.shutdown(); } } @Override public void timeout(final IOSession session) { final NHttpServerIOTarget conn = (NHttpServerIOTarget) session.getAttribute(ExecutionContext.HTTP_CONNECTION); final SSLIOSession sslSession = (SSLIOSession) session.getAttribute(SSL_SESSION); this.handler.timeout(conn); synchronized (sslSession) { if (sslSession.isOutboundDone() && !sslSession.isInboundDone()) { // The session failed to cleanly terminate sslSession.shutdown(); } } } }