Extensible Markup Language (XML) is a set of rules for encoding documents in machine-readable form. XML is a popular format for sharing data on the internet. Websites that frequently update their content, such as news sites or blogs, often provide an XML feed so that external programs can keep abreast of content changes. Uploading and parsing XML data is a common task for network-connected apps. This lesson explains how to parse XML documents and use their data.
Choose Parser
We recommend XmlPullParser
, which is an efficient and maintainable way to parse XML on Android. Historically Android has had two implementations of this interface:
KXmlParser
viaXmlPullParserFactory.newPullParser()
.ExpatPullParser
, viaXml.newPullParser()
.
Either choice is fine. The example in this section usesExpatPullParser
, via Xml.newPullParser()
.
Analyze
The first step in parsing a film
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | <? xml version = '1.0' encoding = 'UTF-8' standalone = 'yes' ?> < doc > < film title = "Scarface" > < runningTime >163 min.</ runningTime > < country >USA</ country > < director >Brian De Palma</ director > < cast >< name >Al</ name > < surname >Pacino</ surname >< name > Steven</ name > < surname >Bauer</ surname >< name >Michelle</ name >< surname >Pfeiffer</ surname > < name >Mary Elizabeth</ name > < surname >Mastrantonio</ surname > </ cast > </ film > < film title = "Hitman" > < runningTime >96 min.</ runningTime > < country >USA</ country > < director >Aleksander Bach</ director > < cast >< name >Rupert</ name > < surname >Friend</ surname > < name >Zachary</ name > < surname >Quinto</ surname > < name >Hannah</ name > < surname >Ware</ surname > < name >Ciarán</ name > < surname >Hinds</ surname > </ cast > </ film > < film title = "Out of Africa" > < runningTime >160 min.</ runningTime > < country >USA</ country > < director >Sydney Pollack</ director > < cast > < name >Robert</ name > < surname >Redford</ surname > < name >Meryl</ name > < surname >Streep</ surname > < name >Klaus Maria</ name > < surname >Brandauer</ surname > < name >Michael</ name > < surname >Kitchen</ surname > </ cast > </ film > </ doc > |
The readFilm()
method does the actual work of processing the feed. It looks for elements tagged “entry” as a starting point for recursively processing the feed. If a tag isn’t an entry
tag, it skips it. Once the whole feed has been recursively processed, readFilm()
returns a List
containing the entries (including nested data members) it extracted from the feed. This List
is then returned by the parser.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | public void readFilm() { try { InputStream inputStream = new FileInputStream(mFileOutPut); XmlPullParser parser = Xml.newPullParser(); parser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false ); parser.setInput(inputStream, null ); parser.nextTag(); List<Film> filmsList = readDoc(parser); ListAdapter adapter = new ListAdapter(filmsList, this ); mListView.setAdapter(adapter); inputStream.close(); } catch (FileNotFoundException e) { e.printStackTrace(); } catch (XmlPullParserException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } } public List<Film> readDoc(XmlPullParser parser) throws XmlPullParserException, IOException { List<Film> list = new ArrayList<Film>(); parser.require(XmlPullParser.START_TAG, ns, "doc" ); while (parser.next() != XmlPullParser.END_TAG) { list.add(readFilms(parser)); } return list; } // Parses the contents of an film. If it encounters a title, runningTime, country, or director, hands them off // to their respective "read" methods for processing. Otherwise, skips the tag. private Film readFilms(XmlPullParser parser) throws XmlPullParserException, IOException { parser.require(XmlPullParser.START_TAG, ns, "film" ); String title = null ; for ( int x= 0 ; x<parser.getAttributeCount(); x++) { if (parser.getAttributeName(x).equals( "title" )) { title = parser.getAttributeValue(x); } } String runningTime = null ; String country = null ; String director = null ; List<Actor> cast = new ArrayList<Actor>(); while (parser.next() != XmlPullParser.END_TAG) { if (parser.getEventType() != XmlPullParser.START_TAG) { continue ; } String name = parser.getName(); if (name.equals( "runningTime" )) { runningTime = readRunningTime(parser); } else if (name.equals( "country" )) { country = readCountry(parser); } else if (name.equals( "director" )) { director = readDirector(parser); } else if (name.equals( "cast" )) { cast = readCast(parser); } else { skip(parser); } } return new Film( title, runningTime, country, director, cast); } private String readRunningTime(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "runningTime" ); String runningTime = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "runningTime" ); return runningTime; } private String readCountry(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "country" ); String country = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "country" ); return country; } private String readDirector(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "director" ); String director = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "director" ); return director; } private List<Actor> readCast(XmlPullParser parser) throws IOException, XmlPullParserException { List<Actor> listActor= new ArrayList<Actor>(); parser.require(XmlPullParser.START_TAG, ns, "cast" ); String nameActor = null ; String surnameActor = null ; while (parser.next() != XmlPullParser.END_TAG) { if (parser.getEventType() != XmlPullParser.START_TAG) { continue ; } String nameParser = parser.getName(); if (nameParser.equals( "name" )) { nameActor = readNameActor(parser); } else if (nameParser.equals( "surname" )) { surnameActor = readSurnameActor(parser); listActor.add( new Actor(nameActor, surnameActor)); } else { skip(parser); } } return listActor; } private String readNameActor(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "name" ); String nameActor = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "name" ); return nameActor; } private String readSurnameActor(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "surname" ); String surnameActor = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "surname" ); return surnameActor; } // For the tags title and runningTime, country, director their text values. private String readText(XmlPullParser parser) throws IOException, XmlPullParserException { String result = "" ; if (parser.next() == XmlPullParser.TEXT) { result = parser.getText(); parser.nextTag(); } return result; } private void skip(XmlPullParser parser) throws XmlPullParserException, IOException { if (parser.getEventType() != XmlPullParser.START_TAG) { throw new IllegalStateException(); } int depth = 1 ; while (depth != 0 ) { switch (parser.next()) { case XmlPullParser.END_TAG: depth--; break ; case XmlPullParser.START_TAG: depth++; break ; } } } |