クラス Application
アプリケーションサブクラスの実装で作成されたインスタンスは、Context を使用してリソースクラスとプロバイダーに注入できます。
Application サブクラスメソッドまたはそのコンストラクターのいずれかが RuntimeExceptionSE をスローした場合、アプリケーションのデプロイは失敗して中止されるべきです(SHOULD)。
- 導入:
- 1.0
- 作成者:
- Paul Sandoz, Marc Hadley, Marek Potociar
コンストラクターの概要
コンストラクターメソッドのサマリー
コンストラクターの詳細
Application
public Application()
メソッドの詳細
getClasses
ルートリソース、プロバイダー、featureクラスのセットを取得します。リソースクラスインスタンスのデフォルトのライフサイクルはリクエストごとです。プロバイダーのデフォルトのライフサイクル(直接または機能を介して登録)はシングルトンです。実装は、ルートリソースまたはプロバイダー / 機能クラスの要件に準拠していないクラスについて警告し、無視する必要があります。実装は、
getSingletons()がインスタンスを返すクラスについて警告し、無視する必要があります。実装は、返されたセットを変更してはなりません(MUSTNOT)。デフォルトの実装は空のセットを返します。
- 戻り値:
- ルートリソースとプロバイダークラスのセット。
nullを返すことは、空のセットを返すことと同じです。
getSingletons
使用すべきではありません。リソースとプロバイダーの自動検出またはgetClassesメソッドは、getSingletonsより優先されます。ルートリソース、プロバイダー、featureインスタンスのセットを取得します。返されたインスタンスのフィールドとプロパティには、使用前にランタイムによって宣言された依存関係(Contextを参照)が挿入されます。実装は、ルートリソースまたはプロバイダークラスの要件に準拠していないクラスについて警告し、無視する必要があります。返されたセットに同じクラスのインスタンスが複数含まれている場合、実装はエラーにフラグを立てる必要があります。実装は、返されたセットを変更してはなりません(MUSTNOT)。
デフォルトの実装は空のセットを返します。
- 戻り値:
- ルートリソースとプロバイダーインスタンスのセット。
nullを返すことは、空のセットを返すことと同じです。
getProperties
アプリケーション全体のカスタムプロパティのマップを取得します。返されたプロパティは、サーバー側の機能に渡されるか、サーバー側の JAX-RS コンポーネントに挿入されるアプリケーション
configurationに反映されます。返されるプロパティのセットは、コンテナー固有の機能とデプロイ記述子を使用して、デプロイ時にさらに拡張またはカスタマイズできます。例: サーブレットベースのデプロイシナリオでは、Web アプリケーションの
<context-param>値とサーブレット<init-param>値を使用して、このメソッドによってプログラムで返されるプロパティの値を継承またはオーバーライドできます。デフォルトの実装は空のセットを返します。
- 戻り値:
- カスタムアプリケーション全体のプロパティのマップ。
nullを返すことは、空のセットを返すことと同じです。 - 導入:
- 2.0
getClassesメソッドは、getSingletonsより優先されます。