XML Parsing in Android using XmlPullParser

23 Feb, 2021
In android, the XMLPullParser interface provides the functionality to parse the XML files in android applications. The XMLPullParser is a simple and efficient parser method to parse the XML data when compared to other parser methods such as DOM Parser and SAX Parser. The XMLPullParser has a method next() that provides access to high-level parsing events. The next() method will advance the parser to the next event. The following are the series of events available in XMLPullParser, which will be seen by the next() method.
START_DOCUMENT: The parser starts processing the XML document.START_TAG: In this event, we can get the start tag in XML.TEXT: In this event, we can read the text content using the getText() method.END_TAG: An end tag was read.END_DOCUMENT: No more events are available.
START_DOCUMENT: The parser starts processing the XML document.
START_TAG: In this event, we can get the start tag in XML.
TEXT: In this event, we can read the text content using the getText() method.
END_TAG: An end tag was read.
END_DOCUMENT: No more events are available.
Note that we are going to implement this project using the Kotlin language. One may also perform XML Parsing in another two ways. Please refer to the below articles:
XML Parsing in Android using DOM Parser
XML Parsing in Android using SAX Parser
XMLPullParser scrutinizes an XML file with a series of events, such as START_DOCUMENT, START_TAG, TEXT, END_TAG, and END_DOCUMENT to parse the XML document. To read and parse XML files using XMLPullParser in android, one needs to create an instance of XMLPullParserFactory, and XMLPullParser.
To parse an XML file using a DOM parser in Android, we follow the following steps:
Step 1: Create a New Project
To create a new project in Android Studio please refer to How to Create/Start a New Project in Android Studio. Note that select Kotlin as the programming language.
Step 2: Create an assets folder
Create an assets folder under the main folder in the Project Layout. Create an Android Resource File in this folder, where we shall put the information in the form of XML. Name this file as userdetails.xml. For doing so refer to the following steps:
Click on Project as shown on the left side of the below image. 
Expand until you find the main folder, right-click on it, go to New > Folder > Assets Folder
Then just click on the Finish button.
Now the asset folder is created successfully. Right-Click on the Assets Folder > New > Android Resource FIle 
Give it name Information, change type to XML, and finish.
Note: Sometimes, right-clicking on the Assets folder and creating an Android Resource File creates a file in the res folder. If this happens, cut our file and paste it directly into the assets folder. This happens due to some internal settings.
Paste this information which is in the form of XML, that is to be displayed in the userdetails.xml file. Below is the code for the userdetails.xml file.
XML
<?xml version="1.0" encoding="utf-8"?><users>    <user>        <name>Tom</name>        <designation>Actor and Producer</designation>    </user>    <user>        <name>Danny</name>        <designation>Music Director</designation>    </user>    <user>        <name>Christopher</name>        <designation>Writer</designation>    </user></users>
Step 3: Working with the activity_main.xml file
Now go to the activity_main.xml file which represents the UI of the application. Create a ListView as shown. Below is the code for the activity_main.xml file.
XML
<?xml version="1.0" encoding="utf-8"?><LinearLayout     xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="fill_parent"    android:orientation="vertical" >      <!--Display the list from list_row file-->    <ListView        android:id="@+id/user_list"        android:layout_width="fill_parent"        android:layout_height="wrap_content"        android:dividerHeight="1dp" />    </LinearLayout>
 Step 4: Create another layout file
Go to app > res > layout > right-click > New > Layout Resource File and name the file as list_row. list_row.xml file is used to show the data in the ListView. Below is the code for the list_row.xml file.
XML
<?xml version="1.0" encoding="utf-8"?><RelativeLayout     xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="fill_parent"    android:layout_height="wrap_content"    android:orientation="horizontal"    android:padding="5dip">      <!--TextView to display the name         from the userdetails file-->    <TextView        android:id="@+id/name"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:textSize="17dp"        android:textStyle="bold" />      <!--TextView to display the designation         from the userdetails file-->    <TextView        android:id="@+id/designation"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_below="@id/name"        android:layout_marginTop="7dp"        android:textColor="#343434"        android:textSize="14dp" />  </RelativeLayout>
Step 5: Working with the MainActivity.kt file
Finally, go to the MainActivity.kt file, and refer to the following code. Below is the code for the MainActivity.kt file. Comments are added inside the code to understand the code in more detail.
Kotlin
import android.os.Bundleimport android.widget.ListAdapterimport android.widget.ListViewimport android.widget.SimpleAdapterimport androidx.appcompat.app.AppCompatActivityimport org.xmlpull.v1.XmlPullParserimport org.xmlpull.v1.XmlPullParserExceptionimport org.xmlpull.v1.XmlPullParserFactoryimport java.io.IOExceptionimport java.util.*  class MainActivity : AppCompatActivity() {    override fun onCreate(savedInstanceState: Bundle?) {        super.onCreate(savedInstanceState)        setContentView(R.layout.activity_main)        try {                          // creating a user list string hash map arraylist            val userList = ArrayList<HashMap<String, String?>>()              // creating a user string hashmap            var user = HashMap<String, String?>()              // declaring the list view from the layout file            val lv = findViewById<ListView>(R.id.user_list)              // input stream the userdetails.xml file            val istream = assets.open("userdetails.xml")              //creating a XmlPull parse Factory instance            val parserFactory = XmlPullParserFactory.newInstance()            val parser = parserFactory.newPullParser()              // setting the namespaces feature to false            parser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false)              // setting the input to the parser            parser.setInput(istream, null)              // working with the input stream            var tag: String? = ""            var text: String? = ""            var event = parser.eventType            while (event != XmlPullParser.END_DOCUMENT) {                tag = parser.name                when (event) {                    XmlPullParser.START_TAG -> if (tag == "user") user = HashMap()                    XmlPullParser.TEXT -> text = parser.text                    XmlPullParser.END_TAG -> when (tag) {                        "name" -> user["name"] = text                        "designation" -> user["designation"] = text                        "user" -> userList.add(user)                    }                }                event = parser.next()            }              // List Adapter to broadcast the information to the list_rows.xml file            val adapter: ListAdapter = SimpleAdapter(this, userList, R.layout.list_row,                arrayOf("name", "designation"), intArrayOf(R.id.name, R.id.designation)            )            lv.adapter = adapter        } catch (e: IOException) {            e.printStackTrace()        } catch (e: XmlPullParserException) {            e.printStackTrace()        }    }}
Android-Misc
Android
Kotlin
Android
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.
How to Add Views Dynamically and Store Data in Arraylist in Android?
Android SDK and it's Components
Flutter - Custom Bottom Navigation Bar
How to Communicate Between Fragments in Android?
Retrofit with Kotlin Coroutine in Android
How to Add Views Dynamically and Store Data in Arraylist in Android?
Android UI Layouts
Kotlin Array
How to Communicate Between Fragments in Android?
Retrofit with Kotlin Coroutine in Android