Android 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()、component2()……等等（參見數據類）

函數的默認參數

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/pair型list

for (( k , v ) in  map ) {

    println ( "$k -> $v" )

}

k、v可以改成任意名字。

使用區間

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 {

    // 計算該字符串

}

擴展函數

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 ()

}

Java 7 的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  < reified  T : Any >  Gson . fromJson ( json : JsonElement ): T  =  this . fromJson ( json , T :: class . java )

使用可空布爾

val  b : Boolean ?  =  ……

if ( b  ==  true ) {

    ……

} else {

    // `b` 是false 或者null

}

參考資料，google 繁體中文機器翻譯：https://kotlinlang.org/docs/reference/idioms.html