
# Spring との違い

`spring_boot_starter_logging` は、Logback を使う Spring Boot のロギングに従っています。同じ `logging.*` プロパティ、同じデフォルトの行、Logback のパターン構文です。このページでは、そうでない箇所とその理由を列挙します。

## 使う理由

Dart には Logback も SLF4J も、呼び出し元のデータも、タイムゾーンデータベースもありません。スターターはアプリケーションから見えるもの (行、プロパティ) を再現し、JVM に依存するものは除いています。

## 例

名前が変わった一つのキーを除いて、そのまま動く Spring Boot の設定:

```properties
logging.level.root=info
logging.level.neon.checkout=debug
logging.pattern.console=%d{HH:mm:ss.SSS} %clr(%5p) [%logger{20}] %m%n
logging.file.name=logs/shop.log
# Spring Boot: logging.logback.rollingpolicy.max-file-size=10MB
logging.file.rolling-policy.max-file-size=10MB
```

## 設定

| Spring Boot | ここでは | 理由 |
|---|---|---|
| `logging.logback.rollingpolicy.*` | `logging.file.rolling-policy.*`。古い名前は起動を止め、新しい名前を示す | Logback がない |
| `logback.xml`、`logback-spring.xml`、`logging.config` | 対応しない。アペンダーはコードで追加する | XML の設定がない |
| `logging.structured.*` | 対応しない | |
| `spring.output.ansi.enabled` のデフォルトは `detect` | デフォルトは `always` (iOS では `never`。そのログはコードをテキストとして表示する) | Flutter のツールは色を表示する |
| ロギングシステムの開始前にログに出された行は、失われるか素のまま出力される | ファイル、バッファー、追加したアペンダーに再生される (Spring Boot の `DeferredLogs`)。コンソールはすでに表示している | |

## パターン

| Spring Boot | ここでは | 理由 |
|---|---|---|
| パターンの最後の `%n` が行を終える | レコードごとに 1 行: コンソールとファイルが改行を追加するため、最後の `%n` は取り除かれる | `print` が改行を追加する |
| `%thread` はスレッド | Isolate の名前 (`main`、`isolate-2`) | Dart にはスレッドではなく Isolate がある |
| `%X` は `k=v, k=v` を出力する | 先頭に空白を付けた ` {k=v, ...}`。フィールドがなければ何も出さない | メッセージの後で読みやすい |
| `%C`、`%M`、`%L`、`%F`、`%caller` | 不明なワードとして起動を止める | Dart のレコードは、どこでログに出されたかを知らない |
| `%marker`、`%contextName` | 対応しない | |
| 任意のタイムゾーンの `%d` | UTC のみ | タイムゾーンデータベースがない |
| `%kvp` は SLF4J のキーと値のペアを出力する | レコードのフィールドを出力する | Dart には SLF4J がない |
| `%prefix`、`%property` | `%prefix` は変換を Logback の長い名前で示す。`%property` はパターン変数を読み、次に Environment を読む | |
| 色のないパターンは素のまま | 何も色付けしないコンソールのパターンには Spring Boot の色が付く (時刻は薄く、レベルはレベルに応じて、ロガーはシアン) | |

## ファイル

| Spring Boot | ここでは |
|---|---|
| 日付とサイズで `file-name-pattern` (日付、`%i`、`.gz`) にロールオーバーする | サイズだけで、番号付きのファイル (`shop.log.1`、`.2`) に。`file-name-pattern` は警告とともに無視される |
| `max-history` は日数を数える | ファイルの数を数える |
| アーカイブは圧縮できる | 圧縮されない |
| `logging.charset.file` に任意の Java の文字セット | UTF-8、ISO-8859-1、US-ASCII。エンコードできない文字は、Java と同じく `?` になる |
| `logging.charset.console` はコンソールの文字セットを設定する | チェックされるだけ: コンソールはテキストを書く `print` |
| 空のパターン: Logback はステータスエラーを報告する | 空の `logging.pattern.console=` や `logging.pattern.file=` はその出力を無効にする |
| どの JVM でもファイル | Web では使えない: `logging.file.*` は警告とともに無視される |

## グループとレベル

定義済みの `web` と `sql` のグループがあります (`spring.web`、`spring.websocket`。`spring.jdbc.core.JdbcTemplate`、`spring.jdbc.core.StatementCreatorUtils`)。ロガー名は Dart の名前なので、`logging.level.org.springframework` には効果がありません。

## ここだけのもの

- アプリ内のログ画面のための `LogBuffer` と `LogQuery`。
- `logging.buffer.*` と `logging.threshold.buffer`。
- Flutter アプリの書き込み可能なディレクトリのための `LoggingSystem.fileDirectory`。

## 関連項目

- [spring_boot_starter_logging](index.md)
- [すべてのプロパティ](properties.md)
- [spring_boot_dart の違い](../spring-boot-dart/differences.md)
