最適化
ジェネレーターは、Spring が実行時にリフレクションで行うこと (Bean を見つける、生成する、そのプロパティを読む、AOP のためにプロキシ化する) を置き換えます。そのすべてを、ビルド時に素の Dart コードとして書き出します。このセクションでは、そのコードを小さく、ビルドを速く保つための選択を説明します。
使う理由
生成コードはアプリが同梱するコードです。素朴なジェネレーターなら、すべてのクラスを完全に記述し、すべての Bean にプロキシクラスを書き、すべてのスターターのモジュールをすべてのアプリに入れるでしょう。それでも動きますが、アプリは決して実行されない大量のコードを抱えることになり、Flutter と Web ではそれがダウンロードの増大と起動の遅延を意味します。
ビルドはアプリケーション全体を見ています。その Bean、アスペクト、呼び出し、設定です。そのため、アプリケーションが使わないことが確かなものを省き、ビルドが見なかったものが実行時に現れたときには、それを明確に伝えることができます。
概要
| 最適化 | 節約するもの | ページ |
|---|---|---|
| リフレクションなし | dart:mirrors は使われません。すべてが素のコンストラクター呼び出しとクロージャーで、AOT、Flutter、Web で動き、ミニファイに耐えます |
生成の仕組み |
| コンパイラーがツリーシェイキングできるコード | 生成される参照は直接的 (create: (r) => Greeter(r.dependency<Clock>(name: r'clock'))) で、記述はトップレベル関数を使う定数で、条件付きのコードはコンパイル時定数の背後にあるので、Dart のコンパイラーは何も到達しないものを取り除きます |
このページ、下記 |
| 実行されるものだけ: イントロスペクション | クラスは、アプリケーションがそれに対して行うことについてだけ記述されます: ゲッター、コンストラクターとセッター、またはメソッド | 実行されるものだけ: イントロスペクション |
| AOP プロキシの刈り込み | どのアドバイスも一致しえない Bean にはプロキシクラスがなく、残るプロキシにはアドバイスされるメンバーだけがあります | AOP プロキシ |
| 遅延されるプロキシ | スターターは自身の Bean のプロキシクラスを書かず、アプリケーションはそのアスペクトが必要とするものだけを書きます | AOP プロキシ |
| ビルドから外されるモジュール | アプリケーションのプロパティが、スターターのモジュール (デバッグパネル) をアプリから、またはリリースからだけ外します | ビルドから外されるモジュール |
| スターターのパート | ジェネレーターはコアとスターターごとのパートでできていて、パートはアプリケーションがそのスターターに届くときだけ動きます。パートはモジュールのようにビルドのキーに従えます | 生成の仕組み、キーで決まるジェネレーターのパート |
| ビルド速度 | ファイルは解決される前にテキストでチェックされ、必要な本体だけが解決され、追加の作業は何かを取り除ける場合にだけ行われます | ビルド速度 |
コンパイラーが取り除けるコード
リリースビルド向けの Dart のコンパイラー (dart2js、AOT) は、何も参照しないコードを取り除きます。ツリーシェイキングです。リフレクションはそれを妨げます。どのクラスも名前で検索される可能性があるからです。生成コードはそれを助けます。
- 直接の参照。 Bean はそのコンストラクターを呼ぶクロージャーで生成されます。名前でクラスを検索するものはないので、どの Bean も呼び出しも使わないクラスは取り除かれます。
- 定数の記述。 型パラメーターのないクラスのイントロスペクションは
const Introspectionで、そのクロージャーはトップレベル関数 (_$get3、_$create5) です。ビルドが省いた部分には関数がまったくありません。 - 定数の条件。 デバッグとプロファイルのビルド専用のモジュールは
if (!const bool.fromEnvironment('dart.vm.product'))の下に列挙されます。リリースビルドではその条件は定数falseなので、その要素、モジュール、それだけが到達するすべてが取り除かれます。ビルドから外されるモジュール を参照してください。 - 共有される定数。 刈り込まれたプロキシは、モジュールごとに一つの既知のアドバイザーの定数セットを共有し、
AopProxyFactory.pruned()の理由のテキストは、すべての生成ファイルではなくランタイムに一度だけ書かれます。
変わらないもの
どの最適化もアプリケーションの振る舞いを保ちます。
- 一致するアドバイスのない Bean は、AOP のオプションにかかわらず、実行時にラップされることはありません。
- 記述の一部が欠けていると、それを必要とするコードは、クラス、部分、修正方法 (
add @Introspected() to Book) を示すメッセージで失敗し、空のオブジェクトになることはありません。 - ビルドが見なかったアドバイス (コードで登録されたもの) は、黙ってスキップされるのではなく、メッセージとともに起動を失敗させます。
- ビルドから外されたモジュールは、スターターがそれを持っていなかったのとまったく同じです。
各最適化は緩めることができます。@Introspected() はクラスを完全に記述し、aop_prune: false はすべてのプロキシを残し、true に設定したビルドプロパティはモジュールをすべてのビルドに残します。オプション を参照してください。