Kotlin 第五章：Kotlin 的编码风格和习惯用语

Kotlin 第五章：Kotlin 的编码风格和习惯用语

前面一起学习了 Kotlin 的插件安装、基本语法、基本类型、包、控制流、返回与跳转，到了这里 Kotlin 的基础学习已经基本差不多了，这一篇文章来一起学习一下 Kotlin 的编码风格和习惯用语。

编码风格

命名风格

在 Kotlin 中的命名风格和 Java 的命名风格基本是一致的，或者说是极其相似的。

* 使用骆驼命名法(在命名中避免下划线)
* 类型名称首字母大写
* 方法和属性首字母小写
* 缩进用四个空格
* public 方法要写说明文档，这样它就可以出现在 Kotllin Doc 中

冒号

在冒号区分类型和父类型中要有空格，在实例和类型之间是没有空格的：

interface Foo<out T : Any> : Bar {
    fun foo(a: Int): T
}

Lambdas

在 Lambdas 表达式中，大括号与表达式间要有空格，箭头与参数和函数体间要有空格。尽可能的把 lambda 放在括号外面传入

list.filter { it > 10 }.map { element -> element * 2 }

Unit

如果函数返回 Unit ，返回类型应该省略：

fun foo() { // ": Unit"被省略了
}

习惯用语

函数默认值

fun foo(a: Int = 0, b: String = "") {...}

过滤 list

使用扩展函数 filter 来过滤list

val positives = list.filter { x -> x >0 }

或者更短：

val positives = list.filter { it > 0 }

字符串插值

println("Name $name")

实例检查

通过用 is 来判断是否属于某个实例

when (x) {
    is Foo ->  ...
    is Bar -> ...
    else -> ...
}

遍历 map/list

for ((k, v) in map) {
    print("$k -> $v")
}

k,v 可以随便命名

只读 list

val list = listOf("a", "b", "c")

只读map

val map = mapOf("a" to 1, "b" to 2, "c" to 3)

访问 map

println(map["key"])
map["key"] = value

创建单例模式

object Resource {
    val name = "Name"
}

如果不为空则… 的简写

val files = File("Test").listFiles()
println(files?.size)

如果不为空…否则… 的简写

val files = File("test").listFiles()
println(files?.size ?: "empty")

如果声明为空执行某操作

val data = ...
val email = data["email"] ?: throw IllegalStateException("Email is missing!")

如果不为空执行某操作

val date = ...
data?.let{
    ...//如果不为空执行该语句块
}

返回 when 判断

fun transform(color: String): Int {
    return when(color) {
        "Red" -> 0
        "Green" -> 1
        "Blue" -> 2
        else -> throw IllegalArgumentException("Invalid color param value")
    }
}

if 表达式

fun foo(param: Int){
    val result = if (param == 1) {
        "one"
    } else if (param == 2) {
        "two"
    } else {
        "three"
    }
}

try-catch 表达式

fun test() {
    val result = try {
        count()
    }catch (e: ArithmeticException) {
        throw IllegaStateException(e)
    }
    //处理 result
}

利用 with 调用一个对象实例的多个方法

class Turtle {
    fun penDown()
    fun penUp()
    fun turn(degrees: Double)
    fun forward(pixels: Double)
}
val myTurtle = Turtle()
with(myTurtle) { // 画一个100像素的正方形
    penDown()
    for(i in 1..4) {
    forward(100.0)
        turn(90.0)
    }
    penUp()
}

Java 7’s try with resources

val stream = Files.newInputStream(Paths.get("/some/file.txt"))
stream.buffered().reader().use { reader ->
    println(reader.readText())
}

需要泛型信息的泛型函数的方便形式

//  public final class Gson {
//     ...
//     public <T> T fromJson(JsonElement json, Class<T> classOfT) throws JsonSyntaxException {
//     ...

inline fun <reified T: Any> Gson.fromJson(json): T = this.fromJson(json, T::class.java)

产生一个可能为空的布尔值

val b: Boolean? = ...
if (b == true) {
  ...
} else {
  // `b` 是false或者null
}

后记

到这这一篇文章结束，Kotlin 的基础中的基础学习算是暂时告一段落了，剩下的算是“中级”及其以上的学习了，小弟也是初学者，边学边写，可能有错误或者不太全面，请各位看官提出宝贵的意见。

参考

Kotlin中文文档