You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2017/05/14 10:52:51 UTC
[08/51] [partial] incubator-freemarker git commit: Migrated from Ant
to Gradle, and modularized the project. This is an incomplete migration;
there are some TODO-s in the build scripts, and release related tasks are
still missing. What works: Building th
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeModel.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeModel.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeModel.java
new file mode 100644
index 0000000..37a5c7d
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeModel.java
@@ -0,0 +1,613 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+
+import java.lang.ref.WeakReference;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.WeakHashMap;
+
+import org.apache.freemarker.core.Configuration;
+import org.apache.freemarker.core._UnexpectedTypeErrorExplainerTemplateModel;
+import org.apache.freemarker.core.model.AdapterTemplateModel;
+import org.apache.freemarker.core.model.TemplateBooleanModel;
+import org.apache.freemarker.core.model.TemplateDateModel;
+import org.apache.freemarker.core.model.TemplateHashModel;
+import org.apache.freemarker.core.model.TemplateModel;
+import org.apache.freemarker.core.model.TemplateModelException;
+import org.apache.freemarker.core.model.TemplateNodeModel;
+import org.apache.freemarker.core.model.TemplateNodeModelEx;
+import org.apache.freemarker.core.model.TemplateNumberModel;
+import org.apache.freemarker.core.model.TemplateSequenceModel;
+import org.apache.freemarker.core.model.WrapperTemplateModel;
+import org.apache.freemarker.core.model.impl.DefaultObjectWrapper;
+import org.apache.freemarker.core.model.impl.SimpleScalar;
+import org.slf4j.Logger;
+import org.w3c.dom.Attr;
+import org.w3c.dom.CDATASection;
+import org.w3c.dom.CharacterData;
+import org.w3c.dom.Document;
+import org.w3c.dom.DocumentType;
+import org.w3c.dom.Element;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import org.w3c.dom.ProcessingInstruction;
+import org.w3c.dom.Text;
+
+/**
+ * A base class for wrapping a single W3C DOM_WRAPPER Node as a FreeMarker template model.
+ * <p>
+ * Note that {@link DefaultObjectWrapper} automatically wraps W3C DOM_WRAPPER {@link Node}-s into this, so you may need do that
+ * with this class manually. However, before dropping the {@link Node}-s into the data-model, you certainly want to
+ * apply {@link NodeModel#simplify(Node)} on them.
+ * <p>
+ * This class is not guaranteed to be thread safe, so instances of this shouldn't be used as
+ * {@linkplain Configuration#getSharedVariables() shared variable}.
+ * <p>
+ * To represent a node sequence (such as a query result) of exactly 1 nodes, this class should be used instead of
+ * {@link NodeListModel}, as it adds extra capabilities by utilizing that we have exactly 1 node. If you need to wrap a
+ * node sequence of 0 or multiple nodes, you must use {@link NodeListModel}.
+ */
+abstract public class NodeModel implements TemplateNodeModelEx, TemplateHashModel, TemplateSequenceModel,
+ AdapterTemplateModel, WrapperTemplateModel, _UnexpectedTypeErrorExplainerTemplateModel {
+
+ static private final Logger LOG = DomLog.LOG;
+
+ private static final Object STATIC_LOCK = new Object();
+
+ static private final Map xpathSupportMap = Collections.synchronizedMap(new WeakHashMap());
+
+ static private XPathSupport jaxenXPathSupport;
+
+ static Class xpathSupportClass;
+
+ static {
+ try {
+ useDefaultXPathSupport();
+ } catch (Exception e) {
+ // do nothing
+ }
+ if (xpathSupportClass == null && LOG.isWarnEnabled()) {
+ LOG.warn("No XPath support is available.");
+ }
+ }
+
+ /**
+ * The W3C DOM_WRAPPER Node being wrapped.
+ */
+ final Node node;
+ private TemplateSequenceModel children;
+ private NodeModel parent;
+
+ protected NodeModel(Node node) {
+ this.node = node;
+ }
+
+ /**
+ * @return the underling W3C DOM_WRAPPER Node object that this TemplateNodeModel
+ * is wrapping.
+ */
+ public Node getNode() {
+ return node;
+ }
+
+ @Override
+ public TemplateModel get(String key) throws TemplateModelException {
+ if (key.startsWith("@@")) {
+ if (key.equals(AtAtKey.TEXT.getKey())) {
+ return new SimpleScalar(getText(node));
+ } else if (key.equals(AtAtKey.NAMESPACE.getKey())) {
+ String nsURI = node.getNamespaceURI();
+ return nsURI == null ? null : new SimpleScalar(nsURI);
+ } else if (key.equals(AtAtKey.LOCAL_NAME.getKey())) {
+ String localName = node.getLocalName();
+ if (localName == null) {
+ localName = getNodeName();
+ }
+ return new SimpleScalar(localName);
+ } else if (key.equals(AtAtKey.MARKUP.getKey())) {
+ StringBuilder buf = new StringBuilder();
+ NodeOutputter nu = new NodeOutputter(node);
+ nu.outputContent(node, buf);
+ return new SimpleScalar(buf.toString());
+ } else if (key.equals(AtAtKey.NESTED_MARKUP.getKey())) {
+ StringBuilder buf = new StringBuilder();
+ NodeOutputter nu = new NodeOutputter(node);
+ nu.outputContent(node.getChildNodes(), buf);
+ return new SimpleScalar(buf.toString());
+ } else if (key.equals(AtAtKey.QNAME.getKey())) {
+ String qname = getQualifiedName();
+ return qname != null ? new SimpleScalar(qname) : null;
+ } else {
+ // As @@... would cause exception in the XPath engine, we throw a nicer exception now.
+ if (AtAtKey.containsKey(key)) {
+ throw new TemplateModelException(
+ "\"" + key + "\" is not supported for an XML node of type \"" + getNodeType() + "\".");
+ } else {
+ throw new TemplateModelException("Unsupported @@ key: " + key);
+ }
+ }
+ } else {
+ XPathSupport xps = getXPathSupport();
+ if (xps != null) {
+ return xps.executeQuery(node, key);
+ } else {
+ throw new TemplateModelException(
+ "Can't try to resolve the XML query key, because no XPath support is available. "
+ + "This is either malformed or an XPath expression: " + key);
+ }
+ }
+ }
+
+ @Override
+ public TemplateNodeModel getParentNode() {
+ if (parent == null) {
+ Node parentNode = node.getParentNode();
+ if (parentNode == null) {
+ if (node instanceof Attr) {
+ parentNode = ((Attr) node).getOwnerElement();
+ }
+ }
+ parent = wrap(parentNode);
+ }
+ return parent;
+ }
+
+ @Override
+ public TemplateNodeModelEx getPreviousSibling() throws TemplateModelException {
+ return wrap(node.getPreviousSibling());
+ }
+
+ @Override
+ public TemplateNodeModelEx getNextSibling() throws TemplateModelException {
+ return wrap(node.getNextSibling());
+ }
+
+ @Override
+ public TemplateSequenceModel getChildNodes() {
+ if (children == null) {
+ children = new NodeListModel(node.getChildNodes(), this);
+ }
+ return children;
+ }
+
+ @Override
+ public final String getNodeType() throws TemplateModelException {
+ short nodeType = node.getNodeType();
+ switch (nodeType) {
+ case Node.ATTRIBUTE_NODE : return "attribute";
+ case Node.CDATA_SECTION_NODE : return "text";
+ case Node.COMMENT_NODE : return "comment";
+ case Node.DOCUMENT_FRAGMENT_NODE : return "document_fragment";
+ case Node.DOCUMENT_NODE : return "document";
+ case Node.DOCUMENT_TYPE_NODE : return "document_type";
+ case Node.ELEMENT_NODE : return "element";
+ case Node.ENTITY_NODE : return "entity";
+ case Node.ENTITY_REFERENCE_NODE : return "entity_reference";
+ case Node.NOTATION_NODE : return "notation";
+ case Node.PROCESSING_INSTRUCTION_NODE : return "pi";
+ case Node.TEXT_NODE : return "text";
+ }
+ throw new TemplateModelException("Unknown node type: " + nodeType + ". This should be impossible!");
+ }
+
+ public TemplateModel exec(List args) throws TemplateModelException {
+ if (args.size() != 1) {
+ throw new TemplateModelException("Expecting exactly one arguments");
+ }
+ String query = (String) args.get(0);
+ // Now, we try to behave as if this is an XPath expression
+ XPathSupport xps = getXPathSupport();
+ if (xps == null) {
+ throw new TemplateModelException("No XPath support available");
+ }
+ return xps.executeQuery(node, query);
+ }
+
+ /**
+ * Always returns 1.
+ */
+ @Override
+ public final int size() {
+ return 1;
+ }
+
+ @Override
+ public final TemplateModel get(int i) {
+ return i == 0 ? this : null;
+ }
+
+ @Override
+ public String getNodeNamespace() {
+ int nodeType = node.getNodeType();
+ if (nodeType != Node.ATTRIBUTE_NODE && nodeType != Node.ELEMENT_NODE) {
+ return null;
+ }
+ String result = node.getNamespaceURI();
+ if (result == null && nodeType == Node.ELEMENT_NODE) {
+ result = "";
+ } else if ("".equals(result) && nodeType == Node.ATTRIBUTE_NODE) {
+ result = null;
+ }
+ return result;
+ }
+
+ @Override
+ public final int hashCode() {
+ return node.hashCode();
+ }
+
+ @Override
+ public boolean equals(Object other) {
+ if (other == null) return false;
+ return other.getClass() == getClass()
+ && ((NodeModel) other).node.equals(node);
+ }
+
+ /**
+ * Creates a {@link NodeModel} from a DOM {@link Node}. It's strongly recommended modify the {@link Node} with
+ * {@link #simplify(Node)}, so the DOM will be easier to process in templates.
+ *
+ * @param node
+ * The DOM node to wrap. This is typically an {@link Element} or a {@link Document}, but all kind of node
+ * types are supported. If {@code null}, {@code null} will be returned.
+ */
+ static public NodeModel wrap(Node node) {
+ if (node == null) {
+ return null;
+ }
+ NodeModel result = null;
+ switch (node.getNodeType()) {
+ case Node.DOCUMENT_NODE : result = new DocumentModel((Document) node); break;
+ case Node.ELEMENT_NODE : result = new ElementModel((Element) node); break;
+ case Node.ATTRIBUTE_NODE : result = new AttributeNodeModel((Attr) node); break;
+ case Node.CDATA_SECTION_NODE :
+ case Node.COMMENT_NODE :
+ case Node.TEXT_NODE : result = new CharacterDataNodeModel((org.w3c.dom.CharacterData) node); break;
+ case Node.PROCESSING_INSTRUCTION_NODE : result = new PINodeModel((ProcessingInstruction) node); break;
+ case Node.DOCUMENT_TYPE_NODE : result = new DocumentTypeModel((DocumentType) node); break;
+ default: throw new IllegalArgumentException(
+ "Unsupported node type: " + node.getNodeType() + " ("
+ + node.getClass().getName() + ")");
+ }
+ return result;
+ }
+
+ /**
+ * Recursively removes all comment nodes from the subtree.
+ *
+ * @see #simplify
+ */
+ static public void removeComments(Node parent) {
+ Node child = parent.getFirstChild();
+ while (child != null) {
+ Node nextSibling = child.getNextSibling();
+ if (child.getNodeType() == Node.COMMENT_NODE) {
+ parent.removeChild(child);
+ } else if (child.hasChildNodes()) {
+ removeComments(child);
+ }
+ child = nextSibling;
+ }
+ }
+
+ /**
+ * Recursively removes all processing instruction nodes from the subtree.
+ *
+ * @see #simplify
+ */
+ static public void removePIs(Node parent) {
+ Node child = parent.getFirstChild();
+ while (child != null) {
+ Node nextSibling = child.getNextSibling();
+ if (child.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) {
+ parent.removeChild(child);
+ } else if (child.hasChildNodes()) {
+ removePIs(child);
+ }
+ child = nextSibling;
+ }
+ }
+
+ /**
+ * Merges adjacent text nodes (where CDATA counts as text node too). Operates recursively on the entire subtree.
+ * The merged node will have the type of the first node of the adjacent merged nodes.
+ *
+ * <p>Because XPath assumes that there are no adjacent text nodes in the tree, not doing this can have
+ * undesirable side effects. Xalan queries like {@code text()} will only return the first of a list of matching
+ * adjacent text nodes instead of all of them, while Jaxen will return all of them as intuitively expected.
+ *
+ * @see #simplify
+ */
+ static public void mergeAdjacentText(Node parent) {
+ mergeAdjacentText(parent, new StringBuilder(0));
+ }
+
+ static private void mergeAdjacentText(Node parent, StringBuilder collectorBuf) {
+ Node child = parent.getFirstChild();
+ while (child != null) {
+ Node next = child.getNextSibling();
+ if (child instanceof Text) {
+ boolean atFirstText = true;
+ while (next instanceof Text) { //
+ if (atFirstText) {
+ collectorBuf.setLength(0);
+ collectorBuf.ensureCapacity(child.getNodeValue().length() + next.getNodeValue().length());
+ collectorBuf.append(child.getNodeValue());
+ atFirstText = false;
+ }
+ collectorBuf.append(next.getNodeValue());
+
+ parent.removeChild(next);
+
+ next = child.getNextSibling();
+ }
+ if (!atFirstText && collectorBuf.length() != 0) {
+ ((CharacterData) child).setData(collectorBuf.toString());
+ }
+ } else {
+ mergeAdjacentText(child, collectorBuf);
+ }
+ child = next;
+ }
+ }
+
+ /**
+ * Removes all comments and processing instruction, and unites adjacent text nodes (here CDATA counts as text as
+ * well). This is similar to applying {@link #removeComments(Node)}, {@link #removePIs(Node)}, and finally
+ * {@link #mergeAdjacentText(Node)}, but it does all that somewhat faster.
+ */
+ static public void simplify(Node parent) {
+ simplify(parent, new StringBuilder(0));
+ }
+
+ static private void simplify(Node parent, StringBuilder collectorTextChildBuff) {
+ Node collectorTextChild = null;
+ Node child = parent.getFirstChild();
+ while (child != null) {
+ Node next = child.getNextSibling();
+ if (child.hasChildNodes()) {
+ if (collectorTextChild != null) {
+ // Commit pending text node merge:
+ if (collectorTextChildBuff.length() != 0) {
+ ((CharacterData) collectorTextChild).setData(collectorTextChildBuff.toString());
+ collectorTextChildBuff.setLength(0);
+ }
+ collectorTextChild = null;
+ }
+
+ simplify(child, collectorTextChildBuff);
+ } else {
+ int type = child.getNodeType();
+ if (type == Node.TEXT_NODE || type == Node.CDATA_SECTION_NODE ) {
+ if (collectorTextChild != null) {
+ if (collectorTextChildBuff.length() == 0) {
+ collectorTextChildBuff.ensureCapacity(
+ collectorTextChild.getNodeValue().length() + child.getNodeValue().length());
+ collectorTextChildBuff.append(collectorTextChild.getNodeValue());
+ }
+ collectorTextChildBuff.append(child.getNodeValue());
+ parent.removeChild(child);
+ } else {
+ collectorTextChild = child;
+ collectorTextChildBuff.setLength(0);
+ }
+ } else if (type == Node.COMMENT_NODE) {
+ parent.removeChild(child);
+ } else if (type == Node.PROCESSING_INSTRUCTION_NODE) {
+ parent.removeChild(child);
+ } else if (collectorTextChild != null) {
+ // Commit pending text node merge:
+ if (collectorTextChildBuff.length() != 0) {
+ ((CharacterData) collectorTextChild).setData(collectorTextChildBuff.toString());
+ collectorTextChildBuff.setLength(0);
+ }
+ collectorTextChild = null;
+ }
+ }
+ child = next;
+ }
+
+ if (collectorTextChild != null) {
+ // Commit pending text node merge:
+ if (collectorTextChildBuff.length() != 0) {
+ ((CharacterData) collectorTextChild).setData(collectorTextChildBuff.toString());
+ collectorTextChildBuff.setLength(0);
+ }
+ }
+ }
+
+ NodeModel getDocumentNodeModel() {
+ if (node instanceof Document) {
+ return this;
+ } else {
+ return wrap(node.getOwnerDocument());
+ }
+ }
+
+ /**
+ * Tells the system to use (restore) the default (initial) XPath system used by
+ * this FreeMarker version on this system.
+ */
+ static public void useDefaultXPathSupport() {
+ synchronized (STATIC_LOCK) {
+ xpathSupportClass = null;
+ jaxenXPathSupport = null;
+ try {
+ useXalanXPathSupport();
+ } catch (Exception e) {
+ // ignore
+ }
+ if (xpathSupportClass == null) try {
+ useSunInternalXPathSupport();
+ } catch (Exception e) {
+ // ignore
+ }
+ if (xpathSupportClass == null) try {
+ useJaxenXPathSupport();
+ } catch (Exception e) {
+ // ignore
+ }
+ }
+ }
+
+ /**
+ * Convenience method. Tells the system to use Jaxen for XPath queries.
+ * @throws Exception if the Jaxen classes are not present.
+ */
+ static public void useJaxenXPathSupport() throws Exception {
+ Class.forName("org.jaxen.dom.DOMXPath");
+ Class c = Class.forName("org.apache.freemarker.dom.JaxenXPathSupport");
+ jaxenXPathSupport = (XPathSupport) c.newInstance();
+ synchronized (STATIC_LOCK) {
+ xpathSupportClass = c;
+ }
+ if (LOG.isDebugEnabled()) {
+ LOG.debug("Using Jaxen classes for XPath support");
+ }
+ }
+
+ /**
+ * Convenience method. Tells the system to use Xalan for XPath queries.
+ * @throws Exception if the Xalan XPath classes are not present.
+ */
+ static public void useXalanXPathSupport() throws Exception {
+ Class.forName("org.apache.xpath.XPath");
+ Class c = Class.forName("org.apache.freemarker.dom.XalanXPathSupport");
+ synchronized (STATIC_LOCK) {
+ xpathSupportClass = c;
+ }
+ if (LOG.isDebugEnabled()) {
+ LOG.debug("Using Xalan classes for XPath support");
+ }
+ }
+
+ static public void useSunInternalXPathSupport() throws Exception {
+ Class.forName("com.sun.org.apache.xpath.internal.XPath");
+ Class c = Class.forName("org.apache.freemarker.dom.SunInternalXalanXPathSupport");
+ synchronized (STATIC_LOCK) {
+ xpathSupportClass = c;
+ }
+ if (LOG.isDebugEnabled()) {
+ LOG.debug("Using Sun's internal Xalan classes for XPath support");
+ }
+ }
+
+ /**
+ * Set an alternative implementation of org.apache.freemarker.dom.XPathSupport to use
+ * as the XPath engine.
+ * @param cl the class, or <code>null</code> to disable XPath support.
+ */
+ static public void setXPathSupportClass(Class cl) {
+ if (cl != null && !XPathSupport.class.isAssignableFrom(cl)) {
+ throw new RuntimeException("Class " + cl.getName()
+ + " does not implement org.apache.freemarker.dom.XPathSupport");
+ }
+ synchronized (STATIC_LOCK) {
+ xpathSupportClass = cl;
+ }
+ }
+
+ /**
+ * Get the currently used org.apache.freemarker.dom.XPathSupport used as the XPath engine.
+ * Returns <code>null</code> if XPath support is disabled.
+ */
+ static public Class getXPathSupportClass() {
+ synchronized (STATIC_LOCK) {
+ return xpathSupportClass;
+ }
+ }
+
+ static private String getText(Node node) {
+ String result = "";
+ if (node instanceof Text || node instanceof CDATASection) {
+ result = ((org.w3c.dom.CharacterData) node).getData();
+ } else if (node instanceof Element) {
+ NodeList children = node.getChildNodes();
+ for (int i = 0; i < children.getLength(); i++) {
+ result += getText(children.item(i));
+ }
+ } else if (node instanceof Document) {
+ result = getText(((Document) node).getDocumentElement());
+ }
+ return result;
+ }
+
+ XPathSupport getXPathSupport() {
+ if (jaxenXPathSupport != null) {
+ return jaxenXPathSupport;
+ }
+ XPathSupport xps = null;
+ Document doc = node.getOwnerDocument();
+ if (doc == null) {
+ doc = (Document) node;
+ }
+ synchronized (doc) {
+ WeakReference ref = (WeakReference) xpathSupportMap.get(doc);
+ if (ref != null) {
+ xps = (XPathSupport) ref.get();
+ }
+ if (xps == null) {
+ try {
+ xps = (XPathSupport) xpathSupportClass.newInstance();
+ xpathSupportMap.put(doc, new WeakReference(xps));
+ } catch (Exception e) {
+ LOG.error("Error instantiating xpathSupport class", e);
+ }
+ }
+ }
+ return xps;
+ }
+
+
+ String getQualifiedName() throws TemplateModelException {
+ return getNodeName();
+ }
+
+ @Override
+ public Object getAdaptedObject(Class hint) {
+ return node;
+ }
+
+ @Override
+ public Object getWrappedObject() {
+ return node;
+ }
+
+ @Override
+ public Object[] explainTypeError(Class[] expectedClasses) {
+ for (Class expectedClass : expectedClasses) {
+ if (TemplateDateModel.class.isAssignableFrom(expectedClass)
+ || TemplateNumberModel.class.isAssignableFrom(expectedClass)
+ || TemplateBooleanModel.class.isAssignableFrom(expectedClass)) {
+ return new Object[]{
+ "XML node values are always strings (text), that is, they can't be used as number, "
+ + "date/time/datetime or boolean without explicit conversion (such as "
+ + "someNode?number, someNode?datetime.xs, someNode?date.xs, someNode?time.xs, "
+ + "someNode?boolean).",
+ };
+ }
+ }
+ return null;
+ }
+
+}
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeOutputter.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeOutputter.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeOutputter.java
new file mode 100644
index 0000000..bda38ac
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeOutputter.java
@@ -0,0 +1,258 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import java.util.Iterator;
+import java.util.LinkedHashMap;
+
+import org.apache.freemarker.core.Environment;
+import org.apache.freemarker.core.Template;
+import org.apache.freemarker.core.util.BugException;
+import org.apache.freemarker.core.util._StringUtil;
+import org.w3c.dom.Attr;
+import org.w3c.dom.Document;
+import org.w3c.dom.DocumentType;
+import org.w3c.dom.Element;
+import org.w3c.dom.NamedNodeMap;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+class NodeOutputter {
+
+ private Element contextNode;
+ private Environment env;
+ private String defaultNS;
+ private boolean hasDefaultNS;
+ private boolean explicitDefaultNSPrefix;
+ private LinkedHashMap<String, String> namespacesToPrefixLookup = new LinkedHashMap<>();
+ private String namespaceDecl;
+ int nextGeneratedPrefixNumber = 1;
+
+ NodeOutputter(Node node) {
+ if (node instanceof Element) {
+ setContext((Element) node);
+ } else if (node instanceof Attr) {
+ setContext(((Attr) node).getOwnerElement());
+ } else if (node instanceof Document) {
+ setContext(((Document) node).getDocumentElement());
+ }
+ }
+
+ private void setContext(Element contextNode) {
+ this.contextNode = contextNode;
+ env = Environment.getCurrentEnvironment();
+ defaultNS = env.getDefaultNS();
+ hasDefaultNS = defaultNS != null && defaultNS.length() > 0;
+ namespacesToPrefixLookup.put(null, "");
+ namespacesToPrefixLookup.put("", "");
+ buildPrefixLookup(contextNode);
+ if (!explicitDefaultNSPrefix && hasDefaultNS) {
+ namespacesToPrefixLookup.put(defaultNS, "");
+ }
+ constructNamespaceDecl();
+ }
+
+ private void buildPrefixLookup(Node n) {
+ String nsURI = n.getNamespaceURI();
+ if (nsURI != null && nsURI.length() > 0) {
+ String prefix = env.getPrefixForNamespace(nsURI);
+ if (prefix == null) {
+ prefix = namespacesToPrefixLookup.get(nsURI);
+ if (prefix == null) {
+ // Assign a generated prefix:
+ do {
+ prefix = _StringUtil.toLowerABC(nextGeneratedPrefixNumber++);
+ } while (env.getNamespaceForPrefix(prefix) != null);
+ }
+ }
+ namespacesToPrefixLookup.put(nsURI, prefix);
+ } else if (hasDefaultNS && n.getNodeType() == Node.ELEMENT_NODE) {
+ namespacesToPrefixLookup.put(defaultNS, Template.DEFAULT_NAMESPACE_PREFIX);
+ explicitDefaultNSPrefix = true;
+ } else if (n.getNodeType() == Node.ATTRIBUTE_NODE && hasDefaultNS && defaultNS.equals(nsURI)) {
+ namespacesToPrefixLookup.put(defaultNS, Template.DEFAULT_NAMESPACE_PREFIX);
+ explicitDefaultNSPrefix = true;
+ }
+ NodeList childNodes = n.getChildNodes();
+ for (int i = 0; i < childNodes.getLength(); i++) {
+ buildPrefixLookup(childNodes.item(i));
+ }
+ }
+
+ private void constructNamespaceDecl() {
+ StringBuilder buf = new StringBuilder();
+ if (explicitDefaultNSPrefix) {
+ buf.append(" xmlns=\"");
+ buf.append(defaultNS);
+ buf.append("\"");
+ }
+ for (Iterator<String> it = namespacesToPrefixLookup.keySet().iterator(); it.hasNext(); ) {
+ String nsURI = it.next();
+ if (nsURI == null || nsURI.length() == 0) {
+ continue;
+ }
+ String prefix = namespacesToPrefixLookup.get(nsURI);
+ if (prefix == null) {
+ throw new BugException("No xmlns prefix was associated to URI: " + nsURI);
+ }
+ buf.append(" xmlns");
+ if (prefix.length() > 0) {
+ buf.append(":");
+ buf.append(prefix);
+ }
+ buf.append("=\"");
+ buf.append(nsURI);
+ buf.append("\"");
+ }
+ namespaceDecl = buf.toString();
+ }
+
+ private void outputQualifiedName(Node n, StringBuilder buf) {
+ String nsURI = n.getNamespaceURI();
+ if (nsURI == null || nsURI.length() == 0) {
+ buf.append(n.getNodeName());
+ } else {
+ String prefix = namespacesToPrefixLookup.get(nsURI);
+ if (prefix == null) {
+ //REVISIT!
+ buf.append(n.getNodeName());
+ } else {
+ if (prefix.length() > 0) {
+ buf.append(prefix);
+ buf.append(':');
+ }
+ buf.append(n.getLocalName());
+ }
+ }
+ }
+
+ void outputContent(Node n, StringBuilder buf) {
+ switch(n.getNodeType()) {
+ case Node.ATTRIBUTE_NODE: {
+ if (((Attr) n).getSpecified()) {
+ buf.append(' ');
+ outputQualifiedName(n, buf);
+ buf.append("=\"")
+ .append(_StringUtil.XMLEncQAttr(n.getNodeValue()))
+ .append('"');
+ }
+ break;
+ }
+ case Node.COMMENT_NODE: {
+ buf.append("<!--").append(n.getNodeValue()).append("-->");
+ break;
+ }
+ case Node.DOCUMENT_NODE: {
+ outputContent(n.getChildNodes(), buf);
+ break;
+ }
+ case Node.DOCUMENT_TYPE_NODE: {
+ buf.append("<!DOCTYPE ").append(n.getNodeName());
+ DocumentType dt = (DocumentType) n;
+ if (dt.getPublicId() != null) {
+ buf.append(" PUBLIC \"").append(dt.getPublicId()).append('"');
+ }
+ if (dt.getSystemId() != null) {
+ buf.append(" \"").append(dt.getSystemId()).append('"');
+ }
+ if (dt.getInternalSubset() != null) {
+ buf.append(" [").append(dt.getInternalSubset()).append(']');
+ }
+ buf.append('>');
+ break;
+ }
+ case Node.ELEMENT_NODE: {
+ buf.append('<');
+ outputQualifiedName(n, buf);
+ if (n == contextNode) {
+ buf.append(namespaceDecl);
+ }
+ outputContent(n.getAttributes(), buf);
+ NodeList children = n.getChildNodes();
+ if (children.getLength() == 0) {
+ buf.append(" />");
+ } else {
+ buf.append('>');
+ outputContent(n.getChildNodes(), buf);
+ buf.append("</");
+ outputQualifiedName(n, buf);
+ buf.append('>');
+ }
+ break;
+ }
+ case Node.ENTITY_NODE: {
+ outputContent(n.getChildNodes(), buf);
+ break;
+ }
+ case Node.ENTITY_REFERENCE_NODE: {
+ buf.append('&').append(n.getNodeName()).append(';');
+ break;
+ }
+ case Node.PROCESSING_INSTRUCTION_NODE: {
+ buf.append("<?").append(n.getNodeName()).append(' ').append(n.getNodeValue()).append("?>");
+ break;
+ }
+ /*
+ case Node.CDATA_SECTION_NODE: {
+ buf.append("<![CDATA[").append(n.getNodeValue()).append("]]>");
+ break;
+ }*/
+ case Node.CDATA_SECTION_NODE:
+ case Node.TEXT_NODE: {
+ buf.append(_StringUtil.XMLEncNQG(n.getNodeValue()));
+ break;
+ }
+ }
+ }
+
+ void outputContent(NodeList nodes, StringBuilder buf) {
+ for (int i = 0; i < nodes.getLength(); ++i) {
+ outputContent(nodes.item(i), buf);
+ }
+ }
+
+ void outputContent(NamedNodeMap nodes, StringBuilder buf) {
+ for (int i = 0; i < nodes.getLength(); ++i) {
+ Node n = nodes.item(i);
+ if (n.getNodeType() != Node.ATTRIBUTE_NODE
+ || (!n.getNodeName().startsWith("xmlns:") && !n.getNodeName().equals("xmlns"))) {
+ outputContent(n, buf);
+ }
+ }
+ }
+
+ String getOpeningTag(Element element) {
+ StringBuilder buf = new StringBuilder();
+ buf.append('<');
+ outputQualifiedName(element, buf);
+ buf.append(namespaceDecl);
+ outputContent(element.getAttributes(), buf);
+ buf.append('>');
+ return buf.toString();
+ }
+
+ String getClosingTag(Element element) {
+ StringBuilder buf = new StringBuilder();
+ buf.append("</");
+ outputQualifiedName(element, buf);
+ buf.append('>');
+ return buf.toString();
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeQueryResultItemObjectWrapper.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeQueryResultItemObjectWrapper.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeQueryResultItemObjectWrapper.java
new file mode 100644
index 0000000..e84e977
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/NodeQueryResultItemObjectWrapper.java
@@ -0,0 +1,92 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import org.apache.freemarker.core.Environment;
+import org.apache.freemarker.core.model.ObjectWrapper;
+import org.apache.freemarker.core.model.TemplateBooleanModel;
+import org.apache.freemarker.core.model.TemplateDateModel;
+import org.apache.freemarker.core.model.TemplateModel;
+import org.apache.freemarker.core.model.TemplateModelAdapter;
+import org.apache.freemarker.core.model.TemplateModelException;
+import org.apache.freemarker.core.model.WrappingTemplateModel;
+import org.apache.freemarker.core.model.impl.SimpleDate;
+import org.apache.freemarker.core.model.impl.SimpleNumber;
+import org.apache.freemarker.core.model.impl.SimpleScalar;
+import org.w3c.dom.Node;
+
+/**
+ * Used for wrapping query result items (such as XPath query result items). Because {@link NodeModel} and such aren't
+ * {@link WrappingTemplateModel}-s, we can't use the actual {@link ObjectWrapper} from the {@link Environment}, also,
+ * even if we could, it might not be the right thing to do, because that {@link ObjectWrapper} might not even wrap
+ * {@link Node}-s via {@link NodeModel}.
+ */
+class NodeQueryResultItemObjectWrapper implements ObjectWrapper {
+
+ static final NodeQueryResultItemObjectWrapper INSTANCE = new NodeQueryResultItemObjectWrapper();
+
+ private NodeQueryResultItemObjectWrapper() {
+ //
+ }
+
+ @Override
+ public TemplateModel wrap(Object obj) throws TemplateModelException {
+ if (obj instanceof NodeModel) {
+ return (NodeModel) obj;
+ }
+ if (obj instanceof Node) {
+ return NodeModel.wrap((Node) obj);
+ } else {
+ if (obj == null) {
+ return null;
+ }
+ if (obj instanceof TemplateModel) {
+ return (TemplateModel) obj;
+ }
+ if (obj instanceof TemplateModelAdapter) {
+ return ((TemplateModelAdapter) obj).getTemplateModel();
+ }
+
+ if (obj instanceof String) {
+ return new SimpleScalar((String) obj);
+ }
+ if (obj instanceof Number) {
+ return new SimpleNumber((Number) obj);
+ }
+ if (obj instanceof Boolean) {
+ return obj.equals(Boolean.TRUE) ? TemplateBooleanModel.TRUE : TemplateBooleanModel.FALSE;
+ }
+ if (obj instanceof java.util.Date) {
+ if (obj instanceof java.sql.Date) {
+ return new SimpleDate((java.sql.Date) obj);
+ }
+ if (obj instanceof java.sql.Time) {
+ return new SimpleDate((java.sql.Time) obj);
+ }
+ if (obj instanceof java.sql.Timestamp) {
+ return new SimpleDate((java.sql.Timestamp) obj);
+ }
+ return new SimpleDate((java.util.Date) obj, TemplateDateModel.UNKNOWN);
+ }
+ throw new TemplateModelException("Don't know how to wrap a W3C DOM query result item of this type: "
+ + obj.getClass().getName());
+ }
+ }
+}
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/PINodeModel.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/PINodeModel.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/PINodeModel.java
new file mode 100644
index 0000000..381d4d6
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/PINodeModel.java
@@ -0,0 +1,45 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import org.apache.freemarker.core.model.TemplateScalarModel;
+import org.w3c.dom.ProcessingInstruction;
+
+class PINodeModel extends NodeModel implements TemplateScalarModel {
+
+ public PINodeModel(ProcessingInstruction pi) {
+ super(pi);
+ }
+
+ @Override
+ public String getAsString() {
+ return ((ProcessingInstruction) node).getData();
+ }
+
+ @Override
+ public String getNodeName() {
+ return "@pi$" + ((ProcessingInstruction) node).getTarget();
+ }
+
+ @Override
+ public boolean isEmpty() {
+ return true;
+ }
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/SunInternalXalanXPathSupport.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/SunInternalXalanXPathSupport.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/SunInternalXalanXPathSupport.java
new file mode 100644
index 0000000..991c93f
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/SunInternalXalanXPathSupport.java
@@ -0,0 +1,163 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import java.util.List;
+
+import javax.xml.transform.TransformerException;
+
+import org.apache.freemarker.core.Environment;
+import org.apache.freemarker.core.Template;
+import org.apache.freemarker.core.model.TemplateBooleanModel;
+import org.apache.freemarker.core.model.TemplateModel;
+import org.apache.freemarker.core.model.TemplateModelException;
+import org.apache.freemarker.core.model.impl.SimpleNumber;
+import org.apache.freemarker.core.model.impl.SimpleScalar;
+import org.w3c.dom.Node;
+import org.w3c.dom.traversal.NodeIterator;
+
+import com.sun.org.apache.xml.internal.utils.PrefixResolver;
+import com.sun.org.apache.xpath.internal.XPath;
+import com.sun.org.apache.xpath.internal.XPathContext;
+import com.sun.org.apache.xpath.internal.objects.XBoolean;
+import com.sun.org.apache.xpath.internal.objects.XNodeSet;
+import com.sun.org.apache.xpath.internal.objects.XNull;
+import com.sun.org.apache.xpath.internal.objects.XNumber;
+import com.sun.org.apache.xpath.internal.objects.XObject;
+import com.sun.org.apache.xpath.internal.objects.XString;
+
+/**
+ * This is just the XalanXPathSupport class using the sun internal
+ * package names
+ */
+
+class SunInternalXalanXPathSupport implements XPathSupport {
+
+ private XPathContext xpathContext = new XPathContext();
+
+ private static final String ERRMSG_RECOMMEND_JAXEN
+ = "(Note that there is no such restriction if you "
+ + "configure FreeMarker to use Jaxen instead of Xalan.)";
+
+ private static final String ERRMSG_EMPTY_NODE_SET
+ = "Cannot perform an XPath query against an empty node set." + ERRMSG_RECOMMEND_JAXEN;
+
+ @Override
+ synchronized public TemplateModel executeQuery(Object context, String xpathQuery) throws TemplateModelException {
+ if (!(context instanceof Node)) {
+ if (context != null) {
+ if (isNodeList(context)) {
+ int cnt = ((List) context).size();
+ if (cnt != 0) {
+ throw new TemplateModelException(
+ "Cannot perform an XPath query against a node set of " + cnt
+ + " nodes. Expecting a single node." + ERRMSG_RECOMMEND_JAXEN);
+ } else {
+ throw new TemplateModelException(ERRMSG_EMPTY_NODE_SET);
+ }
+ } else {
+ throw new TemplateModelException(
+ "Cannot perform an XPath query against a " + context.getClass().getName()
+ + ". Expecting a single org.w3c.dom.Node.");
+ }
+ } else {
+ throw new TemplateModelException(ERRMSG_EMPTY_NODE_SET);
+ }
+ }
+ Node node = (Node) context;
+ try {
+ XPath xpath = new XPath(xpathQuery, null, customPrefixResolver, XPath.SELECT, null);
+ int ctxtNode = xpathContext.getDTMHandleFromNode(node);
+ XObject xresult = xpath.execute(xpathContext, ctxtNode, customPrefixResolver);
+ if (xresult instanceof XNodeSet) {
+ NodeListModel result = new NodeListModel(node);
+ result.xpathSupport = this;
+ NodeIterator nodeIterator = xresult.nodeset();
+ Node n;
+ do {
+ n = nodeIterator.nextNode();
+ if (n != null) {
+ result.add(n);
+ }
+ } while (n != null);
+ return result.size() == 1 ? result.get(0) : result;
+ }
+ if (xresult instanceof XBoolean) {
+ return ((XBoolean) xresult).bool() ? TemplateBooleanModel.TRUE : TemplateBooleanModel.FALSE;
+ }
+ if (xresult instanceof XNull) {
+ return null;
+ }
+ if (xresult instanceof XString) {
+ return new SimpleScalar(xresult.toString());
+ }
+ if (xresult instanceof XNumber) {
+ return new SimpleNumber(Double.valueOf(((XNumber) xresult).num()));
+ }
+ throw new TemplateModelException("Cannot deal with type: " + xresult.getClass().getName());
+ } catch (TransformerException te) {
+ throw new TemplateModelException(te);
+ }
+ }
+
+ private static PrefixResolver customPrefixResolver = new PrefixResolver() {
+
+ @Override
+ public String getNamespaceForPrefix(String prefix, Node node) {
+ return getNamespaceForPrefix(prefix);
+ }
+
+ @Override
+ public String getNamespaceForPrefix(String prefix) {
+ if (prefix.equals(Template.DEFAULT_NAMESPACE_PREFIX)) {
+ return Environment.getCurrentEnvironment().getDefaultNS();
+ }
+ return Environment.getCurrentEnvironment().getNamespaceForPrefix(prefix);
+ }
+
+ @Override
+ public String getBaseIdentifier() {
+ return null;
+ }
+
+ @Override
+ public boolean handlesNullPrefixes() {
+ return false;
+ }
+ };
+
+ /**
+ * Used for generating more intelligent error messages.
+ */
+ private static boolean isNodeList(Object context) {
+ if (context instanceof List) {
+ List ls = (List) context;
+ int ln = ls.size();
+ for (int i = 0; i < ln; i++) {
+ if (!(ls.get(i) instanceof Node)) {
+ return false;
+ }
+ }
+ return true;
+ } else {
+ return false;
+ }
+ }
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/XPathSupport.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/XPathSupport.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/XPathSupport.java
new file mode 100644
index 0000000..e94d391
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/XPathSupport.java
@@ -0,0 +1,30 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import org.apache.freemarker.core.model.TemplateModel;
+import org.apache.freemarker.core.model.TemplateModelException;
+
+public interface XPathSupport {
+
+ // [2.4] Add argument to pass down the ObjectWrapper to use
+ TemplateModel executeQuery(Object context, String xpathQuery) throws TemplateModelException;
+
+}
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/XalanXPathSupport.java
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/XalanXPathSupport.java b/freemarker-core/src/main/java/org/apache/freemarker/dom/XalanXPathSupport.java
new file mode 100644
index 0000000..99a4249
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/XalanXPathSupport.java
@@ -0,0 +1,163 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+package org.apache.freemarker.dom;
+
+import java.util.List;
+
+import javax.xml.transform.TransformerException;
+
+import org.apache.freemarker.core.Environment;
+import org.apache.freemarker.core.Template;
+import org.apache.freemarker.core.model.TemplateBooleanModel;
+import org.apache.freemarker.core.model.TemplateModel;
+import org.apache.freemarker.core.model.TemplateModelException;
+import org.apache.freemarker.core.model.impl.SimpleNumber;
+import org.apache.freemarker.core.model.impl.SimpleScalar;
+import org.apache.xml.utils.PrefixResolver;
+import org.apache.xpath.XPath;
+import org.apache.xpath.XPathContext;
+import org.apache.xpath.objects.XBoolean;
+import org.apache.xpath.objects.XNodeSet;
+import org.apache.xpath.objects.XNull;
+import org.apache.xpath.objects.XNumber;
+import org.apache.xpath.objects.XObject;
+import org.apache.xpath.objects.XString;
+import org.w3c.dom.Node;
+import org.w3c.dom.traversal.NodeIterator;
+
+/**
+ * Some glue code that bridges the Xalan XPath stuff (that is built into the JDK 1.4.x)
+ * with FreeMarker TemplateModel semantics
+ */
+
+class XalanXPathSupport implements XPathSupport {
+
+ private XPathContext xpathContext = new XPathContext();
+
+ /* I don't recommend Jaxen...
+ private static final String ERRMSG_RECOMMEND_JAXEN
+ = "(Note that there is no such restriction if you "
+ + "configure FreeMarker to use Jaxen instead of Xalan.)";
+ */
+ private static final String ERRMSG_EMPTY_NODE_SET
+ = "Cannot perform an XPath query against an empty node set."; /* " + ERRMSG_RECOMMEND_JAXEN;*/
+
+ @Override
+ synchronized public TemplateModel executeQuery(Object context, String xpathQuery) throws TemplateModelException {
+ if (!(context instanceof Node)) {
+ if (context != null) {
+ if (isNodeList(context)) {
+ int cnt = ((List) context).size();
+ if (cnt != 0) {
+ throw new TemplateModelException(
+ "Cannot perform an XPath query against a node set of " + cnt
+ + " nodes. Expecting a single node."/* " + ERRMSG_RECOMMEND_JAXEN*/);
+ } else {
+ throw new TemplateModelException(ERRMSG_EMPTY_NODE_SET);
+ }
+ } else {
+ throw new TemplateModelException(
+ "Cannot perform an XPath query against a " + context.getClass().getName()
+ + ". Expecting a single org.w3c.dom.Node.");
+ }
+ } else {
+ throw new TemplateModelException(ERRMSG_EMPTY_NODE_SET);
+ }
+ }
+ Node node = (Node) context;
+ try {
+ XPath xpath = new XPath(xpathQuery, null, customPrefixResolver, XPath.SELECT, null);
+ int ctxtNode = xpathContext.getDTMHandleFromNode(node);
+ XObject xresult = xpath.execute(xpathContext, ctxtNode, customPrefixResolver);
+ if (xresult instanceof XNodeSet) {
+ NodeListModel result = new NodeListModel(node);
+ result.xpathSupport = this;
+ NodeIterator nodeIterator = xresult.nodeset();
+ Node n;
+ do {
+ n = nodeIterator.nextNode();
+ if (n != null) {
+ result.add(n);
+ }
+ } while (n != null);
+ return result.size() == 1 ? result.get(0) : result;
+ }
+ if (xresult instanceof XBoolean) {
+ return ((XBoolean) xresult).bool() ? TemplateBooleanModel.TRUE : TemplateBooleanModel.FALSE;
+ }
+ if (xresult instanceof XNull) {
+ return null;
+ }
+ if (xresult instanceof XString) {
+ return new SimpleScalar(xresult.toString());
+ }
+ if (xresult instanceof XNumber) {
+ return new SimpleNumber(Double.valueOf(((XNumber) xresult).num()));
+ }
+ throw new TemplateModelException("Cannot deal with type: " + xresult.getClass().getName());
+ } catch (TransformerException te) {
+ throw new TemplateModelException(te);
+ }
+ }
+
+ private static PrefixResolver customPrefixResolver = new PrefixResolver() {
+
+ @Override
+ public String getNamespaceForPrefix(String prefix, Node node) {
+ return getNamespaceForPrefix(prefix);
+ }
+
+ @Override
+ public String getNamespaceForPrefix(String prefix) {
+ if (prefix.equals(Template.DEFAULT_NAMESPACE_PREFIX)) {
+ return Environment.getCurrentEnvironment().getDefaultNS();
+ }
+ return Environment.getCurrentEnvironment().getNamespaceForPrefix(prefix);
+ }
+
+ @Override
+ public String getBaseIdentifier() {
+ return null;
+ }
+
+ @Override
+ public boolean handlesNullPrefixes() {
+ return false;
+ }
+ };
+
+ /**
+ * Used for generating more intelligent error messages.
+ */
+ private static boolean isNodeList(Object context) {
+ if (context instanceof List) {
+ List ls = (List) context;
+ int ln = ls.size();
+ for (int i = 0; i < ln; i++) {
+ if (!(ls.get(i) instanceof Node)) {
+ return false;
+ }
+ }
+ return true;
+ } else {
+ return false;
+ }
+ }
+}
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/3fd56062/freemarker-core/src/main/java/org/apache/freemarker/dom/package.html
----------------------------------------------------------------------
diff --git a/freemarker-core/src/main/java/org/apache/freemarker/dom/package.html b/freemarker-core/src/main/java/org/apache/freemarker/dom/package.html
new file mode 100644
index 0000000..61b1737
--- /dev/null
+++ b/freemarker-core/src/main/java/org/apache/freemarker/dom/package.html
@@ -0,0 +1,30 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<html>
+<head>
+<title></title>
+</head>
+<body>
+
+<p>Exposes DOM XML nodes to templates as easily traversable trees;
+see <a href="http://freemarker.org/docs/xgui.html" target="_blank">in the Manual</a>.
+The default object wrapper of FreeMarker can automatically wraps W3C nodes with this.
+
+</body>
+</html>