com.google.api.client.http
Class HttpResponse

java.lang.Object
  com.google.api.client.http.HttpResponse

public final class HttpResponse
extends Object

HTTP response.

Implementation is not thread-safe.

Since:

1.0

Author:

Yaniv Inbar

Method Summary

void	disconnect() Disconnect using LowLevelHttpResponse.disconnect().
InputStream	getContent() Returns the content of the HTTP response.
String	getContentEncoding() Returns the content encoding or null for none.
int	getContentLoggingLimit() Returns the limit to the content size that will be logged during getContent().
String	getContentType() Returns the content type or null for none.
boolean	getDisableContentLogging() Deprecated. (scheduled to be removed in 1.8) Use getContentLoggingLimit()
HttpHeaders	getHeaders() Returns the HTTP response headers.
HttpParser	getParser() Returns the HTTP response content parser to use for the content type of this HTTP response or null for none.
HttpRequest	getRequest() Returns the HTTP request.
int	getStatusCode() Returns the HTTP status code or 0 for none.
String	getStatusMessage() Returns the HTTP status message or null for none.
HttpTransport	getTransport() Returns the HTTP transport.
void	ignore() Closes the the content of the HTTP response from getContent(), ignoring any content.
boolean	isSuccessStatusCode() Returns whether received a successful HTTP status code >= 200 && < 300 (see getStatusCode()).
<T> T	parseAs(Class<T> dataClass) Parses the content of the HTTP response from getContent() and reads it into a data class of key/value pairs using the parser returned by getParser() .
String	parseAsString() Parses the content of the HTTP response from getContent() and reads it into a string.
HttpResponse	setContentLoggingLimit(int contentLoggingLimit) Set the limit to the content size that will be logged during getContent().
HttpResponse	setDisableContentLogging(boolean disableContentLogging) Deprecated. (scheduled to be removed in 1.8) Use setContentLoggingLimit(int)

Methods inherited from class java.lang.Object

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

Method Detail

getDisableContentLogging

@Deprecated
public boolean getDisableContentLogging()

Deprecated. (scheduled to be removed in 1.8) Use getContentLoggingLimit()

Sets whether to disable response content logging during getContent() (unless Level.ALL is loggable which forces all logging).

Since:

1.5

getContentLoggingLimit

public int getContentLoggingLimit()

Returns the limit to the content size that will be logged during getContent().

If the content size is greater than this limit then it will not be logged.

Can be set to 0 to disable content logging. This is useful for example if content has sensitive data such as authentication information.

Defaults to 100000 (100KB).

Since:

1.7

setDisableContentLogging

@Deprecated
public HttpResponse setDisableContentLogging(boolean disableContentLogging)

Deprecated. (scheduled to be removed in 1.8) Use setContentLoggingLimit(int)

Sets whether to disable response content logging during getContent() (unless Level.ALL is loggable which forces all logging).

Useful for example if content has sensitive data such as an authentication token. Defaults to false.

Since:

1.5

setContentLoggingLimit

public HttpResponse setContentLoggingLimit(int contentLoggingLimit)

Set the limit to the content size that will be logged during getContent().

If the content size is greater than this limit then it will not be logged.

Can be set to 0 to disable content logging. This is useful for example if content has sensitive data such as authentication information.

Defaults to 100000 (100KB).

Since:

1.7

getContentEncoding

public String getContentEncoding()

Returns the content encoding or null for none.

Since:

1.5

getContentType

public String getContentType()

Returns the content type or null for none.

Since:

1.5

getHeaders

public HttpHeaders getHeaders()

Returns the HTTP response headers.

Since:

1.5

isSuccessStatusCode

public boolean isSuccessStatusCode()

Returns whether received a successful HTTP status code >= 200 && < 300 (see getStatusCode()).

Since:

1.5

getStatusCode

public int getStatusCode()

Returns the HTTP status code or 0 for none.

Since:

1.5

getStatusMessage

public String getStatusMessage()

Returns the HTTP status message or null for none.

Since:

1.5

getTransport

public HttpTransport getTransport()

Returns the HTTP transport.

Since:

1.5

getRequest

public HttpRequest getRequest()

Returns the HTTP request.

Since:

1.5

getContent

public InputStream getContent()
                       throws IOException

Returns the content of the HTTP response.

The result is cached, so subsequent calls will be fast.

Returns:

input stream content of the HTTP response or null for none

Throws:

IOException - I/O exception

ignore

public void ignore()
            throws IOException

Closes the the content of the HTTP response from getContent(), ignoring any content.

Throws:

IOException

disconnect

public void disconnect()
                throws IOException

Disconnect using LowLevelHttpResponse.disconnect().

Throws:

IOException

Since:

1.4

getParser

public HttpParser getParser()

Returns the HTTP response content parser to use for the content type of this HTTP response or null for none.

parseAs

public <T> T parseAs(Class<T> dataClass)
          throws IOException

Parses the content of the HTTP response from getContent() and reads it into a data class of key/value pairs using the parser returned by getParser() .

Returns:

parsed data class or null for no content

Throws:

IOException - I/O exception

IllegalArgumentException - if no parser is defined for the given content type or if there is no content type defined in the HTTP response

parseAsString

public String parseAsString()
                     throws IOException

Parses the content of the HTTP response from getContent() and reads it into a string.

Since this method returns "" for no content, a simpler check for no content is to check if getContent() is null.

Returns:

parsed string or "" for no content

Throws:

IOException - I/O exception