org.mitre.taxii.client

Class HttpResponseErrorHandler

java.lang.Object

org.mitre.taxii.client.HttpResponseErrorHandler

Direct Known Subclasses:

ResponseErrorHandler, ResponseErrorHandler

public abstract class HttpResponseErrorHandler
extends java.lang.Object

Abstract class that handles error responses received from a TAXII server.

Constructor Summary

Constructors

Constructor and Description
HttpResponseErrorHandler()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	buildResponseStr(org.apache.http.client.methods.CloseableHttpResponse response) Render the headers and the response content as a string.
abstract java.lang.Object	buildSSLErrorStatusMessage(javax.net.ssl.SSLException ex, java.lang.Object message) Construct an "UNAUTHORIZED" StatusMessage.
abstract java.lang.Object	buildStatusCodeStatusMessage(org.apache.http.client.methods.CloseableHttpResponse response, java.lang.Object message) We received a response that was not a 200 (Success) value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpResponseErrorHandler

public HttpResponseErrorHandler()

Method Detail

buildStatusCodeStatusMessage

public abstract java.lang.Object buildStatusCodeStatusMessage(org.apache.http.client.methods.CloseableHttpResponse response,
                                            java.lang.Object message)

We received a response that was not a 200 (Success) value. Make up an appropriate Status Message.

Parameters:

response - the HTTP response object.

msgIn - the TAXII message received from the server.

Returns:

StatusMessage based on the HTTP response code.

buildSSLErrorStatusMessage

public abstract java.lang.Object buildSSLErrorStatusMessage(javax.net.ssl.SSLException ex,
                                          java.lang.Object message)

Construct an "UNAUTHORIZED" StatusMessage.

Section 5.2 of the TAXII HTTP Protocol Binding Specification states:

"If TLS is used, problems with the TLS handshake or connection are indicated using a TLS Alert Protocol Record. This section defines rules for interpreting a TLS Alert Protocol Record as a TAXII Status Message. Treat a TLS Alert Protocol Record as being equivalent to a TAXII Status Message with the following properties:

• Status = Use the appropriate TAXII Status Type as identified in Table 3.
• Message = The TLS Alert, represented as a hexadecimal string."

Unfortunately, Java does not give us access to the TLS Alert, so we'll just make all the Statuses UNAUTHORIZED and return the exception's message.

Parameters:

ex -

message -

Returns:

"UNAUTHORIZED" status message.

buildResponseStr

public java.lang.String buildResponseStr(org.apache.http.client.methods.CloseableHttpResponse response)

Render the headers and the response content as a string. This could include more things such as the status code.

Parameters:

response -

Returns:

A string consisting of the HTTP Response headers nicely formatted.