. For more information
+ on the JDOM Project, please see .
+
+ */
+
+// Based on code Copyright (c) 1998-2000 Alex Chaffee and Purple Technology.
+
+package org.jdom.contrib.beans;
+
+import java.util.*;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
+import java.text.*;
+
+/**
+ * @author Alex Chaffee (alex@jguru.com)
+ **/
+@SuppressWarnings("javadoc")
+public class DateUtils {
+
+ public static boolean debug;
+
+ /**
+ * Tries to parse the date according to several different formats.
+ *
+ * BUG in TimeZone processing -- Calendar class always screws up the time when a TZ is set -- so ignored for now.
+ *
+ * @return null if not parseable
+ **/
+ @SuppressWarnings("deprecation")
+ public static Date parseDate(String s) {
+
+ // some standard date format
+ try {
+ // this is deprecated, but it still parses more
+ // formats than DateFormat.parse(String)
+ return new Date(s);
+ }
+ catch (IllegalArgumentException dfe) {
+ // do nothing... we try to recover.
+ }
+
+ // some other (?) standard date format
+ try {
+ return DateFormat.getDateInstance().parse(s);
+ }
+ catch (ParseException pe) {
+ // OK, this is challenging, but we try the next option.
+ }
+
+ // a single int = msec since 1970
+ try {
+ return new Date(Long.parseLong(s));
+ }
+ catch (NumberFormatException nfe) {
+ // Getting rediculous now...
+ }
+
+ ISO8601 iso = parseISO8601(s);
+ if (iso != null) {
+ Calendar cal = Calendar.getInstance();
+
+ cal.set(Calendar.YEAR, iso.year);
+ cal.set(Calendar.MONTH, iso.month - 1);
+ cal.set(Calendar.DAY_OF_MONTH, iso.day);
+ cal.set(Calendar.HOUR, iso.hour + 12); // ??? TZ bug again?
+ cal.set(Calendar.MINUTE, iso.min);
+ cal.set(Calendar.SECOND, iso.sec);
+
+ return cal.getTime(); // why the hell does getTime() return a Date?
+
+
+ } // if iso
+
+ return null;
+ } // parseDate
+
+ public static class ISO8601 {
+ public int year;
+ public int month;
+ public int day;
+ public int hour;
+ public int min;
+ public int sec;
+ public int frac;
+ public String tz;
+ }
+
+ protected static String reISO8601 =
+ "(\\d\\d\\d\\d)(-(\\d\\d)(-(\\d\\d))?)?" +
+ "([T| ]?" +
+ "(\\d\\d):(\\d\\d)(:((\\d\\d)(\\.(\\d+))?)?)?" +
+ "(Z|([+-]\\d\\d:\\d\\d)|([A-Z]{3}))?)?";
+
+ public static ISO8601 parseISO8601(String s) {
+ // ISO 8601 datetime: http://www.w3.org/TR/NOTE-datetime
+ // e.g. 1997-07-16T19:20:30.45+01:00
+ // additions: "T" can be a space, TZ can be a three-char code, TZ can be missing
+ try {
+ Pattern pat = Pattern.compile(reISO8601);
+ Matcher re = pat.matcher(s);
+ if (re.matches()) {
+ if (debug)
+ showParens(re);
+
+ ISO8601 iso = new ISO8601();
+ iso.year = toInt(re.group(1));
+ iso.month = toInt(re.group(3));
+ iso.day = toInt(re.group(5));
+ iso.hour = toInt(re.group(7));
+ iso.min = toInt(re.group(8));
+ iso.sec = toInt(re.group(11));
+ iso.frac = toInt(re.group(13));
+ iso.tz = re.group(14);
+
+ if (debug) {
+ System.out.println("year='" + iso.year + "'");
+ System.out.println("month='" + iso.month + "'");
+ System.out.println("day='" + iso.day + "'");
+ System.out.println("hour='" + iso.hour + "'");
+ System.out.println("min='" + iso.min + "'");
+ System.out.println("sec='" + iso.sec + "'");
+ System.out.println("frac='" + iso.frac + "'");
+ System.out.println("tz='" + iso.tz + "'");
+ }
+
+ return iso;
+ }
+ } // try
+ catch (PatternSyntaxException ree) {
+ ree.printStackTrace();
+ }
+ return null;
+ }
+
+ public static int toInt(String x) {
+ if (x == null) return 0;
+ try {
+ return Integer.parseInt(x);
+ }
+ catch (NumberFormatException e) {
+ return 0;
+ }
+ }
+
+ /**
+ * Dump parenthesized subexpressions found by a regular expression matcher object
+ * @param r Matcher object with results to show
+ */
+ static void showParens(Matcher r)
+ {
+ // Loop through each paren
+ for (int i = 0; i < r.groupCount(); i++)
+ {
+ // Show paren register
+ System.out.println("$" + i + " = " + r.group(i));
+ }
+ }
+
+ public static void main(String[] args) {
+ debug = true;
+ for (int i=0; i.
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.beans;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.*;
+
+import org.jdom.Document;
+import org.jdom.Element;
+import org.jdom.JDOMException;
+import org.jdom.input.SAXBuilder;
+import org.jdom.input.sax.XMLReaderJDOMFactory;
+import org.jdom.input.sax.XMLReaderSAX2Factory;
+import org.jdom.output.XMLOutputter2;
+
+// todo:
+// weak references and/or timeout cache
+// load from URL (instead of just from file)
+// pathname normalization (remove ./ and foo/../ and so forth)
+// allow DOM builder or arbitrary builder
+
+/**
+ * A light wrapper on the JDOM library that you use to load in a file
+ * and turn it into a JDOM Document. It also keeps a cache of
+ * already-parsed files, and checks to see if they've changed on disk,
+ * and reloads if they have. (I know there's some sort of swap-out or
+ * weak-reference stuff either in JDOM or coming soon, so this may be
+ * a redundant feature.)
+ *
+ *
+ *
Usage from Java:
+ *
+ *
+ * JDOMBean jdom = new JDOMBean(); // or new JDOMBean("com.foo.saxparser")
+ * jdom.setFileRoot("/path/to/my/xml/documents/");
+ * Document doc = jdom.getDocument("foo.xml");
+ * Element root = jdom.getRootElement("foo.xml");
+ *
+ *
+ * Usage from JSP:
+ *
+ *
+ *
+ * <jsp:useBean id="jdom" class="JDOMBean" scope="application">
+ * <% jdom.setFileRoot(application.getRealPath("")); %>
+ * </jsp:useBean>
+ *
+ * or
+ *
+ * <jsp:useBean id="jdom" class="JDOMBean" scope="application">
+ * <jsp:setProperty name="jdom" property="fileRoot"
+ * +value='<%=application.getRealPath("")%>' />
+ * </jsp:useBean>
+ *
+ * then
+ *
+ * <%
+ * Element root = jdom.getRootElement("foo.xml");
+ * %>
+ * Bar: <%=root.getChild("bar").getContent()%>
+ *
+ *
+ * @author Alex Chaffee [alex@jguru.com]
+ **/
+@SuppressWarnings("javadoc")
+public class JDOMBean {
+
+ /** Default SAX parser class to use */
+ private static final String DEFAULT_PARSER =
+ "org.apache.xerces.parsers.SAXParser";
+
+ /** SAX parser class to use */
+ private String parser;
+
+ /** {@link SAXBuilder} instance to use */
+ private SAXBuilder builder;
+
+ /** file cache **/
+ private Map files = new HashMap();
+
+// /** where to locate files **/
+// private File fileRoot;
+
+ /**
+ * default constructor, uses "org.apache.xerces.parsers.SAXParser"
+ **/
+ public JDOMBean() {
+ setParser(DEFAULT_PARSER);
+ }
+
+ /**
+ * @param parser String name of driver class to use.
+ **/
+ public JDOMBean(String parser) {
+ setParser(parser);
+ }
+
+ /**
+ *
+ * This will create an instance of {@link SAXBuilder}
+ * for use in the rest of this program.
+ *
+ *
+ * @param parser String name of SAX parser class to use.
+ */
+ public void setParser(String parser) {
+ this.parser = parser;
+ XMLReaderJDOMFactory fac = new XMLReaderSAX2Factory(false, parser);
+ builder = new SAXBuilder(fac);
+ }
+
+ /**
+ * @return name of SAX parser class being used
+ **/
+ public String getParser() {
+ return parser;
+ }
+
+ /**
+ * All files are fetched relative to this path
+ * @param root the path (absolute or relative) to the document root
+ **/
+ public void setFileRoot(String root) {
+// if (!root.endsWith("/")) {
+// root = root + "/";
+// }
+// this.fileRoot = new File(root);
+// System.out.println("fileroot=" + fileRoot);
+ }
+
+ /**
+ * @return the path (absolute or relative) to the document root
+ **/
+ public String getFileRoot() {
+// if (fileRoot == null) {
+ return null;
+// }
+// return fileRoot.getAbsolutePath();
+ }
+
+ /**
+ * Load a file, parse it with JDOM, return a org.jdom.Document.
+ * If the file has already been parsed, return the previously
+ * cached object. If the file has changed, ignore the previously
+ * parsed version and reload.
+ *
+ * Note that this never unloads a document, so is unsuitable for
+ * long-term server-side use for a constantly changing set of
+ * files. Todo: use weak references or cache timeouts.
+ *
+ * Also does not do secure checking on file requested, so if
+ * there's no root, and the parameter starts with a "/", this
+ * could conceivably access files you don't want accessed. So be
+ * careful out there.
+ *
+ * @param filename the file to load, relative to file root
+ * @return a JDOM Document corresponding to the given filename
+ **/
+ public Document getDocument(String filename) throws JDOMException, IOException {
+ FileInfo info = files.get(filename);
+ File file = getFile(filename);
+ if (info == null ||
+ info.modified < file.lastModified())
+ {
+ Document doc = builder.build(file);
+ info = new FileInfo(filename, file.lastModified(), doc);
+ files.put(filename, info);
+ }
+ return info.document;
+ }
+
+ /**
+ * Convenience method, calls getDocument(filename).getRootElement()
+ **/
+ public Element getRootElement(String file) throws JDOMException, IOException {
+ Document doc = getDocument(file);
+ if (doc != null) return doc.getRootElement();
+ return null;
+ }
+
+ private File getFile(String filename) {
+// if (fileRoot == null) {
+ return new File(filename);
+// }
+// return new File(fileRoot, filename);
+ }
+
+ /**
+ * Information stored in the cache
+ **/
+ class FileInfo {
+ String name;
+ long modified;
+ Document document;
+ public FileInfo(String name, long modified, Document document) {
+ this.name = name;
+ this.modified = modified;
+ this.document = document;
+ }
+ }
+
+ // Usage: java JDOMBean [-parser com.foo.parser] file1.xml file2.xml
+ // Fetches and prints files
+ public static void main(String[] args) throws IOException, JDOMException {
+ int i=0;
+ JDOMBean bean;
+ if (args[i].equals("-parser")) {
+ ++i;
+ bean = new JDOMBean(args[i]);
+ i++;
+ }
+ else {
+ bean = new JDOMBean();
+ }
+
+ XMLOutputter2 out = new XMLOutputter2();
+
+ for (; i.
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.beans;
+
+import java.lang.reflect.*;
+import java.util.*;
+
+/**
+ * Converts a String into a given object type.
+ *
+ * @author Alex Chaffee (alex@jguru.com)
+ **/
+
+@SuppressWarnings("javadoc")
+public class StringConverter {
+
+ public static interface Factory {
+ public Object instantiate(String string);
+ }
+
+ public static class DateFactory implements Factory
+ {
+ @Override
+ public Object instantiate(String string) {
+ return DateUtils.parseDate(string);
+ }
+ }
+
+ protected Map, Factory> factories = new HashMap, Factory>();
+
+ public StringConverter() {
+ try {
+ factories.put( Class.forName("java.util.Date"),
+ new DateFactory() );
+ }
+ catch (ClassNotFoundException e) {
+ // do nothing
+ }
+ }
+
+ public void setFactory(Class type, Factory factory) {
+ factories.put(type, factory);
+ }
+
+ protected static Class[] argString = new Class[] { String.class };
+
+ public Object parse(String string, Class type)
+ {
+ // if it's a string, return it
+ if (type == String.class) {
+ return string;
+ }
+
+ // if we have a Factory for it
+ Factory factory = factories.get(type);
+ if (factory != null) {
+ return factory.instantiate(string);
+ }
+
+ // if it's a primitive, convert to wrapper (???)
+ if (type == short.class) type = Short.class;
+ if (type == int.class) type = Integer.class;
+ if (type == long.class) type = Long.class;
+ if (type == boolean.class) type = Boolean.class;
+ if (type == char.class) type = Character.class;
+ if (type == byte.class) type = Byte.class;
+
+ // last ditch: see if the class has a String Factory
+ try {
+ Constructor c = type.getConstructor(argString);
+ if (c != null) {
+ return c.newInstance( new Object[] { string } );
+ }
+ }
+ catch (NoSuchMethodException e) {
+ // ignore & fall through
+ }
+ catch (Exception e) {
+ System.err.println("Couldn't instantiate " + type + "(" + string + ")");
+ e.printStackTrace();
+ }
+
+ return null;
+ }
+}
diff --git a/contrib/src/java/org/jdom/contrib/beans/TestBean.java b/contrib/src/java/org/jdom/contrib/beans/TestBean.java
new file mode 100644
index 0000000..fe3323a
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/beans/TestBean.java
@@ -0,0 +1,145 @@
+/*--
+
+ Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.beans;
+
+import org.jdom.*;
+import org.jdom.output.*;
+import java.util.*;
+
+@SuppressWarnings("javadoc")
+public class TestBean implements java.io.Serializable {
+ /**
+ * Default.
+ */
+ private static final long serialVersionUID = 1L;
+
+ private String name;
+ private int age;
+ private Date birthdate;
+ private TestBean friend;
+
+ public String getName() {
+ return name;
+ }
+ public int getAge() {
+ return age;
+ }
+ public Date getBirthdate() {
+ return birthdate;
+ }
+ public TestBean getFriend() {
+ return friend;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+ public void setAge(int age) {
+ this.age = age;
+ }
+ public void setBirthdate(Date birthdate) {
+ this.birthdate = birthdate;
+ }
+ public void setFriend(TestBean friend) {
+ this.friend = friend;
+ }
+
+ @Override
+ public String toString() {
+ return "TestBean[name='" + name + "', age=" + age + ", birthdate=" + birthdate + ", friend=" + friend + "]";
+ }
+
+
+ // Test
+
+ @SuppressWarnings("deprecation")
+ public static void main(String[] args) throws java.io.IOException {
+
+ try {
+ BeanMapper mapper = new BeanMapper();
+ mapper.addMapping("birthdate", "dob"); // element mapping
+ mapper.addMapping("age", "dob", "age"); // attribute mapping
+
+ mapper.setBeanPackage("org.jdom.contrib.beans");
+
+ // test bean->jdom
+
+ TestBean alex = new TestBean();
+ alex.setName("Alex");
+ alex.setAge(31);
+ alex.setBirthdate(new Date(69, 7, 8));
+
+ TestBean amy = new TestBean();
+ amy.setName("Amy");
+ amy.setAge(25);
+ amy.setBirthdate(new Date(75, 4, 1));
+
+ alex.setFriend(amy);
+
+ Document doc = mapper.toDocument(alex);
+ XMLOutputter2 o = new XMLOutputter2(Format.getPrettyFormat());
+ o.output(doc, System.out);
+ System.out.println();
+
+ // test jdom->bean
+ TestBean test2 = (TestBean)mapper.toBean(doc);
+ System.out.println(test2);
+ }
+ catch (BeanMapperException e) {
+ e.printStackTrace();
+ }
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/beans/TestIndexed.java b/contrib/src/java/org/jdom/contrib/beans/TestIndexed.java
new file mode 100644
index 0000000..9e38fc5
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/beans/TestIndexed.java
@@ -0,0 +1,166 @@
+/*--
+
+ Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.beans;
+
+import org.jdom.*;
+import org.jdom.output.*;
+import java.util.*;
+import java.beans.*;
+
+@SuppressWarnings("javadoc")
+public class TestIndexed implements java.io.Serializable {
+ /**
+ * Default.
+ */
+ private static final long serialVersionUID = 1L;
+
+ private String name;
+ private List toppings = new ArrayList();
+ private int[] measurements = new int[]{36, 24, 38};
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public String getTopping(int i) {
+ return toppings.get(i);
+ }
+
+ public void setTopping(int i, String topping) {
+ while (i >= toppings.size()) {
+ toppings.add(null);
+ }
+ toppings.set(i, topping);
+ }
+
+ public String[] getTopping() {
+ String[] a = new String[toppings.size()];
+ for (int i = 0; i < toppings.size(); ++i) {
+ a[i] = toppings.get(i);
+ }
+ return a;
+ }
+
+ public void setTopping(String[] x) {
+ if (x != null)
+ toppings = Arrays.asList(x);
+ }
+
+ public int[] getMeasurements() {
+ return measurements;
+ }
+
+ public void setMeasurements(int[] measurements) {
+ this.measurements = measurements;
+ }
+
+ @Override
+ public String toString() {
+ StringBuilder buf = new StringBuilder();
+ buf.append("TestIndexed[name='" + name + "'");
+ for (int i = 0; i < toppings.size(); ++i) {
+ buf.append(", topping=" + toppings.get(i));
+ }
+ buf.append(", measurements=");
+ for (int i = 0; i < toppings.size(); ++i) {
+ buf.append(" " + measurements[i]);
+ }
+ buf.append("]");
+ return buf.toString();
+ }
+
+ public static void main(String[] args) throws java.beans.IntrospectionException, java.io.IOException, BeanMapperException {
+ BeanMapper mapper = new BeanMapper();
+ mapper.setBeanPackage("org.jdom.contrib.beans");
+
+ TestIndexed pizza = new TestIndexed();
+ pizza.setName("Abominable");
+ pizza.setTopping(0, "Anchovies");
+ pizza.setTopping(1, "Steak Tartare");
+ pizza.setTopping(2, "Raw Eggs");
+
+ BeanInfo info = Introspector.getBeanInfo(pizza.getClass());
+ PropertyDescriptor[] ps = info.getPropertyDescriptors();
+ for (int i = 0; i < ps.length; ++i) {
+ if (ps[i] instanceof IndexedPropertyDescriptor) {
+ IndexedPropertyDescriptor p = (IndexedPropertyDescriptor) ps[i];
+ System.out.println("Indexed property " + p.getName() + " " + p.getShortDescription());
+ System.out.println("Type = " + p.getPropertyType());
+ System.out.println("Getter = " + p.getReadMethod());
+ System.out.println("Indexed Getter = " + p.getIndexedReadMethod());
+ }
+ }
+
+ System.out.println("===== Testing toDocument()");
+ Document doc = mapper.toDocument(pizza);
+ XMLOutputter2 o = new XMLOutputter2(Format.getPrettyFormat());
+ o.output(doc, System.out);
+ System.out.println();
+
+ // test jdom->bean
+ System.out.println("===== Testing toBean()");
+ TestIndexed test2 = (TestIndexed) mapper.toBean(doc);
+ System.out.println(test2);
+
+ int[] test = new int[10];
+ Class a1 = test.getClass();
+ Class a2 = a1.getSuperclass();
+ System.out.println("classes: " + a1 + " " + a2);
+ }
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/DOM.java b/contrib/src/java/org/jdom/contrib/dom/DOM.java
new file mode 100644
index 0000000..7bd62da
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/DOM.java
@@ -0,0 +1,184 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.Attr;
+import org.w3c.dom.CDATASection;
+import org.w3c.dom.Comment;
+import org.w3c.dom.Document;
+import org.w3c.dom.DocumentType;
+import org.w3c.dom.Element;
+import org.w3c.dom.EntityReference;
+import org.w3c.dom.ProcessingInstruction;
+import org.w3c.dom.Text;
+
+import org.jdom.Content;
+
+/**
+ * Access JDOM Content using a (Read-Only) DOM model
+ *
+ * @author Rolf Lear
+ *
+ */
+public final class DOM {
+ /**
+ * Wrap a JDOM Document in a org.w3c.dom.Document instance.
+ * @param doc The JDOM Document to wrap.
+ * @return the wrapped Document
+ */
+ public static final Document wrap(final org.jdom.Document doc) {
+ return wrap(doc, false);
+ }
+
+ /**
+ * Wrap a JDOM Document in a org.w3c.dom.Document instance.
+ * @param doc The JDOM Document to wrap.
+ * @param scan Whether the entire document should be pre-processed
+ * @return the wrapped Document
+ */
+ public static final Document wrap(
+ final org.jdom.Document doc, final boolean scan) {
+ final JDocument ret = new JDocument(doc);
+ if (scan) {
+ ret.scanAll();
+ }
+ return ret;
+ }
+
+ private static final JDocument makeDoc(final Content c) {
+ final org.jdom.Document doc = c.getDocument();
+ return new JDocument(doc);
+ }
+
+ /**
+ * Wrap a JDOM Element in a org.w3c.dom.Element instance.
+ * @param emt The JDOM Element to wrap.
+ * @return the wrapped Element
+ */
+ public static final Element wrap(final org.jdom.Element emt) {
+ return makeDoc(emt).find(emt);
+ }
+
+
+ /**
+ * Wrap a JDOM Attribute in a org.w3c.dom.Attr instance.
+ * @param att The JDOM Attribute to wrap.
+ * @return the wrapped Attribute
+ */
+ public static final Attr wrap(final org.jdom.Attribute att) {
+ final org.jdom.Document doc = att.getDocument();
+ final JDocument jd = new JDocument(doc);
+ return jd.find(att);
+ }
+
+
+
+ /**
+ * Wrap a JDOM Text in a org.w3c.dom.Text instance.
+ * @param text The JDOM Text to wrap.
+ * @return the wrapped Text
+ */
+ public static final Text wrap(final org.jdom.Text text) {
+ return makeDoc(text).find(text);
+ }
+
+ /**
+ * Wrap a JDOM CDATA in a org.w3c.dom.CDATASection instance.
+ * @param cdata The JDOM CDATA to wrap.
+ * @return the wrapped CDATA
+ */
+ public static final CDATASection wrap(final org.jdom.CDATA cdata) {
+ return makeDoc(cdata).find(cdata);
+ }
+
+ /**
+ * Wrap a JDOM EntityRef in a org.w3c.dom.EntityReference instance.
+ * @param eref The JDOM EntityRef to wrap.
+ * @return the wrapped EtityRef
+ */
+ public static final EntityReference wrap(final org.jdom.EntityRef eref) {
+ return makeDoc(eref).find(eref);
+ }
+
+ /**
+ * Wrap a JDOM ProcessingInstruction in a org.w3c.dom.ProcessingInstruction
+ * instance.
+ * @param pi The JDOM ProcessingInstruction to wrap.
+ * @return the wrapped ProcessingInstrction
+ */
+ public static final ProcessingInstruction wrap(
+ final org.jdom.ProcessingInstruction pi) {
+ return makeDoc(pi).find(pi);
+ }
+
+ /**
+ * Wrap a JDOM Comment in a org.w3c.dom.Comment instance.
+ * @param comment The JDOM Comment to wrap.
+ * @return the wrapped Comment
+ */
+ public static final Comment wrap(final org.jdom.Comment comment) {
+ return makeDoc(comment).find(comment);
+ }
+
+ /**
+ * Wrap a JDOM DocType in a org.w3c.dom.DocumentType instance.
+ * @param dt The JDOM DocType to wrap.
+ * @return the wrapped DocType
+ */
+ public static final DocumentType wrap(final org.jdom.DocType dt) {
+ return makeDoc(dt).find(dt);
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JAttribute.java b/contrib/src/java/org/jdom/contrib/dom/JAttribute.java
new file mode 100644
index 0000000..375ead3
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JAttribute.java
@@ -0,0 +1,176 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.net.URISyntaxException;
+
+import org.w3c.dom.Attr;
+import org.w3c.dom.DOMException;
+import org.w3c.dom.Element;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.TypeInfo;
+
+import org.jdom.Attribute;
+import org.jdom.AttributeType;
+import org.jdom.Namespace;
+
+final class JAttribute extends JNamespaceAware implements Attr {
+
+ final Attribute attribute;
+ public JAttribute(final JDocument topdoc, final JParent parent, final Attribute attribute,
+ final Namespace[] nstack) {
+ super(topdoc, parent, Node.ATTRIBUTE_NODE, nstack);
+ this.attribute = attribute;
+ }
+
+ @Override
+ public final Object getWrapped() {
+ return attribute;
+ }
+
+ @Override
+ public String getNodeName() {
+ return getName();
+ }
+ @Override
+ public String getNodeValue() throws DOMException {
+ return getValue();
+ }
+ @Override
+ public NodeList getChildNodes() {
+ return EMPTYLIST;
+ }
+ @Override
+ public Node getFirstChild() {
+ return null;
+ }
+ @Override
+ public Node getLastChild() {
+ return null;
+ }
+ @Override
+ public NamedNodeMap getAttributes() {
+ return null;
+ }
+ @Override
+ public boolean hasChildNodes() {
+ return false;
+ }
+ @Override
+ public String getNamespaceURI() {
+ return attribute.getNamespaceURI();
+ }
+ @Override
+ public String getPrefix() {
+ return attribute.getNamespacePrefix();
+ }
+ @Override
+ public String getLocalName() {
+ return attribute.getName();
+ }
+ @Override
+ public boolean hasAttributes() {
+ return false;
+ }
+ @Override
+ public String getBaseURI() {
+ try {
+ return attribute.getParent().getXMLBaseURI().toASCIIString();
+ } catch (final URISyntaxException e) {
+ throw new IllegalStateException("Unable to process URI", e);
+ }
+ }
+ @Override
+ public String getTextContent() throws DOMException {
+ return "";
+ }
+ @Override
+ public String getName() {
+ return attribute.getQualifiedName();
+ }
+ @Override
+ public boolean getSpecified() {
+ return true;
+ }
+ @Override
+ public String getValue() {
+ return attribute.getValue();
+ }
+
+ @Override
+ public Element getOwnerElement() {
+ return (Element)getParentNode();
+ }
+
+ @Override
+ public TypeInfo getSchemaTypeInfo() {
+ return TYPEINFO;
+ }
+
+ @Override
+ public boolean isId() {
+ return attribute.getAttributeType() == AttributeType.ID;
+ }
+
+ @Override
+ public void setValue(final String value) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+
+}
\ No newline at end of file
diff --git a/contrib/src/java/org/jdom/contrib/dom/JCDATA.java b/contrib/src/java/org/jdom/contrib/dom/JCDATA.java
new file mode 100644
index 0000000..5ba352a
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JCDATA.java
@@ -0,0 +1,73 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.CDATASection;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+final class JCDATA extends JText implements CDATASection {
+ public JCDATA(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return "#cdata-section";
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JComment.java b/contrib/src/java/org/jdom/contrib/dom/JComment.java
new file mode 100644
index 0000000..34f7ae8
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JComment.java
@@ -0,0 +1,74 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.Comment;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+final class JComment extends JSimpleCharacterContent implements Comment {
+
+ public JComment(final JDocument topdoc, final JParent parent, final Content content,
+ final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return "#comment";
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JContent.java b/contrib/src/java/org/jdom/contrib/dom/JContent.java
new file mode 100644
index 0000000..6a42da3
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JContent.java
@@ -0,0 +1,135 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+abstract class JContent extends JNamespaceAware {
+
+ private static final short getNodeType(final Content content) {
+ switch (content.getCType()) {
+ case CDATA:
+ return Node.CDATA_SECTION_NODE;
+ case Comment:
+ return Node.COMMENT_NODE;
+ case DocType:
+ return Node.DOCUMENT_TYPE_NODE;
+ case Element:
+ throw new IllegalStateException("JElement does not extend JContent");
+ case EntityRef:
+ return Node.ENTITY_REFERENCE_NODE;
+ case ProcessingInstruction:
+ return Node.PROCESSING_INSTRUCTION_NODE;
+ case Text:
+ return Node.TEXT_NODE;
+ }
+ // this will never be run....
+ return -1;
+ }
+
+ protected final Content shadow;
+
+ public JContent(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, getNodeType(content), nstack);
+ this.shadow = content;
+ }
+
+ @Override
+ public final Object getWrapped() {
+ return shadow;
+ }
+
+ @Override
+ public final NodeList getChildNodes() {
+ return EMPTYLIST;
+ }
+
+ @Override
+ public final Node getFirstChild() {
+ return null;
+ }
+
+ @Override
+ public final Node getLastChild() {
+ return null;
+ }
+
+ @Override
+ public final boolean hasChildNodes() {
+ return false;
+ }
+
+ @Override
+ public final boolean hasAttributes() {
+ return false;
+ }
+
+ @Override
+ public final String getBaseURI() {
+ return parent.getBaseURI();
+ }
+
+ @Override
+ public final NamedNodeMap getAttributes() {
+ return null;
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JDOMConfiguration.java b/contrib/src/java/org/jdom/contrib/dom/JDOMConfiguration.java
new file mode 100644
index 0000000..7242f08
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JDOMConfiguration.java
@@ -0,0 +1,101 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMConfiguration;
+import org.w3c.dom.DOMException;
+import org.w3c.dom.DOMStringList;
+
+class JDOMConfiguration implements DOMConfiguration {
+
+ private static final DOMStringList EMPTYSTRINGS = new DOMStringList() {
+
+ @Override
+ public String item(final int index) {
+ return null;
+ }
+
+ @Override
+ public int getLength() {
+ return 0;
+ }
+
+ @Override
+ public boolean contains(final String str) {
+ return false;
+ }
+ };
+
+ @Override
+ public void setParameter(final String name, final Object value) throws DOMException {
+ throw new DOMException(DOMException.NOT_FOUND_ERR, "No configuration!");
+ }
+
+ @Override
+ public Object getParameter(final String name) throws DOMException {
+ return null;
+ }
+
+ @Override
+ public boolean canSetParameter(final String name, final Object value) {
+ return false;
+ }
+
+ @Override
+ public DOMStringList getParameterNames() {
+ return EMPTYSTRINGS;
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JDOMImplementation.java b/contrib/src/java/org/jdom/contrib/dom/JDOMImplementation.java
new file mode 100644
index 0000000..6fa6e35
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JDOMImplementation.java
@@ -0,0 +1,86 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.DOMImplementation;
+import org.w3c.dom.Document;
+import org.w3c.dom.DocumentType;
+
+class JDOMImplementation implements DOMImplementation {
+
+ @Override
+ public boolean hasFeature(final String feature, final String version) {
+ return false;
+ }
+
+ @Override
+ public DocumentType createDocumentType(final String qualifiedName,
+ final String publicId, final String systemId) throws DOMException {
+ throw new DOMException(DOMException.NOT_SUPPORTED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Document createDocument(final String namespaceURI, final String qualifiedName,
+ final DocumentType doctype) throws DOMException {
+ throw new DOMException(DOMException.NOT_SUPPORTED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Object getFeature(final String feature, final String version) {
+ return null;
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JDocType.java b/contrib/src/java/org/jdom/contrib/dom/JDocType.java
new file mode 100644
index 0000000..6af1a88
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JDocType.java
@@ -0,0 +1,117 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.DocumentType;
+import org.w3c.dom.NamedNodeMap;
+
+import org.jdom.Content;
+import org.jdom.DocType;
+import org.jdom.Namespace;
+
+class JDocType extends JSimpleContent implements DocumentType {
+
+ public JDocType(final JDocument topdoc, final JParent parent, final Content content,
+ final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return getName();
+ }
+
+ @Override
+ public String getNodeValue() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public String getTextContent() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public String getName() {
+ return ((DocType)shadow).getElementName();
+ }
+
+ @Override
+ public NamedNodeMap getEntities() {
+ return EMPTYMAP;
+ }
+
+ @Override
+ public NamedNodeMap getNotations() {
+ return EMPTYMAP;
+ }
+
+ @Override
+ public String getPublicId() {
+ return ((DocType)shadow).getPublicID();
+ }
+
+ @Override
+ public String getSystemId() {
+ return ((DocType)shadow).getSystemID();
+ }
+
+ @Override
+ public String getInternalSubset() {
+ return ((DocType)shadow).getInternalSubset();
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JDocument.java b/contrib/src/java/org/jdom/contrib/dom/JDocument.java
new file mode 100644
index 0000000..a33bb33
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JDocument.java
@@ -0,0 +1,549 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.IdentityHashMap;
+import java.util.Iterator;
+
+import org.w3c.dom.Attr;
+import org.w3c.dom.CDATASection;
+import org.w3c.dom.Comment;
+import org.w3c.dom.DOMConfiguration;
+import org.w3c.dom.DOMException;
+import org.w3c.dom.DOMImplementation;
+import org.w3c.dom.Document;
+import org.w3c.dom.DocumentFragment;
+import org.w3c.dom.DocumentType;
+import org.w3c.dom.Element;
+import org.w3c.dom.EntityReference;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.ProcessingInstruction;
+import org.w3c.dom.Text;
+
+import org.jdom.Attribute;
+import org.jdom.AttributeType;
+import org.jdom.CDATA;
+import org.jdom.DocType;
+import org.jdom.EntityRef;
+import org.jdom.Namespace;
+import org.jdom.Parent;
+import org.jdom.filter.Filters;
+import org.jdom.util.NamespaceStack;
+
+class JDocument extends JParent implements Document {
+
+ private static final JDOMImplementation implementation =
+ new JDOMImplementation();
+
+ private static final JDOMConfiguration configuration =
+ new JDOMConfiguration();
+
+ private boolean allscanned = false;
+ private final JElement root;
+ private final JDocType doctype;
+ private final IdentityHashMap mapped =
+ new IdentityHashMap();
+ private final HashMap idmap = new HashMap();
+
+ public JDocument(final org.jdom.Document shadow) {
+ super(null, null, shadow, Node.DOCUMENT_NODE, new Namespace[]{
+ Namespace.NO_NAMESPACE,
+ Namespace.XML_NAMESPACE
+ });
+ if (shadow == null) {
+ root = null;
+ doctype = null;
+ } else {
+ final JNamespaceAware[] kids = checkKids();
+ JDocType dt = null;
+ JElement je = null;
+ for (final JNamespaceAware n : kids) {
+ if (n.getNodeType() == Node.DOCUMENT_TYPE_NODE) {
+ dt = (JDocType)n;
+ }
+ if (n.getNodeType() == Node.ELEMENT_NODE) {
+ je = (JElement)n;
+ }
+ }
+ root = je;
+ doctype = dt;
+ }
+ }
+
+ public void scanAll() {
+ if (allscanned) {
+ return;
+ }
+ if (shadow == null) {
+ allscanned = true;
+ return;
+ }
+ allscanned = true;
+ final Iterator it = shadow.getDescendants(Filters.element());
+ while (it.hasNext()) {
+ find(it.next());
+ }
+ }
+
+ public JElement find(final org.jdom.Element emt) {
+ final JNamespaceAware me = mapped.get(emt);
+ if (me != null) {
+ return (JElement)me;
+ }
+ final org.jdom.Element jp = emt.getParentElement();
+ if (jp == null) {
+ // root level element (or detached).
+ final org.jdom.Document jd = emt.getDocument();
+ // both may be null....
+ if (jd != shadow) {
+ // we are from different documents...
+ throw new DOMException(DOMException.WRONG_DOCUMENT_ERR,
+ "Element is not part of our document");
+ }
+ // OK, we are a root level Element... let's map ourselves.
+ final NamespaceStack ns = new NamespaceStack(scope);
+ ns.push(emt);
+ final ArrayList added = new ArrayList();
+ for (final Namespace ans : ns.addedForward()) {
+ added.add(ans);
+ }
+ final JElement je = new JElement(this, this, emt, ns.getScope(),
+ added.toArray(new Namespace[added.size()]));
+ mapped.put(emt, je);
+ checkID(je);
+ return je;
+ }
+ final JElement pnt = find(jp);
+ final NamespaceStack ns = new NamespaceStack(pnt.scope);
+ ns.push(emt);
+ final ArrayList added = new ArrayList();
+ for (final Namespace ans : ns.addedForward()) {
+ added.add(ans);
+ }
+ final JElement ret = new JElement(this, pnt, emt, ns.getScope(),
+ added.toArray(new Namespace[added.size()]));
+ mapped.put(emt, ret);
+ checkID(ret);
+ return ret;
+ }
+
+ public JAttribute find(final org.jdom.Attribute att) {
+ final JNamespaceAware me = mapped.get(att);
+ if (me != null) {
+ return (JAttribute)me;
+ }
+ final org.jdom.Element jp = att.getParent();
+ final JParent pnt = jp == null ? this : find(jp);
+ final NamespaceStack ns = jp == null ?
+ new NamespaceStack() : new NamespaceStack(find(jp).scope);
+ ns.push(att);
+ final JAttribute ret = new JAttribute(this, pnt, att, ns.getScope());
+ mapped.put(att, ret);
+ return ret;
+ }
+
+ private JContent findContent(final org.jdom.Content content) {
+ final JNamespaceAware me = mapped.get(content);
+ if (me != null) {
+ return (JContent)me;
+ }
+ final org.jdom.Element jp = content.getParentElement();
+ final JParent pnt = jp == null ? this : find(jp);
+ JContent ret = null;
+ switch (content.getCType()) {
+ case CDATA:
+ ret = new JCDATA(this, pnt, content, pnt.scope);
+ break;
+ case Comment:
+ ret = new JComment(this, pnt, content, pnt.scope);
+ break;
+ case DocType:
+ ret = new JDocType(this, pnt, content, pnt.scope);
+ break;
+ case EntityRef:
+ ret = new JEntityRef(this, pnt, content, pnt.scope);
+ break;
+ case ProcessingInstruction:
+ ret = new JProcessingInstruction(this, pnt, content, pnt.scope);
+ break;
+ case Text:
+ ret = new JText(this, pnt, content, pnt.scope);
+ break;
+ default:
+ throw new IllegalStateException(
+ "Other types should have their own methods.");
+ }
+ mapped.put(content, ret);
+ return ret;
+ }
+
+ public JCDATA find(final CDATA content) {
+ return (JCDATA)findContent(content);
+ }
+
+ public JDocType find(final DocType content) {
+ return (JDocType)findContent(content);
+ }
+
+ public JProcessingInstruction find(
+ final org.jdom.ProcessingInstruction content) {
+ return (JProcessingInstruction)findContent(content);
+ }
+
+ public JEntityRef find(final EntityRef content) {
+ return (JEntityRef)findContent(content);
+ }
+
+ public JComment find(final org.jdom.Comment content) {
+ return (JComment)findContent(content);
+ }
+
+ public JText find(final org.jdom.Text content) {
+ return (JText)findContent(content);
+ }
+
+ private void checkID(final JElement je) {
+ final org.jdom.Element emt = (org.jdom.Element)(je.shadow);
+ if (emt.hasAttributes()) {
+ for (final Attribute a : emt.getAttributes()) {
+ if (a.getAttributeType() == AttributeType.ID) {
+ if (idmap.put(a.getValue(), je) != null) {
+ throw new DOMException(DOMException.INVALID_STATE_ERR,
+ "Multiple elements with id " + a.getValue());
+ }
+ }
+ }
+ }
+ }
+
+ @Override
+ public DocumentType getDoctype() {
+ return doctype;
+ }
+
+ @Override
+ public Element getDocumentElement() {
+ return root;
+ }
+
+
+
+ @Override
+ public NodeList getElementsByTagName(final String tagname) {
+ return getElementsByTagName(shadow, tagname);
+ }
+
+ @Override
+ public NodeList getElementsByTagNameNS(final String namespaceURI, final String localName) {
+ return getElementsByTagNameNS(shadow, namespaceURI, localName);
+ }
+
+ NodeList getElementsByTagName(final Parent xshadow, final String tagname) {
+ if (tagname == null) {
+ return EMPTYLIST;
+ }
+ final ArrayList enodes = new ArrayList();
+ final boolean alltags = "*".equals(tagname);
+
+ final Iterator it =
+ xshadow.getDescendants(Filters.element());
+
+ while (it.hasNext()) {
+ final org.jdom.Element e = it.next();
+ if (alltags || tagname.equals(e.getQualifiedName())) {
+ enodes.add(find(e));
+ }
+ }
+
+ return new JNodeList(enodes);
+ }
+
+ NodeList getElementsByTagNameNS(final Parent xshadow, final String namespaceURI, final String localName) {
+ if (localName == null) {
+ return EMPTYLIST;
+ }
+ if (namespaceURI == null) {
+ return EMPTYLIST;
+ }
+
+ final boolean alluri = "*".equals(namespaceURI);
+ final boolean allname = "*".equals(localName);
+
+ final ArrayList enodes = new ArrayList();
+
+ final Iterator it =
+ xshadow.getDescendants(Filters.element());
+
+ while (it.hasNext()) {
+ final org.jdom.Element e = it.next();
+ if ((allname || localName.equals(e.getName())) &&
+ (alluri || namespaceURI.equals(e.getNamespaceURI()))) {
+ enodes.add(find(e));
+ }
+ }
+
+ return new JNodeList(enodes);
+ }
+
+ @Override
+ public Element getElementById(final String elementId) {
+ scanAll();
+ return idmap.get(elementId);
+ }
+
+ @Override
+ public String getDocumentURI() {
+ return shadow == null ? null : ((org.jdom.Document)shadow).getBaseURI();
+ }
+
+ @Override
+ public String getNodeName() {
+ return "#document";
+ }
+
+ @Override
+ public String getBaseURI() {
+ return shadow == null ? null : ((org.jdom.Document)shadow).getBaseURI();
+ }
+
+ /* *********************************************************
+ * Everything after this point is 'dumb' code... (or error code)
+ * ********************************************************* */
+
+ @Override
+ public String getNodeValue() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public NamedNodeMap getAttributes() {
+ return null;
+ }
+
+ @Override
+ public String getNamespaceURI() {
+ return null;
+ }
+
+ @Override
+ public String getPrefix() {
+ return null;
+ }
+
+ @Override
+ public String getLocalName() {
+ return null;
+ }
+
+ @Override
+ public boolean hasAttributes() {
+ return false;
+ }
+
+ @Override
+ public String getTextContent() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public String getXmlVersion() {
+ return "1.0";
+ }
+
+ @Override
+ public String getInputEncoding() {
+ return null;
+ }
+
+ @Override
+ public String getXmlEncoding() {
+ return null;
+ }
+
+ @Override
+ public boolean getXmlStandalone() {
+ return false;
+ }
+
+ @Override
+ public final DOMImplementation getImplementation() {
+ return implementation;
+ }
+
+ @Override
+ public final DOMConfiguration getDomConfig() {
+ return configuration;
+ }
+
+ @Override
+ public final boolean getStrictErrorChecking() {
+ return false;
+ }
+
+ @Override
+ public final void setStrictErrorChecking(final boolean strictErrorChecking) {
+ // nothing
+ }
+
+ @Override
+ public final void setDocumentURI(final String documentURI) {
+ // Do nothing
+ }
+
+ @Override
+ public final void normalizeDocument() {
+ // do nothing
+ }
+
+ @Override
+ public final Node renameNode(final Node n, final String namespaceURI, final String qualifiedName)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final void setXmlStandalone(final boolean xmlStandalone) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final void setXmlVersion(final String xmlVersion) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node adoptNode(final Node source) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Element createElement(final String tagName) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final DocumentFragment createDocumentFragment() {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Text createTextNode(final String data) {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Comment createComment(final String data) {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final CDATASection createCDATASection(final String data) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final ProcessingInstruction createProcessingInstruction(final String target,
+ final String data) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Attr createAttribute(final String name) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final EntityReference createEntityReference(final String name)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node importNode(final Node importedNode, final boolean deep) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Element createElementNS(final String namespaceURI, final String qualifiedName)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Attr createAttributeNS(final String namespaceURI, final String qualifiedName)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JElement.java b/contrib/src/java/org/jdom/contrib/dom/JElement.java
new file mode 100644
index 0000000..e1efc9a
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JElement.java
@@ -0,0 +1,371 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.net.URISyntaxException;
+import java.util.Iterator;
+import java.util.List;
+
+import org.jdom.filter2.AbstractFilter;
+import org.w3c.dom.Attr;
+import org.w3c.dom.DOMException;
+import org.w3c.dom.Element;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.TypeInfo;
+
+import org.jdom.Attribute;
+import org.jdom.Namespace;
+import org.jdom.Parent;
+import org.jdom.filter2.Filters;
+
+class JElement extends JParent implements Element {
+
+ private final class AttMap implements NamedNodeMap {
+
+ private final Attr[] atts;
+
+ public AttMap(final Attr[] atts) {
+ super();
+ this.atts = atts;
+ }
+
+ @Override
+ public Node item(final int index) {
+ if (index < 0 || index >= atts.length) {
+ return null;
+ }
+ return atts[index];
+ }
+
+ @Override
+ public Node getNamedItemNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ if (namespaceURI == null || localName == null) {
+ return null;
+ }
+ for (int i = 0; i < atts.length; i++) {
+ if (namespaceURI.equals(atts[i].getNamespaceURI()) &&
+ localName.equals(atts[i].getLocalName())) {
+ return atts[i];
+ }
+ }
+ return null;
+ }
+
+ @Override
+ public Node getNamedItem(final String name) {
+ if (name == null) {
+ return null;
+ }
+ for (int i = 0; i < atts.length; i++) {
+ if (name.equals(atts[i].getName())) {
+ return atts[i];
+ }
+ }
+ return null;
+ }
+
+ @Override
+ public int getLength() {
+ return atts.length;
+ }
+
+ @Override
+ public Node setNamedItemNS(final Node arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node setNamedItem(final Node arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node removeNamedItemNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node removeNamedItem(final String name) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ }
+
+ private NamedNodeMap attmap = null;
+ private final Namespace[] nsdec;
+
+ public JElement(final JDocument topdoc, final JParent parent,
+ final Parent shadow, final Namespace[] nstack,
+ final Namespace[] ndec) {
+ super(topdoc, parent, shadow, Node.ELEMENT_NODE, nstack);
+ this. nsdec = ndec;
+ }
+
+ @Override
+ public final String getNodeName() {
+ return getTagName();
+ }
+
+ @Override
+ public final String getNodeValue() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public final NamedNodeMap getAttributes() {
+ if (attmap == null) {
+ final org.jdom.Element emt = (org.jdom.Element)shadow;
+ if (emt.hasAttributes() || nsdec.length > 0) {
+ final List list = emt.getAttributes();
+ final int sz = list.size();
+ final Attr[] ja = new Attr[sz + nsdec.length];
+ for (int i = 0; i < nsdec.length; i++) {
+ ja[i] = new JNamespace(topdoc, this, nsdec[i], scope);
+ }
+ for (int i = 0; i < sz; i++) {
+ ja[nsdec.length + i] = topdoc.find(list.get(i));
+ }
+ attmap = new AttMap(ja);
+ } else {
+ attmap = EMPTYMAP;
+ }
+ }
+ return attmap;
+ }
+
+ @Override
+ public final String getNamespaceURI() {
+ return ((org.jdom.Element)shadow).getNamespaceURI();
+ }
+
+ @Override
+ public final String getPrefix() {
+ return ((org.jdom.Element)shadow).getNamespacePrefix();
+ }
+
+ @Override
+ public final String getLocalName() {
+ return ((org.jdom.Element)shadow).getName();
+ }
+
+ @Override
+ public final String getBaseURI() {
+ try {
+ return ((org.jdom.Element)shadow).getXMLBaseURI().toASCIIString();
+ } catch (final URISyntaxException e) {
+ throw new IllegalStateException("Broken base URI references.", e);
+ }
+ }
+
+ @Override
+ public String getTextContent() throws DOMException {
+ final Iterator it = ((org.jdom.Element)shadow).
+ getDescendants(AbstractFilter.toFilter(Filters.fclass(org.jdom.Text.class)));
+ final StringBuilder sb = new StringBuilder();
+ while (it.hasNext()) {
+ sb.append(it.next().getText());
+ }
+ return sb.toString();
+ }
+
+ @Override
+ public String getTagName() {
+ return ((org.jdom.Element)shadow).getQualifiedName();
+ }
+
+ @Override
+ public TypeInfo getSchemaTypeInfo() {
+ // TODO Auto-generated method stub
+ return null;
+ }
+
+ @Override
+ public NodeList getElementsByTagName(final String tagname) {
+ return topdoc.getElementsByTagName(shadow, tagname);
+ }
+
+ @Override
+ public NodeList getElementsByTagNameNS(final String namespaceURI, final String localName) {
+ return topdoc.getElementsByTagNameNS(shadow, namespaceURI, localName);
+ }
+
+
+ /* ********************************************************
+ * Attribute Access methods below
+ * ******************************************************** */
+
+ @Override
+ public final boolean hasAttributes() {
+ return ((org.jdom.Element)shadow).hasAttributes();
+ }
+
+ @Override
+ public boolean hasAttribute(final String name) {
+ final Attribute att = ((org.jdom.Element)shadow).getAttribute(name);
+ return att != null;
+ }
+
+ @Override
+ public boolean hasAttributeNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ final Attribute att =
+ ((org.jdom.Element)shadow).getAttribute(
+ localName, Namespace.getNamespace(namespaceURI));
+ return att != null;
+ }
+
+ @Override
+ public String getAttribute(final String name) {
+ final Attribute att = ((org.jdom.Element)shadow).getAttribute(name);
+ return att == null ? "" : att.getValue();
+ }
+
+ @Override
+ public String getAttributeNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ final Attribute att =
+ ((org.jdom.Element)shadow).getAttribute(
+ localName, Namespace.getNamespace(namespaceURI));
+ return att == null ? "" : att.getValue();
+ }
+
+ @Override
+ public Attr getAttributeNode(final String name) {
+ return (Attr)getAttributes().getNamedItem(name);
+ }
+
+ @Override
+ public Attr getAttributeNodeNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ return (Attr)getAttributes().getNamedItemNS(namespaceURI, localName);
+ }
+
+ /* ********************************************************
+ * Illegal modification methods below.
+ * ******************************************************** */
+
+ @Override
+ public Attr setAttributeNodeNS(final Attr newAttr) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void setIdAttribute(final String name, final boolean isId) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void setIdAttributeNS(final String namespaceURI, final String localName,
+ final boolean isId) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void setIdAttributeNode(final Attr idAttr, final boolean isId)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void setAttributeNS(final String namespaceURI, final String qualifiedName,
+ final String value) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void removeAttributeNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public Attr setAttributeNode(final Attr newAttr) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void setAttribute(final String name, final String value) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public void removeAttribute(final String name) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public Attr removeAttributeNode(final Attr oldAttr) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JEntityRef.java b/contrib/src/java/org/jdom/contrib/dom/JEntityRef.java
new file mode 100644
index 0000000..624e910
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JEntityRef.java
@@ -0,0 +1,87 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.EntityReference;
+
+import org.jdom.Content;
+import org.jdom.EntityRef;
+import org.jdom.Namespace;
+
+class JEntityRef extends JSimpleContent implements EntityReference {
+
+ public JEntityRef(final JDocument topdoc, final JParent parent, final Content content,
+ final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return ((EntityRef)shadow).getName();
+ }
+
+ @Override
+ public String getNodeValue() throws DOMException {
+ return null;
+ }
+
+ @Override
+ public String getTextContent() throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JNamespace.java b/contrib/src/java/org/jdom/contrib/dom/JNamespace.java
new file mode 100644
index 0000000..10e27e3
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JNamespace.java
@@ -0,0 +1,169 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.Attr;
+import org.w3c.dom.DOMException;
+import org.w3c.dom.Element;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.TypeInfo;
+
+import org.jdom.JDOMConstants;
+import org.jdom.Namespace;
+
+final class JNamespace extends JNamespaceAware implements Attr {
+
+ final Namespace ns;
+ public JNamespace(final JDocument topdoc, final JElement parent, final Namespace namespace,
+ final Namespace[] nstack) {
+ super(topdoc, parent, Node.ATTRIBUTE_NODE, nstack);
+ this.ns = namespace;
+ }
+
+ @Override
+ public final Object getWrapped() {
+ return ns;
+ }
+
+ @Override
+ public String getNodeName() {
+ return getName();
+ }
+ @Override
+ public String getNodeValue() throws DOMException {
+ return getValue();
+ }
+ @Override
+ public NodeList getChildNodes() {
+ return EMPTYLIST;
+ }
+ @Override
+ public Node getFirstChild() {
+ return null;
+ }
+ @Override
+ public Node getLastChild() {
+ return null;
+ }
+ @Override
+ public NamedNodeMap getAttributes() {
+ return null;
+ }
+ @Override
+ public boolean hasChildNodes() {
+ return false;
+ }
+ @Override
+ public String getNamespaceURI() {
+ return "".equals(ns.getPrefix()) ? "" : JDOMConstants.NS_URI_XMLNS;
+ }
+ @Override
+ public String getPrefix() {
+ return "".equals(ns.getPrefix()) ? "" : JDOMConstants.NS_PREFIX_XMLNS;
+ }
+ @Override
+ public String getLocalName() {
+ return "".equals(ns.getPrefix()) ? JDOMConstants.NS_PREFIX_XMLNS : ns.getPrefix();
+ }
+ @Override
+ public boolean hasAttributes() {
+ return false;
+ }
+ @Override
+ public String getBaseURI() {
+ return parent.getBaseURI();
+ }
+ @Override
+ public String getTextContent() throws DOMException {
+ return "";
+ }
+ @Override
+ public String getName() {
+ return "".equals(ns.getPrefix()) ? ns.getPrefix() : (JDOMConstants.NS_PREFIX_XMLNS + ":" + ns.getPrefix());
+ }
+ @Override
+ public boolean getSpecified() {
+ return true;
+ }
+ @Override
+ public String getValue() {
+ return ns.getURI();
+ }
+
+ @Override
+ public Element getOwnerElement() {
+ return (Element)getParentNode();
+ }
+
+ @Override
+ public TypeInfo getSchemaTypeInfo() {
+ return TYPEINFO;
+ }
+
+ @Override
+ public boolean isId() {
+ return false;
+ }
+
+ @Override
+ public void setValue(final String value) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+
+}
\ No newline at end of file
diff --git a/contrib/src/java/org/jdom/contrib/dom/JNamespaceAware.java b/contrib/src/java/org/jdom/contrib/dom/JNamespaceAware.java
new file mode 100644
index 0000000..7f7f117
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JNamespaceAware.java
@@ -0,0 +1,100 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.jdom.Namespace;
+
+abstract class JNamespaceAware extends JNode {
+
+ protected final Namespace[] scope;
+
+ public JNamespaceAware(final JDocument topdoc, final JParent parent,
+ final short nodetype, final Namespace[] nstack) {
+ super(topdoc, parent, nodetype);
+ scope = nstack;
+ }
+
+ @Override
+ public final String lookupPrefix(final String namespaceURI) {
+ for (int i = 0; i < scope.length; i++) {
+ if (scope[i].getURI().equals(namespaceURI)) {
+ return scope[i].getPrefix();
+ }
+ }
+ return null;
+ }
+
+ @Override
+ public final boolean isDefaultNamespace(final String namespaceURI) {
+ for (int i = 0; i < scope.length; i++) {
+ if (scope[i].getURI().equals(namespaceURI) && "".equals(scope[i].getPrefix())) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ @Override
+ public final String lookupNamespaceURI(final String prefix) {
+ for (int i = 0; i < scope.length; i++) {
+ if (scope[i].getPrefix().equals(prefix)) {
+ return scope[i].getURI();
+ }
+ }
+ return null;
+ }
+
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JNode.java b/contrib/src/java/org/jdom/contrib/dom/JNode.java
new file mode 100644
index 0000000..78a24a3
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JNode.java
@@ -0,0 +1,409 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.Document;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.TypeInfo;
+import org.w3c.dom.UserDataHandler;
+
+abstract class JNode implements Node, Wrapper {
+
+ protected static final TypeInfo TYPEINFO = new TypeInfo() {
+ @Override
+ public boolean isDerivedFrom(final String typeNamespaceArg, final String typeNameArg,
+ final int derivationMethod) {
+ return false;
+ }
+
+ @Override
+ public String getTypeNamespace() {
+ return "http://www.w3.org/TR/REC-xml";
+ }
+
+ @Override
+ public String getTypeName() {
+ return null;
+ }
+ };
+
+
+
+ protected static final NodeList EMPTYLIST = new NodeList() {
+ @Override
+ public Node item(final int index) {
+ return null;
+ }
+ @Override
+ public int getLength() {
+ return 0;
+ }
+ };
+
+ protected static final NamedNodeMap EMPTYMAP = new NamedNodeMap() {
+
+ @Override
+ public Node setNamedItemNS(final Node arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node setNamedItem(final Node arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node removeNamedItemNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node removeNamedItem(final String name) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public Node item(final int index) {
+ return null;
+ }
+
+ @Override
+ public Node getNamedItemNS(final String namespaceURI, final String localName)
+ throws DOMException {
+ return null;
+ }
+
+ @Override
+ public Node getNamedItem(final String name) {
+ return null;
+ }
+
+ @Override
+ public int getLength() {
+ return 0;
+ }
+ };
+
+ private final short nodetype;
+ protected final JDocument topdoc;
+ protected final JParent parent;
+
+ private HashMap userdata;
+
+ JNode(final JDocument topdoc, final JParent parent, final short nodetype) {
+ // the rule is that only JDocument constructor can pass a null topdoc.
+ this.topdoc = topdoc == null ? (JDocument)this : topdoc;
+ this.nodetype = nodetype;
+ this.parent = parent;
+ }
+
+ /**
+ * Attribute, Document, and Element need to override this.
+ * @param other will be another node of the same type that needs to be
+ * compared.
+ * @return true if the rules match the Node.isEqualsNode() method.
+ */
+ protected boolean detailEquals(final JNode other) {
+ return true;
+ }
+
+ /* ****************************************************
+ * Below this all methods are final...
+ * **************************************************** */
+
+ @Override
+ public final Node getPreviousSibling() {
+ if (parent == null) {
+ return null;
+ }
+ return parent.getPreviousSibling(this);
+ }
+
+ @Override
+ public final Node getNextSibling() {
+ if (parent == null) {
+ return null;
+ }
+ return parent.getNextSibling(this);
+ }
+
+
+
+
+ @Override
+ public final Object setUserData(final String key, final Object data, final UserDataHandler handler) {
+ // since the node can never be adopted or cloned, the handler
+ // events can never be called, thus we do not need to track the handler.
+ if (userdata == null) {
+ userdata = new HashMap();
+ }
+ return userdata.put(key, data);
+ }
+
+ @Override
+ public final Object getUserData(final String key) {
+ if (userdata == null) {
+ return null;
+ }
+ return userdata.get(key);
+ }
+
+ @Override
+ public final Object getFeature(final String feature, final String version) {
+ return null;
+ }
+
+ @Override
+ public final Node getParentNode() {
+ return parent;
+ }
+
+ @Override
+ public final short getNodeType() {
+ return nodetype;
+ }
+
+ @Override
+ public final Document getOwnerDocument() {
+ return topdoc;
+ }
+
+ @Override
+ public final short compareDocumentPosition(final Node other) throws DOMException {
+ if ((other instanceof JNode)) {
+ JNode their = (JNode)other;
+ if (their == this) {
+ return 0;
+ }
+ if (their.topdoc == topdoc) {
+ // same document....
+ final ArrayList ancestry = new ArrayList();
+ ancestry.add(their);
+ JNode p = their.parent;
+ while (p != null) {
+ if (p == this) {
+ // we contain the other node.
+ return DOCUMENT_POSITION_CONTAINED_BY | DOCUMENT_POSITION_FOLLOWING;
+ }
+ ancestry.add(p);
+ p = p.parent;
+ }
+ // OK, we have the ancestry.... but, we are not on the direct ancestry of that node.
+ // let's find an intersection of our ancestry...
+ p = this.parent;
+ JNode k = this;
+ final int alen = ancestry.size();
+ while (p != null) {
+ for (int apos = 0; apos < alen; apos++) {
+ if (p == ancestry.get(apos)) {
+ // we have intersected...
+ final int sibpos = apos - 1;
+ if (sibpos < 0) {
+ return DOCUMENT_POSITION_CONTAINS | DOCUMENT_POSITION_PRECEDING;
+ }
+ final JNode sibling = ancestry.get(sibpos);
+ // need to get relative order of 'k' and sibling within 'p'.
+ final JParent prnt = (JParent)p;
+ if (sibling instanceof JAttribute) {
+ final NamedNodeMap nnm = prnt.getAttributes();
+ for (int i = nnm.getLength() - 1; i >= 0; i--) {
+ final Node n = nnm.item(i);
+ if (n == sibling) {
+ return DOCUMENT_POSITION_FOLLOWING;
+ } else if (n == k) {
+ return DOCUMENT_POSITION_PRECEDING;
+ }
+ }
+ } else {
+ for (int i = prnt.getLength() - 1; i >= 0; i--) {
+ final Node n = prnt.item(i);
+ if (n == sibling) {
+ return DOCUMENT_POSITION_FOLLOWING;
+ } else if (n == k) {
+ return DOCUMENT_POSITION_PRECEDING;
+ }
+ }
+ }
+ throw new IllegalStateException("Sibling nodes appear not to be siblings?");
+ }
+ }
+ k = p;
+ p = p.parent;
+ }
+ }
+ return Node.DOCUMENT_POSITION_DISCONNECTED;
+ }
+ throw new DOMException(DOMException.NOT_SUPPORTED_ERR, "Not same Document Model");
+ }
+
+ @Override
+ public final boolean isEqualNode(final Node other) {
+ // definition of DOM isEquals:
+ // Two nodes are equal if and only if the following conditions are satisfied:
+ //
+ // The two nodes are of the same type.
+ // The following string attributes are equal: nodeName, localName, namespaceURI, prefix, nodeValue . This is: they are both null, or they have the same length and are character for character identical.
+ // The attributes NamedNodeMaps are equal. This is: they are both null, or they have the same length and for each node that exists in one map there is a node that exists in the other map and is equal, although not necessarily at the same index.
+ // The childNodes NodeLists are equal. This is: they are both null, or they have the same length and contain equal nodes at the same index. Note that normalization can affect equality; to avoid this, nodes should be normalized before being compared.
+ //
+ if (other == null) {
+ return false;
+ }
+ if (!getClass().isInstance(other)) {
+ return false;
+ }
+ if (isSameNode(other)) {
+ return true;
+ }
+ if (areSame(getNodeName(), other.getNodeName()) &&
+ areSame(getLocalName(), other.getLocalName()) &&
+ areSame(getNamespaceURI(), other.getNamespaceURI()) &&
+ areSame(getPrefix(), other.getPrefix()) &&
+ areSame(getNodeValue(), other.getNodeValue())) {
+ return detailEquals((JNode)other);
+ }
+
+ return false;
+ }
+
+ @Override
+ public final boolean isSameNode(final Node other) {
+ return this == other;
+ }
+
+ @Override
+ public final Node cloneNode(final boolean deep) {
+ // this would modify things.... we skip it.
+ // as a convenience we just return ourselves ... readonly.
+ // this breaks the DOM specification, but there is so much
+ // that is broken by this thin wrapper.....
+ return this;
+ }
+
+ @Override
+ public final void normalize() {
+ // this would modify things.... we skip it.
+ }
+
+ @Override
+ public final boolean isSupported(final String feature, final String version) {
+ // anything that requires feature support is not supported... ;-)
+ return false;
+ }
+
+ @Override
+ public final void setPrefix(final String prefix) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node insertBefore(final Node newChild, final Node refChild) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node replaceChild(final Node newChild, final Node oldChild) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node removeChild(final Node oldChild) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final Node appendChild(final Node newChild) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final void setTextContent(final String textContent) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ @Override
+ public final void setNodeValue(final String nodeValue) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+ protected static final boolean areSame(final String a, final String b) {
+ if (b == null) {
+ return a == null;
+ }
+ if (a == null) {
+ return false;
+ }
+ return a.equals(b);
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JNodeList.java b/contrib/src/java/org/jdom/contrib/dom/JNodeList.java
new file mode 100644
index 0000000..f06faab
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JNodeList.java
@@ -0,0 +1,83 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.util.List;
+
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+final class JNodeList implements NodeList {
+
+ private final List list;
+
+ public JNodeList(final List list) {
+ this.list = list;
+ }
+
+ @Override
+ public Node item(final int index) {
+ if (index < 0 || index >= list.size()) {
+ return null;
+ }
+ return list.get(index);
+ }
+
+ @Override
+ public int getLength() {
+ return list.size();
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JParent.java b/contrib/src/java/org/jdom/contrib/dom/JParent.java
new file mode 100644
index 0000000..92da2f6
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JParent.java
@@ -0,0 +1,189 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import java.util.List;
+
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+import org.jdom.CDATA;
+import org.jdom.Comment;
+import org.jdom.Content;
+import org.jdom.DocType;
+import org.jdom.Element;
+import org.jdom.EntityRef;
+import org.jdom.Namespace;
+import org.jdom.Parent;
+import org.jdom.ProcessingInstruction;
+import org.jdom.Text;
+
+abstract class JParent extends JNamespaceAware implements NodeList {
+
+ private JNamespaceAware[] kids = null;
+ protected final Parent shadow;
+
+ public JParent(final JDocument topdoc, final JParent parent,
+ final Parent shadow, final short nodetype,
+ final Namespace[] nstack) {
+ super(topdoc, parent, nodetype, nstack);
+ this.shadow = shadow;
+ }
+
+ @Override
+ public final Object getWrapped() {
+ return shadow;
+ }
+
+
+
+ private final JNamespaceAware hydrate(final Content k) {
+ switch(k.getCType()) {
+ case CDATA:
+ return topdoc.find((CDATA)k);
+ case Comment:
+ return topdoc.find((Comment)k);
+ case DocType:
+ return topdoc.find((DocType)k);
+ case Element:
+ return topdoc.find((Element)k);
+ case EntityRef:
+ return topdoc.find((EntityRef)k);
+ case ProcessingInstruction:
+ return topdoc.find((ProcessingInstruction)k);
+ case Text:
+ return topdoc.find((Text)k);
+ }
+ throw new IllegalStateException("Unexpected content " + k);
+ }
+
+ protected final JNamespaceAware[] checkKids() {
+ if (kids != null) {
+ return kids;
+ }
+
+ if (shadow == null) {
+ kids = new JNamespaceAware[0];
+ return kids;
+ }
+
+ final List content = shadow.getContent();
+ kids = new JNamespaceAware[content.size()];
+ for (int i = 0; i < kids.length; i++) {
+ kids[i] = hydrate( content.get(i) );
+ }
+
+ return kids;
+ }
+
+ protected final JNode getPreviousSibling(final JNode jNode) {
+ checkKids();
+ for (int i = 0; i < kids.length; i++) {
+ if (kids[i] == jNode) {
+ return i > 0 ? kids[i - 1] : null;
+ }
+ }
+ return null;
+ }
+
+ protected final JNode getNextSibling(final JNode jNode) {
+ checkKids();
+ for (int i = 0; i < kids.length; i++) {
+ if (kids[i] == jNode) {
+ return i < kids.length - 1 ? kids[i + 1] : null;
+ }
+ }
+ return null;
+ }
+
+ @Override
+ public final boolean hasChildNodes() {
+ checkKids();
+ return kids.length > 0;
+ }
+
+
+ @Override
+ public final NodeList getChildNodes() {
+ checkKids();
+ return this;
+ }
+
+ @Override
+ public final Node getFirstChild() {
+ checkKids();
+ return kids.length > 0 ? kids[0] : null;
+ }
+
+ @Override
+ public final Node getLastChild() {
+ checkKids();
+ return kids.length > 0 ? kids[kids.length - 1] : null;
+ }
+
+ @Override
+ public final Node item(final int index) {
+ checkKids();
+ return index >= 0 && index < kids.length ? kids[index] : null;
+ }
+
+ @Override
+ public final int getLength() {
+ checkKids();
+ return kids.length;
+ }
+
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JProcessingInstruction.java b/contrib/src/java/org/jdom/contrib/dom/JProcessingInstruction.java
new file mode 100644
index 0000000..b8b107d
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JProcessingInstruction.java
@@ -0,0 +1,102 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.ProcessingInstruction;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+class JProcessingInstruction extends JSimpleContent implements
+ProcessingInstruction {
+
+ public JProcessingInstruction(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return getTarget();
+ }
+
+ @Override
+ public String getNodeValue() throws DOMException {
+ return getData();
+ }
+
+ @Override
+ public String getTextContent() throws DOMException {
+ return getData();
+ }
+
+ @Override
+ public String getTarget() {
+ return ((org.jdom.ProcessingInstruction)shadow).getTarget();
+ }
+
+ @Override
+ public String getData() {
+ return ((org.jdom.ProcessingInstruction)shadow).getData();
+ }
+
+ @Override
+ public void setData(final String data) throws DOMException {
+ throw new DOMException(DOMException.NO_MODIFICATION_ALLOWED_ERR,
+ "Cannot modify JDOM Wrapper DOM objects.");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JSimpleCharacterContent.java b/contrib/src/java/org/jdom/contrib/dom/JSimpleCharacterContent.java
new file mode 100644
index 0000000..5029d20
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JSimpleCharacterContent.java
@@ -0,0 +1,126 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.CharacterData;
+import org.w3c.dom.DOMException;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+abstract class JSimpleCharacterContent extends JSimpleContent implements CharacterData {
+
+ public JSimpleCharacterContent(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public final String getNodeValue() throws DOMException {
+ return getData();
+ }
+
+ @Override
+ public final String getTextContent() throws DOMException {
+ return getData();
+ }
+
+ @Override
+ public final String getData() throws DOMException {
+ return shadow.getValue();
+ }
+
+ @Override
+ public final void setData(final String data) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public final int getLength() {
+ return getData().length();
+ }
+
+ @Override
+ public final String substringData(final int offset, final int count) throws DOMException {
+ return getData().substring(offset, offset + count);
+ }
+
+ @Override
+ public final void appendData(final String arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public final void insertData(final int offset, final String arg) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public final void deleteData(final int offset, final int count) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public final void replaceData(final int offset, final int count, final String arg)
+ throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JSimpleContent.java b/contrib/src/java/org/jdom/contrib/dom/JSimpleContent.java
new file mode 100644
index 0000000..418c8bc
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JSimpleContent.java
@@ -0,0 +1,82 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+
+abstract class JSimpleContent extends JContent {
+
+ public JSimpleContent(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNamespaceURI() {
+ return null;
+ }
+
+ @Override
+ public String getPrefix() {
+ return null;
+ }
+
+ @Override
+ public String getLocalName() {
+ return null;
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/JText.java b/contrib/src/java/org/jdom/contrib/dom/JText.java
new file mode 100644
index 0000000..5c9f34e
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/JText.java
@@ -0,0 +1,98 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+import org.w3c.dom.DOMException;
+import org.w3c.dom.Text;
+
+import org.jdom.Content;
+import org.jdom.Namespace;
+import org.jdom.Verifier;
+
+class JText extends JSimpleCharacterContent implements Text {
+
+ public JText(final JDocument topdoc, final JParent parent,
+ final Content content, final Namespace[] nstack) {
+ super(topdoc, parent, content, nstack);
+ }
+
+ @Override
+ public String getNodeName() {
+ return "#text";
+ }
+
+ @Override
+ public final Text splitText(final int offset) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+ @Override
+ public final boolean isElementContentWhitespace() {
+ return Verifier.isAllXMLWhitespace(getData());
+ }
+
+ @Override
+ public final String getWholeText() {
+ return getData();
+ }
+
+ @Override
+ public final Text replaceWholeText(final String tcontent) throws DOMException {
+ throw new DOMException(
+ DOMException.NO_MODIFICATION_ALLOWED_ERR, "JDOM Wrapper");
+ }
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/Wrapper.java b/contrib/src/java/org/jdom/contrib/dom/Wrapper.java
new file mode 100644
index 0000000..3ce010c
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/Wrapper.java
@@ -0,0 +1,84 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dom;
+
+/**
+ * All DOM Node instances from this package are also instances of this.
+ * You can access the JDOM object behind this DOM node by calling the
+ * getWrapped() method.
+ *
+ * @author Rolf Lear
+ *
+ */
+public interface Wrapper {
+ /**
+ * Get the backing JDOM object. The backing object could be:
+ *
+ * - null if this is a Document DOM node, and there was not an actual
+ * JDOM document instance.
+ *
- A JDOM Document for
+ *
- A JDOM Attribute
+ *
- A JDOM Element
+ *
- A JDOM Text
+ *
- A JDOM CDATA
+ *
- A JDOM ProcessingInstruction
+ *
- A JDOM EntityRef
+ *
- A JDOM Comment
+ *
- A JDOM DocTyoe
+ *
+ * @return the JDOM object that backs this DOM Node.
+ */
+ public Object getWrapped();
+}
diff --git a/contrib/src/java/org/jdom/contrib/dom/package.html b/contrib/src/java/org/jdom/contrib/dom/package.html
new file mode 100644
index 0000000..a5d55ea
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dom/package.html
@@ -0,0 +1,5 @@
+
+
+Classes enabling the read-only view of a JDOM document as a DOM model.
+
+
diff --git a/contrib/src/java/org/jdom/contrib/dtdaware/AttAwareXMLOutputProcessor.java b/contrib/src/java/org/jdom/contrib/dtdaware/AttAwareXMLOutputProcessor.java
new file mode 100644
index 0000000..1ff34c3
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dtdaware/AttAwareXMLOutputProcessor.java
@@ -0,0 +1,199 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dtdaware;
+
+import java.io.IOException;
+import java.io.Writer;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+import org.jdom.Attribute;
+import org.jdom.Element;
+import org.jdom.output.support.AbstractXMLOutputProcessor;
+import org.jdom.output.support.FormatStack;
+
+/**
+ * Implement a class that is sensitive to an input document's defaulted/implied
+ * attributes, and will not output attributes that are implied.
+ *
+ * You create an instance of this Processor, then tell it what attribute values
+ * to ignore. You do that by calling the ignore() methods with the details of
+ * what attributes (and what the required value of that attribute would be) to
+ * ignore.
+ *
+ * When the XML is output this processor will ignore those attributes which
+ * match the 'ignore' specs.
+ *
+ * @author Rolf Lear
+ *
+ */
+public class AttAwareXMLOutputProcessor extends AbstractXMLOutputProcessor {
+ /**
+ * Yeah, this is complicated, but it is basically a search tree index.
+ * This is a nested index of attribute details:
+ *
+ *
+ * - at the top is the attribute name
+ *
- then the Attribute value.
+ *
- next is the Element name. We only check this level if the attribute
+ * name and value matches to something that is ignored.
+ *
- next we check to make sure that we are in the correct Attribute Namespace
+ *
- then finally the Element namespace.
+ *
+ *
+ * If we search this index tree and all the details match existing entries,
+ * then it is an ignored attribute. The order is set up in such a way that
+ * there should not need to be many checks in HashMaps for non-ignored
+ * content... essentiually we have to have the same attname and attvalue
+ * before the system even checks the Attribute's parent details.
+ */
+ // attname attval emtname attns emtns
+ private final Map>>>>
+ ignores = new HashMap>>>>();
+
+ /**
+ * Construct this AttAwareXMLOutputProcessor.
+ * Add attribute to exclude using the
+ * {@link #ignore(String, String, String, String, String)} method
+ */
+ public AttAwareXMLOutputProcessor() {
+ super();
+ }
+
+
+ /**
+ * Ignore an attribute (where the attribute and element are both in the
+ * no-uri namespace).
+ * @param elementname The name of the Attribute's parent element.
+ * @param attname The name of the attribute.
+ * @param attvalue The attribute value to ignore.
+ */
+ public void ignore(String elementname, String attname, String attvalue) {
+ ignore("", elementname, "", attname, attvalue);
+ }
+
+ /**
+ * Ignore an attribute.
+ * @param elementuri The NamespaceURI of the Attribute's parent Element
+ * @param elementname The name of the Attribute's parent Element.
+ * @param atturi The Attribute's namespace URI.
+ * @param attname The name of the attribute.
+ * @param attvalue The attribute value.
+ */
+ public void ignore(String elementuri, String elementname,
+ String atturi, String attname, String attvalue) {
+ Map>>> av =
+ ignores.get(attname);
+ if (av == null) {
+ av = new HashMap>>>();
+ ignores.put(attname, av);
+ }
+ Map>> en = av.get(attvalue);
+ if (en == null) {
+ en = new HashMap>>();
+ av.put(attvalue, en);
+ }
+ Map> ans = en.get(elementname);
+ if (ans == null) {
+ ans = new HashMap>();
+ en.put(elementname, ans);
+ }
+ Set ens = ans.get(atturi);
+ if (ens == null) {
+ ens = new HashSet();
+ ans.put(atturi, ens);
+ }
+ ens.add(elementuri);
+ }
+
+ /**
+ * This extends the printAttribute code to search for attributes to ignore.
+ */
+ @Override
+ protected void printAttribute(Writer out, FormatStack fstack,
+ Attribute attribute) throws IOException {
+ // do we have anything to ignore.
+ if (!ignores.isEmpty()) {
+ // yes, there are ignores.
+ final Map>>> av =
+ ignores.get(attribute.getName());
+ if (av != null) {
+ // we are ignoring at least one attribute with this name.
+ final Map>> en =
+ av.get(attribute.getValue());
+ if (en != null) {
+ // we ignore something with the attribute name and value
+ final Element e = attribute.getParent();
+ final Map> ans =
+ en.get(e.getName());
+ if (ans != null) {
+ // and the same Element name
+ final Set ens = ans.get(attribute.getNamespaceURI());
+ if (ens != null && ens.contains(e.getNamespaceURI())) {
+ // and the same Attribute and Element namespace....
+ // we match the ignored content...
+ // skip this attribute.
+ return;
+ }
+ }
+ }
+ }
+ }
+ // we are not ignoring this attribute.
+ super.printAttribute(out, fstack, attribute);
+ }
+}
diff --git a/contrib/src/java/org/jdom/contrib/dtdaware/AttFilter.java b/contrib/src/java/org/jdom/contrib/dtdaware/AttFilter.java
new file mode 100644
index 0000000..0592fae
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dtdaware/AttFilter.java
@@ -0,0 +1,189 @@
+/*--
+
+ Copyright (C) 2011-2014 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dtdaware;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.Set;
+
+import org.jdom.Attribute;
+import org.jdom.Element;
+import org.jdom.filter2.AbstractFilter;
+
+
+/**
+ * This AttFilter can be programmed to ignore specific attributes.
+ * The ignore criteria is based on the Attribute name, value, and the
+ * Element it is attached to.
+ *
+ * @author Rolf Lear
+ *
+ */
+public class AttFilter extends AbstractFilter {
+
+ /**
+ *
+ */
+ private static final long serialVersionUID = 1L;
+ /**
+ * Yeah, this is complicated, but it is basically a search tree index.
+ * This is a nested index of attribute details:
+ *
+ *
+ * - at the top is the attribute name
+ *
- then the Attribute value.
+ *
- next is the Element name. We only check this level if the attribute
+ * name and value matches to something that is ignored.
+ *
- next we check to make sure that we are in the correct Attribute Namespace
+ *
- then finally the Element namespace.
+ *
+ *
+ * If we search this index tree and all the details match existing entries,
+ * then it is an ignored attribute. The order is set up in such a way that
+ * there should not need to be many checks in HashMaps for non-ignored
+ * content... essentiually we have to have the same attname and attvalue
+ * before the system even checks the Attribute's parent details.
+ */
+ // attname attval emtname attns emtns
+ private final Map>>>>
+ ignores = new HashMap>>>>();
+
+ /**
+ * Ignore an attribute (where the attribute and element are both in the
+ * no-uri namespace).
+ * @param elementname The name of the Attribute's parent element.
+ * @param attname The name of the attribute.
+ * @param attvalue The attribute value to ignore.
+ */
+ public void ignore(String elementname, String attname, String attvalue) {
+ ignore("", elementname, "", attname, attvalue);
+ }
+
+ /**
+ * Ignore an attribute.
+ * @param elementuri The NamespaceURI of the Attribute's parent Element
+ * @param elementname The name of the Attribute's parent Element.
+ * @param atturi The Attribute's namespace URI.
+ * @param attname The name of the attribute.
+ * @param attvalue The attribute value.
+ */
+ public void ignore(String elementuri, String elementname,
+ String atturi, String attname, String attvalue) {
+ Map>>> av =
+ ignores.get(attname);
+ if (av == null) {
+ av = new HashMap>>>();
+ ignores.put(attname, av);
+ }
+ Map>> en = av.get(attvalue);
+ if (en == null) {
+ en = new HashMap>>();
+ av.put(attvalue, en);
+ }
+ Map> ans = en.get(elementname);
+ if (ans == null) {
+ ans = new HashMap>();
+ en.put(elementname, ans);
+ }
+ Set ens = ans.get(atturi);
+ if (ens == null) {
+ ens = new HashSet();
+ ans.put(atturi, ens);
+ }
+ ens.add(elementuri);
+ }
+
+
+
+
+ @Override
+ public Attribute filter(Object content) {
+ if (!(content instanceof Attribute)) {
+ return null;
+ }
+ Attribute attribute = (Attribute)content;
+ if (!ignores.isEmpty()) {
+ // yes, there are ignores.
+ final Map>>> av =
+ ignores.get(attribute.getName());
+ if (av != null) {
+ // we are ignoring at least one attribute with this name.
+ final Map>> en =
+ av.get(attribute.getValue());
+ if (en != null) {
+ // we ignore something with the attribute name and value
+ final Element e = attribute.getParent();
+ final Map> ans =
+ en.get(e.getName());
+ if (ans != null) {
+ // and the same Element name
+ final Set ens = ans.get(attribute.getNamespaceURI());
+ if (ens != null && ens.contains(e.getNamespaceURI())) {
+ // and the same Attribute and Element namespace....
+ // we match the ignored content...
+ // skip this attribute.
+ return null;
+ }
+ }
+ }
+ }
+ }
+ return attribute;
+ }
+
+
+
+}
diff --git a/contrib/src/java/org/jdom/contrib/dtdaware/AttFilteredXMLOutputProcessor.java b/contrib/src/java/org/jdom/contrib/dtdaware/AttFilteredXMLOutputProcessor.java
new file mode 100644
index 0000000..f6c5f6a
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/dtdaware/AttFilteredXMLOutputProcessor.java
@@ -0,0 +1,101 @@
+/*--
+
+ Copyright (C) 2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.dtdaware;
+
+import java.io.IOException;
+import java.io.Writer;
+
+import org.jdom.Attribute;
+import org.jdom.filter2.Filter;
+import org.jdom.output.support.AbstractXMLOutputProcessor;
+import org.jdom.output.support.FormatStack;
+
+/**
+ * Implement a class that is sensitive to a document's attributes, and will not
+ * output attributes that fail to match the supplied Filter.
+ *
+ * @author Rolf Lear
+ *
+ */
+public class AttFilteredXMLOutputProcessor extends AbstractXMLOutputProcessor {
+ /**
+ * Attributes that do not match this filter will not be printed.
+ */
+ private final Filter attfilter;
+
+ /**
+ * Construct this AttAwareXMLOutputProcessor.
+ * @param attf The filter to use which determines what Attributes are processed.
+ */
+ public AttFilteredXMLOutputProcessor(Filter attf) {
+ super();
+ this.attfilter = attf;
+ }
+
+
+ /**
+ * This extends the printAttribute code to search for attributes to ignore.
+ */
+ @Override
+ protected void printAttribute(Writer out, FormatStack fstack,
+ Attribute attribute) throws IOException {
+ // do we have anything to ignore.
+ // we are not ignoring this attribute.
+ if (!attfilter.matches(attribute)) {
+ return;
+ }
+ super.printAttribute(out, fstack, attribute);
+ }
+}
\ No newline at end of file
diff --git a/contrib/src/java/org/jdom/contrib/helpers/JDOMHelper.java b/contrib/src/java/org/jdom/contrib/helpers/JDOMHelper.java
new file mode 100644
index 0000000..9312b6e
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/helpers/JDOMHelper.java
@@ -0,0 +1,119 @@
+/*--
+
+ Copyright (C) 2000-2012 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.helpers;
+
+import org.jdom.*;
+import java.util.*;
+
+/**
+ * This class contains static helper methods.
+ *
+ * @author Alex Rosen
+ * @deprecated concept has been moved in to core:
+ * {@link Element#sortContent(Comparator)}
+ * @see Element#sortChildren(Comparator)
+ * @see Element#sortContent(Comparator)
+ * @see Element#sortContent(org.jdom.filter2.Filter, Comparator)
+ */
+@Deprecated
+public class JDOMHelper {
+ /**
+ *
+ * Sorts the child elements, using the specified comparator.
+ * @param parent The parent Element, whose child Elements should be sorted.
+ * @param c The Comparator to use for ordering the child Elements.
+ * It will only be given Element objects to compare.
+ *
+ *
+ * This method overcomes two problems with the standard Collections.sort():
+ *
+ * - Collections.sort() doesn't bother to remove an item from its old
+ * location before placing it in its new location, which causes JDOM to
+ * complain that the item has been added twice.
+ *
- This method will sort the child Elements without moving any other
+ * content, such as formatting text nodes (newlines, indents, etc.)
+ * Otherwise, all the formatting whitespace would move to the beginning
+ * or end of the content list.
+ * (Note that this means that the elements will now be in a different
+ * order with respect to any comments, which may cause a problem
+ * if the comments describe the elements.)
+ *
+ *
+ */
+ public static void sortElements(Element parent, Comparator c) {
+ // Create a new, static list of child elements, and sort it.
+ List children = new ArrayList(parent.getChildren());
+ Collections.sort(children, c);
+ ListIterator childrenIter = children.listIterator();
+
+ // Create a new, static list of all content items.
+ List content = new ArrayList(parent.getContent());
+ ListIterator contentIter = content.listIterator();
+
+ // Loop through the content items, and whenever we find an Element,
+ // we'll insert the next ordered Element in its place. Because the
+ // content list is not live, it won't complain about an Element being
+ // added twice.
+ while(contentIter.hasNext()) {
+ Object obj = contentIter.next();
+ if (obj instanceof Element)
+ contentIter.set(childrenIter.next());
+ }
+
+ // Finally, we set the content list back into the parent Element.
+ parent.setContent((List)null);
+ parent.setContent(content);
+ }
+}
\ No newline at end of file
diff --git a/contrib/src/java/org/jdom/contrib/helpers/README b/contrib/src/java/org/jdom/contrib/helpers/README
new file mode 100644
index 0000000..8f66078
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/helpers/README
@@ -0,0 +1,2 @@
+This is an area for little helper classes. It's open to experimentation and
+whimsy.
diff --git a/contrib/src/java/org/jdom/contrib/helpers/XPathHelper.java b/contrib/src/java/org/jdom/contrib/helpers/XPathHelper.java
new file mode 100644
index 0000000..32a75f4
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/helpers/XPathHelper.java
@@ -0,0 +1,561 @@
+/*--
+
+ Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.helpers;
+
+
+import java.util.Iterator;
+import java.util.List;
+
+import org.jdom.Attribute;
+import org.jdom.Comment;
+import org.jdom.Document;
+import org.jdom.Element;
+import org.jdom.JDOMException;
+import org.jdom.Namespace;
+import org.jdom.ProcessingInstruction;
+import org.jdom.Text;
+import org.jdom.filter.Filters;
+
+
+/**
+ * Provides a set of utility methods to generate XPath expressions
+ * to select a given node in a (subtree of a) document.
+ *
+ * Note: As this class has no knowledge of the
+ * document content, the generated XPath expression rely on the
+ * document structure. Hence any modification of the structure
+ * of the document may invalidate the generated XPaths.
+ *
+ * @author Laurent Bihanic
+ * @deprecated moved in to core: org.jdom.xpath.XPathHelper
+ * @see org.jdom.xpath.XPathHelper
+ */
+@Deprecated
+public class XPathHelper {
+
+ /**
+ * Returns the path to the specified Element from the document
+ * root as an XPath expression.
+ *
+ * @param to the Element the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null.
+ */
+ public static String getPathString(Element to) throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a given JDOM node to the specified
+ * Element as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the Element the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or from is not
+ * a {@link Document} or a {@link Element} node.
+ */
+ public static String getPathString(Object from, Element to)
+ throws JDOMException {
+ checkPathStringArguments(from, to);
+
+ if (to == from) {
+ return "node()";
+ }
+ return getElementPath(from, to, true).toString();
+ }
+
+ /**
+ * Returns the path to the specified Attribute from the document
+ * root as an XPath expression.
+ *
+ * @param to the Attribute the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null.
+ */
+ public static String getPathString(Attribute to) throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a given JDOM node to the specified
+ * Attribute as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the Attribute the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or from is not
+ * a {@link Document} or a {@link Element} node.
+ */
+ public static String getPathString(Object from, Attribute to)
+ throws JDOMException {
+ checkPathStringArguments(from, to);
+
+ if (to == from) {
+ return "node()";
+ }
+ StringBuilder path = getElementPath(from, to.getParent(), false);
+ path.append('@').append(to.getName()).toString();
+ return path.toString();
+ }
+
+ /**
+ * Returns the path to the specified Text node from the document
+ * root as an XPath expression.
+ *
+ * @param to the Text node the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null.
+ */
+ public static String getPathString(Text to) throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a given JDOM node to the specified
+ * Text node as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the Text node the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or from is not
+ * a {@link Document} or a {@link Element} node.
+ */
+ public static String getPathString(Object from, Text to)
+ throws JDOMException {
+ checkPathStringArguments(from, to);
+
+ if (to == from) {
+ return "node()";
+ }
+ Element parent = to.getParentElement();
+ List siblings = null;
+ StringBuilder path = getElementPath(from, parent, false);
+
+ if (parent != null) {
+ siblings = parent.getContent(Filters.text());
+ }
+ else {
+ Document doc = to.getDocument();
+ if (doc != null) {
+ siblings = doc.getContent(Filters.text());
+ }
+ }
+ return getPositionPath(to, siblings, "text()", path).toString();
+ }
+
+ /**
+ * Returns the path to the specified Comment from the document
+ * root as an XPath expression.
+ *
+ * @param to the Comment the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null.
+ */
+ public static String getPathString(Comment to) throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a given JDOM node to the specified
+ * Comment as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the Comment the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or from is not
+ * a {@link Document} or a {@link Element} node.
+ */
+ public static String getPathString(Object from, Comment to)
+ throws JDOMException {
+ checkPathStringArguments(from, to);
+
+ if (to == from) {
+ return "node()";
+ }
+ Element parent = to.getParentElement();
+ List siblings = null;
+ StringBuilder path = getElementPath(from, parent, false);
+
+ if (parent != null) {
+ siblings = parent.getContent(Filters.comment());
+ }
+ else {
+ Document doc = to.getDocument();
+ if (doc != null) {
+ siblings = doc.getContent(Filters.comment());
+ }
+ }
+ return getPositionPath(to, siblings, "comment()", path).toString();
+ }
+
+ /**
+ * Returns the path to the specified ProcessingInstruction node
+ * from the document root as an XPath expression.
+ *
+ * @param to the ProcessingInstruction node the generated path
+ * shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null.
+ */
+ public static String getPathString(ProcessingInstruction to)
+ throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a given JDOM node to the specified
+ * ProcessingInstruction node as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the ProcessingInstruction node the generated
+ * path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or from is not
+ * a {@link Document} or a {@link Element} node.
+ */
+ public static String getPathString(Object from, ProcessingInstruction to)
+ throws JDOMException {
+ checkPathStringArguments(from, to);
+
+ if (to == from) {
+ return "node()";
+ }
+ Element parent = to.getParentElement();
+ List siblings = null;
+ StringBuilder path = getElementPath(from, parent, false);
+
+ if (parent != null) {
+ siblings = parent.getContent(Filters.processinginstruction());
+ }
+ else {
+ Document doc = to.getDocument();
+ if (doc != null) {
+ siblings = doc.getContent(Filters.processinginstruction());
+ }
+ }
+ return getPositionPath(to, siblings,
+ "processing-instruction()", path).toString();
+ }
+
+ /**
+ * Returns the path to the specified JDOM node from the document
+ * root as an XPath expression.
+ *
+ * @param to the JDOM node the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if to is
+ * null or is not a JDOM node selectable
+ * by XPath expressions (Element, Attribute, Text,
+ * Comment, ProcessingInstruction).
+ */
+ public static String getPathString(Object to) throws JDOMException {
+ return getPathString(null, to);
+ }
+
+ /**
+ * Returns the path from a JDOM node to another JDOM node
+ * as an XPath expression.
+ *
+ * @param from the Document or Element node at which the
+ * the generated path shall be applied. Use
+ * null to specify the topmost
+ * ancestor of the to node.
+ * @param to the JDOM node the generated path shall select.
+ *
+ * @return an XPath expression to select the specified node.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ * @throws IllegalArgumentException if from is not
+ * a {@link Document} or a {@link Element} node or
+ * to is null or is not a JDOM
+ * node selectable by XPath expressions (Element,
+ * Attribute, Text, Comment, ProcessingInstruction).
+ */
+ public static String getPathString(Object from, Object to)
+ throws JDOMException {
+ if (to instanceof Element) {
+ return getPathString(from, (Element) to);
+ }
+ else if (to instanceof Attribute) {
+ return getPathString(from, (Attribute) to);
+ }
+ else if (to instanceof Text) {
+ return getPathString(from, (Text) to);
+ }
+ else if (to instanceof Comment) {
+ return getPathString(from, (Comment) to);
+ }
+ else if (to instanceof ProcessingInstruction) {
+ return getPathString(from, (ProcessingInstruction) to);
+ }
+ else {
+ throw new IllegalArgumentException(
+ "\"to \" shall be an Element, Attribute," +
+ " Text, Comment or ProcessingInstruction node");
+ }
+ }
+
+
+ /**
+ * Checks that the two arguments of a getPathString()
+ * call are valid.
+ *
+ * @param from the from node.
+ * @param to the to node.
+ *
+ * @throws IllegalArgumentException if one of the arguments is
+ * invalid.
+ */
+ private static void checkPathStringArguments(Object from, Object to) {
+ if (!((from == null) || (from instanceof Element)
+ || (from instanceof Document))) {
+ throw new IllegalArgumentException("from");
+ }
+ if (to == null) {
+ throw new IllegalArgumentException("to");
+ }
+ }
+
+ /**
+ * Returns the XPath expression to select the to
+ * element relatively to the from element.
+ *
+ * @param from the from element.
+ * @param to the to element.
+ * @param leaf whether the to is the last element
+ * of the path to return.
+ *
+ * @return an XPath expression to select the to
+ * element.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ */
+ private static StringBuilder getElementPath(Object from,
+ Element to, boolean leaf)
+ throws JDOMException {
+ if (from instanceof Document) {
+ from = null;
+ }
+ return getElementPath((Element) from, to, leaf, new StringBuilder());
+ }
+
+ /**
+ * Returns the XPath expression to select the to
+ * element relatively to the from element.
+ *
+ * @param from the from element.
+ * @param to the to element.
+ * @param leaf whether the to is the last element
+ * of the path to return.
+ * @param path the buffer to which append the path.
+ *
+ * @return an XPath expression to select the to
+ * element.
+ *
+ * @throws JDOMException if the XPath generation failed.
+ */
+ private static StringBuilder getElementPath(Element from, Element to,
+ boolean leaf, StringBuilder path)
+ throws JDOMException {
+ if (to != from) {
+ List siblings = null;
+
+ Element parent = to.getParentElement();
+ if (parent == null) {
+ // Oops! No more parent but I haven't yet reached the from node.
+ if (parent != from) {
+ // Ouch! from node is not an ancestor.
+ throw new JDOMException(
+ "The \"from\" node is not an ancestor of the \"to\" node");
+ }
+ if (to.isRootElement()) {
+ path.append('/');
+ }
+ }
+ else {
+ siblings = parent.getChildren(to.getName(), null);
+ }
+
+ if (parent != from) {
+ path = getElementPath(from, parent, false, path);
+ }
+
+ Namespace ns = to.getNamespace();
+ if (ns == Namespace.NO_NAMESPACE) {
+ // No namespace => Use local name only.
+ path = getPositionPath(to, siblings, to.getName(), path);
+ }
+ else {
+ // Elements belongs to a namespace => Check prefix.
+ String prefix = to.getNamespacePrefix();
+ if ("".equals(prefix)) {
+ // No prefix (default namespace in scope
+ // => Use wildcard & local name combination.
+ path.append("*[local-name()='").
+ append(to.getName()).append("']");
+
+ path = getPositionPath(to, siblings, null, path);
+ }
+ else {
+ // Not the default namespace => Use prefix.
+ path.append(to.getNamespacePrefix()).append(':');
+
+ path = getPositionPath(to, siblings, to.getName(), path);
+ }
+ }
+
+ if ((!leaf) && (path.length() != 0)) {
+ path.append('/');
+ }
+ }
+ return (path);
+ }
+
+ /**
+ * Appends the specified path token to the provided buffer
+ * followed by the position specification of the target node in
+ * its siblings list.
+ *
+ * @param node the target node for the XPath expression.
+ * @param siblings the siblings of the target node.
+ * @param pathToken the path token identifying the target node.
+ * @param buffer the buffer to which appending the XPath
+ * sub-expression or null if the
+ * method shall allocate a new buffer.
+ *
+ * @return the XPath sub-expression to select the target node
+ * among its siblings.
+ */
+ private static StringBuilder getPositionPath(Object node, List siblings,
+ String pathToken,
+ StringBuilder buffer) {
+ if (buffer == null) {
+ buffer = new StringBuilder();
+ }
+ if (pathToken != null) {
+ buffer.append(pathToken);
+ }
+
+ if ((siblings != null) && (siblings.size() != 1)) {
+ int position = 0;
+ for (Iterator i = siblings.iterator(); i.hasNext();) {
+ position++;
+ if (i.next() == node) break;
+ }
+ buffer.append('[').append(position).append(']');
+ }
+ return buffer;
+ }
+}
+
diff --git a/contrib/src/java/org/jdom/contrib/ids/IdAttribute.java b/contrib/src/java/org/jdom/contrib/ids/IdAttribute.java
new file mode 100644
index 0000000..43ccf4e
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/ids/IdAttribute.java
@@ -0,0 +1,159 @@
+/*--
+
+ Copyright (C) 2001-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.ids;
+
+import org.jdom.Attribute;
+import org.jdom.AttributeType;
+import org.jdom.Document;
+import org.jdom.Element;
+import org.jdom.Namespace;
+import org.jdom.Parent;
+
+
+/**
+ * A sub-class of the default JDOM Attribute to help
+ * keeping up-to-date the element lookup table maintained by
+ * IdDocument.
+ *
+ * @author Laurent Bihanic
+ */
+@SuppressWarnings("javadoc")
+public class IdAttribute extends Attribute {
+
+ /**
+ * Default.
+ */
+ private static final long serialVersionUID = 1L;
+
+ public IdAttribute(String name, String value, Namespace namespace) {
+ super(name, value, namespace);
+ }
+
+ public IdAttribute(String name, String value,
+ AttributeType type, Namespace namespace) {
+ super(name, value, type, namespace);
+ }
+
+ public IdAttribute(String name, String value) {
+ this(name, value, UNDECLARED_TYPE, Namespace.NO_NAMESPACE);
+ }
+
+ public IdAttribute(String name, String value, AttributeType type) {
+ this(name, value, type, Namespace.NO_NAMESPACE);
+ }
+
+ @Override
+ protected Attribute setParent(Element parent) {
+ Parent oldParent = this.getParent();
+
+ super.setParent(parent);
+
+ if (this.getAttributeType() == Attribute.ID_TYPE) {
+ Document doc;
+
+ // Udpate the owning document's lookup table.
+ if (oldParent != null) {
+ doc = oldParent.getDocument();
+ if (doc instanceof IdDocument) {
+ ((IdDocument)doc).removeId(this.getValue());
+ }
+ }
+ doc = this.getDocument();
+ if (doc instanceof IdDocument) {
+ ((IdDocument)doc).addId(this.getValue(), this.getParent());
+ }
+ }
+ return this;
+ }
+
+ @Override
+ public Attribute setValue(String value) {
+ String oldValue = this.getValue();
+
+ super.setValue(value);
+
+ if (this.getAttributeType() == Attribute.ID_TYPE) {
+ // Udpate the owning document's lookup table.
+ Document doc = this.getDocument();
+ if (doc instanceof IdDocument) {
+ ((IdDocument)doc).removeId(oldValue);
+ ((IdDocument)doc).addId(this.getValue(), this.getParent());
+ }
+ }
+ return this;
+ }
+
+ @Override
+ public Attribute setAttributeType(AttributeType type) {
+ AttributeType oldType = this.getAttributeType();
+
+ if (type != oldType) {
+ super.setAttributeType(type);
+
+ // Udpate the owning document's lookup table.
+ Document doc = this.getDocument();
+ if (doc instanceof IdDocument) {
+ if (oldType == Attribute.ID_TYPE) {
+ ((IdDocument)doc).removeId(this.getValue());
+ }
+ if (type == Attribute.ID_TYPE) {
+ ((IdDocument)doc).addId(this.getValue(), this.getParent());
+ }
+ }
+ }
+ return this;
+ }
+}
+
diff --git a/contrib/src/java/org/jdom/contrib/ids/IdDocument.java b/contrib/src/java/org/jdom/contrib/ids/IdDocument.java
new file mode 100644
index 0000000..cb5d51e
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/ids/IdDocument.java
@@ -0,0 +1,162 @@
+/*--
+
+ Copyright (C) 2001-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see .
+
+ */
+
+package org.jdom.contrib.ids;
+
+import java.util.*;
+
+import org.jdom.Document;
+import org.jdom.DocType;
+import org.jdom.Element;
+
+
+/**
+ * IdDocument extends the default JDOM document to support looking
+ * up elements using their ID attribute.
+ *
+ * Instances of this class should not be created directly but through
+ * the {@link IdFactory}. Using this factory ensures that the
+ * document is made of {@link IdElement} instances which update the
+ * look-up table when the element attribute list is updated.
+ *
+ * The method {@link #getElementById} allows looking up an element
+ * in the document given the value of its ID attribute. Instead of
+ * scanning the whole document when searching for an element,
+ * IdDocument uses a lookup table for fast direct
+ * access to the elements. Hence, applications using this method
+ * should see their performances improved compared to walking the
+ * document tree.
+ *
+ * @author Laurent Bihanic
+ */
+@SuppressWarnings("javadoc")
+public class IdDocument extends Document {
+
+ /**
+ * Default.
+ */
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * The ID lookup table for the document.
+ */
+ private Map ids = new HashMap();
+
+ /**
+ *
+ * Creates a new IdDocument, with the supplied
+ * {@link Element} as the root element and the
+ * supplied {@link DocType} declaration.
+ *
+ * @param rootElement Element for document root.
+ * @param docType DocType declaration.
+ */
+ public IdDocument(Element root, DocType docType) {
+ super(root, docType);
+ }
+
+ /**
+ *
+ * Creates a new Document, with the supplied
+ * {@link Element} as the root element, and no
+ * {@link DocType document type} declaration.
+ *
+ *
+ * @param rootElement Element for document root.
+ */
+ public IdDocument(Element root) {
+ super(root);
+ }
+
+ /**
+ *
+ * Retrieves an element using the value of its ID attribute as
+ * key.
+ *
+ * @param id the value of the ID attribute of the element to
+ * retrieve.
+ * @return the Element associated to id
+ * or null if none was found.
+ */
+ public Element getElementById(String id) {
+ return ids.get(id);
+ }
+
+ /**
+ *
+ * Adds the specified ID to the ID lookup table of this document
+ * and make it point to the associated element.
+ *
+ * @param id the ID to add.
+ * @param elt the Element associated to the ID.
+ */
+ protected void addId(String id, Element elt) {
+ ids.put(id, elt);
+ return;
+ }
+
+ /**
+ *
+ * Removes the specified ID from the ID lookup table of this
+ * document.
+ *
+ * @param id the ID to remove.
+ * @return true if the ID was found and removed;
+ * false otherwise.
+ */
+ protected boolean removeId(String id) {
+ return (ids.remove(id) != null);
+ }
+}
+
diff --git a/contrib/src/java/org/jdom/contrib/ids/IdElement.java b/contrib/src/java/org/jdom/contrib/ids/IdElement.java
new file mode 100644
index 0000000..99da508
--- /dev/null
+++ b/contrib/src/java/org/jdom/contrib/ids/IdElement.java
@@ -0,0 +1,209 @@
+/*--
+
+ Copyright (C) 2001-2004 Jason Hunter & Brett McLaughlin.
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions, and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions, and the disclaimer that follows
+ these conditions in the documentation and/or other materials
+ provided with the distribution.
+
+ 3. The name "JDOM" must not be used to endorse or promote products
+ derived from this software without prior written permission. For
+ written permission, please contact .
+
+ 4. Products derived from this software may not be called "JDOM", nor
+ may "JDOM" appear in their name, without prior written permission
+ from the JDOM Project Management .
+
+ In addition, we request (but do not require) that you include in the
+ end-user documentation provided with the redistribution and/or in the
+ software itself an acknowledgement equivalent to the following:
+ "This product includes software developed by the
+ JDOM Project (http://www.jdom.org/)."
+ Alternatively, the acknowledgment may be graphical using the logos
+ available at http://www.jdom.org/images/logos.
+
+ THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
+ CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+ This software consists of voluntary contributions made by many
+ individuals on behalf of the JDOM Project and was originally
+ created by Jason Hunter and
+ Brett McLaughlin . For more information
+ on the JDOM Project, please see