kotlin源碼結構層次詳解

Posted on by

協程源碼的結構

在研究Kotlin源碼之前，得先搞懂Kotlin源碼結構分佈。不然找不到該看哪裡的代碼。看源碼之前當然先得有一個目標，最好是帶著這個目標去看源碼才比較有針對性，抓主流程，不然可能會陷入浩瀚的源碼細節中。

協程源碼，按道理可以分成2個倉庫，一個是Kotlin倉庫，一個是Kotlin協程倉庫。

  • Kotlin倉庫 https://github.com/JetBrains/kotlin
  • 協程倉庫 kotlinx.coroutines https://github.com/Kotlin/kotlinx.coroutines

Kotlin倉庫中定義瞭協程的基礎元素，這些基礎元素非常關鍵，它們是構建協程的基礎。而協程倉庫相當於是用Kotlin倉庫中定義的基礎元素來實現協程的邏輯。

Kotlin協程源碼分為3層：

  • 基礎層：Kotlin庫中定義的協程基礎元素。比如CancellationException、CombinedContext、Continuation、ContinuationInterceptor、CoroutineContext、SafeContinuation等。
  • 中間層：協程倉庫中，協程框架的通用邏輯kotlinx.coroutine-common。比如Job、Deferred、Select、Channel、Flow。
  • 平臺層：協程倉庫中，協程在特定平臺的實現。如JVM、JS、Native。

下面，我們來詳細瞭解一下這些層是怎麼分佈的。

基礎層

Kotlin庫中，協程的基礎層具體位置是在/kotlin/libraries/stdlib/src/kotlin/coroutines/裡面。官方把這些基礎元素放標準庫裡面，是為瞭解耦。

  • 通過這些基礎元素可以組合成各種協程框架，雖然目前是官方的協程框架組合的最好。
  • 在基礎層定義好瞭API之後，協程庫在各自的平臺層才好有規可循，在這些API下面開發平臺相關的代碼。

中間層

在kotlin.coroutines庫中的/kotlinx.coroutines/kotlinx-coroutines-core/common/子模塊下，是一些公共的邏輯。比如launch、async、withContext、Deferred、Job、NonCancellable、Channel、Flow、AbstractCoroutine，這些東西是對基礎層的元素進行的封裝，使上手協程更容易。

在這些公共邏輯的源碼裡，是不涉及平臺相關的邏輯的。

平臺層

因為Kotlin是跨平臺的，所以它的平臺相關的邏輯又分為瞭js、jvm、native，它們的目錄與common平級，分別是：

js：kotlinx-coroutines-core/js/

jvm：kotlinx-coroutines-core/jvm/

native：kotlinx-coroutines-core/native/

我們重點關註一下jvm的就行，下面是jvm目錄下的代碼，其他平臺也需要實現其自己的線程池、事件循環、異步任務等。

.
├── AbstractTimeSource.kt
├── Builders.kt
├── CoroutineContext.kt
├── CoroutineExceptionHandlerImpl.kt
├── Debug.kt
├── DebugStrings.kt
├── DefaultExecutor.kt
├── Dispatchers.kt
├── EventLoop.kt    //事件循環
├── Exceptions.kt
├── Executors.kt
├── Future.kt     
├── Interruptible.kt
├── Runnable.kt    //java.lang.Runnable
├── SchedulerTask.kt
├── ThreadContextElement.kt     //線程池
├── ThreadPoolDispatcher.kt
├── channels
│   ├── Actor.kt
│   └── TickerChannels.kt
├── debug
│   ├── AgentPremain.kt
│   └── internal
│       ├── AgentInstallationType.kt
│       ├── ConcurrentWeakMap.kt
│       ├── DebugCoroutineInfo.kt
│       ├── DebugCoroutineInfoImpl.kt
│       ├── DebugProbes.kt
│       ├── DebugProbesImpl.kt
│       ├── DebuggerInfo.kt
│       └── StackTraceFrame.kt
├── flow
│   └── internal
│       ├── FlowExceptions.kt
│       └── SafeCollector.kt
├── internal
│   ├── Concurrent.kt
│   ├── ExceptionsConstructor.kt
│   ├── FastServiceLoader.kt
│   ├── InternalAnnotations.kt
│   ├── LocalAtomics.kt
│   ├── MainDispatchers.kt
│   ├── ProbesSupport.kt
│   ├── ResizableAtomicArray.kt
│   ├── StackTraceRecovery.kt
│   ├── Synchronized.kt
│   ├── SystemProps.kt
│   ├── ThreadContext.kt
│   └── ThreadLocal.kt   //java.lang.ThreadLocal
└── scheduling
    ├── CoroutineScheduler.kt
    ├── Deprecated.kt
    ├── Dispatcher.kt
    ├── Tasks.kt
    └── WorkQueue.kt

以上就是kotlin源碼結構層次詳解的詳細內容，更多關於kotlin源碼結構的資料請關註WalkonNet其它相關文章！

推薦閱讀：