Class JDOMXPath

  • All Implemented Interfaces:
    Serializable

    @Deprecated
    public class JDOMXPath
    extends XPath
    Deprecated.
    replaced by compiled version.
    A concrete XPath implementation for Jaxen. This class must be public because the main JDOM XPath class needs to access the class, and the constructor. The generic type of the returned values from this XPath instance.
    See Also:
    Serialized Form
    • Constructor Detail

      • JDOMXPath

        public JDOMXPath​(String expr)
                  throws JDOMException
        Deprecated.
        Creates a new XPath wrapper object, compiling the specified XPath expression.
        Parameters:
        expr - the XPath expression to wrap.
        Throws:
        JDOMException - if the XPath expression is invalid.
    • Method Detail

      • selectNodes

        public List<?> selectNodes​(Object context)
                            throws JDOMException
        Deprecated.
        Evaluates the wrapped XPath expression and returns the list of selected items.
        Specified by:
        selectNodes in class XPath
        Parameters:
        context - the node to use as context for evaluating the XPath expression.
        Returns:
        the list of selected items, which may be of types: Element , Attribute, Text, CDATA, Comment , ProcessingInstruction, Boolean, Double, or String.
        Throws:
        JDOMException - if the evaluation of the XPath expression on the specified context failed.
      • selectSingleNode

        public Object selectSingleNode​(Object context)
                                throws JDOMException
        Deprecated.
        Evaluates the wrapped XPath expression and returns the first entry in the list of selected nodes (or atomics).
        Specified by:
        selectSingleNode in class XPath
        Parameters:
        context - the node to use as context for evaluating the XPath expression.
        Returns:
        the first selected item, which may be of types: Element, Attribute, Text, CDATA, Comment, ProcessingInstruction, Boolean, Double, String, or null if no item was selected.
        Throws:
        JDOMException - if the evaluation of the XPath expression on the specified context failed.
      • valueOf

        public String valueOf​(Object context)
                       throws JDOMException
        Deprecated.
        Returns the string value of the first node selected by applying the wrapped XPath expression to the given context.
        Specified by:
        valueOf in class XPath
        Parameters:
        context - the element to use as context for evaluating the XPath expression.
        Returns:
        the string value of the first node selected by applying the wrapped XPath expression to the given context.
        Throws:
        JDOMException - if the XPath expression is invalid or its evaluation on the specified context failed.
      • numberValueOf

        public Number numberValueOf​(Object context)
                             throws JDOMException
        Deprecated.
        Returns the number value of the first item selected by applying the wrapped XPath expression to the given context.
        Specified by:
        numberValueOf in class XPath
        Parameters:
        context - the element to use as context for evaluating the XPath expression.
        Returns:
        the number value of the first item selected by applying the wrapped XPath expression to the given context, null if no node was selected or the special value Double.NaN (Not-a-Number) if the selected value can not be converted into a number value.
        Throws:
        JDOMException - if the XPath expression is invalid or its evaluation on the specified context failed.
      • setVariable

        public void setVariable​(String name,
                                Object value)
                         throws IllegalArgumentException
        Deprecated.
        Defines an XPath variable and sets its value.
        Specified by:
        setVariable in class XPath
        Parameters:
        name - the variable name.
        value - the variable value.
        Throws:
        IllegalArgumentException - if name is not a valid XPath variable name or if the value type is not supported by the underlying implementation
      • addNamespace

        public void addNamespace​(Namespace namespace)
        Deprecated.
        Adds a namespace definition to the list of namespaces known of this XPath expression.

        Note: In XPath, there is no such thing as a 'default namespace'. The empty prefix always resolves to the empty namespace URI.

        Specified by:
        addNamespace in class XPath
        Parameters:
        namespace - the namespace.
      • getXPath

        public String getXPath()
        Deprecated.
        Returns the wrapped XPath expression as a string.
        Specified by:
        getXPath in class XPath
        Returns:
        the wrapped XPath expression as a string.