Class DocumentInfo

java.lang.Object

com.codename1.ui.html.DocumentInfo

public class DocumentInfo
extends Object

DocumentInfo holds important information about a document that is loading. This class is constructed internally by HTMLComponent and HTMLForm and is sent to the RequestHandler. It is intended for the RequestHandler to use and update (For example update encoding according to the HTTP response, update URL in case of a redirect etc.)

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ENCODING_ISO	ISO-8859-1 encoding, the default one
static final String	ENCODING_UTF8	UTF8 encoding, very common
static final int	TYPE_CSS	Indicates that the request is for a CSS file
static final int	TYPE_HTML	Indicates that the request is for a page
static final int	TYPE_IMAGE	Indicates that the request is for an image

Method Summary

Modifier and Type	Method	Description
String	getBaseURL()	Returns the base URL for this document
String	getEncoding()	Returns a string describing the document's encoding
int	getExpectedContentType()	Returns the expected content type, one of TYPE_HTML, TYPE_IMAGE or TYPE_CSS
String	getFullUrl()	Returns the full url string including parameters in GET request
String	getParams()	Returns the request paramter as a percentage-encoded string
String	getUrl()	Returns the absolute URL associated with this DocumentInfo object
boolean	isPostRequest()	Returns whether this document request is a POST request or not
void	setBaseURL(String baseURL)	Sets the base URL for this document.
static void	setDefaultEncoding(String encoding)	Sets the default encoding for the document e.g.
void	setEncoding(String encoding)	Sets the document encoding (This can be determined via the charset attribute in the response)
void	setExpectedContentType(int requestType)	Sets this expected content type to be either TYPE_HTML, TYPE_IMAGE or TYPE_CSS When the document itself is requested the type will be TYPE_HTML and when images in the document are requested the type will be TYPE_IMAGE The differentiation is important to handle cases in which the HTMLComponent expects one type but the URL is has a resource of another type
void	setParams(String params)	Sets the request paramters of this request
void	setPostRequest(boolean postRequest)	Sets this DocumentInfo as using a POST request or not
void	setUrl(String url)	Sets the URL to the specified URL

Methods inherited from class Object

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

Field Details

ENCODING_ISO

public static final String ENCODING_ISO

ISO-8859-1 encoding, the default one

See Also:

• Constant Field Values

ENCODING_UTF8

public static final String ENCODING_UTF8

UTF8 encoding, very common

See Also:

• Constant Field Values

TYPE_HTML

public static final int TYPE_HTML

Indicates that the request is for a page

See Also:

• Constant Field Values

TYPE_IMAGE

public static final int TYPE_IMAGE

Indicates that the request is for an image

See Also:

• Constant Field Values

TYPE_CSS

public static final int TYPE_CSS

Indicates that the request is for a CSS file

See Also:

• Constant Field Values

Method Details

setDefaultEncoding

public static void setDefaultEncoding(String encoding)

Sets the default encoding for the document e.g. ENCODING_UTF8

Parameters

• encoding: the encoding string matching ISO standards

getUrl

public String getUrl()

Returns the absolute URL associated with this DocumentInfo object

Returns

the absolute URL associated with this DocumentInfo object

setUrl

public void setUrl(String url)

Sets the URL to the specified URL

Parameters

• url: the URL to set as the URL of the document

getFullUrl

public String getFullUrl()

Returns the full url string including parameters in GET request

Returns

the full url string including parameters in GET request

getExpectedContentType

public int getExpectedContentType()

Returns the expected content type, one of TYPE_HTML, TYPE_IMAGE or TYPE_CSS

Returns

the expected content type, one of TYPE_HTML, TYPE_IMAGE or TYPE_CSS

setExpectedContentType

public void setExpectedContentType(int requestType)

Sets this expected content type to be either TYPE_HTML, TYPE_IMAGE or TYPE_CSS When the document itself is requested the type will be TYPE_HTML and when images in the document are requested the type will be TYPE_IMAGE The differentiation is important to handle cases in which the HTMLComponent expects one type but the URL is has a resource of another type

Parameters

• requestType: the requestType to set, one of TYPE_HTML, TYPE_IMAGE or TYPE_CSS

isPostRequest

public boolean isPostRequest()

Returns whether this document request is a POST request or not

Returns

true if the document was requested via POST, false otherwise

setPostRequest

public void setPostRequest(boolean postRequest)

Sets this DocumentInfo as using a POST request or not

Parameters

• postRequest: true if this is a POST request, false otherwise

getParams

public String getParams()

Returns the request paramter as a percentage-encoded string

Returns

the request paramter as an encoded string

setParams

public void setParams(String params)

Sets the request paramters of this request

Parameters

• params: The request paramters to set, should be as a percentage encoded string

getEncoding

public String getEncoding()

Returns a string describing the document's encoding

Returns

the document's encoding

setEncoding

public void setEncoding(String encoding)

Sets the document encoding (This can be determined via the charset attribute in the response)

Parameters

• encoding: the encoding to set. It is recommended to use the ENCODING_* constants when possible to avoid typos

getBaseURL

public String getBaseURL()

Returns the base URL for this document

Returns

the baseURL

setBaseURL

public void setBaseURL(String baseURL)

Sets the base URL for this document. Usually this is deduced automatically from the page URL, but in some cases this is different, for example when an HREF attribute is provided in the BASE tag

Parameters

• baseURL: the baseURL to set