Package org.jsoup.helper

Class HttpConnection.Response

java.lang.Object

org.jsoup.helper.HttpConnection.Base<Connection.Response>

org.jsoup.helper.HttpConnection.Response

All Implemented Interfaces:

Connection.Base<Connection.Response>, Connection.Response

Enclosing class:

HttpConnection

public static class HttpConnection.Response
extends HttpConnection.Base<Connection.Response>
implements Connection.Response

Field Summary

Fields

Modifier and Type	Field	Description
private ControllableInputStream	bodyStream
private ByteBuffer	byteData
private String	charset
private HttpURLConnection	conn
private final String	contentType
private boolean	executed
private boolean	inputStreamRead
private static final String	LOCATION
private static final int	MAX_REDIRECTS
private int	numRedirects
private final HttpConnection.Request	req
private final int	statusCode
private final String	statusMessage
private static final Pattern	xmlContentTypeRxp

Fields inherited from class org.jsoup.helper.HttpConnection.Base

cookies, headers, method, url

Constructor Summary

Constructors

Modifier	Constructor	Description
(package private)	Response()	Internal only! Creates a dummy HttpConnection.Response, useful for testing.
private	Response(HttpURLConnection conn, HttpConnection.Request request, HttpConnection.Response previousResponse)

Method Summary

Modifier and Type	Method	Description
String	body()	Get the body of the response as a plain string.
byte[]	bodyAsBytes()	Get the body of the response as an array of bytes.
BufferedInputStream	bodyStream()	Get the body of the response as a (buffered) InputStream.
Connection.Response	bufferUp()	Read the body of the response into a local buffer, so that Connection.Response.parse() may be called repeatedly on the same connection response.
String	charset()	Get the character set name of the response, derived from the content-type header.
HttpConnection.Response	charset(String charset)	Set / override the response character set.
String	contentType()	Get the response content type (e.g.
private static HttpURLConnection	createConnection(HttpConnection.Request req)
private static LinkedHashMap<String,List<String>>	createHeaderMap(HttpURLConnection conn)
(package private) static HttpConnection.Response	execute(HttpConnection.Request req)
(package private) static HttpConnection.Response	execute(HttpConnection.Request req, HttpConnection.Response previousResponse)
private static String	fixHeaderEncoding(String val)	Servers may encode response headers in UTF-8 instead of RFC defined 8859.
private static boolean	looksLikeUtf8(byte[] input)
Document	parse()	Read and parse the body of the response as a Document.
private void	prepareByteData()
(package private) void	processResponseHeaders(Map<String,List<String>> resHeaders)
private void	safeClose()	Call on completion of stream read, to close the body (or error) stream.
private static void	serialiseRequestUrl(Connection.Request req)
private static String	setOutputContentType(Connection.Request req)
int	statusCode()	Get the status code of the response.
String	statusMessage()	Get the status message of the response.
private static void	writePost(Connection.Request req, OutputStream outputStream, String boundary)

Methods inherited from class org.jsoup.helper.HttpConnection.Base

addHeader, cookie, cookie, cookies, hasCookie, hasHeader, hasHeaderWithValue, header, header, headers, headers, method, method, multiHeaders, removeCookie, removeHeader, url, url

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jsoup.Connection.Base

addHeader, cookie, cookie, cookies, hasCookie, hasHeader, hasHeaderWithValue, header, header, headers, headers, method, method, multiHeaders, removeCookie, removeHeader, url, url

Field Details

MAX_REDIRECTS

private static final int MAX_REDIRECTS

See Also:

• Constant Field Values

LOCATION

private static final String LOCATION

See Also:

• Constant Field Values

statusCode

private final int statusCode

statusMessage

private final String statusMessage

byteData

private ByteBuffer byteData

bodyStream

private ControllableInputStream bodyStream

conn

private HttpURLConnection conn

charset

private String charset

contentType

private final String contentType

executed

private boolean executed

inputStreamRead

private boolean inputStreamRead

numRedirects

private int numRedirects

req

private final HttpConnection.Request req

xmlContentTypeRxp

private static final Pattern xmlContentTypeRxp

Constructor Details

Response

Response()

Internal only! Creates a dummy HttpConnection.Response, useful for testing. All actual responses are created from the HttpURLConnection and fields defined.

Response

private Response(HttpURLConnection conn,
 HttpConnection.Request request,
 HttpConnection.Response previousResponse)
          throws IOException

Throws:

IOException

Method Details

execute

static HttpConnection.Response execute(HttpConnection.Request req)
                                throws IOException

Throws:

IOException

execute

static HttpConnection.Response execute(HttpConnection.Request req,
 HttpConnection.Response previousResponse)
                                throws IOException

Throws:

IOException

statusCode

public int statusCode()

Description copied from interface: Connection.Response

Get the status code of the response.

Specified by:

statusCode in interface Connection.Response

Returns:

status code

statusMessage

public String statusMessage()

Description copied from interface: Connection.Response

Get the status message of the response.

Specified by:

statusMessage in interface Connection.Response

Returns:

status message

charset

public String charset()

Description copied from interface: Connection.Response

Get the character set name of the response, derived from the content-type header.

Specified by:

charset in interface Connection.Response

Returns:

character set name if set, null if not

charset

public HttpConnection.Response charset(String charset)

Description copied from interface: Connection.Response

Set / override the response character set. When the document body is parsed it will be with this charset.

Specified by:

charset in interface Connection.Response

Parameters:

charset - to decode body as

Returns:

this Response, for chaining

contentType

public String contentType()

Description copied from interface: Connection.Response

Get the response content type (e.g. "text/html");

Specified by:

contentType in interface Connection.Response

Returns:

the response content type, or null if one was not set

parse

public Document parse()
               throws IOException

Description copied from interface: Connection.Response

Read and parse the body of the response as a Document. If you intend to parse the same response multiple times, you should Connection.Response.bufferUp() first.

Specified by:

parse in interface Connection.Response

Returns:

a parsed Document

Throws:

IOException - on error

prepareByteData

private void prepareByteData()

body

public String body()

Description copied from interface: Connection.Response

Get the body of the response as a plain string.

Specified by:

body in interface Connection.Response

Returns:

body

bodyAsBytes

public byte[] bodyAsBytes()

Description copied from interface: Connection.Response

Get the body of the response as an array of bytes.

Specified by:

bodyAsBytes in interface Connection.Response

Returns:

body bytes

bufferUp

public Connection.Response bufferUp()

Description copied from interface: Connection.Response

Read the body of the response into a local buffer, so that Connection.Response.parse() may be called repeatedly on the same connection response. Otherwise, once the response is read, its InputStream will have been drained and may not be re-read.

Calling Connection.Response.body() or Connection.Response.bodyAsBytes() has the same effect.

Specified by:

bufferUp in interface Connection.Response

Returns:

this response, for chaining

bodyStream

public BufferedInputStream bodyStream()

Description copied from interface: Connection.Response

Get the body of the response as a (buffered) InputStream. You should close the input stream when you're done with it.

Other body methods (like bufferUp, body, parse, etc) will generally not work in conjunction with this method, as it consumes the InputStream.

Any configured max size or maximum read timeout applied to the connection will not be applied to this stream, unless Connection.Response.bufferUp() is called prior.

This method is useful for writing large responses to disk, without buffering them completely into memory first.

Specified by:

bodyStream in interface Connection.Response

Returns:

the response body input stream

createConnection

private static HttpURLConnection createConnection(HttpConnection.Request req)
                                           throws IOException

Throws:

IOException

safeClose

private void safeClose()

Call on completion of stream read, to close the body (or error) stream. The connection.disconnect allows keep-alives to work (as the underlying connection is actually held open, despite the name).

createHeaderMap

private static LinkedHashMap<String,List<String>> createHeaderMap(HttpURLConnection conn)

processResponseHeaders

void processResponseHeaders(Map<String,List<String>> resHeaders)

fixHeaderEncoding

private static String fixHeaderEncoding(String val)

Servers may encode response headers in UTF-8 instead of RFC defined 8859. This method attempts to detect that and re-decode the string as UTF-8.

Parameters:

val - a header value string that may have been incorrectly decoded as 8859.

Returns:

a potentially re-decoded string.

looksLikeUtf8

private static boolean looksLikeUtf8(byte[] input)

setOutputContentType

private static String setOutputContentType(Connection.Request req)

writePost

private static void writePost(Connection.Request req,
 OutputStream outputStream,
 String boundary)
                       throws IOException

Throws:

IOException

serialiseRequestUrl

private static void serialiseRequestUrl(Connection.Request req)
                                 throws IOException

Throws:

IOException