Kotlin 生態系統入門

// Kotlin 強調簡潔性、安全性和互操作性
fun main() {
    println("Kotlin: 簡潔、安全、互操作")
    
    // 預設空安全
    var name: String = "Kotlin"
    // name = null  // 這會導致編譯時錯誤
    
    // 可空類型是顯式的
    var nullableName: String? = "Kotlin"
    nullableName = null  // 這是允許的
}

# JavaScript 環境驗證
node --version
npm --version

# Kotlin 環境驗證
kotlin --version
java --version
gradle --version

// package.json (JavaScript)
{
  "name": "my-project",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.2",
    "axios": "^1.6.0"
  },
  "devDependencies": {
    "jest": "^29.7.0",
    "eslint": "^8.55.0"
  },
  "scripts": {
    "start": "node index.js",
    "test": "jest"
  }
}

// build.gradle.kts (Kotlin)
plugins {
    kotlin("jvm") version "1.9.0"
    application
}

group = "com.example"
version = "1.0.0"

repositories {
    mavenCentral()
}

dependencies {
    implementation("org.jetbrains.kotlin:kotlin-stdlib")
    implementation("com.squareup.okhttp3:okhttp:4.11.0")
    testImplementation("org.jetbrains.kotlin:kotlin-test")
    testImplementation("org.jetbrains.kotlin:kotlin-test-junit")
}

application {
    mainClass.set("MainKt")
}

# JavaScript 專案初始化
npm init -y
npm install express axios
npm install --save-dev jest eslint

# Kotlin 專案初始化
gradle init --type kotlin-application
# 依賴在 build.gradle.kts 中管理

# JavaScript 專案結構
my-js-project/
├── package.json           # 專案設定
├── node_modules/          # 依賴
├── src/
│   └── index.js
├── tests/
│   └── index.test.js
└── README.md

# Kotlin 專案結構
my-kotlin-project/
├── build.gradle.kts       # 建置設定
├── src/
│   ├── main/
│   │   └── kotlin/
│   │       └── Main.kt
│   └── test/
│       └── kotlin/
│           └── MainTest.kt
├── gradle/
│   └── wrapper/
├── gradlew               # Gradle 包裝器
└── README.md

# macOS
brew install openjdk@17

# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-17-jdk

# Windows
# 從 Oracle 下載或使用 Chocolatey
choco install openjdk17

# 使用 SDKMAN! (推薦)
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install kotlin

# 使用 Homebrew (macOS)
brew install kotlin

# 手動安裝
# 從 https://github.com/JetBrains/kotlin/releases 下載

# 從 https://www.jetbrains.com/idea/download/ 下載
# Community Edition 是免費的，對大多數開發足夠

kotlin --version
java --version
gradle --version

# 建立新的 Kotlin 專案
gradle init --type kotlin-application --dsl kotlin --project-name my-kotlin-app

# 進入專案
cd my-kotlin-app

# 建置專案
./gradlew build

# 執行應用
./gradlew run

fun main() {
    println("你好，Kotlin!")
    
    // 示範一些 Kotlin 特性
    val numbers = listOf(1, 2, 3, 4, 5)
    val doubled = numbers.map { it * 2 }
    println("翻倍的數字: $doubled")
    
    // 協程範例
    runBlocking {
        delay(1000)
        println("這會在 1 秒延遲後執行")
    }
}

import kotlin.test.*

class CalculatorTest {
    @Test
    fun testAddition() {
        val calculator = Calculator()
        assertEquals(4, calculator.add(2, 2))
    }
    
    @Test
    fun testCoroutine() = runTest {
        val result = async { 
            delay(100)
            "Hello"
        }.await()
        assertEquals("Hello", result)
    }
}

# 1. 建立新的 Kotlin 專案
gradle init --type kotlin-application --dsl kotlin --project-name my-first-kotlin-project

# 2. 進入專案
cd my-first-kotlin-project

# 3. 建置專案
./gradlew build

# 4. 執行應用
./gradlew run

// 建立檔案: src/main/kotlin/CoroutineExample.kt
import kotlinx.coroutines.*

fun main() = runBlocking {
    println("開始協程範例...")
    
    // 啟動多個協程
    val jobs = List(3) { index ->
        launch {
            delay(1000L * (index + 1))
            println("協程 $index 完成")
        }
    }
    
    // 等待所有協程完成
    jobs.forEach { it.join() }
    println("所有協程完成!")
}

// 建立檔案: src/main/kotlin/NullSafetyExample.kt
data class User(val name: String, val email: String?)

fun processUser(user: User?) {
    // 使用安全呼叫操作符
    val email = user?.email
    println("信箱: ${email ?: "未提供信箱"}")
    
    // 使用 let 進行安全操作
    user?.let { safeUser ->
        println("處理使用者: ${safeUser.name}")
    }
}

fun main() {
    val user1 = User("張三", "[email protected]")
    val user2 = User("李四", null)
    val user3: User? = null
    
    processUser(user1)
    processUser(user2)
    processUser(user3)
}