Kotlin实现《第一行代码》案例“酷欧天气”

 

看过《第一行代码》的朋友应该知道“酷欧天气”，作者郭神用整整一章的内容来讲述其从无到有的过程。

最近正好看完该书的第二版（也有人称“第二行代码”），尝试着将项目中的Java代码用Kotlin实现。

 

原项目获取点这里

Kotlin实现点这里

 

除了将Java转为Kotlin外，界面与资源的定义也略微做了调整，但是功能上没有变化（这部分后续进行完善，书中有提到可以改进的地方）。

 

1. 界面调整

1.1 将“预告”和“空气质量”两个模块的位置互换，“空气质量”和“温度/天气状态”放在一起感觉会比较直观。

1.2 将模块布局的背景色调整为主题色，与标题栏背景色保持一致。

效果图如下：

   

    

 

2. 资源定义

2.1 将dimen、color及string由直接使用字面值改为先将资源值定义在相应的文件中，然后在布局文件中用@type/value的形式引用。

2.2 将表示左/右方向的xxxLeft、xxxRight改为xxxStart、xxxEnd，适配Android高版本设备左/右方向问题。

具体细节可以下载代码进行查看，这样做的目的是加强应用的适配性与可维护性。

 

3. Java->Kotlin

Kotlin的基础知识可以阅读官方文档或者我之前的文章进行了解，下面只描述和原项目代码结构上的调整，或者Java转为Kotlin值得注意的地方。

3.1 Android Studio 3.0开始已经集成Kotlin（2.0需要手动安装插件），不过有两种情况：

a 在非Kotlin项目的基础上进行Kotlin编码，得先在Project和Module的build.gradle文件中引入依赖；

b 新建支持Kotlin的项目，那么依赖是默认引入的，直接编码即可；

3.2 将“散落”在多个文件中的常量提取到HttpUtil类中：

object HttpUtil {
    val Url = "http://guolin.tech/api/weather"
    val Key = "key=bc0418b57b2d4918819d3974ac1285d9"
    val Bing = "http://guolin.tech/api/bing_pic"
    val China = "http://guolin.tech/api/china"
    ...
}

Kotlin中推荐用object修饰工具类，里面的成员默认是static的。常量用val，变量用var。

但是在使用HttpUtil.Url时并不像Java那样是引用类所属的静态变量，而是通过单例对象（lazy-init机制，第一次使用时进行创建）来引用成员变量，了解更多点这里。

3.3 for (int i = start; i < end; ++i) {}改为for (i in start..end - 1) {}：

for (i in start..end - 1) {
    ...
}

in和..的组合遍历的区间是[start, end-1]，即最后一个元素是包含在内的，不注意容易引起下标越界问题。变量i是自动推断类型，不需要显式声明。

3.4 将只有数据的类由class改为data class，如城市类的定义：

data class City(var id: Int = 0,
                var cityName: String? = null,
                var cityCode: Int = 0,
                var provinceId: Int = 0) : DataSupport() {}

这种类一般称为Bean类（只拥有数据而没有操作），编译器会根据声明的属性自动生成对应的equal()、hashCode()方法及pair，了解更多点这里。

3.5 Kotlin中==和equals效果是相同的（比较的是对象的值），比较引用的是===。那么我们在比较字串的值时可以简化代码了：

if ("ok" == it.status) {
    ...
}

将常量字面值写在前面也是一种好习惯，因为str.equals("ok")的形式，当str为空时会报空指针异常。还有，基本类型比较时需要显式转换，否则也会报错，如1 == 1L需要写成1.toLong() == 1L。了解更多点这里。

3.6 打开应用时会进行天气缓存信息的读取，如果之前使用过应用，那么就直接显示上次的天气信息；如果没有则进行城市的选择，并进行对应天气的获取。这里通过？.let语法来代替下一步操作前的null判断：

val prefs = PreferenceManager.getDefaultSharedPreferences(this@MainActivity)
val weather = prefs.getString("weather", null)
weather?.let {
　　val intent = Intent(this, WeatherActivity::class.java)
　　startActivity(intent)
　　finish()
}

如果weather变量值为null，那么就不会往下执行，类似的用法还有获取字串长度str?.length，当str为null时不往后取length值就能避免空指针异常。

3.7 by lazy延迟加载

val drawerLayout by lazy {
    findViewById(R.id.drawer_layout) as DrawerLayout
}

val swipeRefresh by lazy {
    findViewById(R.id.swipe_refresh) as SwipeRefreshLayout
}

之前的做法一般是先定义变量，然后在onCreate等重载方法中利用findViewById将变量和id进行绑定。现在Kotlin中提供了延迟加载机制，只有在布局环境初始化完成后，才会建立变量和id的联系。不管是绑定的时机，还是这个过程的代码实现，都变得一目了然。

3.8 when、_和is

list_view.onItemClickListener = AdapterView.OnItemClickListener { _, _, position, _ ->
    when (currentLevel) {
        LEVEL_PROVINCE -> {
            selectedProvince = provinceList!![position]
            queryCities()
        }
        LEVEL_CITY -> {
            selectedCity = cityList!![position]
            queryCounties()
        }
        LEVEL_COUNTY -> {
            val weatherId = countyList!![position].weatherId
            weatherId?.let {
                when (activity) {
                    is MainActivity -> {
                        val intent = Intent(activity, WeatherActivity::class.java)
                        intent.putExtra("weather_id", weatherId)
                        startActivity(intent)
                        activity.finish()
                    }
                    is WeatherActivity -> {
                        val activity = activity as WeatherActivity
                        activity.drawerLayout.closeDrawers()
                        activity.swipeRefresh.isRefreshing = true
                        activity.requestWeather(weatherId)
                    }
                    else -> {}
                }
            }
        }
        else -> {}
    }
}

这段代码的功能是给列表项添加点击响应，也比以往的写法简化很多，提一下代码中用到的三个点。

a when用来替换switch case，省去了case:、break及default，毕竟每一个分支结尾处都要记得写上break还是不爽的；

b 方法参数_，当后面不会使用的情况下可以写成下划线，优点是过多不用的参数可以简写，缺点是可读性不好，后续如果参数被使用还是需要加上名称；

c is和as，前者是判断类型是否匹配，后者是类型转换。

3.9 map映射和it

provinceList?.let {
    if (it.isNotEmpty()) {
        dataList.clear()
        it.map {
            dataList.add(it.provinceName!!)
        }
        adapter.notifyDataSetChanged()
        list_view.setSelection(0)
        currentLevel = LEVEL_PROVINCE
        return
    }
}

之前提到过let的用法，其实和之搭配的还有it，代表let前面的变量，比如it.isNotEmpty()就是判断列表变量provinceList是否为空。而it.map的作用是遍历列表/数组，元素又可以用it表示，有点像it的嵌套，Kotlin会自动区分it代表的对象。

3.10 @SerializedName注解（Java中概念），用于将json内容中的属性名和对应类的成员变量名进行一一对应，毕竟json中字段名的可读性是不能保证的。用法如下：

class Now {
    @SerializedName("tmp")
    var temperature: String? = null
    ...    
}

3.11 $name和${name}获取变量值

val address = "${HttpUtil.China}/$provinceCode"

这种用法在字串拼接时特别适用，不用再通过“+”号写一长串的代码来进行各字串的拼接，直接将值的获取放到字串中。

$name当name是普通变量时使用，${name}当name是类属性或者数组/列表元素时使用，还可以这样使用：

val a = 10
println("a > 10 is ${if (a > 10) "true" else "false"}")

输出结果为false，将变量值的判断和结果都放在${}中。

 

4. 总结

上面仅仅介绍了关于Kotlin语言的部分用法，项目中还用到了Glide、Litepal、OkHttp及Gson等流行库，以及在Service中用AlarmManager来后台定期更新天气数据。感兴趣的话建议查看相关源码，会有收获的。