Android XmlPullParser Move to Next enter(final XmlPullParser pp, final String tagName)

Description

enter

License

Open Source License

Declaration

public static void enter(final XmlPullParser pp, final String tagName)
            throws XmlPullParserException, IOException 

Method Source Code

//package com.java2s;
/*//w ww  .  jav a  2  s. co  m
 * For license please see accompanying LICENSE.txt file (available also at http://www.xmlpull.org/).
 * According to www.xmlpull.org, this code is in the public domain.
 */

import java.io.IOException;
import org.xmlpull.v1.XmlPullParser;
import org.xmlpull.v1.XmlPullParserException;

public class Main {
    public static void enter(final XmlPullParser pp)
            throws XmlPullParserException, IOException {
        skipWhitespace(pp);

        if (pp.getEventType() != XmlPullParser.START_TAG)
            throw new IllegalStateException("expecting start tag to enter");
        if (pp.isEmptyElementTag())
            throw new IllegalStateException("cannot enter empty tag");

        pp.next();
    }

    public static void enter(final XmlPullParser pp, final String tagName)
            throws XmlPullParserException, IOException {
        skipWhitespace(pp);

        pp.require(XmlPullParser.START_TAG, null, tagName);
        enter(pp);
    }

    private static void skipWhitespace(final XmlPullParser pp)
            throws XmlPullParserException, IOException {
        if (pp.getEventType() == XmlPullParser.START_DOCUMENT)
            pp.next();
        if (pp.getEventType() == XmlPullParser.TEXT && pp.isWhitespace())
            pp.next();
    }

    public static void next(final XmlPullParser pp)
            throws XmlPullParserException, IOException {
        skipSubTree(pp);
        pp.next();
    }

    public static void require(final XmlPullParser pp, final String tagName)
            throws XmlPullParserException, IOException {
        skipWhitespace(pp);

        pp.require(XmlPullParser.START_TAG, null, tagName);
    }

    /**
     * Skip sub tree that is currently porser positioned on. <br>
     * NOTE: parser must be on START_TAG and when funtion returns parser will be positioned on corresponding END_TAG
     */
    public static void skipSubTree(final XmlPullParser pp)
            throws XmlPullParserException, IOException {
        pp.require(XmlPullParser.START_TAG, null, null);

        int level = 1;
        while (level > 0) {
            final int eventType = pp.next();
            if (eventType == XmlPullParser.END_TAG)
                --level;
            else if (eventType == XmlPullParser.START_TAG)
                ++level;
        }
    }
}

Related

1. nextString(XmlPullParser parser, String tag)
2. nextText(XmlPullParser pp, String namespace, String name)
3. nextText(XmlPullParser pp, String namespace, String name)
4. safeNext(XmlPullParser parser)
5. enter(final XmlPullParser pp)