wjhk.jupload2.upload.helper

Class HTTPInputStreamReader

java.lang.Object

wjhk.jupload2.upload.helper.HTTPInputStreamReader

public class HTTPInputStreamReader
extends Object

A helper, to read the response coming from the server.

Author:

etienne_sf

Constructor Summary

Constructors

Constructor and Description
HTTPInputStreamReader(HTTPConnectionHelper httpConnectionHelper, UploadPolicy uploadPolicy) The standard constructor: does nothing !

Method Summary

Modifier and Type	Method and Description
int	gethttpStatusCode() Return the last read http response (200, in case of success).
String	getResponseBody() Get the last response bytearrayResponseBody.
byte[]	getResponseBodyAsByteArray() Get the last response bytearrayResponseBody.
String	getResponseCharset() Get the charset that should be used to decode the last response, when using the getResponseBodyAsByteArray() method.
String	getResponseHeaders() Get the headers of the HTTP response.
String	getResponseMsg() Get the last response message.
int	readHttpResponse() The main method: reads the response in the input stream.
static byte[]	readLine(PushbackInputStream inputStream, boolean includeCR) Similar like BufferedInputStream#readLine() but operates on raw bytes.
static String	readLine(PushbackInputStream inputStream, String charset, boolean includeCR) Similar like BufferedInputStream#readLine() but operates on raw bytes.

Methods inherited from class java.lang.Object

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

Constructor Detail

HTTPInputStreamReader

public HTTPInputStreamReader(HTTPConnectionHelper httpConnectionHelper,
                             UploadPolicy uploadPolicy)

The standard constructor: does nothing ! Oh yes, it initialize some attribute from the given parameter... :-)

Parameters:

httpConnectionHelper - The connection helper, associated with this instance.

uploadPolicy - The current upload policy.

Method Detail

gethttpStatusCode

public int gethttpStatusCode()

Return the last read http response (200, in case of success).

Returns:

The last read http response

getResponseBody

public String getResponseBody()

Get the last response bytearrayResponseBody.

Returns:

The last read response bytearrayResponseBody.

getResponseBodyAsByteArray

public byte[] getResponseBodyAsByteArray()

Get the last response bytearrayResponseBody. This byte array should be decoded by using the getResponseCharset().

Returns:

The last read response bytearrayResponseBody.

getResponseCharset

public String getResponseCharset()

Get the charset that should be used to decode the last response, when using the getResponseBodyAsByteArray() method.

Returns:

The last read response bytearrayResponseBody.

getResponseHeaders

public String getResponseHeaders()

Get the headers of the HTTP response.

Returns:

The HTTP headers.

getResponseMsg

public String getResponseMsg()

Get the last response message.

Returns:

The response message from the first line of the response (e.g. "200 OK").

readHttpResponse

public int readHttpResponse()
                     throws JUploadException

The main method: reads the response in the input stream.

Returns:

The response status (e.g.: 200 if everything was ok)

Throws:

JUploadException

readLine

public static String readLine(PushbackInputStream inputStream,
                              String charset,
                              boolean includeCR)
                       throws IOException,
                              JUploadException

Similar like BufferedInputStream#readLine() but operates on raw bytes. Line-Ending is always "\r\n".

Parameters:

inputStream -

charset - The input charset of the stream.

includeCR - Set to true, if the terminating CR/LF should be included in the returned byte array.

Returns:

The line, encoded from the input stream with the given charset

Throws:

IOException

JUploadException

readLine

public static byte[] readLine(PushbackInputStream inputStream,
                              boolean includeCR)
                       throws IOException,
                              JUploadException

Similar like BufferedInputStream#readLine() but operates on raw bytes. According to RFC 2616, and of line may be CR (13), LF (10) or CRLF. Line-Ending is always "\r\n" in header, but not in text bodies. Update done by TedA (sourceforge account: tedaaa). Allows to manage response from web server that send LF instead of CRLF ! Here is a part of the RFC: "we recommend that applications, when parsing such headers, recognize a single LF as a line terminator and ignore the leading CR".
Corrected again to manage line finished by CR only. This is not allowed in headers, but this method is also used to read lines in the bytearrayResponseBody.

Parameters:

inputStream -

includeCR - Set to true, if the terminating CR/LF should be included in the returned byte array. In this case, CR/LF is always returned to the caller, whether the input stream got CR, LF or CRLF.

Returns:

The byte array from the input stream, with or without a trailing CRLF

Throws:

IOException

JUploadException