Class PTHTTPRequest

Object
   |
   +--PTHTTPRequest

Direct Known Subclasses:

PTHTTPPOSTRequest, PTHTTPGETRequest

class PTHTTPRequest

Abstract superclass for PTHTTPGETRequest and PTHTTPPOSTRequest. Invoking a PTHTTPRequest will cause a background HTTP request to be sent to the server without reloading the contents of the browser. PTHTTPRequests can be set to automatically refresh the inner HTML of an element on the page, or to have the HTTP response that they generate be handled by a JavaScript function. Note that this class should not be used or instantiated directly.
Defined in PTXML.js

Field Detail

responsePostProcHandler

Function responsePostProcHandler

A reference to a function that will be called (and passed a PTHTTPResponse object) after either the callback is invoked or the targetElement's innerHTML is set. This field can also be set using the String name of a function. (Optional)

responsePreProcHandler

Function responsePreProcHandler

A reference to a function that will be called (and passed a PTHTTPResponse object) before either the callback is invoked or the targetElement's innerHTML is set. If this method returns false, further processing is halted. This field can also be set using the String name of a function. (Optional)

REQUEST_TYPE_CLIENT_SIDE

<static> <final> Object REQUEST_TYPE_CLIENT_SIDE

Enumerated Request type for client side requests

See Also:

Constant Field Values

REQUEST_TYPE_HEADER

<static> <final> String REQUEST_TYPE_HEADER

Request Header containing the type of request being generated

See Also:

Constant Field Values

REQUEST_TYPE_PORTLET_REFRESH

<static> <final> Object REQUEST_TYPE_PORTLET_REFRESH

Enumerated Request type for portlet refresh requests

See Also:

Constant Field Values

VERSION

<static> <final> Object VERSION

See Also:

Constant Field Values

PTHTTPRequest

PTHTTPRequest()

Abstract superclass for PTHTTPGETRequest and PTHTTPPOSTRequest. Note that this class should not be used or instantiated directly.

invoke

Object invoke(loadMessageCommand)

Invoke the HTTP request, sending the request to a server and executing any actions required by the response.

Parameters:
loadMessageCommand - A JavaScript string to be evaluated when a response is being loaded as content

setRequestHeader

void setRequestHeader(header, value)

Sets a client http request header for the request.

Parameters:
header - the request header name
value - the request header value

setResponseHandler

void setResponseHandler(responseHandler)

Sets the appropriate response handler for the request

Parameters:
responseHandler - This can be either a callback function to call and pass back results of the request (string or Function) or it can be a target HTML element, whose innerHTML property will be set from the response text