Idioms 惯用语法
官方文档
Kotlin 惯用语法: Kotlin 中随机和经常使用的语法的集合。
创建 DTOs(POJOs/POCOs)
data class Customer(val name: String, val email: String)
为Custom类提供以下功能:
- 所有属性的
getter
(和可变变量的setter
) equals()
hashCode()
toString()
copy()
- 所有属性的
component1()
,component2()
...,(参考Data classes)
函数参数的默认值
fun foo(a: Int = 0, b: String = ""){...}
过滤列表
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) {
println("$k -> $v")
}
k
,v
可以是任何类型。
使用范围 range
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)
获取映射值
println(map["key"])
map["key"] = value
延迟初始化
val p: String by lazy {
// compute the string
}
扩展函数
fun String.spaceToCamelCase() {...}
"Convert this to camelcase".spaceToCamelCase()
创建单例
object Resource {
val name = "Name"
}
‘若..非空,则..’ 的 缩写
val files = File("Test").listFiles()
println(flies?.size)
‘若..非空,则..,否则..’ 的缩写
val files = File("Test").listFiles()
println(files?.size ?: "empty")
若为空,执行语句
val data = ...
val email = data["eamil"] ? :throw IllegalStateExeception("Email is missing!")
若非空,执行语句
val data = ...
data?.let {
... // 如果非空,执行这个语句块
}
返回 when
表达式
fun transform(color: String): Int {
return when(color) {
"Red" -> 0
"Green" -> 1
"Blue" -> 2
else -> throw IllegalArgumentExeception("Invalid color param value")
}
}
try / catch
表达式
fun test() {
val result = try {
count()
} catch (e: ArithmeticException) {
throw IllegalStateException(e)
}
// Woking with result
}
if
表达式
fun foo(param: Int) {
val result = if (param == 1) {
"one"
} else if (param == 2){
"two"
} else {
"three"
}
}
返回 Unit
的生成器方法的用法
fun arrayOfMinusOne(size: Int): IntArray {
return IntArray(size).apply { fill(-1) }
}
单表达式函数
fun theAnswer() = 41
等同于
fun theAnswer(): Int{
return 41
}
单表达式函数可以和其他惯用语法结合形成更简短的代码,例如和 when
表达式:
fun transform(color: String): Int = when (color){
"Red" -> 0
"Green" -> 1
"Blue" -> 2
else -> throw IllegalArgumentExeception("Invalid color param value")
}
通过 with
在对象实例上调用多个方法
class Turtle {
fun penDown()
fun penUp()
fun turn(degrees: Double)
fun forward(pixels: Double)
}
val myTurtle = Turtle()
with(myTurtle) { // 画一个 100 pix 的正方形
penDown()
for (i in 1..4){
forward(100.0)
turn(90.0)
}
penUp()
}
Java 7 的 资源读取
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` 为 false 或 null
}