META-INF.adf.jsLibsDebug.xhr.XMLRequestEvent.js Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of trinidad-impl Show documentation
Private implementation of the Apache MyFaces Trinidad project
The newest version!
/*
 *  Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you under the Apache License, Version 2.0 (the
 *  "License"); you may not use this file except in compliance
 *  with the License.  You may obtain a copy of the License at
 * 
 *  http://www.apache.org/licenses/LICENSE-2.0
 * 
 *  Unless required by applicable law or agreed to in writing,
 *  software distributed under the License is distributed on an
 *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 *  KIND, either express or implied.  See the License for the
 *  specific language governing permissions and limitations
 *  under the License.
 */

/**
 * AJAX Request Event class. This object is passed back to the listeners
 * of a AJAX Service Request. It support ITrXMLRequestEvent pseudo-interface
 * with the following methods: getStatus, getResponseXML, getResponseText, 
 * isPprResponse, getResponseContentType
 */
function TrXMLRequestEvent(
  status,
  request,
  source,
  formId
  )
{
  this._status = status;
  this._request = request;
  this._source = source;
  this._formId = formId;
}

TrXMLRequestEvent.STATUS_QUEUED = 1;
TrXMLRequestEvent.STATUS_SEND_BEFORE = 2;
TrXMLRequestEvent.STATUS_SEND_AFTER = 3;
TrXMLRequestEvent.STATUS_COMPLETE = 4;

TrXMLRequestEvent.prototype.getFormId = function()
{
  return this._formId;
}

TrXMLRequestEvent.prototype.getStatus = function()
{
  return this._status;
}

TrXMLRequestEvent.prototype.getSource = function()
{
  return this._source;
}

/**
* Returns the response of the AJAX Request as an XML document
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype.getResponseXML = function()
{
  return this._request.getResponseXML();
}

/**
* Returns true if the response XML of the AJAX Request is valid.
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype._isResponseValidXML = function()
{         
  // Note: Mozilla applies default XSLT to XML parse error
  var responseDocument = this._request.getResponseXML();
  if (!responseDocument)
    return false;

  var docElement = responseDocument.documentElement;
  if (!docElement)
    return false;

  var nodeName = docElement.nodeName;
  if (!nodeName)
    nodeName = docElement.tagName;

  if (nodeName == "parsererror")
    return false;

  return true;
}

/**
* Returns the response of the AJAX Request as text.
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype.getResponseText = function()
{  
  return this._request.getResponseText();
}

/**
* Returns the status code of the xml http AJAX Request.
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype.getResponseStatusCode = function()
{
  return this._request.getStatus();
}

/**
* Returns all the response headers for xml http AJAX Request.
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype._getAllResponseHeaders = function()
{
  return this._request.getAllResponseHeaders();
}

/**
* Returns a particular response header for xml http Request.
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype.getResponseHeader = function(
  name
  )
{
  // Note: Mozilla chokes when we ask for a response header that does not exist
  var allHeaders = this._request.getAllResponseHeaders();
  return (allHeaders.indexOf(name) != -1) ?
           this._request.getResponseHeader(name)
           : null;
}

/**
* Returns if whether if is a rich response
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
// TODO: this should likely be deleted or renamed, as it is
// not PPR-specific here
TrXMLRequestEvent.prototype.isPprResponse = function()
{
  // todo: do we need to mark rich responses?
  // var responseType = this.getResponseHeader("Tr-XHR-Response-Type");
  var isrich = true;
  if (isrich && (!this._isResponseValidXML()))
  {
    TrRequestQueue._logError("Invalid PPR response."+
        " The response-headers were:\n"+
        this._getAllResponseHeaders() +
        "\n The invalid response was:\n"+
        this.getResponseText());
  }
  return isrich;
}

/**
* Returns if whether if is a rich response
* NOTE: this method is valid only for TrXMLRequestEvent.STATUS_COMPLETE
**/
TrXMLRequestEvent.prototype.getResponseContentType = function()
{
  this.getResponseHeader("Content-Type");
}

/**
 * Returns if the request was made by the built in JSF AJAX APIs
 */
TrXMLRequestEvent.prototype.isJsfAjaxRequest = function()
{
  return (this._request instanceof TrXMLJsfAjaxRequest);
};