Spring との違い
spring_boot_dart は Spring Boot に従っています。アノテーションも、プロパティの名前も、起動の順序も同じです。このページでは、そうでない箇所をすべて、その理由とともにトピックごとに列挙します。
使う理由
違いのほとんどは、次の 3 つの事実から来ています。
- Dart には実行時のリフレクションもクラスパスもありません。 パッケージはビルド時にスキャンされ、スターターもビルド時に検出され、
lib/resources/ がクラスパスの役割を果たします。
- シグナルを待ち受ける Dart プログラムは、自分からは決して終了しません。 これがシャットダウンフックの扱いを変えます。
- 黙って無視される古い名前は害になります。 そのため、名前が変わったキーは警告ではなく起動を止めます。
例
両者での同じアプリケーション:
@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 (ロギングスターターを使う場合) |
タイムゾーンデータベースがない |
対応していないもの
spring.main.allow-circular-references、none 以外の spring.main.web-application-type。
env: のインポート、XML のプロパティ、.env ファイル、Spring Cloud Config、Consul と Vault のクライアント。
logging.config、logging.structured.*。
@WebMvcTest のようなテストスライス。
関連項目