Kotlin网络编程(5)访问互联网资源

URL 的概念

HTTP/HTTPS 协议

使用 URL 类

使用 HttpURLConnection 发送 GET 请求

使用 HttpURLConnection 发送 POST 请求

实例：Downloader 下载程序

一、URL 的概念

互联网资源是通过 URL 指定的，URL 是 Uniform Resource Locator 的简称，翻译过来是 “一致资源定位器” ，但人们都习惯 URL 这个简称。

URL 组成格式如下：

协议名://资源名

如：

二、HTTP/HTTPS 协议

互联网访问大多都是基于 HTTP/HTTPS 协议。

1、HTTP 协议

HTTP 是 Hypertext Transfer Protocol 的缩写，即超文本传输协议。HTTP 是一个属于应用层的面向对象的协议，其简捷、快速的方式适用于分布式超文本信息的传输。HTTP 协议支持 C/S 网络结构，是无连接协议，即每一次请求时建立连接，服务器处理完客户端的请求后，应答给客户端然后断开连接，不会一直占用网络资源。

HTTP/1.1 协议共定义了 8 种请求函数：OPTIONS、HEAD、GET、POST、PUT、DELETE、TRACE 和 CONNECT。在 HTTP 访问中，一般使用 GET 和 POST 函数。

GET 函数。向指定的资源发出请求，发送的信息 “显示” 的跟在 URL 后面。GET 函数应该只用在读取数据，例如静态图片等。GET 函数优点像使用明信片给别人写信，“信内容” 写在外面，接触到的人都可以看到，因此是不安全的。
POST 函数。向指定的资源提交数据，请求服务器进行处理，例如提交表单或者上传文件等。数据被包含在请求体中。POST 函数像是把 “信内容” 装入信封中，接触到的人都看不到，因此是安全的。

2、HTTPS 协议

HTTPS 是 Hypertext Transfer Protocol Secure 的缩写，即超文本传输安全协议，是超文本传输协议和 SSL 的组合，用以提供加密通信及对网络服务器身份的鉴定。

三、使用 URL 类

URL 类常用的构造函数如下：

URL(spec: String!)。根据字符串表示形式创建 URL 对象。
URL(protocol: String!, host: String!, file: String!)。根据指定的协议名、主机名和文件名称创建 URL 对象。
URL(protocol: String!, host: String!, port: Int! file: String!)。根据指定的协议名、主机名、端口号和文件名称创建 URL 对象。

URL 类常用函数如下：

openStream()。打开到此 URL 的连接，并返回一个输入流 InputStream 对象。
openConnection()。打开到此 URL 的新连接，返回一个 URLConnection 对象。

fun main(args: Array<String>) {
    val url = 
    URL(url).openStream().use { input ->
        input.bufferedReader().forEachLine {
            println(it)
        }
    }
}

四、使用 HttpURLConnection 发送 GET 请求

由于 URL 类只能发送 HTTP/HTTPS 的 GET 函数请求，如果想进行其他函数的操作时，可以使用 HttpURLConnection 类型。

private const val urlString =  +
        

fun main(args: Array<String>) {
    var conn: HttpURLConnection? = null
    try {
        conn = URL(urlString).openConnection() as HttpURLConnection
        conn.connect()
        conn.inputStream.use { input ->
            val data = input.bufferedReader().readText()
            println(data)
        }
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        conn?.disconnect()
    }
}

// 返回数据
{
    "ResultCode": 0,
    "Record": [
        {
            "ID": 666,
            "CDate": "2017-05-18",
            "Content": "欢迎来到智捷课堂。"
        },
        {
            "ID": 666,
            "CDate": "2018-10-18",
            "Content": "Welcome to zhijieketang."
        }
    ]
}

五、使用 HttpURLConnection 发送 POST 请求

HttpURLConnection 也可以发送 HTTP/HTTPS 的 POST 请求，下面是使用 HttpURLConnection 发送 POST 请求的案例。

private const val urlString = 

fun main(args: Array<String>) {
    var conn: HttpURLConnection? = null
    try {
        conn = URL(urlString).openConnection() as HttpURLConnection
        conn.requestMethod = "POST" // 指定POST请求
        conn.doOutput = true // 设置请求过程可以传递参数给服务器

        // post请求参数
        val param = String.format("email=%s&type=%s&action=%s",  "JSON", "query")
        DataOutputStream(conn.outputStream).use { os ->
            os.writeBytes(param)
        }
        conn.connect()
        conn.inputStream.use { input ->
            val data = input.bufferedReader().readText()
            println(data)
        }
    } catch (e: Exception) {
        e.printStackTrace()
    } finally {
        conn?.disconnect()
    }
}

// 返回数据
{
    "ResultCode": 0,
    "Record": [
        {
            "ID": 666,
            "CDate": "2017-05-18",
            "Content": "欢迎来到智捷课堂。"
        },
        {
            "ID": 666,
            "CDate": "2018-10-18",
            "Content": "Welcome to zhijieketang."
        }
    ]
}

六、实例：Downloader 下载程序

private const val urlString =  +
        "5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png"

fun main(args: Array<String>) {
    var conn: HttpURLConnection? = null
    try {
        conn = URL(urlString).openConnection() as HttpURLConnection
        conn.connect()
        conn.inputStream.use { input ->
            BufferedOutputStream(FileOutputStream("./download.png")).use { bos ->
                input.copyTo(bos)
            }
        }
        println("下载成功！")
    } catch (e: Exception) {
        e.printStackTrace()
        println("下载失败！")
    } finally {
        conn?.disconnect()
    }
}