XML 데이터 파싱

확장성 마크업 언어(XML)는 컴퓨터에서 읽을 수 있는 형식으로 문서를 인코딩하기 위한 일련의 규칙을 모은 것입니다. XML은 인터넷에서 데이터를 공유하는 데 흔히 사용되는 형식입니다.

뉴스 사이트나 블로그와 같이 콘텐츠를 자주 업데이트하는 웹사이트에서는 종종 XML 피드를 제공하여 외부 프로그램이 콘텐츠 변경사항을 잘 파악할 수 있도록 합니다. XML 데이터 업로드 및 파싱은 네트워크에 연결된 앱의 일반적인 작업입니다. 이 주제에서는 XML 문서를 파싱하고 파싱한 데이터를 사용하는 방법을 설명합니다.

Android 앱에서 웹 기반 콘텐츠를 만드는 방법에 관한 자세한 내용은 웹 기반 콘텐츠를 참고하세요.

파서 선택

XmlPullParser를 사용하는 것이 좋습니다. 이 파서를 사용하면 Android에서 효율적이고 유지관리하기 쉬운 방식으로 XML을 파싱할 수 있습니다. Android에는 이 인터페이스의 두 가지 구현이 있습니다.

어느 쪽을 선택하든 괜찮습니다. 이 섹션의 예에서는 Xml.newPullParser()ExpatPullParser를 사용합니다.

피드 분석

피드를 파싱하는 첫 번째 단계는 관심 있는 필드를 결정하는 것입니다. 파서는 관심 필드에 관한 데이터를 추출하고 나머지는 무시합니다.

샘플 앱의 파싱된 피드에서 다음 발췌 부분을 참고하세요. 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)
        }
    }
 ...
}

자바

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
}

자바

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 피드를 파싱하는 단계는 다음과 같습니다.

  1. 피드 분석에 설명한 대로 앱에 포함할 태그를 식별합니다. 이 예에서는 entry 태그와 이 태그의 중첩된 태그인 title, link, summary의 데이터를 추출합니다.
  2. 다음과 같은 메서드를 만듭니다.

    • readEntry()readTitle()과 같은 포함하려는 각 태그의 'read' 메서드. 파서는 입력 스트림에서 태그를 읽습니다. 이름이 지정된 태그(이 예에서는 entry, title, link 또는 summary)를 만나면 해당 태그에 적절한 메서드를 호출합니다. 위에서 언급한 태그가 아니면 태그를 건너뜁니다.
    • 서로 다른 태그의 데이터를 추출하고 파서를 다음 태그로 진행하게 하는 메서드. 이 예에서 관련 메서드는 다음과 같습니다.
      • titlesummary 태그의 경우 파서에서 readText()를 호출합니다. 이 메서드는 parser.getText()를 호출하여 이러한 태그의 데이터를 추출합니다.
      • link 태그의 경우 파서는 먼저 링크가 관심 있는 종류의 링크인지 확인하여 링크의 데이터를 추출합니다. 그런 다음, parser.getAttributeValue()를 사용하여 링크 값을 추출합니다.
      • entry 태그의 경우 파서에서 readEntry()를 호출합니다. 이 메서드는 항목의 중첩된 태그를 파싱하고 데이터 멤버 title, link, summary와 함께 Entry 객체를 반환합니다.
    • 반복적인 skip() 도우미 메서드. 이 항목에 관한 자세한 내용은 관심 없는 태그 건너뛰기를 참고하세요.

이 스니펫은 파서가 항목, 제목, 링크, 요약을 파싱하는 방법을 보여줍니다.

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
}
...

자바

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++
        }
    }
}

자바

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를 포함한 모든 이벤트를 사용합니다.
  • 중첩 깊이를 추적하여 원래 START_TAG 이후에 만나는 첫 번째 태그가 아니라 올바른 END_TAG에서 멈추도록 합니다.

따라서, 현재 요소에 중첩된 요소가 있으면 depth 값은 파서가 원래 START_TAG 및 이 태그에 일치하는 END_TAG 사이의 모든 이벤트를 사용할 때까지 0이 되지 않습니다. 예를 들어, 파서가 <author> 요소(두 개의 중첩된 요소인 <name><uri> 포함)를 건너뛰는 방법을 생각해보세요.

  • 첫 번째로 while 루프를 통과할 때 파서가 <author> 이후 만나는 태그는 <name>START_TAG입니다. depth 값은 2로 증가합니다.
  • 두 번째로 while 루프를 통과할 때 파서가 만나는 태그는 END_TAG </name>입니다. depth 값은 1로 감소합니다.
  • 세 번째로 while 루프를 통과할 때 파서가 만나는 태그는 START_TAG <uri>입니다. depth 값은 2로 증가합니다.
  • 네 번째로 while 루프를 통과할 때 파서가 만나는 태그는 END_TAG </uri>입니다. depth 값은 1로 감소합니다.
  • 다섯 번째로(마지막으로) while 루프를 통과할 때 파서가 만나는 태그는 END_TAG </author>입니다. depth 값은 0으로 감소하여 <author> 요소를 성공적으로 건너뛰었음을 나타냅니다.

XML 데이터 사용

예로 든 애플리케이션은 XML 피드를 비동기식으로 가져와 파싱합니다. 이 작업은 기본 UI 스레드 밖에서 처리됩니다. 처리가 완료되면 앱이 기본 활동(NetworkActivity)에서 UI를 업데이트합니다.

다음 발췌 부분에서 loadPage() 메서드는 다음을 실행합니다.

  • XML 피드의 URL을 포함한 문자열 변수를 초기화합니다.
  • 사용자의 설정과 네트워크 연결에서 허용하는 경우 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) - Kotlin 코루틴을 사용하여 IO 스레드에서 loadXmlFromNetwork() 메서드를 실행합니다. 피드 URL을 매개변수로 전달합니다. loadXmlFromNetwork() 메서드가 피드를 가져와서 처리합니다. 작업이 완료되면 결과 문자열을 다시 전달합니다.
  • withContext(Dispatchers.Main) - Kotlin 코루틴을 사용하여 기본 스레드로 돌아가고 반환된 문자열을 사용하여 UI에 표시합니다.

Java 프로그래밍 언어에서 이 프로세스는 다음과 같습니다.

  • Executor가 백그라운드 스레드에서 loadXmlFromNetwork() 메서드를 실행합니다. 피드 URL을 매개변수로 전달합니다. loadXmlFromNetwork() 메서드가 피드를 가져와서 처리합니다. 작업이 완료되면 결과 문자열을 다시 전달합니다.
  • Handlerpost를 호출하여 기본 스레드로 돌아가고 반환된 문자열을 사용하여 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);
        });
    });
}

downloadXml에서 호출되는 loadXmlFromNetwork() 메서드는 다음 스니펫에 나와 있습니다. 이 메서드는 다음을 실행합니다.

  1. StackOverflowXmlParser를 인스턴스화합니다. 또한, Entry 객체의 List(entries), title, url, summary에 관한 변수를 만들어 XML 피드에서 추출한 이러한 필드의 값을 보관합니다.
  2. downloadUrl()을 호출하여 피드를 가져오고 InputStream으로 반환합니다.
  3. StackOverflowXmlParser를 사용하여 InputStream을 파싱합니다. StackOverflowXmlParser는 피드에서 가져온 데이터로 entriesList를 채웁니다.
  4. entries List를 처리하고 피드 데이터와 HTML 마크업을 결합합니다.
  5. 기본 활동 UI에 표시되는 HTML 문자열을 반환합니다.

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();
}