3.1 包（package）

我们先来举个例子。比如说，程序员A写了一个类叫 JSON , 程序员B也写了一个类叫 JSON。然后，我们在写代码的时候，想要同时使用这两个类，该怎么区分呢？

一个答案是使用目录命名空间。对应在Java中，就是使用package来组织类，以确保类名的唯一性。上面说的例子，A写的类放到package com.abc.fastjson 中, B写的类就放到 package com.bbc.jackjson中。这样我们在代码中，就可以根据命名空间来分别使用这两个类。调用示例如下

1. com.abc.fastjson.JSON.toJSONString()
2. com.bbc.jackjson.JSON.parseJSONObject()

在Kotlin中也沿袭了Java的 package 这个概念，同时做了一些扩展。

我们可以在*.kt文件开头声明package命名空间。例如在PackageDemo.kt源代码中，我们按照如下方式声明包

1. package com.easy.kotlin

3. fun what(){
4. println("This is WHAT ?")
5. }

7. class Motorbike{
8. fun drive(){
9. println("Drive The Motorbike ...")
10. }
11. }

13. fun main(args:Array<String>){
14. println("Hello,World!")
15. }

包的声明处于源文件顶部。这里，我们声明了包 com.easy.kotlin , 里面定义了包级函数 what() , 同时定义了一个类 Motorbike 。另外，目录与包的结构无需匹配：源代码可以在文件系统的任意位置。

我们怎么使用这些类和函数呢？我们写一个Junit 测试类来示例说明。

首先，我们使用标准Gradle工程目录，对应的测试代码放在test目录下。具体目录结构如下

Kotlin极简教程

我们在测试源代码目录 src/test/kotlin下面新建一个包，跟src/main/kotlin在同一个 package com.easy.kotlin。然后，在此包下面新建一个测试类PackageDemoTest

1. package com.easy.kotlin

3. import org.junit.Test
4. import org.junit.runner.RunWith
5. import org.junit.runners.JUnit4

7. @RunWith(JUnit4::class)
8. class PackageDemoTest {

10. @Test
11. fun testWhat() {
12. what()
13. }

15. @Test
16. fun testDriveMotorbike(){
17. val motorbike = Motorbike()
18. motorbike.drive()
19. }
20. }

其中，what() 函数跟PackageDemoTest类在同一个包命名空间下，可以直接调用，不需要 import。Motorbike类跟PackageDemoTest类也是同理分析。

如果不在同一个package下面，我们就需要import对应的类和函数。例如，我们在 src/test/kotlin目录下新建一个package com.easy.kotlin.test, 使用package com.easy.kotlin 下面的类和函数，示例如下

1. package com.easy.kotlin.test

3. import com.easy.kotlin.Motorbike
4. import com.easy.kotlin.what
5. import org.junit.Test
6. import org.junit.runner.RunWith
7. import org.junit.runners.JUnit4

9. @RunWith(JUnit4::class)
10. class PackageDemoTest {

12. @Test
13. fun testWhat() {
14. what()
15. }

17. @Test
18. fun testDriveMotorbike() {
19. val motorbike = Motorbike()
20. motorbike.drive()
21. }
22. }

我们使用import com.easy.kotlin.Motorbike导入类，直接使用import com.easy.kotlin.what导入包级函数。

上面我们使用JUnit4测试框架。在build.gradle中的依赖是

1. testCompile group: 'junit', name: 'junit', version: '4.12'

右击测试类，点击执行

Kotlin极简教程

运行结果

Kotlin极简教程

另外，如果我们不定义package命令空间，则默认在根级目录。例如直接在src/main/kotlin 源代码目录下面新建 DefaultPackageDemo.kt 类

1. import java.util.*

3. fun now() {
4. println("Now Date is: " + Date())
5. }

7. class Car{
8. fun drive(){
9. println("Drive The Car ... ")
10. }
11. }

如果，我们同样在src/test/kotlin 目录下面新建测试类DefaultPackageDemoTest

1. import org.junit.Test
2. import org.junit.runner.RunWith
3. import org.junit.runners.JUnit4

5. @RunWith(JUnit4::class)
6. class DefaultPackageDemoTest {

8. @Test
9. fun testDefaultPackage() {
10. now()
11. val car = Car()
12. car.drive()
13. }

15. }

我们不需要import now() 函数和 Car类，可以直接调用。如果我们在 src/test/kotlin/com/easy/kotlin/PackageDemoTest.kt 测试类里面调用now() 函数和 Car类， 我们按照下面的方式import

1. import now
2. import Car

PackageDemoTest.kt完整测试代码如下

1. package com.easy.kotlin

3. import now
4. import Car
5. import org.junit.Test
6. import org.junit.runner.RunWith
7. import org.junit.runners.JUnit4

9. @RunWith(JUnit4::class)
10. class PackageDemoTest {

12. @Test
13. fun testWhat() {
14. what()
15. }

17. @Test
18. fun testDriveMotorbike(){
19. val motorbike = Motorbike()
20. motorbike.drive()
21. }

23. @Test
24. fun testDefaultPackage() {
25. now()
26. val car = Car()
27. car.drive()
28. }
29. }

另外， Kotlin会默认导入一些基础包到每个 Kotlin 文件中：

  • kotlin.*
  • kotlin.annotation.*
  • kotlin.collections.*
  • kotlin.comparisons.* （自 1.1 起）
  • kotlin.io.*
  • kotlin.ranges.*
  • kotlin.sequences.*
  • kotlin.text.*

根据目标平台还会导入额外的包：

JVM:

  • java.lang.*
  • kotlin.jvm.*

JS:

  • kotlin.js.*

本小节示例工程源代码：<https://github.com/EasyKotlin/chapter3_kotlin_basics/tree/package_demo>