我自己留着看的 Kotlin 速查表

val str: String? = "ABC"
str.length // ERROR
str?.length // OK

val str: String? = "ABC"
str?.length ?: 0 // str.length 或 0 
str?.length ?: throw IllegalArgumentException("null이 들어왔습니다.") // 或抛出异常
str?.length ?: return 0 // 也可用于 Early return

// 有 @Nullable、@NonNull 时会被转换，没有时则是平台类型
// 在 java 中 
private final String name; << 没有 Annotation 时

val name : String? = javaPerson.name // OK
val name : String = javaPerson.name  // OK

val number1 : Int = 4
val number2 : Long = number1.toLong()

val number1 : Int? = 3 
val number2 : Long = number1?.toLong() ?: 0L // 如果是 nullable 变量则灵活处理

fun printAgeIfPerson(obj: Any){
	// is = Java 的 instanceof
	if(obj is Person){
			// 经过智能转换，obj 的 type 变为 Person
			println(obj.age)
	}
}

// 或者
// 等同于 java 的 (Person) obj
val person = obj as Person

// !is、as? 等也可以使用
// as?：整体为 null

fun fail(message : String): Nothing{
	throw IllegalArgumentException(message)
}

val person = Person(name = "lemon", age = 20)
val log = "이름 : ${person.name}, 나이 : ${person.age}"

val str = "ABC"
// 取代 Java 中的 str.get(0)
str[1] //ok

val numbers = 1..100 // 创建从 1 到 100 的 IntRange 对象
println(1 in numbers) // true
println(0 in numbers) // false

// 以下两个表达式相同
if(0 <= score && score <= 100) {..}
if(score in 0..100)

data class Money(val amount : Long){
	
	operator fun plus(other : Money): Money{
		return Money(this.amount + other.amount)
	}
}

// 可以像下面这样使用
val sumMoney = money1 + money2

// 在 Java 中不可行，但在 Kotlin 中 if 是 expression 所以 OK 
fun getPassOrFail(score : Int): String{
	return if (score >= 50){ "P" } else { "F" }
}

// 基础用法，代替 Switch
fun getGradeWithSwitch(score: Int): String{
	return when(score / 10){
		9 -> "A"
		8 -> "B"
		7 -> "C"
		else -> "D"
	}
}

// 左侧也可以使用 expression，is Type 等也可以使用
when(score){
in 90..99 -> "A"
in 80..89 -> "B"
...

// 同时检查多个条件
when (number){
1,0,-1 -> println("1,0,-1입니다")
else -> println("아닙니다")
}

// 像条件语句一样使用
fun printOdd(score: Int): Int{
	when{
		score % 2 == 1 -> println("홀수")
		score % 2 == 0 -> println("짝수")
		else -> println("넌머임")
	}
	return 1
}

val numbers = listOf(1L, 2L, 3L)
for (number in numbers){
	println(number)
}

val intRange = 1..100

// JAVA 的 try with resources
// try 结束后会自动关闭。但必须是 AutoCloseable 接口的实现类。 
public void readFile(String path) throws IOException{
	try(BufferedReader reader = new BufferedReader(new FileReader(path))){
		System.out.println(reader.readLine());
	}
}

// 在 Kotlin 中使用，use 的工作方式类似于 try with resources
fun readFile(path: String){
	BufferedReader(FileReader(path)).use { reader ->
		println(reader.readLine())
	}
}

// 如果函数体仅由表达式（Expression）组成，可以使用 =
fun max(a: Int, b: Int) : Int = if(a > b) {a} else {b}

fun repeat(
	str : String,
	num : Int = 3,
	useNewLine : Boolean = true
){
	for(i in 1..num){
	if(useNewLine) { println(str)} else{ print(str) }
	}
}

repeat(str = "Hello, World", useNewLine = true)
// 这种情况下未指定 num，因此使用默认值（3）
// 不用创建 builder 也可以像 builder 一样使用

// Java
public void printAll(String... strings){
	for(String str : strings){
		System.out.println(str);	
	}
}
String[] array = new String[]{"Hello", "World", "!!"};
printAll(array)
printAll("Hello", "World", "!!")

// Kotlin
printAll(vararg strings : String){
	for (str in strings){
		println(str)
	}
}

val array = arrayOf("Hello", "World", "!!")
printAll(*array) // spread 运算符
printAll("Hello", "World", "!!")

class Person(
	val name:String,
	var age:Int
)

// 像访问属性一样访问 getter、setter
person.age = 10
println(person.age)

class Person(
	val name:String = "Patrick",
	var age:Int = 1
){
	init{
		if(age <= 0){
			throw IllegalArgumentException("나이는 ${age}일 수 없습니다.")
		}
	}
}

class Person(
	val name:String,
	var age:Int
){
	
	// 像 Property 一样使用，可以用单个 Expression 表示的内容用 = 表示
	val isAdult: Boolean
		get() = this.age >= 20
	
	// 与上面是相同的表达式
	fun isAdult(): Boolean{
		return this.age >= 20
	}
}

// 默认是 public class 
abstract class Animal(
	protected val species:String,
	protected val legCount:Int
){
	abstract fun move()
}

//Java
public class JavaPenguin extends JavaAnimal{
	
	// 子对象中新增的字段
	private final int wingCount;
	
	public JavaPenguin(String species){
		super(species, 2)
		this.wingCount = 2;
	}

	@Override
	public void move(){
		System.out.println("penguin is moving");
	}

	// 重写父类方法的 getter
	@Override
	public int getLegCount(){
		return super.legCount + this.wingCount;
	}
}

//Kotlin
class penguin(
	species : String // 主构造函数
) : Animal(species, 2) // 继承 Animal 并直接调用 Animal 的构造函数 {

	private val wingCount: Int = 2
	
	// 使用关键字代替 Annotation
	override fun move(){
		println("cat is moving")
	}

	override val legCount: Int
		get() = super.legCount + this.wingCount
}

// 但 Kotlin 默认所有类都加了 final 关键字，因此要 override 必须加 open
abstract class Animal(
	protected val species:String,
	protected open val legCount: Int
){
	abstract fun move()
}

// Java
public interface JavaSwimable{
	default void act(){System.out.println("swim!"); }
}
public interface JavaFlyable{
	default void act(){System.out.println("swim!"); }
}

// Kotlin
interface Swimable{
	// 不需要 default 关键字也可以实现
	fun act(){ println("swim!") } 
}
interface Flyable{
	fun act(){ println("fly!") }
}

// Java
public final class JavaPenguin extends JavaAnimal implements JavaFlyable, JavaSwimable{
	
	// 构造函数实现..（省略）
	
	@Override
	public void act(){
		JavaSwimable.super.act();
		JavaFlyable.super.act();
	}
}

// Kotlin
class Penguin(): Animal(species, 2), Swimable, Flyable{
	override fun act(){
		super<Swimable>.act()
		super<Flyable>.act()
	}
}

// Kotlin
interface Swimable{
	// 期望子类实现的 property
	val swimAbility: Int 
}

class Penguin(): Swimable{
	// 像下面这样实现
	override val swimAbility: Int
		get() = 3
}

open class Base(
	open val number : Int = 100
){
	init{
		println("Base Class")
		println(number)
	}
}

class Derived(
	override val number: Int
): Base(number){
	init{
		println("Derived class")
	}
}

// 实例化 Derived 类时的输出
/*
	Output : 
	Base Class
	0
	Derived Class 
*/

// 原因：在父类（Base）调用 number 时，会取子类的 Number。
// 但此时父类（Base）的 constructor 正在执行，子类（Derived）尚未初始化
// 因此输出 0

class Car(
	// 将 name 的 getter 设为 internal
	internal val name : String,
	var owner : String,
	_price : Int
){
	// 仅 Setter 设为 private
	var price = _price
		private set
}

//Java
public class JavaPerson{
    private static final int MIN_AGE = 1;

    // 静态工厂方法
    public static JavaPerson newBaby(String name){
        return new JavaPerson(name, MIN_AGE);
    }

    private String name;
    private int age;

    private JavaPerson(String name, int age){ this.name = name; this.age = age}
}

//Kotlin
class Person private constructor(
    var name : String,
    var age : Int,
){
		// 用 companion object 代替 Static
    companion object{
				// 有 const 时编译时分配，没有时运行时分配
				// 仅可分配于基本类型 + String
        const val MIN_AGE = 1
        fun newBaby(name: String): Person{
            return Person(name, MIN_AGE)
        }
    }
}

// 可通过 Person.Companion.newBaby("ABC") 调用，
// 或通过 @JvmStatic 注解像 Java Static 一样直接访问

/*
	@JvmStatic
	fun newBaby(name: String) : Person{...}

	之后
	可以使用 Person.newBaby("ABC")
*/

// Kotlin
interface Log{ fun log() }

class Person private constructor(
    var name : String,
    var age : Int,
){
		// 可以设置名称
    companion object Factory{
        const val MIN_AGE = 1
        fun newBaby(name: String): Person{
            return Person(name, MIN_AGE)
        }
				override fun log(){ println("I am companion object!") }
    }
}

// 如果有名称，可以基于名称访问
// Person.Factory.newBaby("ABC");

//Java
public class JavaSingleton{
	private static final JavaSingleton INSTANCE = new JavaSingleton();
	private JavaSingleton(){}

	public static Javasingleton getInstance(){ return INSTANCE; }
}

//Kotlin
object Singleton{
	var a: Int = 0
}

// 之后可以像 Singleton.a 这样使用

// Java
private static void moveSomething(Movable movable){ movable.move(); movable.fly(); }

// 匿名类实现
moveSomething(new Movable(){
	@Override
	public void move(){System.out.println("move~");}
	@Override
	public void fly(){System.out.println("fly~");}
}

// Kotlin
private fun moveSomething(movable:Movable){ movable.move(); movable.fly();}

// 使用 Object 关键字实现匿名类
moveSomething(object : Movable{
	override fun move(){ println("move~") }
	override fun fly(){println("fly~")}
})

//Kotlin
data class PersonDto(val name: String, val age: Int)

// 使用命名参数效果等同于使用 Builder 模式
PersonDto(name="Patrick", age=20)

//Java
public enum JavaCountry{
	KOREA("KO"),
	AMERICA("US");

	private final String code;
	JavaCountry(String code) { this.code=code; }
	public String getCode() { return this.code; }
}

// Kotlin（等效代码）
enum class Country(
	private val code: String
){
	KOREA("KO"),
	AMERICA("US");
}

// 利用 When 子句方便地处理
// 此外，这样使用时如果 ENUM CLASS 增加新值，编译器会提醒
fun handleCountry(country: Country){
	when(country){
		Country.KOREA -> LOGIC()
		Country.AMERICA -> LOGIC()
		// 不写 ELSE 也能用！
	}
}

//Kotlin
sealed class Car(
	val name:String,
	val price:Long
)

class Avante: Car("Avante",1_000L)
class Sonata: Car("Sonata",2_000L)
class Grandeur: Car("Grandeur",3_000L)
// 像上面的 Enum class 一样可以使用 when 子句

/* 默认实现：ArrayList */
// 创建不可变 List
val numbers = listOf(100,200)
// 创建可变 List
val mutableNumbers = mutableListOf(100,200)
// 创建空 List
val emptyList = emptyList<Int>()

// 等同于 numbers.get(0)
numbers[0]

for(number in numbers){println(number)}
// 需要同时取得 Index 时
for((idx, number) in numbers.withIndex()){println("${idx}, ${number}")}

/* 默认实现：LinkedHashSet */
val numbers = setOf(100,200)

val weekMap= mutableMapOf<Int, String>()
// 可以像数组一样访问
weekMap[1] = "MONDAY"
weekMap[2] = "TUESDAY"

// 也可使用 to 进行初始化
mapOf(1 to "MONDAY", 2 to "TUESDAY")

for(key in weekMap.keys){println(key) println(weekMap[key]) }
for((key, value) in weekMap.entries){println(key) println(value)} 

// Kotlin

// 扩展 String 类
fun String.lastChar(){ return this[this.length - 1] }

// 之后在 Kotlin 中可像下面这样使用
val str = "ABC"
println(str.lastChar());

infix fun Int.add(other: Int): Int{
	return this + other
}

// 可以像下面这样调用
3 add 4

inline fun Int.add(other: Int): Int{

// Kotlin
fun createPerson(firstName: String, lastName:String): Person{
	if(firstName.isEmpty()){ throw IllegalArgumentException("에러!!")}
	if(lastName:String.isEmpty()){ throw IllegalArgumentException("에러!!")}
	return Person(firstName, lastName)
}

// 使用 Local 函数
fun createPerson(firstName: String, lastName:String): Person{
	// 函数中的函数
	fun validateName(name: String){if(name.isEmpty()){throw IllegalArgumentException("에러!!")}
	
	validateName(firstName)
	validateName(lastName)
	return Person(firstName, lastName)
}

// Kotlin

// 函数的 Type 也可以这样设置
val isApple : (Fruit) -> Boolean 
= fun(fruit: Fruit): Boolean {
	return fruit.name == "사과"
}

// 与上面完全相同的代码
val isApple2 = {fruit: Fruit -> fruit.name == "사과" }

val isApple3 = { fruit ->
println("사과만 받는 함수입니다.")
fruit.name == "사과" // 多行 lambda 中省略 return 时，最后一行会自动作为返回值
}

// 调用 lambda，相同代码
isApple(Fruit("사과", 1000))
// 显式调用
isApple.invoke(Fruit("사과", 1000))

// 写出函数 Type 即可接收函数
fun filterFruits(fruits: List<Fruit>, filterFunc : (Fruit) -> Boolean) : List<Fruit>{
	val results = mutableListOf<Fruit>()
	for(fruit in fruits){
		if(filterFunc(fruit)){ results.add(fruit)}
	}
	return results
}

// 调用时可像下面这样传递 lambda
filterFruits(fruit, {fruit -> fruit.name =="사과"} )

// 当 lambda 是最后一个参数时，可以像下面这样使用（与上面代码功能相同）
filterFruits(fruit) {fruit -> fruit.name =="사과"}

// 当只有一个参数时，可用 it 替代箭头前的部分
filterFruits(fruit) {it.name =="사과"}

//Java
String targetFruitName = "바나나"
targetFruitName = "수박"

// 在 Java 中 Lambda 中使用的变量必须是 final 变量， 
// 或虽未加 final 关键字但实际未变更（Effectively final）的变量
filterFruits(fruits, (fruit) -> targetFruitName.equals(fruit.getName())); // ERROR!

//Kotlin
var targetFruitName = "바나나"
targetFruitName = "수박"
filterFruits(fruits) { it.name == targetFruitName } // It Works!

// 仅取苹果
val apples = fruits.filter { fruit -> fruit.name == "사과" }

val apples = fruits.filterIndexed { idx, fruit -> 
println(idx)
fruit.name == "사과"
} 

val values = fruits.filter { it.name == "사과" }
	.mapNotNull { it.nullOrValue() } // 只取非 null 的值

// 检查是否全部为苹果
val isAllApple = fruits.all { it.name == "사과" }

// 检查是否一个苹果都没有
val isNoApple = fruits.none { it.name =="사과" }

// 检查是否有任意一个超过一万韩元的水果
val hasExpensiveFruit = fruits.any { it.price > 10_000 }

// 等同于 Java 的 list.size()
val fruitCount = fruits.count()

val sortedFruit = fruit.sortedBy{it.price} // 升序
val desendSortedFruit = fruit.sortedByDescending{it.price} // 降序

// 检查存在哪些种类的水果
val distinctFruitNames = fruits.distinctBy{ it.name } // 按名称去重
	.map{it.name}

fruits.first()
fruits.lastOrNull()

// 以水果名称为 key 对列表内容分组
// key：사과（苹果），value：{사과1, 사과2, 사과3...}
val map: Map<String, List<Fruit>> = fruits.groupBy{fruit -> fruit.name } 

// 也可同时处理 key、value
// 以名称为 Key、价格 List 为 value 的示例
val map2 : Map<String, List<Long>> = fruits
	.groupBy({it.name}, {it.price})

val map: Map<Long, Fruit> = fruits.associateBy { fruit -> fruit.id }

val fruitList = listOf<Fruit>(
			// id 相同
      Fruit(1,"1"),
      Fruit(1,"2"),
      Fruit(1,"3"),
    )

  val associateBy = fruitList.associateBy { it.id }

  println(associateBy.count()) // 1
  for (entry in associateBy) {
      println(entry) // 1=Fruit(id=1, name=3)
  }

// 同样可以同时处理 key、value
val map: Map<Long, Long> = fruits
	.associateBy({it.id}, {it.price})

val map: Map<String, List<Fruit>> = fruits.groupBy{fruit -> fruit.name } 
	.filter { (key, value) -> key == "사과" } 

var fruitsInList: List<List<Fruit>> = listOf(
	listOf(Fruit(1,"사과"), Fruit(2,"수박"), Fruit(3,"사과")),
	listOf(Fruit(4,"바나나"), Fruit(5,"사과"), Fruit(6,"바나나")),
)

// 不论列表结构，将所有苹果取出来
// output：listOf(Fruit(1,"사과"), Fruit(3,"사과"), Fruit(5,"사과"))
val appleList : List<Fruit>
	= fruitsInList.flatMap { list -> list.filter{it.name == "사과"}

// 将二维列表展平为一维
val flattenList : List<Fruit>
	= fruitsInList.flatten();

// 这个函数
fun getFruitOrNull(fruit: Fruit): Fruit?{
	return if(fruit.name == "사과"){fruit} else {null}
}
// 可以这样使用
val getfruit = fruit.takeIf { it.name == "사과" }
Fruit(1L, "사과") // 这种情况返回 fruit
Fruit(1L, "바나나") // 这种情况返回 null

// 以下两个函数相同
fun printPerson(person: Person?){
	if(person != null){
		println(person.name)
		println(person.age)
	}
}

fun printPerson(person: Person?){
	person?.let{
		println(person.name)
		println(person.age)
	}
}

val value1 = person.let{ it.age }  // value1 的值：person.age
// 可以像 person.let{ person -> person.age } 一样另起名称
val value2 = person.run{ this.age } // value2 的值：person.age
// 可以像 person.run{ age } 一样省略 this

val value3 = person.also{ it.age } // value3 的值：person
val value4 = person.apply{ this.age } // value4 的值：person 

with(person){
	println(name)
	println(age)
}

/* 
使用 it 的情况：以普通函数为参数 block : (T) -> R : R
使用 this 的情况：以扩展函数为参数 block: T.() -> R : R
有兴趣的话直接看实现吧....
*/