public class DefaultBHttpServerConnection extends Object implements HttpServerConnection
HttpServerConnection
.Constructor and Description |
---|
DefaultBHttpServerConnection(String scheme,
Http1Config http1Config) |
DefaultBHttpServerConnection(String scheme,
Http1Config http1Config,
CharsetDecoder charDecoder,
CharsetEncoder charEncoder) |
DefaultBHttpServerConnection(String scheme,
Http1Config http1Config,
CharsetDecoder charDecoder,
CharsetEncoder charEncoder,
ContentLengthStrategy incomingContentStrategy,
ContentLengthStrategy outgoingContentStrategy,
HttpMessageParserFactory<ClassicHttpRequest> requestParserFactory,
HttpMessageWriterFactory<ClassicHttpResponse> responseWriterFactory)
Creates new instance of DefaultBHttpServerConnection.
|
Modifier and Type | Method and Description |
---|---|
protected boolean |
awaitInput(Timeout timeout) |
void |
bind(Socket socket)
Binds this connection to the given
Socket . |
protected void |
bind(SocketHolder socketHolder) |
void |
bind(SSLSocket sslSocket,
Socket baseSocket) |
void |
close()
Closes this connection gracefully.
|
void |
close(CloseMode closeMode)
Closes this process or endpoint and releases any system resources associated
with it.
|
protected InputStream |
createContentInputStream(long len,
SessionInputBuffer buffer,
InputStream inputStream) |
protected OutputStream |
createContentOutputStream(long len,
SessionOutputBuffer buffer,
OutputStream outputStream,
Supplier<List<? extends Header>> trailers) |
protected SocketHolder |
ensureOpen() |
void |
flush()
Writes out all pending buffered data over the open connection.
|
EndpointDetails |
getEndpointDetails()
Returns this connection's endpoint details.
|
SocketAddress |
getLocalAddress()
Returns this connection's local address or
null if it is not bound yet. |
ProtocolVersion |
getProtocolVersion()
Returns this connection's protocol version or
null if unknown. |
SocketAddress |
getRemoteAddress()
Returns this connection's remote address or
null if it is not connected yet or
unconnected. |
protected SocketHolder |
getSocketHolder() |
Timeout |
getSocketTimeout()
Returns the socket timeout value.
|
SSLSession |
getSSLSession()
Returns this connection's SSL session or
null if TLS has not been activated. |
protected void |
incrementRequestCount() |
protected void |
incrementResponseCount() |
boolean |
isDataAvailable(Timeout timeout)
Checks if input data is available from the connection.
|
boolean |
isOpen()
Checks if this connection is open.
|
boolean |
isStale()
Checks whether this connection has gone down.
|
protected void |
onRequestReceived(ClassicHttpRequest request) |
protected void |
onResponseSubmitted(ClassicHttpResponse response) |
void |
receiveRequestEntity(ClassicHttpRequest request)
Receives the next request entity available from this connection and attaches it to
an existing request.
|
ClassicHttpRequest |
receiveRequestHeader()
Receives the request line and all headers available from this connection.
|
void |
sendResponseEntity(ClassicHttpResponse response)
Sends the response entity of a response over this connection.
|
void |
sendResponseHeader(ClassicHttpResponse response)
Sends the response line and headers of a response over this connection.
|
void |
setSocketTimeout(Timeout timeout)
Sets the socket timeout value.
|
String |
toString() |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
flush, isDataAvailable, isStale
close, getEndpointDetails, getLocalAddress, getProtocolVersion, getRemoteAddress, getSSLSession, isOpen
getSocketTimeout, setSocketTimeout
close
public DefaultBHttpServerConnection(String scheme, Http1Config http1Config, CharsetDecoder charDecoder, CharsetEncoder charEncoder, ContentLengthStrategy incomingContentStrategy, ContentLengthStrategy outgoingContentStrategy, HttpMessageParserFactory<ClassicHttpRequest> requestParserFactory, HttpMessageWriterFactory<ClassicHttpResponse> responseWriterFactory)
scheme
- protocol schemehttp1Config
- Message http1Config. If null
Http1Config.DEFAULT
will be used.charDecoder
- decoder to be used for decoding HTTP protocol elements.
If null
simple type cast will be used for byte to char conversion.charEncoder
- encoder to be used for encoding HTTP protocol elements.
If null
simple type cast will be used for char to byte conversion.incomingContentStrategy
- incoming content length strategy. If null
DefaultContentLengthStrategy.INSTANCE
will be used.outgoingContentStrategy
- outgoing content length strategy. If null
DefaultContentLengthStrategy.INSTANCE
will be used.requestParserFactory
- request parser factory. If null
DefaultHttpRequestParserFactory.INSTANCE
will be used.responseWriterFactory
- response writer factory. If null
DefaultHttpResponseWriterFactory.INSTANCE
will be used.public DefaultBHttpServerConnection(String scheme, Http1Config http1Config, CharsetDecoder charDecoder, CharsetEncoder charEncoder)
public DefaultBHttpServerConnection(String scheme, Http1Config http1Config)
protected void onRequestReceived(ClassicHttpRequest request)
protected void onResponseSubmitted(ClassicHttpResponse response)
public void bind(Socket socket) throws IOException
Socket
. This socket will be
used by the connection to send and receive data.
After this method's execution the connection status will be reported
as open and the isOpen()
will return true
.
socket
- the socket.IOException
- in case of an I/O error.public void bind(SSLSocket sslSocket, Socket baseSocket) throws IOException
IOException
- in case of an I/O error.public ClassicHttpRequest receiveRequestHeader() throws HttpException, IOException
HttpServerConnection
receiveRequestHeader
in interface HttpServerConnection
null
if the connection has been closed
by the opposite endpoint.HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorpublic void receiveRequestEntity(ClassicHttpRequest request) throws HttpException, IOException
HttpServerConnection
receiveRequestEntity
in interface HttpServerConnection
request
- the request to attach the entity to.HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorpublic void sendResponseHeader(ClassicHttpResponse response) throws HttpException, IOException
HttpServerConnection
sendResponseHeader
in interface HttpServerConnection
response
- the response whose headers to send.HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorpublic void sendResponseEntity(ClassicHttpResponse response) throws HttpException, IOException
HttpServerConnection
sendResponseEntity
in interface HttpServerConnection
response
- the response whose entity to send.HttpException
- in case of HTTP protocol violationIOException
- in case of an I/O errorprotected SocketHolder ensureOpen() throws IOException
IOException
protected void bind(SocketHolder socketHolder) throws IOException
IOException
public boolean isOpen()
HttpConnection
isOpen
in interface HttpConnection
public ProtocolVersion getProtocolVersion()
HttpConnection
null
if unknown.getProtocolVersion
in interface HttpConnection
null
if unknown.protected SocketHolder getSocketHolder()
protected OutputStream createContentOutputStream(long len, SessionOutputBuffer buffer, OutputStream outputStream, Supplier<List<? extends Header>> trailers)
protected InputStream createContentInputStream(long len, SessionInputBuffer buffer, InputStream inputStream)
public SocketAddress getRemoteAddress()
HttpConnection
null
if it is not connected yet or
unconnected.getRemoteAddress
in interface HttpConnection
null
if it is not connected yet or
unconnected.public SocketAddress getLocalAddress()
HttpConnection
null
if it is not bound yet.getLocalAddress
in interface HttpConnection
null
if it is not bound yet.public void setSocketTimeout(Timeout timeout)
SocketModalCloseable
setSocketTimeout
in interface SocketModalCloseable
timeout
- timeout valuepublic Timeout getSocketTimeout()
SocketModalCloseable
getSocketTimeout
in interface SocketModalCloseable
public void close(CloseMode closeMode)
ModalCloseable
close
in interface ModalCloseable
closeMode
- How to close the receiver.public void close() throws IOException
HttpConnection
shutdown
instead.close
in interface Closeable
close
in interface AutoCloseable
close
in interface HttpConnection
IOException
protected boolean awaitInput(Timeout timeout) throws IOException
IOException
public boolean isDataAvailable(Timeout timeout) throws IOException
BHttpConnection
isDataAvailable
in interface BHttpConnection
timeout
- the maximum time to wait for datatimeout
.IOException
- if an error happens on the connectionpublic boolean isStale() throws IOException
BHttpConnection
isStale
in interface BHttpConnection
true
if attempts to use this connection are likely
to fail and this connection should be closed,
or false
if they are likely to succeedIOException
- in case of an I/O error.public void flush() throws IOException
BHttpConnection
flush
in interface BHttpConnection
IOException
- in case of an I/O errorprotected void incrementRequestCount()
protected void incrementResponseCount()
public SSLSession getSSLSession()
HttpConnection
null
if TLS has not been activated.getSSLSession
in interface HttpConnection
null
if TLS has not been activated.public EndpointDetails getEndpointDetails()
HttpConnection
getEndpointDetails
in interface HttpConnection
Copyright © 2005–2021 The Apache Software Foundation. All rights reserved.