Class CQ.HTTP

Package:	CQ
Class:	HTTP
Extends:	Object
Clientlib:	cq.widgets

A helper class providing a set of HTTP-related utilities.
The response object returned by the methods get and post has the following properties:

body: String
The response body
headers: Object
The response headers:
Status: Number
The status code
Message: String
(optional) The status message
Location: String
(optional) The location
Path: String
(optional) The path

You can use the isOk method to verify the response object.

This class is a singleton and cannot be created directly.

Public Properties

Property		Defined By
	EXTENSION_HTML : String Deprecated: use CQ.shared.HTTP.EXTENSION_HTML instead <static> The extension for HTML files.	HTTP
	EXTENSION_JSON : String Deprecated: use CQ.shared.HTTP.EXTENSION_JSON instead <static> The extension for JSON files.	HTTP
	HEADER_LOCATION : String Deprecated: use CQ.shared.HTTP.HEADER_LOCATION instead <static> The Location header.	HTTP
	HEADER_MESSAGE : String Deprecated: use CQ.shared.HTTP.HEADER_MESSAGE instead <static> The Message header.	HTTP
	HEADER_PATH : String Deprecated: use CQ.shared.HTTP.HEADER_PATH instead <static> The Path header.	HTTP
	HEADER_STATUS : String Deprecated: use CQ.shared.HTTP.HEADER_STATUS instead <static> The Status header.	HTTP
	PARAM_NO_CACHE : String Deprecated: use CQ.shared.HTTP.PARAM_NO_CACHE instead <static> The parameter name for no caching.	HTTP

Public Methods

Method		Defined By
	addParameter( `String url`, `String name`, `String/String[] value` ) : String Deprecated: use CQ.shared.HTTP.addParameter instead <static> Adds a parameter to the specified URL. The parameter name and value will be URL-endcoded. <static> Adds a parameter to the specified URL. The parameter name and value will be URL-endcoded. Parameters: `url` : String The URL `name` : String The name of the parameter `value` : String/String[] The value of the parameter. Since 5.3, an array of strings can be passed Returns: `String` The URL with the new parameter	HTTP
	addSelector( `String url`, `String selector`, [`Number index`] ) : String Deprecated: use CQ.shared.HTTP.addSelector instead Adds the specified selector to an URL. Adds the specified selector to an URL. Parameters: `url` : String The URL. The URL must contain a extension and must not contain a suffix (x.json/a/b). Anchor and request parameters are supported. `selector` : String The name of the selector to insert `index` : Number (optional) The index of the selector. If it is "-1" or bigger than the number of the existing selectors the selector will be appended. Defaults to "0". Returns: `String` The updated URL Added in CQ 5.3.	HTTP
	clearCookie( `String name`, [`String path`], [`String domain`], [`Boolean secure`] ) : void Deprecated: use CQ.shared.HTTP.clearCookie instead <static> Clears the cookie with the specified name. <static> Clears the cookie with the specified name. Parameters: `name` : String The name of the cookie `path` : String (optional) The server path the cookie applies to `domain` : String (optional) The server domain `secure` : Boolean (optional) True if the connection is secure Returns: `void`	HTTP
	encodePath( `String path` ) : String Deprecated: use CQ.shared.HTTP.encodePath instead Encodes the specified path using encodeURI. Additionally +, # and ? are encoded. The following characters are not enc... Encodes the specified path using encodeURI. Additionally `+`, `#` and `?` are encoded. The following characters are not encoded: `0-9 a-z A-Z` `- _ . ! ~ * ( )` `/ : @ & =` Parameters: `path` : String The path to encode Returns: `String` The encoded path Added in CQ 5.3.	HTTP
	encodePathOfURI( `String url` ) : String Deprecated: use CQ.shared.HTTP.encodePathOfURI instead Encodes the path of the specified URL if it is not already encoded. Path means the part of the URL before the first q... Encodes the path of the specified URL if it is not already encoded. Path means the part of the URL before the first question mark or hash sign. See CQ.shared.HTTP.encodePath for details about the encoding. Sample: `/x/y+z.png?path=/x/y+z >> /x/y%2Bz.png?path=x/y+z` Note that the sample would not work because the "+" in the request parameter would be interpreted as a space. Parameters must be encoded separately. Parameters: `url` : String The URL to encoded Returns: `String` The encoded URL Added in CQ 5.3.	HTTP
	eval( `Object/String response` ) : Object Deprecated: use CQ.shared.HTTP.eval instead <static> Evaluates and returns the body of the specified response object. Alternatively, a URL can be specified... <static> Evaluates and returns the body of the specified response object. Alternatively, a URL can be specified, in which case it will be requested using a synchornous get in order to acquire the response object. Parameters: `response` : Object/String The response object or URL Returns: `Object` The evaluated response body Added in CQ 5.3.	HTTP
	externalize( `String url`, [`boolean encode`] ) : String Deprecated: use CQ.shared.HTTP.externalize instead <static> Makes sure the specified relative URL starts with the context path used on the server. If an absolute ... <static> Makes sure the specified relative URL starts with the context path used on the server. If an absolute URL is passed, it will be returned as-is. Parameters: `url` : String The URL `encode` : boolean true to encode the path of the URL (optional) Returns: `String` The externalized URL Added in CQ 5.3.	HTTP
	get( `String url`, [`Function callback`], [`Object scope`] ) : Mixed <static> Requests the specified URL from the server using GET. The request will be synchronous, unless a callba... <static> Requests the specified URL from the server using GET. The request will be synchronous, unless a callback function is specified. Parameters: `url` : String The URL to request `callback` : Function (optional) The callback function which is called regardless of success or failure and is passed the following parameters: options : Object The parameter to the request call. success : Boolean True if the request succeeded. response : Object The response object. `scope` : Object The scope for the callback (optional) Returns: `Mixed` The response object or, if the request is asynchronous, the transaction ID	HTTP
	getAnchor( `String url` ) : String Deprecated: use CQ.shared.HTTP.getAnchor instead <static> Returns the anchor part of the URL. <static> Returns the anchor part of the URL. Parameters: `url` : String The URL Returns: `String` The anchor	HTTP
	getContextPath() : String Deprecated: use CQ.shared.HTTP.getContextPath instead <static> Returns the context path used on the server. <static> Returns the context path used on the server. Parameters: None. Returns: `String` The context path Added in CQ 5.3.	HTTP
	getCookie( `String name` ) : String Deprecated: use CQ.shared.HTTP.getCookie instead <static> Returns the value of the cookie with the specified name. <static> Returns the value of the cookie with the specified name. Parameters: `name` : String The name of the cookie Returns: `String` The value of the cookie	HTTP
	getExtension( `String url` ) : String Deprecated: use CQ.shared.HTTP.getExtension instead Returns the extension of an URL. This is the string after the last dot until the end of the url without any request p... Returns the extension of an URL. This is the string after the last dot until the end of the url without any request parameters, anchors or suffix, for example "html". Parameters: `url` : String The URL Returns: `String` The URL extension (without the dot) or an empty string if no was found. Added in CQ 5.4.	HTTP
	getParameter( `String url`, `String name` ) : String Deprecated: use CQ.shared.HTTP.getParameter instead <static> Returns the value of the parameter with the specified name in the URL. Only the first value will be co... <static> Returns the value of the parameter with the specified name in the URL. Only the first value will be considered. Values will be URL-decoded. Parameters: `url` : String The URL `name` : String The name of the parameter Returns: `String` The value	HTTP
	getParameters( `String url`, `String name` ) : String[] Deprecated: use CQ.shared.HTTP.getParameters instead <static> Returns the values of the parameters with the specified name in the URL. Values will be URL-decoded. <static> Returns the values of the parameters with the specified name in the URL. Values will be URL-decoded. Parameters: `url` : String The URL `name` : String The name of the parameter Returns: `String[]` The values	HTTP
	getPath( `String url` ) : String Deprecated: use CQ.shared.HTTP.getPath instead <static> Removes all parts but the path from the specified URL. Examples:/x/y.sel.html?param=abc => /x/y htt... <static> Removes all parts but the path from the specified URL. Examples: `/x/y.sel.html?param=abc => /x/y` `http://www.day.com/foo/bar.html => /foo/bar` Parameters: `url` : String The URL Returns: `String` The path Added in CQ 5.3.	HTTP
	getSchemeAndAuthority( `String url` ) : String Deprecated: use CQ.shared.HTTP.getSchemeAndAuthority instead <static> Returns the scheme and authority (user, hostname, port) part of the specified URL or an empty string i... <static> Returns the scheme and authority (user, hostname, port) part of the specified URL or an empty string if the URL does not include that part. Parameters: `url` : String The URL Returns: `String` The scheme and authority part	HTTP
	getSelectors( `String url` ) : Array Deprecated: use CQ.shared.HTTP.getSelectors instead <static> Returns an array with the selectors present in the given url. If no selectors are present, an empty ar... <static> Returns an array with the selectors present in the given url. If no selectors are present, an empty array is returned. Parameters: `url` : String The URL Returns: `Array` An array containing the selectors or an empty array if none were found. Added in CQ 5.4.	HTTP
	getSuffix() : String Deprecated: use CQ.shared.HTTP.getSuffix instead <static> Returns the current request suffix as provided by CQURLInfo.suffix. <static> Returns the current request suffix as provided by CQURLInfo.suffix. Parameters: None. Returns: `String` The suffix Added in CQ 5.5.	HTTP
	internalize( `String url`, [`String doc`] ) : String Deprecated: use CQ.shared.HTTP.internalize instead <static> Removes scheme, authority and context path from the specified absolute URL if it has the same scheme a... <static> Removes scheme, authority and context path from the specified absolute URL if it has the same scheme and authority as the specified document (or the current one). Parameters: `url` : String The URL `doc` : String (optional) The document Returns: `String` The internalized URL Added in CQ 5.3.	HTTP
	isOk( `Object response` ) : Boolean Deprecated: use CQ.shared.HTTP.isOk instead <static> Checks if the specified response is OK. The response object is expected to look like this: { headers: ... <static> Checks if the specified response is OK. The response object is expected to look like this: `{ headers: { "Status": 200, ... } }` See constants above for all supported headers. Parameters: `response` : Object The response object Returns: `Boolean` True if the response is OK, else false	HTTP
	isOkStatus( `Number status` ) : Boolean Deprecated: use CQ.shared.HTTP.isOkStatus instead <static> Checks whether the specified status code is OK. <static> Checks whether the specified status code is OK. Parameters: `status` : Number The status code Returns: `Boolean` True if the status is OK, else false	HTTP
	multiPartPost( `String url`, [`Function callback`], `Object params`, `Object scope`, `Boolean suppressErrorMsg` ) : Mixed <static> Requests the specified URL from the server using multipart POST. The request will be synchronous, unle... <static> Requests the specified URL from the server using multipart POST. The request will be synchronous, unless a callback function is specified. The returned response object looks like this: `{ headers: { "Status": 200, ... } }` See constants above for all supported headers. Parameters: `url` : String The URL to request `callback` : Function (optional) The callback function which is called regardless of success or failure and is passed the following parameters: xhr : Object The XMLHttpRequest object containing the response data. See http://www.w3.org/TR/XMLHttpRequest/ for details about accessing elements of the response. `params` : Object The parameters `scope` : Object The scope for the callback `suppressErrorMsg` : Boolean Suppress the error msg notification Returns: `Mixed` The response object or, if the request is asynchronous, null	HTTP
	noCaching( `String url` ) : String Deprecated: use CQ.shared.HTTP.noCaching instead <static> Prevents caching by adding a timestamp to the specified URL. <static> Prevents caching by adding a timestamp to the specified URL. Parameters: `url` : String The URL Returns: `String` The URL with timestamp	HTTP
	post( `String url`, [`Function callback`], `Object params`, `Object scope`, `Boolean suppressErrorMsg` ) : Mixed <static> Requests the specified URL from the server using POST. The request will be synchronous, unless a callb... <static> Requests the specified URL from the server using POST. The request will be synchronous, unless a callback function is specified. The returned response object looks like this: `{ headers: { "Status": 200, ... } }` See constants above for all supported headers. Parameters: `url` : String The URL to request `callback` : Function (optional) The callback function which is called regardless of success or failure and is passed the following parameters: options : Object The parameter to the request call. success : Boolean True if the request succeeded. xhr : Object The XMLHttpRequest object containing the response data. See http://www.w3.org/TR/XMLHttpRequest/ for details about accessing elements of the response. response : Object The response object. Added in CQ 5.3 `params` : Object The parameters `scope` : Object The scope for the callback `suppressErrorMsg` : Boolean Suppress the error msg notification Returns: `Mixed` The response object or, if the request is asynchronous, the transaction ID	HTTP
	removeAnchor( `String url` ) : String Deprecated: use CQ.shared.HTTP.removeAnchor instead <static> Removes the anchor from the specified URL. <static> Removes the anchor from the specified URL. Parameters: `url` : String The URL Returns: `String` The URL without anchor	HTTP
	removeParameter( `String url`, `String name` ) : String Deprecated: use CQ.shared.HTTP.removeParameter instead <static> Removes a parameter from the specified URL. <static> Removes a parameter from the specified URL. Parameters: `url` : String The URL `name` : String The name of the parameter to remove Returns: `String` The URL without the parameter	HTTP
	removeParameters( `String url` ) : String Deprecated: use CQ.shared.HTTP.removeParameters instead <static> Removes all parameter from the specified URL. <static> Removes all parameter from the specified URL. Parameters: `url` : String The URL Returns: `String` The URL without parameters	HTTP
	setAnchor( `String url`, `String anchor` ) : String Deprecated: use CQ.shared.HTTP.setAnchor instead <static> Sets the anchor of the specified URL. <static> Sets the anchor of the specified URL. Parameters: `url` : String The URL `anchor` : String The anchor Returns: `String` The URL with anchor	HTTP
	setCookie( `String name`, `String value`, [`String path`], [`Number days`], [`String domain`], [`Boolean secure`] ) : String Deprecated: use CQ.shared.HTTP.setCookie instead <static> Sets the value of the cookie with the specified name. <static> Sets the value of the cookie with the specified name. Parameters: `name` : String The name of the cookie `value` : String The value of the cookie `path` : String (optional) The server path the cookie applies to `days` : Number (optional) The number of days the cookie will live `domain` : String (optional) The server domain `secure` : Boolean (optional) True if the connection is secure Returns: `String` The value of the cookie	HTTP
	setParameter( `String url`, `String name`, `String value` ) : String Deprecated: use CQ.shared.HTTP.setParameter instead <static> Overwrites a parameter in the specified URL. The parameter name and value will be URL-endcoded. <static> Overwrites a parameter in the specified URL. The parameter name and value will be URL-endcoded. Parameters: `url` : String The URL `name` : String The name of the parameter `value` : String The value of the parameter Returns: `String` The URL with the new parameter	HTTP
	setSelector( `String url`, `String selector`, `Number index` ) : String Deprecated: use CQ.shared.HTTP.setSelector instead Replaces the selector at the given index position. If no selector exists at the index position, no change is made to ... Replaces the selector at the given index position. If no selector exists at the index position, no change is made to the URL. Parameters: `url` : String The URL. `selector` : String The value with which to replace the selector. `index` : Number The index of the selector to set/replace. Returns: `String` The URL with the selector replaced. Added in CQ 5.4.	HTTP

Public Events

This class has no public events.