Class XmlUtils
java.lang.Object
org.astrogrid.samp.xmlrpc.internal.XmlUtils
Utilities for XML manipulations required by SAMP/XML-RPC.
- Since:
- 26 Aug 2008
- Author:
- Mark Taylor
-
Method Summary
Modifier and TypeMethodDescriptionstatic Element
Returns the single element child of a DOM node.static Element
Returns the single child element of a DOM node, which has a given known name.static Element[]
getChildren
(Node parent) Returns an array of all the Element children of a DOM node.static String
Returns the text content of an element as a string.static Object
parseSampValue
(Element valueEl) Returns the content of a DOM element representing avalue
element of an XML-RPC document.
-
Method Details
-
getChildren
Returns an array of all the Element children of a DOM node.- Parameters:
parent
- parent node- Returns:
- children array
-
getChild
public static Element getChild(Node parent) throws org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException Returns the single element child of a DOM node.- Parameters:
parent
- parent node- Returns:
- sole child element
- Throws:
org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException
- if there is not exactly one child per element
-
getChild
public static Element getChild(Node parent, String tagName) throws org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException Returns the single child element of a DOM node, which has a given known name.- Parameters:
parent
- parent nodetagName
- child node name- Returns:
- sole child element with name
tagName
- Throws:
org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException
- if there is not exactly one child element or if it does not have nametagName
-
getTextContent
public static String getTextContent(Element el) throws org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException Returns the text content of an element as a string.- Parameters:
el
- parent node- Returns:
- text content
- Throws:
org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException
- if content is not just text
-
parseSampValue
public static Object parseSampValue(Element valueEl) throws org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException Returns the content of a DOM element representing avalue
element of an XML-RPC document. Note that some content which would be legal in XML-RPC, but is not legal in SAMP, may result in an exception.- Parameters:
valueEl
- value element- Returns:
- SAMP-friendly object (string, list or map)
- Throws:
org.astrogrid.samp.xmlrpc.internal.XmlRpcFormatException
-