Android APIs
public class

XmlPullParserFactory

extends Object
java.lang.Object
   ↳ org.xmlpull.v1.XmlPullParserFactory

Class Overview

This class is used to create implementations of XML Pull Parser defined in XMPULL V1 API.

See Also

Summary

Constants
String PROPERTY_NAME
Fields
protected String classNamesLocation Unused, but we have to keep it because it's public API.
protected HashMap<String, Boolean> features
protected ArrayList parserClasses
protected ArrayList serializerClasses
Protected Constructors
XmlPullParserFactory()
Protected constructor to be called by factory implementations.
Public Methods
boolean getFeature(String name)
Return the current value of the feature with given name.
boolean isNamespaceAware()
Indicates whether or not the factory is configured to produce parsers which are namespace aware (it simply set feature XmlPullParser.FEATURE_PROCESS_NAMESPACES to true or false).
boolean isValidating()
Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.
static XmlPullParserFactory newInstance()
Creates a new instance of a PullParserFactory that can be used to create XML pull parsers.
static XmlPullParserFactory newInstance(String unused, Class unused2)
Creates a factory that always returns instances of of KXmlParser and KXmlSerializer.
XmlPullParser newPullParser()
Creates a new instance of a XML Pull Parser using the currently configured factory features.
XmlSerializer newSerializer()
Creates a new instance of a XML Serializer.
void setFeature(String name, boolean state)
Set the features to be set when XML Pull Parser is created by this factory.
void setNamespaceAware(boolean awareness)
Specifies that the parser produced by this factory will provide support for XML namespaces.
void setValidating(boolean validating)
Specifies that the parser produced by this factory will be validating (it simply set feature XmlPullParser.FEATURE_VALIDATION to true or false).
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String PROPERTY_NAME

Added in API level 1

Constant Value: "org.xmlpull.v1.XmlPullParserFactory"

Fields

protected String classNamesLocation

Added in API level 1

Unused, but we have to keep it because it's public API.

protected HashMap<String, Boolean> features

Added in API level 1

protected ArrayList parserClasses

Added in API level 1

protected ArrayList serializerClasses

Added in API level 1

Protected Constructors

protected XmlPullParserFactory ()

Added in API level 1

Protected constructor to be called by factory implementations.

Public Methods

public boolean getFeature (String name)

Added in API level 1

Return the current value of the feature with given name.

NOTE: factory features are not used for XML Serializer.

Parameters
name The name of feature to be retrieved.
Returns
  • The value of named feature. Unknown features are always returned as false

public boolean isNamespaceAware ()

Added in API level 1

Indicates whether or not the factory is configured to produce parsers which are namespace aware (it simply set feature XmlPullParser.FEATURE_PROCESS_NAMESPACES to true or false).

Returns
  • true if the factory is configured to produce parsers which are namespace aware; false otherwise.

public boolean isValidating ()

Added in API level 1

Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.

Returns
  • true if the factory is configured to produce parsers which validate the XML content during parse; false otherwise.

public static XmlPullParserFactory newInstance ()

Added in API level 1

Creates a new instance of a PullParserFactory that can be used to create XML pull parsers. The factory will always return instances of KXmlParser and KXmlSerializer.

Throws
XmlPullParserException

public static XmlPullParserFactory newInstance (String unused, Class unused2)

Added in API level 1

Creates a factory that always returns instances of of KXmlParser and KXmlSerializer. This does not support factories capable of creating arbitrary parser and serializer implementations. Both arguments to this method are unused.

Throws
XmlPullParserException

public XmlPullParser newPullParser ()

Added in API level 1

Creates a new instance of a XML Pull Parser using the currently configured factory features.

Returns
  • A new instance of a XML Pull Parser.
Throws
XmlPullParserException

public XmlSerializer newSerializer ()

Added in API level 1

Creates a new instance of a XML Serializer.

NOTE: factory features are not used for XML Serializer.

Returns
  • A new instance of a XML Serializer.
Throws
XmlPullParserException if a parser cannot be created which satisfies the requested configuration.

public void setFeature (String name, boolean state)

Added in API level 1

Set the features to be set when XML Pull Parser is created by this factory.

NOTE: factory features are not used for XML Serializer.

Parameters
name string with URI identifying feature
state if true feature will be set; if false will be ignored
Throws
XmlPullParserException

public void setNamespaceAware (boolean awareness)

Added in API level 1

Specifies that the parser produced by this factory will provide support for XML namespaces. By default the value of this is set to false.

Parameters
awareness true if the parser produced by this code will provide support for XML namespaces; false otherwise.

public void setValidating (boolean validating)

Added in API level 1

Specifies that the parser produced by this factory will be validating (it simply set feature XmlPullParser.FEATURE_VALIDATION to true or false). By default the value of this is set to false.

Parameters
validating - if true the parsers created by this factory must be validating.