001package biweekly.property;
002
003import org.w3c.dom.Document;
004import org.w3c.dom.Element;
005import org.w3c.dom.Node;
006import org.xml.sax.SAXException;
007
008import biweekly.util.XmlUtils;
009
010/*
011 Copyright (c) 2013-2015, Michael Angstadt
012 All rights reserved.
013
014 Redistribution and use in source and binary forms, with or without
015 modification, are permitted provided that the following conditions are met: 
016
017 1. Redistributions of source code must retain the above copyright notice, this
018 list of conditions and the following disclaimer. 
019 2. Redistributions in binary form must reproduce the above copyright notice,
020 this list of conditions and the following disclaimer in the documentation
021 and/or other materials provided with the distribution. 
022
023 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
024 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
025 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
026 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
027 ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
028 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
029 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
030 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
031 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
032 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
033 */
034
035/**
036 * Stores a property that was parsed from an xCal document (XML-encoded
037 * iCalendar object) whose XML namespace was not part of the xCal XML namespace.
038 * @author Michael Angstadt
039 * @see <a href="http://tools.ietf.org/html/rfc6321#page-17">RFC 6321 p.17-8</a>
040 */
041public class Xml extends ValuedProperty<Document> {
042        /**
043         * Creates an XML property.
044         * @param xml the XML to use as the property's value
045         * @throws SAXException if the XML cannot be parsed
046         */
047        public Xml(String xml) throws SAXException {
048                super(XmlUtils.toDocument(xml));
049        }
050
051        /**
052         * Creates an XML property.
053         * @param element the XML element to use as the property's value (the
054         * element is imported into an empty {@link Document} object)
055         */
056        public Xml(Element element) {
057                super(XmlUtils.createDocument());
058                Node imported = value.importNode(element, true);
059                value.appendChild(imported);
060        }
061
062        /**
063         * Creates an XML property.
064         * @param document the XML document to use as the property's value
065         */
066        public Xml(Document document) {
067                super(document);
068        }
069}