Kotlin入门(32)网络接口访问

手机上的资源毕竟有限,为了获取更丰富的信息,就得到辽阔的互联网大海上冲浪。对于App自身,也要经常与服务器交互,以便获取最新的数据显示到界面上。这个客户端与服务端之间的信息交互,基本使用HTTP协议进行通信,即App访问服务器的HTTP接口来传输数据。HTTP接口调用在Java代码中可不是一个轻松的活,开发者若用最基础的HttpURLConnection来编码的话,至少要考虑以下场景的处理:
1、HTTP的请求方式是什么,是GET还是POST还是PUT还是DELETE?
2、HTTP的连接超时时间是多少,请求应答的超时时间又是多少?
3、HTTP头部的语言和浏览器信息该设置为什么?
4、HTTP传输的数据内容采取的是哪种编码方式?
5、HTTP的应答数据如果是压缩过的,又要如何解压?
6、HTTP的输入输出流需要注意哪些方面?
7、HTTP如何分块传输较大的数据信息?
瞧瞧上面层出不穷的功能要求,如果开发者事必躬亲逐个编码,那可真是要累得够呛。因此,各种意图取代HttpURLConnection的网络交互框架如雨后春笋般涌现出来,既有老资格的如HttpClient,又有后起之秀如Android-Async-Http、Volley、OkHttp、Retrofit等等,可谓是百花齐放、百家争鸣。当然,这些网络框架是需要学习成本的,使用起来也不如想象中的那么容易;它们只是在技术上各有千秋,并非终极的解决方案,往往是你方唱罢我登台,各领风骚几年然后歇菜。
其实HTTP交互原本无需这样大动干戈,常见的接口调用仅仅是App往服务器发送一串请求信息,然后服务器返回给App一串处理结果,这种简单的业务场景已经足够应付大多数App的网络通信需求。所以大道至简,Kotlin把网络交互看作是跟文件读写一样的I/O操作,后端地址就像是个文件路径,那么请求服务器的数据犹如读取文件内容。文本分为文本文件和二进制文件两种,则HTTP接口对应获取文本数据和获取二进制数据两种,于是整个网络请求便简化为数据的存跟取了。
具体到详细的Kotlin编码,文件对象由“File(文件路径)”构建,而HTTP对象由“URL(网络地址)”构建,获取接口数据则有readText和readBytes两个方法,前者用于获取文本形式的应答数据,后者用于二进制形式的应答数据如图片文件、音频文件等等。仅仅一个readText方法真的能完成繁杂的HTTP接口调用操作吗?下面我们通过一个具体的接口访问案例,探讨一下如何使用Kotlin代码实现HTTP接口调用。
智能手机普遍提供了定位功能,可是系统自带的定位服务只能获得用户所在的经纬度信息,而这枯燥的经纬度数字令人不知所云,肯定要把经纬度转换为详细的地址信息才方便用户理解。将经纬度转换为详细地址,就要访问谷歌地图提供的地址查询接口了,该接口的地址形如“http://maps.google.cn/maps/api/geocode/json?请求参数信息”,App把经纬度数据作文请求参数传入,对方会返回一个包含地址信息的json串,通过解析json串即可获得当前的详细地址。由于访问网络需要在分线程进行,因此接口访问代码必须放在doAsync代码块中,下面给出根据经纬度获取详细地址的Kotlin代码片段:

    private val mapsUrl = "http://maps.google.cn/maps/api/geocode/json?latlng={0},{1}&sensor=true&language=zh-CN"

    //位置监听器侦听到定位变化事件,就调用该函数请求详细地址
    private fun setLocationText(location: Location?) {
        if (location != null) {
            doAsync {
                //根据经纬度数据从谷歌地图获取详细地址信息
                val url = MessageFormat.format(mapsUrl, location.latitude, location.longitude)
                val text = URL(url).readText()
                val obj = JSONObject(text)
                val resultArray = obj.getJSONArray("results")
                var address = ""
                //解析json字符串,其中formatted_address字段为具体地址名称
                if (resultArray.length() > 0) {
                    val resultObj = resultArray.getJSONObject(0)
                    address = resultObj.getString("formatted_address")
                }
                //获得该地点的详细地址之后,回到主线程把地址显示在界面上
                uiThread { findAddress(location, address) }
            }
        } else {
            tv_location.text = "$mLocation\n暂未获取到定位对象"
        }
    }

    //在主线程中把定位信息连同地址信息都打印到界面上
    private fun findAddress(location: Location, address: String) {
        tv_location.text = "$mLocation\n定位对象信息如下: " +
                "\n\t时间:${DateUtil.nowDateTime}" +
                "\n\t经度:${location.longitude},纬度:${location.latitude}" +
                "\n\t高度:${location.altitude}米,精度:${location.accuracy}米" +
                "\n\t地址:$address"
    }

上述代码看起来显然简明扼要,寥寥数行便搞定了完整的功能实现。如果使用Java代码实现该功能,首先HTTP调用就得提供底层的接口访问代码,其次分线程请求网络又得专门写个继承自AsyncTask的任务处理代码,末了Activity这边厢还得实现该任务的完成事件,真是兴师动众、劳民伤财。由此可见Kotlin的网络交互是革命性的,方式虽然简单,却足以应付大部分的网络通信需求,并且运行效果与Java代码几无差别,例如调用地图接口查询地址信息,无论采用Java编码还是Kotlin编码,界面效果都如下图所示。

上面利用readText方法就完成了文本数据的接口调用,当时提到了readBytes可用于获取二进制数据如图片文件,那么获取网络图片是否也同样方便呢?下面我们继续探讨如何使用Kotlin代码读取网络图片。
获取网络图片的基本流程同文本格式的接口访问,一样先通过URL类构建HTTP对象,然后在doAsync代码块中调用HTTP对象的readBytes方法获得图片的字节数组。将字节数组转换为位图对象,这在前面的文章《Kotlin入门(27)文件读写操作》已经加以介绍,即利用BitmapFactory工具的decodeByteArray方法实现转换操作。转换好的位图当然可以在主线程直接显示出来,也可以先保存为图片文件,等到需要的时候再去读取。前面描述如何把位图保存为图片文件时,由于Bitmap相关类并未提供简单的图片保存方法,因此当时保存位图文件还着实颇费了一番功夫。现在保存网络图片反而无需如此折腾,这是因为获取网络图片得到了字节数组,字节数组保存为文件可是相当方便的噢,只要调用File对象的writeBytes方法,短短一行就保存好图片了。介绍完了网络图片的存取流程,最终的Kotlin编码一如既往地简单明了,下面展示了一个验证码动态显示的页面代码:

class HttpImageActivity : AppCompatActivity() {
    private val imageUrl = "http://222.77.181.14/ValidateCode.aspx?r="

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_http_image)
        iv_image_code.setOnClickListener { getImageCode() }
        getImageCode()
    }

    //获取网络上的图片验证码
    private fun getImageCode() {
        iv_image_code.isEnabled = false
        doAsync {
            val url = "$imageUrl${DateUtil.getFormatTime()}"
            val bytes = URL(url).readBytes()
            //把字节数组解码为位图数据
            val bitmap = BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
            //也可通过下面三行代码把字节数组写入文件,即生成一个图片文件
            val path = getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS).toString() + "/"
            val file_path = "$path${DateUtil.getFormatTime()}.png"
            File(file_path).writeBytes(bytes)
            //获得验证码图片数据,回到主线程把验证码显示在界面上
            uiThread { finishGet(bitmap) }
        }
    }

    //在主线程中显示获得到的验证码图片
    private fun finishGet(bitmap: Bitmap) {
        iv_image_code.setImageBitmap(bitmap)
        iv_image_code.isEnabled = true
    }
}

看到了吧,即使是完整的Activity代码,Kotlin也只需数十行而已。倘若使用Java完成同样的功能,除了HTTP底层与AsyncTask的编码之外,还得补充Bitmap对象的图片保存代码。也就是说,Java代码需要额外添加三个工具类的实现代码,光光这一点,Kotlin的效率就令人赞叹。而且,短小精悍的Kotlin代码并未造成任何功能缺失,以上面的图片验证码页面为例,使用Java编码和使用Kotlin编码,最终的显示效果都如下图所示。

原文地址:https://www.cnblogs.com/aqi00/p/9926505.html

时间: 2024-10-13 04:45:16

Kotlin入门(32)网络接口访问的相关文章

Kotlin入门

转载自:https://www.cnblogs.com/jaymo/articles/6924144.html 创建类的实例 要创建一个类的实例,我们就像普通函数一样调用构造函数: 1 2 3 val invoice = Invoice() val customer = Customer("Joe Smith") 注意 Kotlin 并没有 new 关键字. 继承 在 Kotlin 中所有类都有一个共同的超类 Any,这对于没有超类型声明的类是默认超类 1 class Example

Node.js开发入门—使用http访问外部世界

Node.js的http模块,不但可以构建服务器,也可以作为客户端类库来访问别的服务器.关键就在两个方法: http.request(options[,callback]) http.get(path[,callback]) 除了http,还会用到FileSystem模块和Stream中的stream.Readable和stream.Writable. 先来大概介绍一下相关API吧. API解释 http.request()方法接受一个options参数,这个参数可以是对象,用来指明你要访问的网

Kotlin入门(16)容器的遍历方式

Kotlin号称全面兼容Java,于是乎Java的容器类仍可在Kotlin中正常使用,包括大家熟悉的队列ArrayList.映射HashMap等等.不过Kotlin作为一门全新的语言,肯定还是要有自己的容器类,不然哪天Java跟Kotlin划清界限,那麻烦就大了.与Java类似,Kotlin也拥有三类基本的容器,分别是集合Set.队列List.映射Map,然后每类容器又分作只读与可变两种类型,这是为了判断该容器能否进行增删改等变更操作.Kotlin对修改操作很慎重,比如变量用val前缀表示不可修

springboot入门_数据库访问_jdbcTemplate

本文记录下在springboot项目中使用jdbcTemplate访问数据库. 创建springboot项目,添加依赖,pom文件如下: 1 <!--web 依赖--> 2 <dependency> 3 <groupId>org.springframework.boot</groupId> 4 <artifactId>spring-boot-starter-web</artifactId> 5 </dependency>

Kotlin入门(23)适配器的进阶表达

前面在介绍列表视图和网格视图时,它们的适配器代码都存在视图持有者ViewHolder,因为Android对列表类视图提供了回收机制,如果某些列表项在屏幕上看不到了,则系统会自动回收相应的视图对象.随着用户的下拉或者上拉手势,已经被回收的列表项要重新加载到界面上,倘若每次加载都得从头创建视图对象,势必增加了系统的资源开销.所以ViewHolder便应运而生,它在列表项首次初始化时,就将其视图对象保存起来,后面再次加载该视图时,即可直接从持有者处获得先前的视图对象,从而减少了系统开销,提高了系统的运

Kotlin入门(33)运用扩展属性

进行App开发的时候,使用震动器要在AndroidManifest.xml中加上如下权限: <!-- 震动 --> <uses-permission android:name="android.permission.VIBRATE" /> 让手机震动的功能用到了震动器Vibrator类,而震动器对象从系统服务VIBRATOR_SERVICE获得,实现该功能的代码很简单,即便用Java书写也只有以下两行代码: Vibrator vibrator = (Vibrat

黑马day05 Cookie技术入门&amp;记录上次访问的时间

1.Cookie技术: 客户端技术 Cookie是基于set-Cookie响应头和Cookie请求头工作的,服务器可以发送set-Cookie请求头命令浏览器保存一个cookie信息,浏览器会在访问服务器时以Cookie请求头的方式带回之前保存的信息 request.getCookies(); response.addCookie(Cookie c); new  Cookie(String name,String value)//Cookie在构造的时候就需要设定好cookie的名字和值 get

Kotlin入门(12)类的概貌与构造

上一篇文章提到泛型函数appendString是在类外面定义,这不免使人疑惑,类里面又该怎样定义成员函数呢?为解答这个疑问,接下来的几篇文章将好好描述一下Kotlin如何操作类及其对象,本篇文章先对类的定义进行说明并加以运用. 之前我们已经多次见过的类MainActivity,在Java代码中该类的写法如下所示: public class MainActivity extends AppCompatActivity { } 而对应的Kotlin代码是下面这样的: class MainActivi

《Linux菜鸟入门2》访问网络文件系统

1.cifs网络文件系统访问 1.安装共享访问客户端 yum install samba-client -y 2.识别共享服务器共享目录 smbclient -L //172.25.254.253 3.访问共享 直接用命令访问 smbclient //..... -o username=guest 挂载访问 4.开机自动挂载 方法1  vim /etc/fstab //172.25.254.254/westos /mnt cifs default,username=guest 方法2  vim