Idioms.md

原文

习语

这里是一些在 Kotlin 中经常使用的习语。如果你有特别喜欢的习语想要贡献出来，赶快发起 pull request 吧。

创建DTOs(POJOs/POCOs) 数据类

data class Customer(val name: String, val email: String)

创建 Customer 类并带有如下方法：

--为所有属性添加 getters ，如果为 var 类型同时添加 setters --equals() --hashCode() --toString() --copy() --component1() , component1() , ... 参看数据类

函数默认参数

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

过滤 list

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

或者更短：

val positives = list.filter { it > 0 }

字符串插值

println("Name $name")

实例检查

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

遍历 map/list 键值对

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

k,v 可以随便命名

使用 ranges

for (i in 1..100) { ... }  // 闭区间: 包括100
for (i in 1 until 100) { ... } // 半开区间: 不包括100
for (x in 2..10 step 2) { ... }
for (x in 10 downTo 1) { ... }
if (x in 1..10) { ... }

只读 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

懒属性(延迟加载)

val p: String by lazy {
    // compute the string
}

扩展函数

fun String.spcaceToCamelCase() { ... }
"Convert this to camelcase".spcaceToCamelCase()

创建单例模式

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{
	...//如果不为空执行该语句块
}

如果不空则映射(Map nullable value if not null)

val data = ...

val mapped = data?.let { transformData(it) } ?: defaultValueIfDataIsNull

返回 when 判断

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

try-catch 表达式

fun test() {
    val result = try {
        count()
    } catch (e: ArithmeticException) {
        throw IllegalStateException(e)
    }

    // Working with result
}

if 表达式

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

使用生成器模式返回 Unit

fun arrayOfMinusOnes(size: Int): IntArray {
    return IntArray(size).apply { fill(-1) }
}

单表达式函数

fun theAnswer() = 42

与下面的语句是等效的

fun theAnswer(): Int {
	return 42
}

可以和其它习语组合成高效简洁的代码。譬如说 when 表达式：

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

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

class Turtle {
    fun penDown()
    fun penUp()
    fun turn(degrees: Double)
    fun forward(pixels: Double)
}

val myTurtle = Turtle()
with(myTurtle) { //draw a 100 pix square
    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` is false or null
}