クラス JobDetailFactoryBean
- 実装されているすべてのインターフェース:
Aware、BeanNameAware、FactoryBean<JobDetail>、InitializingBean、ApplicationContextAware
JobDetail インスタンスを作成するための Spring FactoryBean。JobDetail 構成の Bean スタイルの使用をサポートします。JobDetail(Impl) 自体はすでに JavaBean ですが、適切なデフォルトがありません。このクラスは、Spring Bean 名をジョブ名として使用し、Quartz デフォルトグループ("DEFAULT" )をジョブグループとして指定します(指定されていない場合)。
- 導入:
- 3.1
- 作成者:
- Juergen Hoeller
- 関連事項:
フィールドのサマリー
インターフェース org.springframework.beans.factory.FactoryBean から継承されたフィールド
OBJECT_TYPE_ATTRIBUTEコンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明voidジョブの JobDataMap を返します。このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。ClassSE<?>この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合はnullを返します。booleanこのファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?voidsetApplicationContext(ApplicationContext applicationContext) このオブジェクトが実行される ApplicationContext を設定します。voidsetApplicationContextJobDataKey(StringSE applicationContextJobDataKey) JobDataMap で公開する ApplicationContext 参照のキーを設定します (例: "applicationContext" )。voidsetBeanName(StringSE beanName) この Bean を作成した Bean ファクトリで Bean の名前を設定します。voidsetDescription(StringSE description) このジョブの説明文を設定します。voidsetDurability(boolean durability) ジョブの耐久性を指定します。voidジョブのグループを指定します。voidsetJobClass(ClassSE<? extends Job> jobClass) ジョブの実装クラスを指定します。voidsetJobDataAsMap(MapSE<StringSE, ?> jobDataAsMap) 指定されたマップを介して JobDataMap にオブジェクトを登録します。voidsetJobDataMap(JobDataMap jobDataMap) ジョブの JobDataMap を設定します。voidジョブの名前を指定します。voidsetRequestsRecovery(boolean requestsRecovery) このジョブの回復フラグを設定します。
コンストラクターの詳細
JobDetailFactoryBean
public JobDetailFactoryBean()
メソッドの詳細
setName
ジョブの名前を指定します。setGroup
ジョブのグループを指定します。setJobClass
ジョブの実装クラスを指定します。setJobDataMap
ジョブの JobDataMap を設定します。getJobDataMap
ジョブの JobDataMap を返します。setJobDataAsMap
指定されたマップを介して JobDataMap にオブジェクトを登録します。これらのオブジェクトは、SchedulerContext のオブジェクトとは対照的に、このジョブでのみ使用できます。
メモ: JobDetail がデータベースに保持される永続的なジョブを使用する場合は、Spring 管理の Bean または ApplicationContext 参照を JobDataMap ではなく SchedulerContext に配置しないでください。
- パラメーター:
jobDataAsMap- String キーと任意のオブジェクトを値として持つ Map (たとえば、Spring に管理された Bean)- 関連事項:
setDurability
public void setDurability(boolean durability) ジョブの永続化を指定します。つまり、トリガーが指していなくても、ジョブストアに保存されたままにするかどうかを指定します。setRequestsRecovery
public void setRequestsRecovery(boolean requestsRecovery) このジョブの回復フラグを設定します。つまり、「回復」または「フェイルオーバー」の状況が発生した場合にジョブを再実行する必要があるかどうかを設定します。setDescription
このジョブの説明文を設定します。setBeanName
インターフェースからコピーされた説明:BeanNameAwareこの Bean を作成した Bean ファクトリで Bean の名前を設定します。通常の Bean プロパティの設定後、ただし
InitializingBean.afterPropertiesSet()またはカスタム init メソッドなどの init コールバックの前に呼び出されます。- 次で指定:
- インターフェース
BeanNameAwareのsetBeanName - パラメーター:
beanName- ファクトリ内の Bean の名前。この名前は、ファクトリで使用される実際の Bean 名であり、最初に指定した名前とは異なる場合があります。特に内部 Bean 名の場合、実際の Bean 名は "#..." サフィックスを追加することで一意になります。必要に応じて、BeanFactoryUtils.originalBeanName(String)メソッドを使用して、元の Bean 名(サフィックスなし)を抽出します。
setApplicationContext
インターフェースからコピーされた説明:ApplicationContextAwareこのオブジェクトが実行される ApplicationContext を設定します。通常、この呼び出しはオブジェクトの初期化に使用されます。通常の Bean プロパティの設定後、ただし
InitializingBean.afterPropertiesSet()またはカスタム init メソッドなどの init コールバックの前に呼び出されます。ResourceLoaderAware.setResourceLoader(org.springframework.core.io.ResourceLoader)、ApplicationEventPublisherAware.setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher)およびMessageSourceAwareの後に呼び出されます(該当する場合)。- 次で指定:
- インターフェース
ApplicationContextAwareのsetApplicationContext - パラメーター:
applicationContext- このオブジェクトによって使用される ApplicationContext オブジェクト- 関連事項:
setApplicationContextJobDataKey
JobDataMap で公開する ApplicationContext 参照のキーを設定します (例: "applicationContext" )。デフォルトはなしです。Spring ApplicationContext で実行している場合にのみ適用されます。QuartzJobBean の場合、参照は Bean プロパティとしてジョブインスタンスに適用されます。そのシナリオでは、"applicationContext" 属性 は "setApplicationContext" メソッドに対応します。
Quartz 自体がジョブのライフサイクルを担当するため、ApplicationContextAware のような BeanFactory コールバックインターフェースは Quartz ジョブインスタンスに自動的に適用されないことに注意してください。
メモ: JobDetail の内容がデータベースに保持される永続的なジョブストアを使用する場合は、ApplicationContext 参照を JobDataMap ではなく SchedulerContext に配置してください。
afterPropertiesSet
public void afterPropertiesSet()インターフェースからコピーされた説明:InitializingBeanすべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAwareなどを満たした後、包含BeanFactoryによって呼び出されます。このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
- 次で指定:
- インターフェース
InitializingBeanのafterPropertiesSet
getObject
インターフェースからコピーされた説明:FactoryBeanこのファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。BeanFactoryと同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する
FactoryBeanNotInitializedExceptionをスローします。Spring 2.0 以降、FactoryBeans は
nullオブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。- 次で指定:
- インターフェース
FactoryBean<JobDetail>のgetObject - 戻り値:
- Bean のインスタンス (
nullにすることができます) - 関連事項:
getObjectType
インターフェースからコピーされた説明:FactoryBeanこの FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合はnullを返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで
nullを返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。- 次で指定:
- インターフェース
FactoryBean<JobDetail>のgetObjectType - 戻り値:
- この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は
null - 関連事項:
isSingleton
public boolean isSingleton()インターフェースからコピーされた説明:FactoryBeanこのファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、
getObject()から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、trueを返さないでください。FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 :
falseを返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張SmartFactoryBeanインターフェースの実装は、SmartFactoryBean.isPrototype()メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンなFactoryBean実装は、isSingleton()実装がfalseを返す場合、常に独立したインスタンスを返すと単純に想定されます。FactoryBeanは通常シングルトンインスタンスを管理するため、デフォルトの実装ではtrueが返されます。- 次で指定:
- インターフェース
FactoryBean<JobDetail>のisSingleton - 戻り値:
- 公開されたオブジェクトがシングルトンかどうか
- 関連事項: