// 繼承SendChannel接口和ReceiveChannel接口
public interface Channel<E> : SendChannel<E>, ReceiveChannel<E> {
    // 枚舉常量
    public companion object Factory {
        // Channel的容量為無限
        public const val UNLIMITED: Int = Int.MAX_VALUE
        // Channel的容量為0，沒有緩存
        public const val RENDEZVOUS: Int = 0
        // Channel的容量為1，溢出策略為DROP_OLDEST，
        // 后一個(gè)的數(shù)據(jù)會(huì)覆蓋前一個(gè)數(shù)據(jù)
        public const val CONFLATED: Int = -1
        // Channel的容量為默認(rèn)值CHANNEL_DEFAULT_CAPACITY，
        // 默認(rèn)溢出策略為SUSPEND，send方法會(huì)發(fā)生掛起
        // 當(dāng)容量策略為BUFFERED，而溢出策略不為SUSPEND時(shí)，Channel的容量為1
        public const val BUFFERED: Int = -2
        // 協(xié)程內(nèi)部使用的一個(gè)默認(rèn)枚舉值，不對(duì)外暴露
        internal const val OPTIONAL_CHANNEL = -3
        // 用于手動(dòng)配置容量策略為BUFFERED時(shí)的默認(rèn)值
        public const val DEFAULT_BUFFER_PROPERTY_NAME: String = "kotlinx.coroutines.channels.defaultBuffer"
        // 容量策略為BUFFERED時(shí)的默認(rèn)值
        // 默認(rèn)64，最小1，最大為Int.MAX_VALUE-1
        internal val CHANNEL_DEFAULT_CAPACITY = systemProp(DEFAULT_BUFFER_PROPERTY_NAME,
            64, 1, UNLIMITED - 1
        )
    }
}

public enum class BufferOverflow {
    // 當(dāng)容量已滿時(shí)，掛起調(diào)用send方法的協(xié)程
    SUSPEND,
    // 當(dāng)容量已滿時(shí)，刪除舊數(shù)據(jù)，將新的數(shù)據(jù)添加進(jìn)去，不掛起調(diào)用send方法的協(xié)程
    DROP_OLDEST,
    // 當(dāng)容量已滿時(shí)，忽略當(dāng)前要添加的數(shù)據(jù)，不掛起調(diào)用send方法的協(xié)程
    DROP_LATEST
}

@InternalCoroutinesApi
public interface FusibleFlow<T> : Flow<T> {
    // 用于流的融合
    public fun fuse(
        context: CoroutineContext = EmptyCoroutineContext,
        capacity: Int = Channel.OPTIONAL_CHANNEL,
        onBufferOverflow: BufferOverflow = BufferOverflow.SUSPEND
    ): Flow<T>
}

@InternalCoroutinesApi
public abstract class ChannelFlow<T>(
    // 上游流的上下文
    @JvmField public val context: CoroutineContext,
    // 上下游之間流的緩存容量
    @JvmField public val capacity: Int,
    // 溢出策略
    @JvmField public val onBufferOverflow: BufferOverflow
) : FusibleFlow<T> {
    ...
    public override fun fuse(context: CoroutineContext, capacity: Int, onBufferOverflow: BufferOverflow): Flow<T> {
        // CONFLATED是一個(gè)復(fù)合的類型，需要拆解成capacity = 0, onBufferOverflow = DROP_OLDEST
        assert { capacity != Channel.CONFLATED }
        // 計(jì)算融合后流的上下文
        val newContext = context + this.context
        // 用于保存融合后流的容量
        val newCapacity: Int
        // 用于保存融合后流的溢出策略
        val newOverflow: BufferOverflow
        // SUSPEND為默認(rèn)溢出策略，如果溢出策略不是默認(rèn)的策略
        if (onBufferOverflow != BufferOverflow.SUSPEND) {
            // 直接保存
            newCapacity = capacity
            newOverflow = onBufferOverflow
        } else { // 如果是默認(rèn)策略
            // 計(jì)算并保存新的容量
            newCapacity = when {
                // 如果之前的容量為默認(rèn)枚舉值，則使用新的
                this.capacity == Channel.OPTIONAL_CHANNEL -> capacity
                // 如果新的容量為默認(rèn)枚舉值，則使用原來的
                capacity == Channel.OPTIONAL_CHANNEL -> this.capacity
                // 如果原來的容量為默認(rèn)值CHANNEL_DEFAULT_CAPACITY，則使用新的
                this.capacity == Channel.BUFFERED -> capacity
                // 如果新的容量為默認(rèn)值CHANNEL_DEFAULT_CAPACITY，則使用原來的
                capacity == Channel.BUFFERED -> this.capacity
                // 如果不為默認(rèn)值或默認(rèn)枚舉值
                else -> {
                    // 檢查容量都是大于等于0的
                    assert { this.capacity >= 0 }
                    assert { capacity >= 0 }
                    // 將原來的容量和新的容量進(jìn)行相加
                    val sum = this.capacity + capacity
                    // 如果相加后大與等于0，則容量為相加后的結(jié)果，否則為無限
                    if (sum >= 0) sum else Channel.UNLIMITED
                }
            }
            // 保存溢出策略
            newOverflow = this.onBufferOverflow
        }
        // 如果融合的兩個(gè)流的上下文相同，容量相同，溢出策略也相同
        if (newContext == this.context && newCapacity == this.capacity && newOverflow == this.onBufferOverflow)
            // 則直接返回
            return this
        // 有變化則根據(jù)新計(jì)算出得參數(shù)，創(chuàng)建融合后的流
        return create(newContext, newCapacity, newOverflow)
    }
    // 由子類進(jìn)行重寫
    protected abstract fun create(context: CoroutineContext, capacity: Int, onBufferOverflow: BufferOverflow): ChannelFlow<T>
    ...
}