spring_boot_starter_logging

spring_boot_starter_logging は Spring for Dart のロギングのバックエンドで、spring-boot-starter-logging に当たる Dart のものです。追加すると、SpringLog の行が Spring Boot の形式で出力されます。設定には Spring Boot のアプリケーションと同じ logging.* プロパティと、Logback のパターン構文を使います。

コードは不要です。ジェネレーターがスターターを見つけ、アプリケーションの起動時に SpringLog の背後に LoggingSystem がインストールされます。他のスターター (Web、Feign、WebSocket、スケジューリング、キャッシュ) はこれを一緒に持ち込みます。

使う理由

spring_core_dart のロガーである SpringLog は、単独ではコンソールに素の行を出力するだけです。アプリケーションには、たいていもっと多くのものが必要です。

スターターはこれらすべてを Spring Boot のプロパティ名で提供するため、Spring Boot の設定がそのまま動きます。

セットアップ

# pubspec.yaml
dependencies:
  spring_boot_starter_logging: ^0.9.0

生成される springApplication がその自動構成を列挙するよう、追加した後に dart run build_runner build を再実行してください。

例

// lib/checkout.dart
import 'package:spring_boot_dart/spring_boot_dart.dart';

import 'spring_gen/app.spring.dart'; // スキャンの生成ファイルが log ゲッターを持つ

@Service()
@Log(topic: 'neon.checkout') // ロガーの名前。topic がなければ <package>.<Class>
class Checkout {
  // 注文はフィールドとして渡す: 検索でき、メッセージの後に出力される。
  void pay(int order, double amount) =>
      log.info('paid $amount', fields: {'order': order});
}
# lib/resources/application.yml
spring:
  application:
    name: shop
logging:
  level:
    root: info
    neon.checkout: debug
  file:
    name: logs/shop.log

Spring Boot の形式でのコンソールの行:

2026-10-23T21:08:01.580Z  INFO 4711 --- [shop] [           main] neon.checkout                            : paid 12.5 {order=1}

同じ行が色なしで logs/shop.log に書かれます。生成ファイルが手元にない場所 (ライブラリ、スクリプト、トップレベルの関数) では、ロガーを自分で作ります: const log = SpringLog('neon.checkout');。

起動するもの

自動構成 (springBootStarterLoggingAutoConfiguration) は、logging.enabled=false でない限り、3 つの Bean を追加します。

Bean 内容
loggingSystemInitializer logging.* プロパティから LoggingSystem.instance を構成し、どのアプリケーションの Bean も生成される前にインストールする。コンテキストが閉じるとアンインストールする
loggingSystem 実行時にレベルを変えたりアペンダーを追加したりするための LoggingSystem.instance
logBuffer ログ画面のための、メモリ上の LogBuffer

レベル (logging.level.*、logging.group.*) は、このスターターの有無にかかわらず、spring_boot_dart 自身が適用します。スターターは出力を追加します。ログレベル を参照してください。

起動中、システムが設定される前にログに出された行は、Spring Boot の DeferredLogs と同じく、ファイル、バッファー、追加したアペンダーに再生されます。起動が失敗した場合は、失敗レポートがログに出されるまでシステムはインストールされたままなので、レポートもファイルに届きます。

内容

Spring (Java) との対応

@Slf4j(topic = "neon.checkout")   // Lombok
@Service
class Checkout {
  void pay(int order, double amount) {
    log.info("paid {}", amount);
  }
}
logging.level.neon.checkout=debug
logging.file.name=logs/shop.log
logging.logback.rollingpolicy.max-file-size=10MB

重要な違い:

関連項目