simbot-api/love.forte.simbot.application/Application

Application

interface Application : CoroutineScope

Simple Robot 的应用.

一个 simbot应用代表了已经配置完毕的运行时作用域，此作用域内包含了有关事件处理、事件推送的相关内容.

每个 Application 中，应当包括一个事件处理器、一些 bot管理器和一些注册的组件。

Author

ForteScarlet

Types

interface Environment

当前应用的组件环境内容。

Functions

abstract suspend fun join()

挂起此应用直至其被终止。

abstract suspend fun shutdown(reason: Throwable? = null)

终止当前应用，并关闭其中所有可能的资源。

shutdownBlocking

open fun shutdownBlocking()

终止当前应用，并关闭其中所有可能的资源。

Properties

abstract val botManagers: BotManagers

当前应用下的所有 bot管理器。

abstract val configuration: ApplicationConfiguration

在进行构建时所使用的配置信息。构建完成后可以得到，但是尽可能不要进行修改操作。这可能没有意义，也可能会导致意外的错误。

coroutineContext

abstract val coroutineContext: CoroutineContext

abstract val environment: Application.Environment

当前 Application 的环境属性。

eventListenerManager

abstract val eventListenerManager: EventListenerManager

得到当前 Application 最终的 EventListenerManager.

abstract val providers: List<EventProvider>

当前应用下的所有事件提供者。

Extensions

applicationLauncher

fun <A : Application> CoroutineScope.applicationLauncher(create: suspend () -> A): ApplicationLauncher<A>

通过一个协程作用域并提供构建函数来得到一个 ApplicationLauncher 实例。

inline fun Application.bots(block: BotManagers.() -> Unit)

使用 Application.botManagers.

effectedFlowItems

inline fun <T> CoroutineScope.effectedFlowItems(crossinline block: suspend FlowCollector<T>.() -> Unit): Items<T>

以构建 Flow 的方式构建 Items.

effectedItemsByFlow

inline fun <T> CoroutineScope.effectedItemsByFlow(crossinline flowFactory: () -> Flow<T>): Items<T>

提供 CoroutineScope 和构建 Flow 的函数 flowFactory 来构建 Items.

inline fun <T> CoroutineScope.flowItems(crossinline block: suspend FlowCollector<T>.(Items.PreprocessingProperties) -> Unit): Items<T>

以构建 Flow 的方式构建 Items.

inline fun <T> CoroutineScope.itemsByFlow(crossinline flowFactory: (Items.PreprocessingProperties) -> Flow<T>): Items<T>

提供 CoroutineScope 和构建 Flow 的函数 flowFactory 来构建 Items.

fun <T> CoroutineScope.lazyValue(init: Boolean = false, initializer: suspend () -> T): LazyValue<T>

inline fun <T> CoroutineScope.produceItems(context: CoroutineContext = EmptyCoroutineContext, capacity: Int = 0, crossinline block: suspend ProducerScope<T>.(Items.PreprocessingProperties) -> Unit): Items<T>

通过 produce 构建 ChannelIterator 来得到一个 Items 实例。