【译】kotlin 官方文档翻译-习语
原文
习语
这里是一些在 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 fromJson(JsonElement json, Class classOfT) throws JsonSyntaxException {
// ...
inline fun Gson.fromJson(json): T = this.fromJson(json, T::class.java)
消费一个可能为空的布尔值
val b: Boolean? = ...
if (b == true) {
...
} else {
// `b` is false or null
}