mirror of
https://github.com/Nanaloveyuki/BitLogger.git
synced 2026-07-24 00:42:18 +00:00
Nanaloveyuki
53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# Sink 组合 API
|
|
|
|
当预设输出不足以表达路由规则时，使用 typed `Logger::new(...)` 和 sink 组合函数。它们接收完整 `Record`，因此仍保留 level、target、message 与 fields。
|
|
|
|
## `Logger::new(...)`
|
|
|
|
```moonbit
|
|
pub fn Logger::new(
|
|
sink : S,
|
|
min_level~ : Level = Level::Info,
|
|
target~ : String = "",
|
|
) -> Logger[S]
|
|
```
|
|
|
|
从任意 `Sink` 实现创建 typed Logger。`min_level` 在任何 sink 写入前生效；`target` 是默认值，之后可由 `with_target(...)`、`child(...)` 或单次 `log(..., target=...)` 覆盖。
|
|
|
|
## `fanout_sink(...)`
|
|
|
|
```moonbit
|
|
pub fn fanout_sink(left : A, right : B) -> FanoutSink[A, B]
|
|
```
|
|
|
|
每条记录写入两个目的地，适合控制台加 JSON，或控制台加 callback。右侧获得独立记录副本，两个写入在记录值层面互不影响。
|
|
|
|
## `split_by_level(...)`
|
|
|
|
```moonbit
|
|
pub fn split_by_level(
|
|
left : A,
|
|
right : B,
|
|
min_level~ : Level = Level::Warn,
|
|
) -> SplitSink[A, B]
|
|
```
|
|
|
|
达到阈值的记录进入 `left`，低于阈值的记录进入 `right`。典型用法是把 warning/error 单独输出，而 info/debug 留在普通控制台。
|
|
|
|
## `callback_sink(...)`
|
|
|
|
```moonbit
|
|
pub fn callback_sink(
|
|
callback : (Record) -> Unit,
|
|
) -> CallbackSink
|
|
```
|
|
|
|
将完整结构化 `Record` 交给应用回调。适合测试、自定义桥接与集成；它不自动格式化记录。
|
|
|
|
## 英文原始 API
|
|
|
|
- [`Logger::new(...)`](../../api/logger-new.md)
|
|
- [`fanout_sink(...)`](../../api/fanout-sink.md)
|
|
- [`split_by_level(...)`](../../api/split-by-level.md)
|
|
- [`callback_sink(...)`](../../api/callback-sink.md)
|