Spring との違い

spring_boot_dart は Spring Boot に従っています。アノテーションも、プロパティの名前も、起動の順序も同じです。このページでは、そうでない箇所をすべて、その理由とともにトピックごとに列挙します。

使う理由

違いのほとんどは、次の 3 つの事実から来ています。

例

両者での同じアプリケーション:

@SpringBootApplication()
void main(List<String> args) => runApplication(args);
@SpringBootApplication
public class NeonBooks {
  public static void main(String[] args) {
    SpringApplication.run(NeonBooks.class, args);
  }
}

起動

Spring Boot ここでは 理由
クラスに @SpringBootApplication。起動時にクラスパスをスキャンする main 関数に付ける。パッケージは build_runner がスキャンし、生成される springApplication が Bean とスターターを列挙する リフレクションがない
SpringApplication.run はランナーの後に戻る runApplication は同期部分の後に戻る。runApplicationAsync はランナーを待つ ランナーは非同期でありうる
META-INF/spring.factories の EnvironmentPostProcessor、FailureAnalyzer、リスナー SpringApplication のコンストラクターに渡す (アナライザーは Bean でもよい) スキャンするクラスパスがない
スターターの META-INF/spring.factories のそれ以外のエントリー。SpringFactoriesLoader.loadFactories(type, classLoader) で読む その @AutoConfigurationModule の factories にある定数。ジェネレーターが生成される springApplication にコピーする。SpringApplication.factories.load<T>() または springFactories Bean で読む。ファクトリー を参照 スキャンするクラスパスがない
Started app in 0.07 seconds (process running for 0.3) プロセスの稼働時間なし Dart にはプロセスの開始時刻がない
バナーは System.out に出力される。banner.txt の ${application.version}、${AnsiColor.*} print (またはログ)。${spring-boot.version}、${spring-boot.formatted-version}、Environment のプレースホルダー マニフェストのバージョンも ANSI のプロパティソースもない
spring.main.allow-circular-references=true 対応しない: 循環は常にエラー。@Lazy() か ObjectProvider を使う シングルトンの早期参照がない
起動の進捗のフックはない StartupProgress を使う SpringApplication.progressListener モバイルアプリのスプラッシュ画面

設定ファイルとロケーション

Spring Boot ここでは 理由
classpath: resources: (lib/resources/。ジェネレーターが埋め込む) クラスパスがない
.properties は ISO-8859-1 として読まれる UTF-8。ロケーションに [encoding=iso-8859-1]、または PropertiesPropertySourceLoader(encoding: latin1) Dart のファイルは UTF-8
エンコーディングのヒントに任意の Java の文字セット UTF-8、ISO-8859-1、US-ASCII のみ。それ以外は起動を失敗させる Dart のコーデック
YAML 1.1 (SnakeYAML) YAML 1.2: on、off、yes、no は文字列のまま (bool には変換できる)。0777 は 777 Dart チームの YAML パーサー
application.xml と .xml のインポート 読まれない。x.xml は起動を失敗させる Properties.loadFromXML がない
env: のインポート、classpath*: のロケーション 対応しない
#--- の直後のコメントはドキュメントを結合する ドキュメントは分かれたまま 書かれたとおりに読む
; のグループでは、空白は保たれ、空のエントリーはインポート元のディレクトリになる 空白は取り除かれ、空のエントリーはスキップされる
; のグループのリゾルバーは最初のエントリーから決まる 各エントリーはそれぞれのプレフィックスで読まれる
ワイルドカードで見つかったファイル内の相対インポートは、パターンを基準に解決される そのファイルを基準に
ファイルである configtree: のロケーションは、optional: でも失敗する ないものとみなされる
--dart-define はない --dart-define の値は、コマンドラインのすぐ下のソース Flutter と Web のアプリにはコマンドラインがない
Spring Cloud Config を通した HTTP のインポート 非同期の起動での spring.config.import=https://...。設定サーバーのクライアントはない

プロファイル

Spring Boot ここでは
Spring Boot 4.1 は、プロファイルに限定されたドキュメントから spring.profiles.active、.default、.group.* を読む Spring Boot のドキュメントの記述どおり、ドキュメントが適用される場合は起動を失敗させ、適用されない場合は無視する
on-profile と spring.config.import のプレースホルダーは、最初のパスで一度だけ解決される on-profile はプロファイルが決まった時点で、インポートは読まれた時点で解決される
抜けのあるプロファイルグループのリストは起動を失敗させる 抜けのところまで読む
Profiles.of は一部の不正な式 ((dev、a &) を受け入れる Malformed profile expression で失敗する
プラットフォームのプロファイルはない Flutter アプリは android、ios、web、macos、windows、linux、mobile、desktop と debug、profile、release を得る

バインド

Spring Boot ここでは 理由
@EnableConfigurationProperties、@ConfigurationPropertiesScan、ゲッターとセッター どれも不要。フィールドは直接バインドされる アノテーションがクラスを Bean にする
コンストラクターバインドは、ないプロパティに null を渡す 非 nullable のスカラーがないと起動が止まる。ないコレクションは空、ないネストしたオブジェクトはそのデフォルトを得る 非 nullable の型
@ConstructorBinding がコンストラクターを選ぶ public な生成的コンストラクターが一つだけで、それがパラメーターを持つクラスのみ 実装されていない
@DurationUnit(ChronoUnit.SECONDS) @DurationUnit(ChronoUnit.seconds)。月と年はない Dart の Duration
BindHandler.onFailure は代わりの値を返す 失敗を数えるかどうかを返す エラーは集められ、まとめて報告される

名前が変わったキー

Spring Boot ここでは
spring.jackson.* spring.json.*
spring.cloud.openfeign.* spring.feign.*
spring.servlet.multipart.* spring.web.multipart.*
server.servlet.* server.*
logging.logback.rollingpolicy.* logging.file.rolling-policy.*
spring.flyway.* spring.sql.migration.*

spring-boot-properties-migrator は警告するだけです。ここでは、どのソースにある古い名前も起動を止め、新しいキーを示します。

このプロジェクト独自のキー

spring.messages.default-locale (アプリには意味のあるシステムロケールがないことが多い)、Dart VM のホットリロードのための spring.devtools.restart.enabled、spring.remote.allow-insecure、そして spring.main.register-shutdown-hook のデフォルト false。

自動構成と条件

Spring Boot ここでは 理由
起動時にクラスパスから読まれる AutoConfiguration.imports ビルド時に読まれる lib/spring_auto_configuration.dart。新しいスターターには再ビルドが必要 クラスパスがない
クラスの @AutoConfiguration(before, after)、@AutoConfigureOrder @AutoConfigurationModule の order、before、after。クラスは短い名前で指定する 単位はモジュール
exclude はクラスを比較する Type は単純名で比較される 実行時の Type からは名前しか得られない
@ConditionalOnBean(annotation = Service.class) はメタアノテーションを付けた Bean も見つける まさにそのアノテーションクラスのみ アノテーションは普通のオブジェクト
@ConditionalOnClass、@ConditionalOnWebApplication 利用できない 実行時にクラスを検索できない
レポートは各結果を説明する 各条件とそれが一致したかどうかを示す 条件は普通の Dart オブジェクト
ビルド時のスイッチはない AutoConfigurationModule(build:) がモジュールをリリースから除く アプリを小さくする
Spring Boot の BOM リリーストレインと、ビルド時にチェックされる requires pub はパッケージごとに一つのバージョンに解決する

JSON

Spring Boot ここでは
Jackson のすべての機能を持つ spring.jackson.* 組み込みの Bean のキーを持つ spring.json.*。それ以外は警告されて無視される
名前付きのタイムゾーン UTC と固定オフセットのみ: Dart にはタイムゾーンデータベースがない
JsonMapperBuilderCustomizer は Jackson のビルダーを受け取る 中核の JsonMapperBuilder を受け取る

ロギングとシャットダウン

Spring Boot ここでは 理由
シャットダウンフックは有効で、JVM の終了時に実行される デフォルトで無効。SIGINT と SIGTERM でのみ動き、その後 exit(130) または exit(143) Dart には終了フックがなく、シグナルのリスナーはプログラムを生かし続ける
ロガー名は Java のパッケージ Dart のライブラリ名、または SpringLog に与えた名前
ログの日時はローカルのタイムゾーン UTC (ロギングスターターを使う場合) タイムゾーンデータベースがない

対応していないもの

関連項目