org.simpleframework.http.SocketPipeline Maven / Gradle / Ivy
/*
* SocketPipeline.java February 2001
*
* Copyright (C) 2001, Niall Gallagher
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307 USA
*/
package org.simpleframework.http;
import java.nio.channels.SocketChannel;
import java.util.HashMap;
import java.util.Map;
import javax.net.ssl.SSLEngine;
/**
* This is a Pipeline interface that is used to represent
* a HTTP pipeline. This contains a map that allows attributes to be
* associated with the client connection. Attributes such as security
* certificates or other transport related details can be exposed to
* the Request using the pipeline attribute map.
*
* This provides the connected SocketChannel that can be
* used to receive and response to HTTP requests. The socket channel
* must be selectable and in non-blocking mode. If the socket is not
* in a non-blocking state the connection will not be processed.
*
* @author Niall Gallagher
*/
public class SocketPipeline implements Pipeline {
/**
* This is the socket that provides the input and output.
*/
private SocketChannel socket;
/**
* This is used to encrypt content for secure connections.
*/
private SSLEngine engine;
/**
* This is used to store the attributes for the pipeline.
*/
private Map map;
/**
* This creates a SocketPipeline from a socket channel
* object. Any classes of the SocketPipeline object may
* use this constructor to ensure that all the data is initialized
* for the SocketPipeline.
*
* @param socket the socket channel that is used as the transport
*/
public SocketPipeline(SocketChannel socket) {
this(socket, null);
}
/**
* This creates a SocketPipeline from a socket channel
* object. Any classes of the SocketPipeline object may
* use this constructor to ensure that all the data is initialized
* for the SocketPipeline.
*
* @param socket the socket channel that is used as the transport
* @param engine this is the SSL engine used for secure transport
*/
public SocketPipeline(SocketChannel socket, SSLEngine engine) {
this.map = new HashMap();
this.engine = engine;
this.socket = socket;
}
/**
* This is used to acquire the SSL engine used for https. If the
* pipeline is connected to an SSL transport this returns an SSL
* engine which can be used to establish the secure connection
* and send and receive content over that connection. If this is
* null then the pipeline represents a normal transport.
*
* @return the SSL engine used to establish a secure transport
*/
public SSLEngine getEngine() {
return engine;
}
/**
* This method is used to acquire the SocketChannel
* for the connection. This allows the server to acquire the input
* and output streams with which to communicate. It can also be
* used to configure the connection and perform various network
* operations that could otherwise not be performed.
*
* @return this returns the socket used by this HTTP pipeline
*/
public SocketChannel getSocket() {
return socket;
}
/**
* This method is used to get the Map of attributes
* by this pipeline. The attributes map is used to maintain details
* about the connection. Information such as security credentials
* to client details can be placed within the attribute map.
*
* @return this returns the map of attributes for this pipeline
*/
public Map getAttributes() {
return map;
}
}