features.xmlutil.xmlutil.js Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of shindig-features
Packages all the features that shindig provides into a single jar file to allow loading from the classpath
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.
 */

var opensocial = opensocial || {};

opensocial.xmlutil = opensocial.xmlutil || {};

/**
 * Cached DOMParser objects on browsers that support it.
 * @private
 */
opensocial.xmlutil.parser_ = null;


/**
 * Parses an XML string into an XML Document.
 * @param {string} str A string of well-formed XML.
 * @return {Document} XML document.
 */
opensocial.xmlutil.parseXML = function(str) {
  if (typeof(DOMParser) != 'undefined') {
    opensocial.xmlutil.parser_ = opensocial.xmlutil.parser_ || new DOMParser();
    var doc = opensocial.xmlutil.parser_.parseFromString(str, 'text/xml');
    if (doc.firstChild && doc.firstChild.tagName == 'parsererror') {
      throw Error(doc.firstChild.firstChild.nodeValue);
    }
    return doc;
  } else if (typeof(ActiveXObject) != 'undefined') {
    var doc = new ActiveXObject('MSXML2.DomDocument');
    doc.validateOnParse = false;
    doc.loadXML(str);
    if (doc.parseError && doc.parseError.errorCode) {
      throw Error(doc.parseError.reason);
    }
    return doc;
  }
  throw Error('No XML parser found in this browser.');
};


/**
 * Map of Namespace prefixes to their respective URLs.
 * @type {Object.}
 */
opensocial.xmlutil.NSMAP = {
  'os': 'http://opensocial.org/'
};


/**
 * Returns the XML namespace declarations that need to be injected into a
 * particular XML-like snippet to make it valid XML. Uses the defined
 * namespaces to see which are available, and checks that they are used in
 * the supplied code. An empty string is returned if no injection is needed.
 *
 * @param {string} xml XML-like source code.
 * @param {Element=} opt_container Optional container node to look for namespace
 * declarations.
 * @return {string} A string of xmlns delcarations required for this XML.
 */
opensocial.xmlutil.getRequiredNamespaces = function(xml, opt_container) {
  var namespaces = opt_container ?
      opensocial.xmlutil.getNamespaceDeclarations_(opt_container) : {};
  for (var prefix in opensocial.xmlutil.NSMAP) {
    if (opensocial.xmlutil.NSMAP.hasOwnProperty(prefix) &&
        !namespaces.hasOwnProperty(prefix) &&
        xml.indexOf('<' + prefix + ':') >= 0 &&
        xml.indexOf('xmlns:' + prefix + ':') < 0) {
      namespaces[prefix] = opensocial.xmlutil.NSMAP[prefix];
    }
  }
  return opensocial.xmlutil.serializeNamespaces_(namespaces);
};

/**
 * @private
 * @return {string}
 */
opensocial.xmlutil.serializeNamespaces_ = function(namespaces) {
  var buffer = [];
  for (var prefix in namespaces) {
    if (namespaces.hasOwnProperty(prefix)) {
      buffer.push(' xmlns:', prefix, '=\"', namespaces[prefix], '\"');
    }
  }
  return buffer.join('');
};


/**
 * Returns a map of XML namespaces declared on an DOM Element.
 * @param {Element} el The Element to inspect.
 * @return {Object.} A Map of keyed by prefix of declared
 *     namespaces.
 * @private
 */
opensocial.xmlutil.getNamespaceDeclarations_ = function(el) {
  var namespaces = {};
  for (var i = 0; i < el.attributes.length; i++) {
    var name = el.attributes[i].nodeName;
    if (name.substring(0, 6) != 'xmlns:') {
      continue;
    }
    namespaces[name.substring(6, name.length)] = el.getAttribute(name);
  }
  return namespaces;
};


/**
 * XHTML Entities we need to support in XML, definted in DOCTYPE declaration.
 *
 * TODO: A better way to do this.
 */
opensocial.xmlutil.ENTITIES = '';


/**
 * Prepares an XML-like string to be parsed by browser parser. Injects a DOCTYPE
 * with entities and a top-level  element to encapsulate the code.
 * @param {string} xml XML string to be prepared.
 * @param {Element=} opt_container Optional container Element with namespace
 * declarations.
 * @return {string} XML string prepared for client-side parsing.
 */
opensocial.xmlutil.prepareXML = function(xml, opt_container) {
  var namespaces = opensocial.xmlutil.getRequiredNamespaces(xml, opt_container);
  return '' + xml + '';
};