Package com.google.api.client.http

Class UrlEncodedContent

java.lang.Object

com.google.api.client.http.AbstractHttpContent

com.google.api.client.http.UrlEncodedContent

All Implemented Interfaces:

HttpContent, StreamingContent

public class UrlEncodedContent
extends AbstractHttpContent

Implements support for HTTP form content encoding serialization of type application/x-www-form-urlencoded as specified in the HTML 4.0 Specification.

Sample usage:

  static void setContent(HttpRequest request, Object item) {
    request.setContent(new UrlEncodedContent(item));
  }
 

Implementation is not thread-safe.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.Object	data	Key name/value data.

Constructor Summary

Constructors

Constructor	Description
UrlEncodedContent(java.lang.Object data)

Method Summary

Modifier and Type	Method	Description
private static boolean	appendParam(boolean first, java.io.Writer writer, java.lang.String name, java.lang.Object value)
static UrlEncodedContent	getContent(HttpRequest request)	Returns the URL-encoded content of the given HTTP request, or if none return and set as content a new instance of UrlEncodedContent (whose getData() is an implementation of Map).
java.lang.Object	getData()	Returns the key name/value data or null for none.
UrlEncodedContent	setData(java.lang.Object data)	Sets the key name/value data.
UrlEncodedContent	setMediaType(HttpMediaType mediaType)	Sets the media type to use for the Content-Type header, or null if unspecified.
void	writeTo(java.io.OutputStream out)	Writes the byte content to the given output stream.

Methods inherited from class com.google.api.client.http.AbstractHttpContent

computeLength, computeLength, getCharset, getLength, getMediaType, getType, retrySupported

Methods inherited from class java.lang.Object

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

Field Detail

data

private java.lang.Object data

Key name/value data.

Constructor Detail

UrlEncodedContent

public UrlEncodedContent(java.lang.Object data)

Parameters:

data - key name/value data

Method Detail

writeTo

public void writeTo(java.io.OutputStream out)
             throws java.io.IOException

Description copied from interface: StreamingContent

Writes the byte content to the given output stream.

Implementations must not close the output stream, and instead should flush the output stream. Some callers may assume that the the output stream has not been closed, and will fail to work if it has been closed.

Parameters:

out - output stream

Throws:

java.io.IOException

setMediaType

public UrlEncodedContent setMediaType(HttpMediaType mediaType)

Description copied from class: AbstractHttpContent

Sets the media type to use for the Content-Type header, or null if unspecified.

This will also overwrite any previously set parameter of the media type (for example "charset"), and therefore might change other properties as well.

Overrides:

setMediaType in class AbstractHttpContent

getData

public final java.lang.Object getData()

Returns the key name/value data or null for none.

Since:

1.5

setData

public UrlEncodedContent setData(java.lang.Object data)

Sets the key name/value data.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Since:

1.5

getContent

public static UrlEncodedContent getContent(HttpRequest request)

Returns the URL-encoded content of the given HTTP request, or if none return and set as content a new instance of UrlEncodedContent (whose getData() is an implementation of Map).

Parameters:

request - HTTP request

Returns:

URL-encoded content

Throws:

java.lang.ClassCastException - if the HTTP request has a content defined that is not UrlEncodedContent

Since:

1.7

appendParam

private static boolean appendParam(boolean first,
                                   java.io.Writer writer,
                                   java.lang.String name,
                                   java.lang.Object value)
                            throws java.io.IOException

Throws:

java.io.IOException