IXmlPullParser 接口

定义

[Android.Runtime.Register("org/xmlpull/v1/XmlPullParser", "", "Org.XmlPull.V1.IXmlPullParserInvoker")]
public interface IXmlPullParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/xmlpull/v1/XmlPullParser", "", "Org.XmlPull.V1.IXmlPullParserInvoker")>]
type IXmlPullParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

派生

Android.Content.Res.IXmlResourceParser

Android.Runtime.XmlReaderPullParser

Android.Runtime.XmlReaderResourceParser

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable IDisposable

注解

XML 拉取分析器是一个接口，用于定义 XMLPULL V1 API 中提供的分析功能（请访问此网站了解有关 API 及其实现的详细信息）。

根据以下不同类型的分析程序，在 XML 1.0 规范中将FEATURE_PROCESS_DOCDECL设置为 true li b 验证 xml 1.0 FEATURE_VALIDATION 规范中定义的功能：<ul><li><b>非验证</b>> 分析器（这意味着FEATURE_PROCESS_DOCDECL为 true<><><）li><如果FEATURE_PROCESS_DOCDECL为 false（这是默认值，如果在启动分析之前必须更改不同的值），则分析程序的行为类似于 XML 1.0 兼容的不符合验证分析程序的条件<>，即 XML 文档中没有 DOCDECL 存在</em>（仍可使用 defineEntityReplacementText（内部 entites 仍可使用 defineEntityReplacementText（）定义）。 此操作模式适用于<>在受约束的环境</b>（如 J2ME）中执行的操作。 </ul>

有两个关键方法：next（） 和 nextToken（）。 虽然 next（） 提供对高级分析事件的访问权限，但 nextToken（） 允许访问较低级别的令牌。

分析程序当前的事件状态可以通过调用 getEventType（） 方法来确定。 最初，分析器处于START_DOCUMENT状态。

next（） 方法将分析器推进到下一个事件。 从下一步返回的 int 值确定当前分析程序状态，与从以下调用 getEventType 返回的值相同。

以下事件类型由 next（）<dl<>dt>START_TAG<dd> An XML start tag 读取。 <已读取 dt>TEXT<dd> Text 内容;可以使用 getText（） 方法检索文本内容。 （在验证模式 next（） 不会报告可忽略的空格时，请改<用 nextToken（）dt>END_TAG dd> 已读取<结束标记 dt>END_DOCUMENT<dd> 没有更多事件可用 </dl<>

在第一个 next（） 或 nextToken（） （或任何其他 next*（） 方法调用后，用户应用程序可以通过以下方式从 XML 声明获取 XML 版本、独立和编码：<ul><li><b>version</b>： getProperty（”http://xmlpull.org/v1/doc/properties.html#xmldecl-version“）如果 XMLDecl 未读取或属性不受 li><b>独立</b> 支持<，则返回 String （“1.0”） 或 null：getProperty（”http://xmlpull.org/v1/doc/properties.html#xmldecl-standalone“）返回布尔值：如果没有独立声明，或者如果不支持属性，则当 standalone=“yes” 和 Boolean（false） 时返回 boolean;如果 standalone=“<><<>>yes” 和 Boolean（false） 时返回 null：如果 stream 具有未知编码（未在 setInputStream 中设置），则为 null;如果未在 XMLDecl </ul 中声明>

使用此 API 的最小示例如下所示：

import java.io.IOException;
            import java.io.StringReader;

            import org.xmlpull.v1.XmlPullParser;
            import org.xmlpull.v1.<a href="XmlPullParserException.html">XmlPullParserException</a>;
            import org.xmlpull.v1.<a href="XmlPullParserFactory.html">XmlPullParserFactory</a>;

            public class SimpleXmlPullApp
            {

                public static void main (String args[])
                    throws XmlPullParserException, IOException
                {
                    XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
                    factory.setNamespaceAware(true);
                    XmlPullParser xpp = factory.newPullParser();

                    xpp.<a href="#setInput">setInput</a>( new StringReader ( "&lt;foo>Hello World!&lt;/foo>" ) );
                    int eventType = xpp.getEventType();
                    while (eventType != XmlPullParser.END_DOCUMENT) {
                     if(eventType == XmlPullParser.START_DOCUMENT) {
                         System.out.println("Start document");
                     } else if(eventType == XmlPullParser.START_TAG) {
                         System.out.println("Start tag "+xpp.<a href="#getName()">getName()</a>);
                     } else if(eventType == XmlPullParser.END_TAG) {
                         System.out.println("End tag "+xpp.getName());
                     } else if(eventType == XmlPullParser.TEXT) {
                         System.out.println("Text "+xpp.<a href="#getText()">getText()</a>);
                     }
                     eventType = xpp.next();
                    }
                    System.out.println("End document");
                }
            }

上面的示例将生成以下输出：

Start document
            Start tag foo
            Text Hello World!
            End tag foo
            End document

有关 API 使用情况的更多详细信息，请参阅 处提供的快速简介 http://www.xmlpull.org

Java文档org.xmlpull.v1.XmlPullParser。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。