jsdav-ext/lib/DAV/property/href.js

jsDAV allows you to easily add WebDAV support to a NodeJS application. jsDAV is meant to cover the entire standard, and attempts to allow integration using an easy to understand API.

/*
 * @package jsDAV
 * @subpackage DAV
 * @copyright Copyright(c) 2013 Mike de Boer. <info AT mikedeboer DOT nl>
 * @author Mike de Boer <info AT mikedeboer DOT nl>
 * @license http://github.com/mikedeboer/jsDAV/blob/master/LICENSE MIT License
 */

"use strict";

var jsDAV_Property_iHref = require("./../interfaces/iHref");

var Xml = require("./../../shared/xml");

var jsDAV_Property_Href = module.exports = jsDAV_Property_iHref.extend({
    initialize: function(href, autoPrefix) {
        this.href       = href;
        this.autoPrefix = typeof autoPrefix == "boolean" ? autoPrefix : true;
    },

    /**
     * Returns the uri
     *
     * @return string
     */
    getHref: function() {
        return this.href;
    },

    /**
     * Serializes this property.
     *
     * It will additionally prepend the href property with the server's base uri.
     *
     * @param Sabre_DAV_Server server
     * @param DOMElement dom
     * @return void
     */
    serialize: function(handler, dom) {
        var propPrefix = Xml.xmlNamespaces["DAV:"];
        var href = Xml.escapeXml((this.autoPrefix ? handler.server.getBaseUri() : "") + this.href);
        return dom + "<" + propPrefix + ":href>" + href + "</" + propPrefix + ":href>";
    },

    /**
     * Unserializes this property from a DOM Element
     *
     * This method returns an instance of this class.
     * It will only decode {DAV:}href values. For non-compatible elements null will be returned.
     *
     * @param {DOMElement} dom
     * @return jsDAV_Property_Href
     */
    unserialize: function(dom) {
        return (Xml.toClarkNotation(dom.firstChild) === "{DAV:}href")
            ? jsDAV_Property_Href.new(dom.firstChild.textContent, false)
            : null;
    }
});