库和 API
为了充分利用 Kotlin,请使用现有的库和 API,这样您可以将更多时间花在编写代码上,减少重复造轮子的时间。
库分发了可简化常见任务的可重用代码。在库中,有将相关类、函数和实用工具进行分组的软件包与对象。库以一组函数、类或属性的形式公开 API(应用程序编程接口),供开发者在自己的代码中使用。
让我们来探索 Kotlin 的无限可能。
标准库
Kotlin 拥有一个标准库,提供基本类型、函数、集合与实用工具,使您的代码更加简洁且富有表现力。标准库的大部分内容(kotlin 软件包中的所有内容)都可直接在任何 Kotlin 文件中使用,无需显式导入:
fun main() {
val text = "emosewa si niltoK"
// 使用标准库中的 reversed() 函数
val reversedText = text.reversed()
// 使用标准库中的 print() 函数
print(reversedText)
// Kotlin is awesome
}但是,标准库的某些部分需要先导入才能在代码中使用。例如,如果您想使用标准库的时间度量功能,则需要导入 kotlin.time 软件包。
在文件顶部,添加 import 关键字,后跟您所需的软件包:
import kotlin.time.*星号 * 是一种通配符导入,它指示 Kotlin 导入该软件包内的所有内容。不能对伴生对象使用星号 *。相反,您需要显式声明要使用的伴生对象成员。
例如:
import kotlin.time.Duration
import kotlin.time.Duration.Companion.hours
import kotlin.time.Duration.Companion.minutes
fun main() {
val thirtyMinutes: Duration = 30.minutes
val halfHour: Duration = 0.5.hours
println(thirtyMinutes == halfHour)
// true
}此示例:
- 导入了
Duration类以及来自其伴生对象的hours和minutes扩展属性。 - 使用
minutes属性将30转换为时长为 30 分钟的Duration。 - 使用
hours属性将0.5转换为时长为 30 分钟的Duration。 - 检查这两个时长是否相等并打印结果。
构建前先搜索
在决定编写自己的代码之前,请先检查标准库,看看您要找的内容是否已经存在。以下是标准库已经为您提供了大量类、函数和属性的领域列表:
要详细了解标准库中的其他内容,请浏览其 API 参考。
Kotlin 库
标准库涵盖了许多常见的用例,但仍有一些场景并未涉及。幸运的是,Kotlin 团队以及广大的社区开发了丰富的库来补充标准库。例如,kotlinx-datetime 可以帮助您跨不同平台管理时间。
您可以在我们的搜索平台上找到实用的库。若要使用它们,您需要执行额外的步骤,例如添加依赖项或插件。每个库都有一个 GitHub 仓库,其中包含有关如何将其引入 Kotlin 项目的说明。
添加库之后,就可以导入其中的任何软件包。以下是一个导入 kotlinx-datetime 软件包以获取纽约当前时间的示例:
import kotlinx.datetime.*
fun main() {
val now = Clock.System.now() // 获取当前时刻
println("Current instant: $now")
val zone = TimeZone.of("America/New_York")
val localDateTime = now.toLocalDateTime(zone)
println("Local date-time in NY: $localDateTime")
}此示例:
- 导入了
kotlinx.datetime软件包。 - 使用
Clock.System.now()函数创建包含当前时间的Instant类实例,并将结果赋值给now变量。 - 打印当前时间。
- 使用
TimeZone.of()函数查找纽约的时区,并将结果赋值给zone变量。 - 在包含当前时间的实例上调用
.toLocalDateTime()函数,并将纽约时区作为实参传入。 - 将结果赋值给
localDateTime变量。 - 打印按纽约时区调整后的时间。
要更详细地探索此示例所使用的函数和类,请参阅 API 参考。
选择启用 API
库作者可能会将某些 API 标记为需要选择启用(opt-in)才能在代码中使用。当 API 仍处于开发阶段且将来可能会发生更改时,他们通常会这样做。如果您没有选择启用,将会看到如下警告或错误:
This declaration needs opt-in. Its usage should be marked with '@...' or '@OptIn(...)'要选择启用,请在写入 @OptIn 后跟圆括号,其中包含对该 API 进行分类的类名,并在其后追加双冒号 :: 和 class。
例如,标准库中的 uintArrayOf() 函数属于 @ExperimentalUnsignedTypes,如 API 参考中所示:
@ExperimentalUnsignedTypes
inline fun uintArrayOf(vararg elements: UInt): UIntArray在您的代码中,选择启用如下所示:
@OptIn(ExperimentalUnsignedTypes::class)以下示例选择启用了 uintArrayOf() 函数来创建无符号整数数组,并修改了其中的一个元素:
@OptIn(ExperimentalUnsignedTypes::class)
fun main() {
// 创建无符号整数数组
val unsignedArray: UIntArray = uintArrayOf(1u, 2u, 3u, 4u, 5u)
// 修改一个元素
unsignedArray[2] = 42u
println("Updated array: ${unsignedArray.joinToString()}")
// Updated array: 1, 2, 42, 4, 5
}这是选择启用的最简单方式,但还有其他方法。要了解更多信息,请参阅选择启用要求。
练习
计算复利
您正在开发一款金融应用程序,帮助用户计算其投资的未来价值。计算复利的公式为:
其中:
A是计息后累计的金额(本金 + 利息)。P是本金金额(初始投资)。r是年利率(小数形式)。n是每年复利的次数。t是投资时间(年)。
更新代码以:
- 从
kotlin.math软件包中导入必要的函数。 - 为
calculateCompoundInterest()函数添加函数体,以计算应用复利后的最终金额。
// 在此处编写代码
fun calculateCompoundInterest(P: Double, r: Double, n: Int, t: Int): Double {
// 在此处编写代码
}
fun main() {
val principal = 1000.0
val rate = 0.05
val timesCompounded = 4
val years = 5
val amount = calculateCompoundInterest(principal, rate, timesCompounded, years)
println("The accumulated amount is: $amount")
// The accumulated amount is: 1282.0372317085844
}参考解答 {...}
import kotlin.math.*
fun calculateCompoundInterest(P: Double, r: Double, n: Int, t: Int): Double {
return P * (1 + r / n).pow(n * t)
}
fun main() {
val principal = 1000.0
val rate = 0.05
val timesCompounded = 4
val years = 5
val amount = calculateCompoundInterest(principal, rate, timesCompounded, years)
println("The accumulated amount is: $amount")
// The accumulated amount is: 1282.0372317085844
}度量数据处理所花费的时间
您想要度量程序中执行多项数据处理任务所花费的时间。更新代码以添加来自 kotlin.time 软件包的正确导入语句和函数:
// 在此处编写代码
fun main() {
val timeTaken = /* 在此处编写代码 */ {
// 模拟一些数据处理
val data = List(1000) { it * 2 }
val filteredData = data.filter { it % 3 == 0 }
// 模拟处理过滤后的数据
val processedData = filteredData.map { it / 2 }
println("Processed data")
}
println("Time taken: $timeTaken") // e.g. 16 ms
}参考解答 {...}
import kotlin.time.measureTime
fun main() {
val timeTaken = measureTime {
// 模拟一些数据处理
val data = List(1000) { it * 2 }
val filteredData = data.filter { it % 3 == 0 }
// 模拟处理过滤后的数据
val processedData = filteredData.map { it / 2 }
println("Processed data")
}
println("Time taken: $timeTaken") // e.g. 16 ms
}选择启用实验性 API
最新发布的 Kotlin 版本中引入了标准库的新功能。您想试用一下,但它需要选择启用。该功能归属于 @ExperimentalStdlibApi。在您的代码中,该选择启用语句应该是什么样的?
参考解答 {...}
@OptIn(ExperimentalStdlibApi::class)下一步?
恭喜!您已完成了中级导览!您愿意分享您的体验反馈吗?
作为下一步,请查看我们关于热门 Kotlin 应用程序的教程:
