DomUtils (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

The Spring Framework

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.util.xml
Class DomUtils

java.lang.Object
  org.springframework.util.xml.DomUtils

public abstract class DomUtils
extends Object
extends Object

Convenience methods for working with the DOM API, in particular for working with DOM Nodes and DOM Elements.

Since:: 1.2
Author:: Juergen Hoeller, Rob Harrop, Costin Leau
See Also:: Node, Element

Constructor Summary

DomUtils()


Method Summary

static Element getChildElementByTagName(Element ele, String childEleName)
          Utility method that returns the first child element identified by its name.

static List getChildElementsByTagName(Element ele, String childEleName)
          Retrieve all child elements of the given DOM element that match the given element name.

static String getChildElementValueByTagName(Element ele, String childEleName)
          Utility method that returns the first child element value identified by its name.

static String getTextValue(Element valueEle)
          Extract the text value from the given DOM element, ignoring XML comments.

static boolean nodeNameEquals(Node node, String desiredName)
          Namespace-aware equals comparison.

Methods inherited from class java.lang.Object

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

Constructor Summary
`DomUtils()`

Method Summary
`static Element`	`getChildElementByTagName(Element ele, String childEleName)` Utility method that returns the first child element identified by its name.
`static List`	`getChildElementsByTagName(Element ele, String childEleName)` Retrieve all child elements of the given DOM element that match the given element name.
`static String`	`getChildElementValueByTagName(Element ele, String childEleName)` Utility method that returns the first child element value identified by its name.
`static String`	`getTextValue(Element valueEle)` Extract the text value from the given DOM element, ignoring XML comments.
`static boolean`	`nodeNameEquals(Node node, String desiredName)` Namespace-aware equals comparison.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

DomUtils

public DomUtils()

Method Detail

getChildElementsByTagName

public static List getChildElementsByTagName(Element ele,
                                             String childEleName)

Retrieve all child elements of the given DOM element that match the given element name. Only look at the direct child level of the given element; do not go into further depth (in contrast to the DOM API's getElementsByTagName method).

Parameters:: ele - the DOM element to analyze; childEleName - the child element name to look for
Returns:: a List of child org.w3c.dom.Element instances
See Also:: Element, Element.getElementsByTagName(java.lang.String)

getChildElementByTagName

public static Element getChildElementByTagName(Element ele,
                                               String childEleName)

Utility method that returns the first child element identified by its name.

Parameters:: ele - the DOM element to analyze; childEleName - the child element name to look for
Returns:: the org.w3c.dom.Element instance, or null if none found

getChildElementValueByTagName

public static String getChildElementValueByTagName(Element ele,
                                                   String childEleName)

Utility method that returns the first child element value identified by its name.

Parameters:: ele - the DOM element to analyze; childEleName - the child element name to look for
Returns:: the extracted text value, or null if no child element found

nodeNameEquals

public static boolean nodeNameEquals(Node node,
                                     String desiredName)

Namespace-aware equals comparison. Returns true if either Node.getLocalName() or Node.getNodeName() equals desiredName, otherwise returns false.

getTextValue

public static String getTextValue(Element valueEle)

Extract the text value from the given DOM element, ignoring XML comments.

Appends all CharacterData nodes and EntityReference nodes into a single String value, excluding Comment nodes.

See Also:: CharacterData, EntityReference, Comment