Package com.google.api.client.xml
Class Xml
- java.lang.Object
-
- com.google.api.client.xml.Xml
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Xml.CustomizeParser
Customizes the behavior of XML parsing.
-
Field Summary
Fields Modifier and Type Field Description static String
MEDIA_TYPE
"application/xml; charset=utf-8"
media type used as a default for XML parsing.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static org.xmlpull.v1.XmlPullParser
createParser()
Returns a new XML pull parser.static org.xmlpull.v1.XmlSerializer
createSerializer()
Returns a new XML serializer.static void
parseElement(org.xmlpull.v1.XmlPullParser parser, Object destination, XmlNamespaceDictionary namespaceDictionary, Xml.CustomizeParser customizeParser)
Parses an XML element using the given XML pull parser into the given destination object.static String
toStringOf(Object element)
Shows a debug string representation of an element data object of key/value pairs.
-
-
-
Field Detail
-
MEDIA_TYPE
public static final String MEDIA_TYPE
"application/xml; charset=utf-8"
media type used as a default for XML parsing.Use
HttpMediaType.equalsIgnoreParameters(com.google.api.client.http.HttpMediaType)
for comparing media types.- Since:
- 1.10
-
-
Method Detail
-
createSerializer
public static org.xmlpull.v1.XmlSerializer createSerializer()
Returns a new XML serializer.- Throws:
IllegalArgumentException
- if encountered anXmlPullParserException
-
createParser
public static org.xmlpull.v1.XmlPullParser createParser() throws org.xmlpull.v1.XmlPullParserException
Returns a new XML pull parser.- Throws:
org.xmlpull.v1.XmlPullParserException
-
toStringOf
public static String toStringOf(Object element)
Shows a debug string representation of an element data object of key/value pairs.It will make up something for the element name and XML namespaces. If those are known, it is better to use
XmlNamespaceDictionary.toStringOf(String, Object)
.- Parameters:
element
- element data object of key/value pairs (GenericXml
,Map
, or any object with public fields)
-
parseElement
public static void parseElement(org.xmlpull.v1.XmlPullParser parser, Object destination, XmlNamespaceDictionary namespaceDictionary, Xml.CustomizeParser customizeParser) throws IOException, org.xmlpull.v1.XmlPullParserException
Parses an XML element using the given XML pull parser into the given destination object.Requires the the current event be
XmlPullParser.START_TAG
(skipping any initialXmlPullParser.START_DOCUMENT
) of the element being parsed. At normal parsing completion, the current event will either beXmlPullParser.END_TAG
of the element being parsed, or theXmlPullParser.START_TAG
of the requestedatom:entry
.- Parameters:
parser
- XML pull parserdestination
- optional destination object to parser into ornull
to ignore XML contentnamespaceDictionary
- XML namespace dictionary to store unknown namespacescustomizeParser
- optional parser customizer ornull
for none- Throws:
IOException
org.xmlpull.v1.XmlPullParserException
-
-