org.dlese.dpc.xml

Class XPathUtils

java.lang.Object

org.dlese.dpc.xml.XPathUtils

public class XPathUtils
extends java.lang.Object

Utilities for testing and manipulating XPaths, represented as String.

Author:

ostwald

Constructor Summary

Constructors

Constructor and Description
XPathUtils()

Method Summary

Modifier and Type	Method and Description
static int	compare(java.lang.String path1, java.lang.String path2) Compares two xpaths for "xpath order", using "natuiral" or alphabetical ordering except for when xpath indexing is involved, e.g., "/record/general[3]/foo[5]" is "less than" "/record/general[4]/foo[6]".
static java.lang.String	decodeXPath(java.lang.String path) Converts encoded paths of the form used in jsp pages ( "foo_1_") to a XPath form ("foo[1]").
static java.lang.String	encodeXPath(java.lang.String s) Converts indexed paths of the form ("foo[1]") to the form used in jsp pages ( "foo_1_")
static int	getIndex(java.lang.String s) Returns the index, if any, for the leaf of the given path.
static java.lang.String	getLeaf(java.lang.String xpath) Returns the name of the element refered to by the given xpath, which is the leaf, stripped of "\@" in the case of attribute paths).
static java.lang.String	getNodeName(java.lang.String xpath) Returns the name of the node referred to by the (possibly jsp-encoded) xpath, stripped of indexing information.
static java.lang.String	getParentXPath(java.lang.String xpath) Gets the parentXPath attribute of the XPathUtils class
static java.lang.String	getSiblingXPath(java.lang.String xpath) Gets the siblingPath (that matches all like-named nodes of the parent Element) of a given xpath.
static boolean	isAttributePath(java.lang.String xpath) Returns true if the xpath refers to an attribute.
static java.lang.String	normalizeXPath(java.lang.String s) Removes indexing information from XPath strings.
static java.lang.String	removeELbrackets(java.lang.String s) Remove jsp expressionLanauge brackets used to support indexing in jsp pages (i.e., ${...}) from a path.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XPathUtils

public XPathUtils()

Method Detail

decodeXPath

public static java.lang.String decodeXPath(java.lang.String path)

Converts encoded paths of the form used in jsp pages ( "foo_1_") to a XPath form ("foo[1]"). (square brackets cannot be used in xpaths contained in jsp pages)

Parameters:

path - NOT YET DOCUMENTED

Returns:

equivalent XPath

removeELbrackets

public static java.lang.String removeELbrackets(java.lang.String s)

Remove jsp expressionLanauge brackets used to support indexing in jsp pages (i.e., ${...}) from a path.

Parameters:

s - path containing el-encoded brackets

Returns:

NOT YET DOCUMENTED

getIndex

public static int getIndex(java.lang.String s)

Returns the index, if any, for the leaf of the given path.

Works for both encoded indexing (e.g., "asdf_1_") and decoded (e.g., "asasdf[1]".

Parameters:

s - NOT YET DOCUMENTED

Returns:

The index value

encodeXPath

public static java.lang.String encodeXPath(java.lang.String s)

Converts indexed paths of the form ("foo[1]") to the form used in jsp pages ( "foo_1_")

Parameters:

s - indexed xpath

Returns:

equivalent XPath

normalizeXPath

public static java.lang.String normalizeXPath(java.lang.String s)

Removes indexing information from XPath strings.

• before: "/itemRecord/general/foo[1]/@url"
• after: "/itemRecord/general/foo/@url"

Parameters:

s - xpath possibly containing index notation

Returns:

equivalent XPath

getLeaf

public static java.lang.String getLeaf(java.lang.String xpath)

Returns the name of the element refered to by the given xpath, which is the leaf, stripped of "\@" in the case of attribute paths). Accepts jsp-encoded xpaths.

Parameters:

xpath - NOT YET DOCUMENTED

Returns:

The leafName value, with indexing intact

isAttributePath

public static boolean isAttributePath(java.lang.String xpath)

Returns true if the xpath refers to an attribute.

Parameters:

xpath - xpath to be tested

Returns:

The attributePath value

getNodeName

public static java.lang.String getNodeName(java.lang.String xpath)

Returns the name of the node referred to by the (possibly jsp-encoded) xpath, stripped of indexing information.

Parameters:

xpath - NOT YET DOCUMENTED

Returns:

The nodeName, stripped of indexing

getParentXPath

public static java.lang.String getParentXPath(java.lang.String xpath)

Gets the parentXPath attribute of the XPathUtils class

Parameters:

xpath - Description of the Parameter

Returns:

The parentXPath value

getSiblingXPath

public static java.lang.String getSiblingXPath(java.lang.String xpath)

Gets the siblingPath (that matches all like-named nodes of the parent Element) of a given xpath. Removes indexing information only on the terminal element (leaf), NOT on the rest of the path (as (String) does).

Parameters:

xpath - XPath as String

Returns:

The siblingPath value

compare

public static int compare(java.lang.String path1,
                          java.lang.String path2)

Compares two xpaths for "xpath order", using "natuiral" or alphabetical ordering except for when xpath indexing is involved, e.g., "/record/general[3]/foo[5]" is "less than" "/record/general[4]/foo[6]".

NOTE: result of this comparison is not the same "document order", since XML documents are not structured in alpha order!

Parameters:

path1 - first path to be compared

path2 - second path to be compared

Returns:

0 if the two paths are equal, -1 if path1 is "less than" path 2, 1 otherwise