Kotlin开发Android笔记8：Kotlin数据类及json解析

–额外的函数——–

   通过数据类，可以方便地得到很多有趣的函数，一部分是来自属性，比如编写getter和setter函数，还有下面这些函数：

• equals(): 比较两个对象的属性来确保他们是相同的。
• hashCode(): 得到一个hash值，也是从属性中计算出来的。
• copy(): 拷贝一个对象，可以根据需要去修改里面的属性。
• 其它一系列可以映射对象到变量中的函数。

–复制数据类——–

 如果使用不可修改的对象，假如我们需要修改这个对象状态，必须要创建一个新的一个或者多个属性被修改的实例。这个任务是非常重复且不简洁的。

 比如需要修改Forecast中的temperature（温度），我们可以这么做：

val f1 = Forecast(Date(), 27.5f, "Shiny day")
val f2 = f1.copy(temperature = 30f)

上面的代码拷贝了第一个forecast对象然后只修改了temperature的属性而没有修改这个对象的其它状态。

—映射对象到变量中——-

 映射对象的属性到变量中，就是我们通常所说的多声明。这就是为什么会有componentX函数被自动创建。使用上面的Forecast类举个例子：

val f1 = Forecast(Date(), 27.5f, "Shiny day")
val (date, temperature, details) = f1

上面这个多声明会被编译成下面的代码：

val date = f1.component1()
val temperature = f1.component2()
val details = f1.component3()

这个特性背后的逻辑是非常强大的，它可以在很多情况下帮助我们简化代码。举个例子，Map类含有一些扩展函数的实现，允许它在迭代时使用key和value：

for ((key, value) in map) {
    Log.d("map", "key:$key, value:$value")
}

—json解析——-

《Kotlin for Android Developers》中文翻译第8章中的url，你可以看到json文件整个结构。
它的基本组成包括一个城市，一个系列的天气预报，这个城市有id，名字，所在的坐标。
每一个天气预报有很多信息，比如日期，不同的温度，和一个由描述和图标的id。

在我们当前的UI中，我们不会去使用所有的这些数据。我们会解析所有到类里面，因为可能会在以后某些情况下会用到。以下就是我们需要使用到的类：

data class ForecastResult(val city: City, val list: List<Forecast>)

data class City(val id: Long, val name: String, val coord: Coordinates, val country: String, val population: Int)

data class Coordinates(val lon: Float, val lat: Float)

data class Forecast(val dt: Long, val temp: Temperature, val pressure: Float,val humidity: Int, val weather: List<Weather>,val speed: Float, val deg: Int, val clouds: Int,val rain: Float)

data class Temperature(val day: Float, val min: Float, val max: Float, val night: Float, val eve: Float, val morn: Float)

data class Weather(val id: Long, val main: String, val description: String, val icon: String)

通常我们可以使用Gson来解析json到我们的类中，要求属性的名字必须要与json中的名字一样，或者指定一个serialised name（序列化名称）。
一个好的实践是，大部分的软件结构中会根据我们app中布局来解耦成不同的模型。

 为了返回被解析后的结果，我们的Request类需要进行一些修改。它将仍然只接收一个城市的zipcode作为参数而不是一个完整的url，因此这样变得更加具有可读性。
 现在，我会把这个静态的url放在一个companion object（伴随对象）中。如果我们之后还要对该API增加更多请求，我们需要提取它。

Companion objects

Kotlin允许我们去定义一些行为与静态对象一样的对象。尽管这些对象可以用众所周知的模式来实现，比如单例模式。

我们需要一个类里面有一些静态的属性、常量或者函数，我们可以使用companion objecvt。这个对象被这个类的所有对象所共享，就像Java中的静态属性或者方法。

以下是最后的代码：

public class ForecastRequest(val zipCode: String) {
    companion object {
        private val APP_ID = "15646a06818f61f7b8d7823ca833e1ce"
        private val URL = "http://api.openweathermap.org/data/2.5/" +
                "forecast/daily?mode=json&units=metric&cnt=7"
        private val COMPLETE_URL = "$URL&APPID=$APP_ID&q="
    }

    fun execute(): ForecastResult {
        val forecastJsonStr = URL(COMPLETE_URL + zipCode).readText()
        return Gson().fromJson(forecastJsonStr, ForecastResult::class.java)
    }
}

不要忘记在build.gradle中增加你需要的Gson依赖：

compile "com.google.code.gson:gson:<version>"

–构建domain层——–

首先，必须要定义一个Command：

public interface Command<T> {
    fun execute(): T
}

这个command会执行一个操作并且返回某种类型的对象，这个类型可以通过范型被指定。
你需要知道一个有趣的概念，一切kotlin函数都会返回一个值。如果没有指定，它就默认返回一个Unit类。
所以如果我们想让Command不返回数据，我们可以指定它的类型为Unit。

Kotlin中的接口比Java（Java 8以前）中的强大多了，因为它们可以包含代码。但是我们现在不需要更多的代码，以后的章节中会仔细讲这个话题。

第一个command需要去请求天气预报结构然后转换结果为domain类。下面这些类会在domain类中被定义：

data class ForecastList(val city: String, val country: String,
                        val dailyForecast:List<Forecast>)

data class Forecast(val date: String, val description: String, val high: Int,
                    val low: Int)

这些类必须从数据映射到我们的domain类，所以我接下来需要创建DataMapper：

public class ForecastDataMapper {
    fun convertFromDataModel(forecast: ForecastResult): ForecastList {
        return ForecastList(forecast.city.name, forecast.city.country,convertForecastListToDomain(forecast.list))

    private fun convertForecastListToDomain(list: List<Forecast>):
            List<ModelForecast> {
        return list.map { convertForecastItemToDomain(it) }
    }

    private fun convertForecastItemToDomain(forecast: Forecast): ModelForecast {
        return ModelForecast(convertDate(forecast.dt),forecast.weather[0].description, forecast.temp.max.toInt(),forecast.temp.min.toInt())
}

    private fun convertDate(date: Long): String {
        val df = DateFormat.getDateInstance(DateFormat.MEDIUM, Locale.getDefault())
        return df.format(date * 1000)
    }
}

使用了两个相同名字的类，我们可以给其中一个指定一个别名，这样我们就不需要写完整的包名了：

import com.xxxx.Forecast as ModelForecast

我们从一个forecast list中转换为domain model的方法：

return list.map { convertForecastItemToDomain(it) }

通过这条语句就可以循环这个集合并且返回一个转换后的新的List。
Kotlin在List中提供了很多不错的函数操作符，它们可以在这个List的每个item中应用这个操作并且任何方式转换它们。

 现在，编写命令前的准备就绪：

class RequestForecastCommand(val zipCode: String) :
                Command<ForecastList> {
    override fun execute(): ForecastList {
        val forecastRequest = ForecastRequest(zipCode)
        return ForecastDataMapper().convertFromDataModel(
                forecastRequest.execute())
    }
}

—在UI中绘制数据——-

http://blog.csdn.net/true100/article/details/52034460中的
MainActivity中的代码进行改动，把真实的数据需要填充到adapter中。异步调用需要被重写成：

async() {
    val result = RequestForecastCommand("94043").execute()
    uiThread{
        forecastList.adapter = ForecastListAdapter(result)
    }
}

Adapter也需要被修改：

class ForecastListAdapter(val weekForecast: ForecastList) :
        RecyclerView.Adapter<ForecastListAdapter.ViewHolder>() {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int):
            ViewHolder? {
        return ViewHolder(TextView(parent.getContext()))
    }

    override fun onBindViewHolder(holder: ViewHolder,
            position: Int) {
        with(weekForecast.dailyForecast[position]) {
            holder.textView.text = "$date - $description - $high/$low"
    } 
}
    override fun getItemCount(): Int = weekForecast.dailyForecast.size

    class ViewHolder(val textView: TextView) : RecyclerView.ViewHolder(textView)
}

with函数

with是一个非常有用的函数，它包含在Kotlin的标准库中。它接收一个对象和一个扩展函数作为它的参数，然后使这个对象扩展这个函数。
这表示所有我们在括号中编写的代码都是作为对象（第一个参数）的一个扩展函数，我们可以就像作为this一样使用所有它的public方法和属性。

博客学习来自《Kotlin for Android Developers》中文翻译。