kotlin

Kotlin语法特点:
1.没有“;”在Kotlin语法里，代码行不需要用“;”结尾，什么都不写就好
2.重要的“:”在Java里，“:”主要在运算符里出现（for/switch/三元运算符等）。
在Kotlin里，“:”的地位大大提升了，它的用途非常广泛，包括：
定义变量类型

var name:String="my name" //变量name为String类型

定义参数的类型

fun makeTool(id:Int){ //参数id为Int类型
}

定义函数的返回值

fun getAddr(id:Int):String{ //返回值为String类型
}

声明类/接口的继承

class KotlinActivityUI :AnkoComponent<KotlinActivity>{
//继承AnkoComponent接口

使用Java类

val intent = Intent(this, MainActivity::class.java) //需要用::来使用Java类，注意是两个“”

3.没有“new”
Kotlin实例化一个对象时不需要new关键字

var list=ArrayList()

4.变量、常量、类型推断用var定义变量（像js）

var name:String="my name"

用val定义常量（相当于final）

val TAG:String="ClassName"

上面两个例子用:String来定义了数据类型，这个是可以省略的，Kotlin支持类型推断，这两句话你可以写成

var name="my name"
val TAG="ClassName"

5.初始化和延迟加载在Java里，我们可以定义一个变量，但是并不赋值（int和boolean会有默认值）但是Kotlin里必须为变量赋值，如果只写一个变量，却不赋值，像下面这样：

var name

编译器会报错，提示你未初始化，你必须赋值为0或者null，或者别的什么值。
不过，我们有时候就是不能在定义变量时就初始化它，比如在Android中我们经常预定义一个View控件而不初始化，但是直到onCreate或onCreateView时才初始化它。
针对这种情况，Kotlin提供了懒加载lazy机制来解决这个问题，在懒加载机制里，变量只有在第一次被调用时，才会初始化，代码需要这样写

lazy只适用于val对象，对于var对象，需要使用lateinit，原理是类似的，只是代码需要这样写

6.空指针安全

在Kotlin里，可以用“?”表示可以为空，也可以用“!!”表示不可以为空。

空指针安全并不是不需要处理空指针，你需要用“?”声明某个变量是允许空指针的，例如：

var num:Int?=null

声明允许为空时，不能使用类型推断，必须声明其数据类型

空指针虽然安全了，但对空指针的处理还是要视情况而定，
有时候不处理，
有时候做数据检查，
有时候还需要抛出异常，
这三种情况可以这样写：

val v1 =num?.toInt() //不做处理返回 null

val v2 =num?.toInt() ?:0 //判断为空时返回0

val v3 =num!!.toInt() //抛出空指针异常（用“!!”表示不能为空）

基本语法：

函数
带有两个 Int 参数、返回 Int 的函数：

fun sum(a: Int, b: Int): Int {
    return a + b
}

将表达式作为函数体、返回值类型自动推断的函数：

fun sum(a: Int, b: Int) = a + b

函数返回无意义的值：

fun printSum(a: Int, b: Int): Unit {
    println("sum of $a and $b is ${a + b}")
}

Unit 返回类型可以省略：

fun printSum(a: Int, b: Int) {
    println("sum of $a and $b is ${a + b}")
}

函数的默认参数

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

变量
定义只读局部变量使用关键字 val 定义。只能为其赋值一次。

val a: Int = 1  // 立即赋值
val b = 2   // 自动推断出 `Int` 类型
val c: Int  // 如果没有初始值类型不能省略
c = 3       // 明确赋值

可重新赋值的变量使用 var 关键字：

var x = 5 // 自动推断出 `Int` 类型
x += 1

顶层变量：

val PI = 3.14
var x = 0

fun incrementX() { 
    x += 1 
}

字符串模板

var a = 1
// 模板中的简单名称：
val s1 = "a is $a" 

a = 2
// 模板中的任意表达式：
val s2 = "${s1.replace("is", "was")}, but now is $a"

条件表达式

fun maxOf(a: Int, b: Int): Int {
    if (a > b) {
        return a
    } else {
        return b
    }
}

在 Kotlin 中，if 也可以用作表达式：

fun maxOf(a: Int, b: Int) = if (a > b) a else b

空值与 null 检测
当某个变量的值可以为 null 的时候，必须在声明处的类型后添加 ? 来标识该引用可为空。

如果 str 的内容不是数字返回 null：

 fun parseInt(str: String): Int? {
        // ……
    }
    
fun printProduct(arg1: String, arg2: String) {
    val x = parseInt(arg1)
    val y = parseInt(arg2)

    // 直接使用 `x * y` 会导致编译错误，因为它们可能为 null
    if (x != null && y != null) {
        // 在空检测后，x 与 y 会自动转换为非空值（non-nullable）
        println(x * y)
    }
    else {
        println("'$arg1' or '$arg2' is not a number")
    }    
}

类型检测与自动类型转换
is 运算符检测一个表达式是否某类型的一个实例。 如果一个不可变的局部变量或属性已经判断出为某类型，那么检测后的分支中可以直接当作该类型使用，无需显式转换：

fun getStringLength(obj: Any): Int? {
    if (obj is String) {
        // `obj` 在该条件分支内自动转换成 `String`
        return obj.length
    }

    // 在离开类型检测分支后，`obj` 仍然是 `Any` 类型
    return null
}

或者

fun getStringLength(obj: Any): Int? {
    if (obj !is String) return null

    // `obj` 在这一分支自动转换为 `String`
    return obj.length
}

甚至

fun getStringLength(obj: Any): Int? {
    // `obj` 在 `&&` 右边自动转换成 `String` 类型
    if (obj is String && obj.length > 0) {
      return obj.length
    }

    return null
}

for 循环

val items = listOf("apple", "banana", "kiwifruit")
for (item in items) {
    println(item)
}

或者

val items = listOf("apple", "banana", "kiwifruit")
for (index in items.indices) {
    println("item at $index is ${items[index]}")
}

while 循环

val items = listOf("apple", "banana", "kiwifruit")
var index = 0
while (index < items.size) {
    println("item at $index is ${items[index]}")
    index++
}

when 表达式

fun describe(obj: Any): String =
    when (obj) {
        1          -> "One"
        "Hello"    -> "Greeting"
        is Long    -> "Long"
        !is String -> "Not a string"
        else       -> "Unknown"
    }

使用区间（range）
使用 in 运算符来检测某个数字是否在指定区间内：

val x = 10
val y = 9
if (x in 1..y+1) {
    println("fits in range")
}

检测某个数字是否在指定区间外:

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

if (-1 !in 0..list.lastIndex) {
    println("-1 is out of range")
}
if (list.size !in list.indices) {
    println("list size is out of valid list indices range, too")
}

区间迭代:

for (x in 1..5) {
    print(x)
}

使用区间

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) { …… }

或数列迭代：

for (x in 1..10 step 2) {
    print(x)
}
println()
for (x in 9 downTo 0 step 3) {
    print(x)
}

Collections
对集合进行迭代:

for (item in items) {
    println(item)
}

使用 in 运算符来判断集合内是否包含某实例：

when {
    "orange" in items -> println("juicy")
    "apple" in items -> println("apple is fine too")
}

使用 lambda 表达式来过滤（filter）与映射（map）集合：

val fruits = listOf("banana", "avocado", "apple", "kiwifruit")
fruits
  .filter { it.startsWith("a") }
  .sortedBy { it }
  .map { it.toUpperCase() }
  .forEach { println(it) }

过滤 list

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

或者可以更短:

val positives = list.filter { it > 0 }

检测元素是否存在于集合中

if ("john@example.com" in emailsList) { …… }

if ("jane@example.com" !in emailsList) { …… }

字符串内插

println("Name $name")

类型判断

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

遍历 map/pair型list

for ((k, v) in map) {
    println("$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

延迟属性

val p: String by lazy {
    // 计算该字符串
}

扩展函数

fun String.spaceToCamelCase() { …… }

"Convert this to camelcase".spaceToCamelCase()

创建单例

object Resource {
    val name = "Name"
}

If not null 缩写

val files = File("Test").listFiles()

println(files?.size)

If not null and else 缩写

val files = File("Test").listFiles()

println(files?.size ?: "empty")

if null 执行一个语句

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

在可能会空的集合中取第一元素

val emails = …… // 可能会是空集合
val mainEmail = emails.firstOrNull() ?: ""

if not null 执行代码

val value = ……

value?.let {
    …… // 代码会执行到此处, 假如data不为null
}

映射可空值（如果非空的话）

val value = ……

val mapped = value?.let { transformValue(it) } ?: defaultValueIfValueIsNull

返回 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)
    }

    // 使用 result
}

“if”表达式

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

返回类型为 Unit 的方法的 Builder 风格用法

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) { // 画一个 100 像素的正方形
    penDown()
    for(i in 1..4) {
        forward(100.0)
        turn(90.0)
    }
    penUp()
}

使用可空布尔

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

交换两个变量

var a = 1
var b = 2
a = b.also { b = a }

冒号
在以下场景中的 : 之前留一个空格

• 当它用于分隔类型与超类型时；
• 当委托给一个超类的构造函数或者同一类的另一个构造函数时；
• 在 object 关键字之后。

而当分隔声明与其类型时，不要在 : 之前留空格。
在 : 之后总要留一个空格。

abstract class Foo<out T : Any> : IFoo {
    abstract fun foo(a: Int): T
}

class FooImpl : Foo() {
    constructor(x: String) : this(x) { …… }
    
    val x = object : IFoo { …… }
}

修饰符
如果一个声明有多个修饰符，请始终按照以下顺序安放：

public / protected / private / internal
expect / actual
final / open / abstract / sealed / const
external
override
lateinit
tailrec
vararg
suspend
inner
enum / annotation
companion
inline
infix
operator
data

将所有注解放在修饰符前：

@Named("Foo")
private val foo: Foo

注解格式化
注解通常放在单独的行上，在它们所依附的声明之前，并使用相同的缩进：

@Target(AnnotationTarget.PROPERTY)
annotation class JsonExclude

无参数的注解可以放在同一行：

@JsonExclude @JvmField
var x: String

无参数的单个注解可以与相应的声明放在同一行：

@Test fun foo() { …… }

对于由单个表达式构成的函数体，优先使用表达式形式。

fun foo(): Int {     // 不良
    return 1 
}
​
fun foo() = 1        // 良好

属性格式化
对于非常简单的只读属性，请考虑单行格式：

val isEmpty: Boolean get() = size == 0

将短分支放在与条件相同的行上，无需花括号。

when (foo) {
    true -> bar() // 良好
    false -> { baz() } // 不良
}