Extensible Markup Language (XML) คือชุดกฎสำหรับการเข้ารหัสเอกสารในรูปแบบที่เครื่องอ่านได้ XML เป็นรูปแบบที่ได้รับความนิยมในการแชร์ข้อมูลบนอินเทอร์เน็ต
เว็บไซต์ที่อัปเดตเนื้อหาบ่อยๆ เช่น เว็บไซต์ข่าวหรือบล็อก มักจะให้ฟีด XML เพื่อให้โปรแกรมภายนอกติดตามการเปลี่ยนแปลงเนื้อหาได้ การอัปโหลดและแยกวิเคราะห์ข้อมูล XML เป็นงานทั่วไปสำหรับแอปที่เชื่อมต่อเครือข่าย หัวข้อนี้อธิบายวิธีแยกวิเคราะห์เอกสาร XML และใช้ข้อมูลของเอกสารดังกล่าว
ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างเนื้อหาบนเว็บในแอป Android ได้ที่เนื้อหาบนเว็บ
เลือกโปรแกรมแยกวิเคราะห์
เราขอแนะนำ XmlPullParser ซึ่งเป็นวิธีที่มีประสิทธิภาพและดูแลรักษาได้ในการแยกวิเคราะห์ XML บน Android Android มีการใช้งานอินเทอร์เฟซนี้ 2 แบบ ได้แก่
KXmlParserโดยใช้XmlPullParserFactory.newPullParser()ExpatPullParserโดยใช้Xml.newPullParser()
คุณเลือกเองได้เลยว่าอยากทำแบบไหน ตัวอย่างในส่วนนี้ใช้ ExpatPullParser และ Xml.newPullParser()
วิเคราะห์ฟีด
ขั้นตอนแรกในการแยกวิเคราะห์ฟีดคือการตัดสินใจเลือกฟิลด์ที่คุณสนใจ โปรแกรมแยกวิเคราะห์จะดึงข้อมูลสำหรับฟิลด์เหล่านั้นและละเว้นส่วนที่เหลือ
ดูข้อความที่ตัดตอนมาต่อไปนี้จากฟีดที่แยกวิเคราะห์ในแอปตัวอย่าง โพสต์แต่ละรายการใน StackOverflow.com จะปรากฏในฟีดเป็นแท็ก entry ที่มีแท็กที่ฝังอยู่หลายแท็ก
<?xml version="1.0" encoding="utf-8"?> <feed xmlns="http://www.w3.org/2005/Atom" xmlns:creativeCommons="http://backend.userland.com/creativeCommonsRssModule" ..."> <title type="text">newest questions tagged android - Stack Overflow</title> ... <entry> ... </entry> <entry> <id>http://stackoverflow.com/q/9439999</id> <re:rank scheme="http://stackoverflow.com">0</re:rank> <title type="text">Where is my data file?</title> <category scheme="http://stackoverflow.com/feeds/tag?tagnames=android&sort=newest/tags" term="android"/> <category scheme="http://stackoverflow.com/feeds/tag?tagnames=android&sort=newest/tags" term="file"/> <author> <name>cliff2310</name> <uri>http://stackoverflow.com/users/1128925</uri> </author> <link rel="alternate" href="http://stackoverflow.com/questions/9439999/where-is-my-data-file" /> <published>2012-02-25T00:30:54Z</published> <updated>2012-02-25T00:30:54Z</updated> <summary type="html"> <p>I have an Application that requires a data file...</p> </summary> </entry> <entry> ... </entry> ... </feed>
แอปตัวอย่างจะดึงข้อมูลสำหรับแท็ก entry และแท็กที่ซ้อนกัน title, link และ summary
สร้างอินสแตนซ์ของโปรแกรมแยกวิเคราะห์
ขั้นตอนถัดไปในการแยกวิเคราะห์ฟีดคือการสร้างอินสแตนซ์โปรแกรมแยกวิเคราะห์และเริ่มกระบวนการแยกวิเคราะห์ ข้อมูลโค้ดนี้จะเริ่มต้นโปรแกรมแยกวิเคราะห์เพื่อไม่ให้ประมวลผลเนมสเปซและใช้ InputStream ที่ระบุเป็นอินพุต โดยจะเริ่มกระบวนการแยกวิเคราะห์ด้วยการเรียกใช้ nextTag() และเรียกใช้เมธอด readFeed() ซึ่งจะดึงข้อมูลและประมวลผลข้อมูลที่แอปสนใจ ดังนี้
Kotlin
// We don't use namespaces. private val ns: String? = null class StackOverflowXmlParser { @Throws(XmlPullParserException::class, IOException::class) fun parse(inputStream: InputStream): List<*> { inputStream.use { inputStream -> val parser: XmlPullParser = Xml.newPullParser() parser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false) parser.setInput(inputStream, null) parser.nextTag() return readFeed(parser) } } ... }
Java
public class StackOverflowXmlParser { // We don't use namespaces. private static final String ns = null; public List parse(InputStream in) throws XmlPullParserException, IOException { try { XmlPullParser parser = Xml.newPullParser(); parser.setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false); parser.setInput(in, null); parser.nextTag(); return readFeed(parser); } finally { in.close(); } } ... }
อ่านฟีด
เมธอด readFeed() จะทำงานจริงในการประมวลผลฟีด โดยจะมองหาองค์ประกอบที่ติดแท็ก "entry" เป็นจุดเริ่มต้นสำหรับการประมวลผลฟีดซ้ำๆ หากแท็กไม่ใช่แท็ก entry ระบบจะข้ามแท็กนั้น เมื่อประมวลผลฟีดทั้งหมดซ้ำแล้ว readFeed() จะแสดงผล List ที่มีรายการ (รวมถึงสมาชิกข้อมูลที่ซ้อนกัน) ที่ดึงมาจากฟีด จากนั้นโปรแกรมแยกวิเคราะห์จะแสดงผล List นี้
Kotlin
@Throws(XmlPullParserException::class, IOException::class) private fun readFeed(parser: XmlPullParser): List<Entry> { val entries = mutableListOf<Entry>() parser.require(XmlPullParser.START_TAG, ns, "feed") while (parser.next() != XmlPullParser.END_TAG) { if (parser.eventType != XmlPullParser.START_TAG) { continue } // Starts by looking for the entry tag. if (parser.name == "entry") { entries.add(readEntry(parser)) } else { skip(parser) } } return entries }
Java
private List readFeed(XmlPullParser parser) throws XmlPullParserException, IOException { List entries = new ArrayList(); parser.require(XmlPullParser.START_TAG, ns, "feed"); while (parser.next() != XmlPullParser.END_TAG) { if (parser.getEventType() != XmlPullParser.START_TAG) { continue; } String name = parser.getName(); // Starts by looking for the entry tag. if (name.equals("entry")) { entries.add(readEntry(parser)); } else { skip(parser); } } return entries; }
แยกวิเคราะห์ XML
ขั้นตอนในการแยกวิเคราะห์ฟีด XML มีดังนี้
- ตามที่อธิบายไว้ในวิเคราะห์ฟีด ให้ระบุแท็กที่ต้องการรวมไว้ในแอป ตัวอย่างนี้จะดึงข้อมูลสำหรับแท็ก
entryและแท็กที่ฝังอยู่ ได้แก่title,linkและsummary - สร้างเมธอดต่อไปนี้
- เมธอด "read" สำหรับแต่ละแท็กที่ต้องการรวม เช่น
readEntry()และreadTitle()โปรแกรมแยกวิเคราะห์จะอ่านแท็กจากสตรีมอินพุต เมื่อพบแท็กที่มีชื่อ เช่นentry,title,linkหรือsummaryในตัวอย่างนี้ ระบบจะเรียกใช้เมธอดที่เหมาะสมสำหรับแท็กนั้น ไม่เช่นนั้น ระบบจะข้ามแท็ก - วิธีการดึงข้อมูลสำหรับแท็กแต่ละประเภทและเพื่อเลื่อนโปรแกรมแยกวิเคราะห์ไปยังแท็กถัดไป ในตัวอย่างนี้ เมธอดที่เกี่ยวข้องมีดังนี้
- สำหรับแท็ก
titleและsummaryโปรแกรมแยกวิเคราะห์จะเรียกใช้readText()เมธอดนี้จะดึงข้อมูลสำหรับแท็กเหล่านี้โดยเรียกใช้parser.getText() - สำหรับแท็ก
linkโปรแกรมแยกวิเคราะห์จะดึงข้อมูลสำหรับลิงก์โดยพิจารณาก่อนว่าลิงก์นั้นเป็นประเภทที่สนใจหรือไม่ จากนั้นจะใช้parser.getAttributeValue()เพื่อดึงค่าของลิงก์ - สำหรับแท็ก
entryโปรแกรมแยกวิเคราะห์จะเรียกใช้readEntry()เมธอดนี้จะแยกวิเคราะห์แท็กที่ฝังของรายการและแสดงผลออบเจ็กต์Entryที่มีสมาชิกข้อมูลtitle,linkและsummary
- สำหรับแท็ก
- เมธอด
skip()ของตัวช่วยที่เกิดซ้ำ ดูการพูดคุยเพิ่มเติมเกี่ยวกับหัวข้อนี้ได้ที่ข้ามแท็กที่คุณไม่สนใจ
- เมธอด "read" สำหรับแต่ละแท็กที่ต้องการรวม เช่น
ข้อมูลโค้ดนี้แสดงวิธีที่โปรแกรมแยกวิเคราะห์แยกวิเคราะห์รายการ ชื่อ ลิงก์ และสรุป
Kotlin
data class Entry(val title: String?, val summary: String?, val link: String?) // Parses the contents of an entry. If it encounters a title, summary, or link tag, hands them off // to their respective "read" methods for processing. Otherwise, skips the tag. @Throws(XmlPullParserException::class, IOException::class) private fun readEntry(parser: XmlPullParser): Entry { parser.require(XmlPullParser.START_TAG, ns, "entry") var title: String? = null var summary: String? = null var link: String? = null while (parser.next() != XmlPullParser.END_TAG) { if (parser.eventType != XmlPullParser.START_TAG) { continue } when (parser.name) { "title" -> title = readTitle(parser) "summary" -> summary = readSummary(parser) "link" -> link = readLink(parser) else -> skip(parser) } } return Entry(title, summary, link) } // Processes title tags in the feed. @Throws(IOException::class, XmlPullParserException::class) private fun readTitle(parser: XmlPullParser): String { parser.require(XmlPullParser.START_TAG, ns, "title") val title = readText(parser) parser.require(XmlPullParser.END_TAG, ns, "title") return title } // Processes link tags in the feed. @Throws(IOException::class, XmlPullParserException::class) private fun readLink(parser: XmlPullParser): String { var link = "" parser.require(XmlPullParser.START_TAG, ns, "link") val tag = parser.name val relType = parser.getAttributeValue(null, "rel") if (tag == "link") { if (relType == "alternate") { link = parser.getAttributeValue(null, "href") parser.nextTag() } } parser.require(XmlPullParser.END_TAG, ns, "link") return link } // Processes summary tags in the feed. @Throws(IOException::class, XmlPullParserException::class) private fun readSummary(parser: XmlPullParser): String { parser.require(XmlPullParser.START_TAG, ns, "summary") val summary = readText(parser) parser.require(XmlPullParser.END_TAG, ns, "summary") return summary } // For the tags title and summary, extracts their text values. @Throws(IOException::class, XmlPullParserException::class) private fun readText(parser: XmlPullParser): String { var result = "" if (parser.next() == XmlPullParser.TEXT) { result = parser.text parser.nextTag() } return result } ...
Java
public static class Entry { public final String title; public final String link; public final String summary; private Entry(String title, String summary, String link) { this.title = title; this.summary = summary; this.link = link; } } // Parses the contents of an entry. If it encounters a title, summary, or link tag, hands them off // to their respective "read" methods for processing. Otherwise, skips the tag. private Entry readEntry(XmlPullParser parser) throws XmlPullParserException, IOException { parser.require(XmlPullParser.START_TAG, ns, "entry"); String title = null; String summary = null; String link = null; while (parser.next() != XmlPullParser.END_TAG) { if (parser.getEventType() != XmlPullParser.START_TAG) { continue; } String name = parser.getName(); if (name.equals("title")) { title = readTitle(parser); } else if (name.equals("summary")) { summary = readSummary(parser); } else if (name.equals("link")) { link = readLink(parser); } else { skip(parser); } } return new Entry(title, summary, link); } // Processes title tags in the feed. private String readTitle(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "title"); String title = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "title"); return title; } // Processes link tags in the feed. private String readLink(XmlPullParser parser) throws IOException, XmlPullParserException { String link = ""; parser.require(XmlPullParser.START_TAG, ns, "link"); String tag = parser.getName(); String relType = parser.getAttributeValue(null, "rel"); if (tag.equals("link")) { if (relType.equals("alternate")){ link = parser.getAttributeValue(null, "href"); parser.nextTag(); } } parser.require(XmlPullParser.END_TAG, ns, "link"); return link; } // Processes summary tags in the feed. private String readSummary(XmlPullParser parser) throws IOException, XmlPullParserException { parser.require(XmlPullParser.START_TAG, ns, "summary"); String summary = readText(parser); parser.require(XmlPullParser.END_TAG, ns, "summary"); return summary; } // For the tags title and summary, extracts 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; } ... }
ข้ามแท็กที่ไม่สนใจ
โปรแกรมแยกวิเคราะห์ต้องข้ามแท็กที่ไม่สนใจ เมธอด skip() ของโปรแกรมแยกวิเคราะห์มีดังนี้
Kotlin
@Throws(XmlPullParserException::class, IOException::class) private fun skip(parser: XmlPullParser) { if (parser.eventType != XmlPullParser.START_TAG) { throw IllegalStateException() } var depth = 1 while (depth != 0) { when (parser.next()) { XmlPullParser.END_TAG -> depth-- XmlPullParser.START_TAG -> depth++ } } }
Java
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; } } }
โดยมีวิธีการดังนี้
- ระบบจะแสดงข้อยกเว้นหากเหตุการณ์ปัจจุบันไม่ใช่
START_TAG - โดยจะใช้
START_TAGและเหตุการณ์ทั้งหมดจนถึงและรวมถึงEND_TAGที่ตรงกัน - โดยจะติดตามความลึกของการฝังเพื่อให้แน่ใจว่าหยุดที่
END_TAGที่ถูกต้อง ไม่ใช่ที่แท็กแรกที่พบหลังจากSTART_TAGเดิม
ดังนั้น หากองค์ประกอบปัจจุบันมีองค์ประกอบที่ฝังอยู่ ค่าของ depth จะไม่เป็น 0 จนกว่าโปรแกรมแยกวิเคราะห์จะใช้เหตุการณ์ทั้งหมดระหว่าง START_TAG เดิมกับ END_TAG ที่ตรงกัน ตัวอย่างเช่น ลองพิจารณาวิธีที่โปรแกรมแยกวิเคราะห์ข้ามองค์ประกอบ <author> ซึ่งมีองค์ประกอบที่ฝังอยู่ 2 รายการ ได้แก่ <name> และ <uri>
- ครั้งแรกที่ผ่านลูป
whileแท็กถัดไปที่โปรแกรมแยกวิเคราะห์พบหลังจาก<author>คือSTART_TAGสำหรับ<name>ค่าของdepthจะเพิ่มขึ้นเป็น 2 - ครั้งที่ 2 ที่ผ่านลูป
whileแท็กถัดไปที่โปรแกรมแยกวิเคราะห์พบคือEND_TAG</name>ค่าของdepthจะลดลงเป็น 1 - ครั้งที่ 3 ที่ผ่านลูป
whileแท็กถัดไปที่โปรแกรมแยกวิเคราะห์พบคือSTART_TAG<uri>ค่าของdepthจะเพิ่มเป็น 2 - ครั้งที่ 4 ที่ผ่านลูป
whileแท็กถัดไปที่โปรแกรมแยกวิเคราะห์พบคือEND_TAG</uri>ค่าของdepthจะลดลงเป็น 1 - ครั้งที่ 5 และครั้งสุดท้ายผ่านลูป
whileแท็กถัดไปที่โปรแกรมแยกวิเคราะห์พบคือEND_TAG</author>ค่าของdepthจะลดลงเป็น 0 ซึ่งบ่งบอกว่าข้ามองค์ประกอบ<author>เรียบร้อยแล้ว
ใช้ข้อมูล XML
แอปพลิเคชันตัวอย่างจะดึงข้อมูลและแยกวิเคราะห์ฟีด XML แบบอะซิงโครนัส ซึ่งจะช่วยลดการประมวลผลในเธรด UI หลัก เมื่อประมวลผลเสร็จแล้ว แอปจะอัปเดต UI ในกิจกรรมหลัก NetworkActivity
ในข้อความที่ตัดตอนมาต่อไปนี้ เมธอด loadPage() จะทำสิ่งต่อไปนี้
- เริ่มต้นตัวแปรสตริงด้วย URL สำหรับฟีด XML
- เรียกใช้เมธอด
downloadXml(url)หากการตั้งค่าของผู้ใช้และการเชื่อมต่อเครือข่ายอนุญาต เมธอดนี้จะดาวน์โหลดและแยกวิเคราะห์ฟีด แล้วแสดงผลลัพธ์สตริงที่จะแสดงใน UI
Kotlin
class NetworkActivity : Activity() { companion object { const val WIFI = "Wi-Fi" const val ANY = "Any" const val SO_URL = "http://stackoverflow.com/feeds/tag?tagnames=android&sort=newest" // Whether there is a Wi-Fi connection. private var wifiConnected = false // Whether there is a mobile connection. private var mobileConnected = false // Whether the display should be refreshed. var refreshDisplay = true // The user's current network preference setting. var sPref: String? = null } ... // Asynchronously downloads the XML feed from stackoverflow.com. fun loadPage() { if (sPref.equals(ANY) && (wifiConnected || mobileConnected)) { downloadXml(SO_URL) } else if (sPref.equals(WIFI) && wifiConnected) { downloadXml(SO_URL) } else { // Show error. } } ... }
Java
public class NetworkActivity extends Activity { public static final String WIFI = "Wi-Fi"; public static final String ANY = "Any"; private static final String URL = "http://stackoverflow.com/feeds/tag?tagnames=android&sort=newest"; // Whether there is a Wi-Fi connection. private static boolean wifiConnected = false; // Whether there is a mobile connection. private static boolean mobileConnected = false; // Whether the display should be refreshed. public static boolean refreshDisplay = true; public static String sPref = null; ... // Asynchronously downloads the XML feed from stackoverflow.com. public void loadPage() { if((sPref.equals(ANY)) && (wifiConnected || mobileConnected)) { downloadXml(URL); } else if ((sPref.equals(WIFI)) && (wifiConnected)) { downloadXml(URL); } else { // Show error. } }
เมธอด downloadXml จะเรียกใช้เมธอดต่อไปนี้ใน Kotlin
lifecycleScope.launch(Dispatchers.IO)ซึ่งใช้ coroutine ของ Kotlin เพื่อเปิดเมธอดloadXmlFromNetwork()ในเทรด IO โดยจะส่ง URL ของฟีดเป็นพารามิเตอร์ เมธอดloadXmlFromNetwork()จะดึงข้อมูลและประมวลผลฟีด เมื่อเสร็จแล้ว ระบบจะส่งสตริงผลลัพธ์กลับมาwithContext(Dispatchers.Main)ซึ่งใช้โครูทีน Kotlin เพื่อกลับไปยังเธรดหลัก จะรับสตริงที่แสดงผลและแสดงใน UI
ในภาษาโปรแกรม Java กระบวนการมีดังนี้
Executorจะเรียกใช้เมธอดloadXmlFromNetwork()ในเทรดเบื้องหลัง โดยจะส่ง URL ของฟีดเป็นพารามิเตอร์ เมธอดloadXmlFromNetwork()จะดึงข้อมูลและประมวลผลฟีด เมื่อเสร็จแล้ว ระบบจะส่งสตริงผลลัพธ์กลับมาHandlerเรียกpostเพื่อกลับไปยังชุดข้อความหลัก รับสตริงที่แสดงผล และแสดงสตริงนั้นใน UI
Kotlin
// Implementation of Kotlin coroutines used to download XML feed from stackoverflow.com. private fun downloadXml(vararg urls: String) { var result: String? = null lifecycleScope.launch(Dispatchers.IO) { result = try { loadXmlFromNetwork(urls[0]) } catch (e: IOException) { resources.getString(R.string.connection_error) } catch (e: XmlPullParserException) { resources.getString(R.string.xml_error) } withContext(Dispatchers.Main) { setContentView(R.layout.main) // Displays the HTML string in the UI via a WebView. findViewById<WebView>(R.id.webview)?.apply { loadData(result?: "", "text/html", null) } } } }
Java
// Implementation of Executor and Handler used to download XML feed asynchronously from stackoverflow.com. private void downloadXml(String... urls) { ExecutorService executor = Executors.newSingleThreadExecutor(); Handler handler = new Handler(Looper.getMainLooper()); executor.execute(() -> { String result; try { result = loadXmlFromNetwork(urls[0]); } catch (IOException e) { result = getResources().getString(R.string.connection_error); } catch (XmlPullParserException e) { result = getResources().getString(R.string.xml_error); } String finalResult = result; handler.post(() -> { setContentView(R.layout.main); // Displays the HTML string in the UI via a WebView. WebView myWebView = (WebView) findViewById(R.id.webview); myWebView.loadData(finalResult, "text/html", null); }); }); }
เมธอด loadXmlFromNetwork() ที่เรียกใช้จาก downloadXml จะแสดงในข้อมูลโค้ดถัดไป โดยจะดำเนินการดังนี้
- สร้างอินสแตนซ์
StackOverflowXmlParserนอกจากนี้ยังสร้างตัวแปรสำหรับListของออบเจ็กต์Entry(entries) และสำหรับtitle,urlและsummaryเพื่อเก็บค่าที่ดึงมาจากฟีด XML สำหรับช่องเหล่านั้น - เรียก
downloadUrl()ซึ่งจะดึงข้อมูลฟีดและแสดงผลเป็นInputStream - ใช้
StackOverflowXmlParserเพื่อแยกวิเคราะห์InputStreamStackOverflowXmlParserจะสร้างListของentriesด้วยข้อมูลจากฟีด - ประมวลผล
entriesListและรวมข้อมูลฟีดเข้ากับมาร์กอัป HTML - แสดงผลสตริง HTML ที่แสดงใน UI ของกิจกรรมหลัก
Kotlin
// Uploads XML from stackoverflow.com, parses it, and combines it with // HTML markup. Returns HTML string. @Throws(XmlPullParserException::class, IOException::class) private fun loadXmlFromNetwork(urlString: String): String { // Checks whether the user set the preference to include summary text. val pref: Boolean = PreferenceManager.getDefaultSharedPreferences(this)?.run { getBoolean("summaryPref", false) } ?: false val entries: List<Entry> = downloadUrl(urlString)?.use { stream -> // Instantiates the parser. StackOverflowXmlParser().parse(stream) } ?: emptyList() return StringBuilder().apply { append("<h3>${resources.getString(R.string.page_title)}</h3>") append("<em>${resources.getString(R.string.updated)} ") append("${formatter.format(rightNow.time)}</em>") // StackOverflowXmlParser returns a List (called "entries") of Entry objects. // Each Entry object represents a single post in the XML feed. // This section processes the entries list to combine each entry with HTML markup. // Each entry is displayed in the UI as a link that optionally includes // a text summary. entries.forEach { entry -> append("<p><a href='") append(entry.link) append("'>" + entry.title + "</a></p>") // If the user set the preference to include summary text, // adds it to the display. if (pref) { append(entry.summary) } } }.toString() } // Given a string representation of a URL, sets up a connection and gets // an input stream. @Throws(IOException::class) private fun downloadUrl(urlString: String): InputStream? { val url = URL(urlString) return (url.openConnection() as? HttpURLConnection)?.run { readTimeout = 10000 connectTimeout = 15000 requestMethod = "GET" doInput = true // Starts the query. connect() inputStream } }
Java
// Uploads XML from stackoverflow.com, parses it, and combines it with // HTML markup. Returns HTML string. private String loadXmlFromNetwork(String urlString) throws XmlPullParserException, IOException { InputStream stream = null; // Instantiates the parser. StackOverflowXmlParser stackOverflowXmlParser = new StackOverflowXmlParser(); List<Entry> entries = null; String title = null; String url = null; String summary = null; Calendar rightNow = Calendar.getInstance(); DateFormat formatter = new SimpleDateFormat("MMM dd h:mmaa"); // Checks whether the user set the preference to include summary text. SharedPreferences sharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); boolean pref = sharedPrefs.getBoolean("summaryPref", false); StringBuilder htmlString = new StringBuilder(); htmlString.append("<h3>" + getResources().getString(R.string.page_title) + "</h3>"); htmlString.append("<em>" + getResources().getString(R.string.updated) + " " + formatter.format(rightNow.getTime()) + "</em>"); try { stream = downloadUrl(urlString); entries = stackOverflowXmlParser.parse(stream); // Makes sure that the InputStream is closed after the app is // finished using it. } finally { if (stream != null) { stream.close(); } } // StackOverflowXmlParser returns a List (called "entries") of Entry objects. // Each Entry object represents a single post in the XML feed. // This section processes the entries list to combine each entry with HTML markup. // Each entry is displayed in the UI as a link that optionally includes // a text summary. for (Entry entry : entries) { htmlString.append("<p><a href='"); htmlString.append(entry.link); htmlString.append("'>" + entry.title + "</a></p>"); // If the user set the preference to include summary text, // adds it to the display. if (pref) { htmlString.append(entry.summary); } } return htmlString.toString(); } // Given a string representation of a URL, sets up a connection and gets // an input stream. private InputStream downloadUrl(String urlString) throws IOException { URL url = new URL(urlString); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setReadTimeout(10000 /* milliseconds */); conn.setConnectTimeout(15000 /* milliseconds */); conn.setRequestMethod("GET"); conn.setDoInput(true); // Starts the query. conn.connect(); return conn.getInputStream(); }