顧客モデルを対象とした「顧客登録ジョブ」を用意してみます。次の手順となります。
例として、CreateCustomerJob.xml を作成します。次の内容とします。
<?xml version="1.0" encoding="UTF-8"?> <jfcjob createApplicationContext="false"> <name>CreateCustomer</name> <memo>CreateCustomer</memo> <classname>jp.jasminesoft.wagby.job.CreateCustomerJob</classname> <description>顧客データを作成する</description> </jfcjob>
ジョブクラスは、Wagbyのジョブスケジューラから呼び出されます。 ここでは上記で示した CreateCustomerJob.java クラスを用意します。
package jp.jasminesoft.wagby.job;
import org.apache.log4j.Logger;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import jp.jasminesoft.jfc.DbActionParameter;
import jp.jasminesoft.jfc.job.JFCBaseJobBean;
public class CreateCustomerJob extends JFCBaseJobBean {
private final static Logger logger =
Logger.getLogger(CreateCustomerJob.class.getName());
private CreateCustomerTask createCustomerTask;
public void setCreateCustomerTask(CreateCustomerTask createCustomerTask) {
this.createCustomerTask = createCustomerTask;
}
@Override
protected String executeInternal0(JobExecutionContext jobContext,
DbActionParameter p) throws JobExecutionException {
return createCustomerTask.process(p);
}
}
このコードに示したように、バッチ処理の本体は CreateCustomerTask というクラスに記述します。ジョブクラスは入れ物であり、ジョブパラメータを受け取ることができるようになっています。このパラメータをタスククラスへの引数とし、実際の処理をタスククラスに委譲します。
バッチ処理の本体です。CreateCustomerTask.java とします。
package jp.jasminesoft.wagby.job;
import jp.jasminesoft.jfc.DbActionParameter;
import jp.jasminesoft.jfc.app.EntityHelper;
import jp.jasminesoft.jfc.service.JFCEntityService;
import jp.jasminesoft.wagby.model.customer.*;
import jp.jasminesoft.wagby.app.customer.*;
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
public class CreateCustomerTask {
private final static Logger logger =
Logger.getLogger(CreateCustomerTask.class.getName());
@Autowired
@Qualifier("CustomerHelper")
protected EntityHelper<Customer, Integer> customerHelper;
@Autowired
@Qualifier("CustomerEntityService")
protected JFCEntityService<Customer, Integer> customerEntityService;
protected String process(DbActionParameter p) {
logger.info("顧客データ作成ジョブを開始しました。");
for (int i = 0; i < 100; i++) {
Customer customer = new Customer();
customerHelper.initialize(customer, p);
customerEntityService.insert(customer);
logger.info( i + "件の顧客データを登録しました。");
}
return "顧客データ作成ジョブを正常終了しました。";
}
}
タスククラスは@Autowiredアノテーションを利用して(自動生成された)ヘルパやサービスクラスを再利用しています。これによってSQLを書かずに業務処理を実現しています。
以下のファイルを customize/webapp/WEB-INF/applicationContext/customer-ex.xml として保存します。(ファイル名は自動生成されたファイルと重複しないのであれば自由です。)
ここではCreateCustomerTaskをbean定義として用意します。また、CreateCustomerジョブを定義し、CreateCustomerTaskとひも付けます。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<bean id="CreateCustomer" scope="prototype"
class="org.springframework.scheduling.quartz.JobDetailFactoryBean">
<property name="jobClass">
<value>jp.jasminesoft.wagby.job.CreateCustomerJob</value>
</property>
<property name="jobDataAsMap">
<map>
<entry key="createCustomerTask" value-ref="CreateCustomerTask"/>
</map>
</property>
</bean>
<bean id="CreateCustomerTask" scope="prototype"
class="jp.jasminesoft.wagby.job.CreateCustomerTask"/>
</beans>
追加したファイルは次のとおりです。
customize/java/jp/jasminesoft/wagby/job/CreateCustomerJob.java customize/java/jp/jasminesoft/wagby/job/CreateCustomerTask.java customize/webapp/WEB-INF/applicationContext/customer-ex.xml customize/webapp/WEB-INF/export/init/jfcjob/CreateCustomerJob.xml
このファイルをダウンロードできます。customize フォルダ直下に展開してください。
システム管理者でログオンします。「管理者ガイド(R7) > 準備:ジョブ実行アカウントを利用可能にする」の説明に従って、ジョブ実行アカウントを利用可能にします。
管理処理タブの「ジョブ管理...」を選択します。
「ジョブスケジュール検索」画面を開きます。
ジョブスケジュールの新規登録画面を開きます。
作成したジョブを選択します。
ジョブ実行アカウントを指定します。この段階では、ジョブは有効にしません。
「今すぐ実行」ボタンを押下し、このジョブを実行させてみます。
ジョブが実行されます。wagbyapp/logs/system.logに、ジョブに関するメッセージが記録されます。
「ジョブパラメータ」を追加し、これをジョブクラスが受け取ることができます。
受け取る側のソースコードは次のように記述できます。
package jp.jasminesoft.wagby.job;
import org.apache.log4j.Logger;
import org.quartz.JobDataMap;// 追加
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import jp.jasminesoft.jfc.DbActionParameter;
import jp.jasminesoft.jfc.job.JFCBaseJobBean;
public class CreateCustomerJob extends JFCBaseJobBean {
private final static Logger logger =
Logger.getLogger(CreateCustomerJob.class.getName());
private CreateCustomerTask createCustomerTask;
public void setCreateCustomerTask(CreateCustomerTask createCustomerTask) {
this.createCustomerTask = createCustomerTask;
}
@Override
protected String executeInternal0(JobExecutionContext jobContext,
DbActionParameter p) throws JobExecutionException {
JobDataMap dataMap = jobContext.getJobDetail().getJobDataMap();
String args = (String)dataMap.get("process");
return createCustomerTask.process(p);
}
}
4行目のimport文を追加しています。ジョブパラメータは org.quartz.JobDataMap クラスが管理します。
24行目,25行目でパラメータを取得しています。図9の例では、キー"process"という名前で(画面から)登録されたパラメータを受け取っています。変数 args には文字列 "AAA" が格納されます。
R7.10より前のWagby(R7.0.0〜R7.9.2)では、org.springframework.scheduling.quartz.JobDetailFactoryBean クラスの代わりに org.springframework.scheduling.quartz.JobDetailBean クラスを指定するようにしてください。これは R7.10 で、Spring Framework のバージョンが 3 から 4 へバージョンアップされたためです。
具体的にはジョブ定義の xml ファイルが次のようになります。
...
<bean id="CreateCustomer" scope="prototype"
class="org.springframework.scheduling.quartz.JobDetailBean">
...
R7.5より前のWagby(R7.0.0〜R7.4.3)では、CreateCustomerJob.xml に用意した jfcjob 要素の createApplicationContext="false" 属性が無視されます。そのため、自動生成された WEB-INF/applicationContext/__jobcontrol.xml に CreateCustomer ジョブ定義が出力されます。これを手動で削除する必要があります。
具体的には $(DEVHOME)/wagbydesigner/webapps/wagbydesigner/WEB-INF/env/work/srcgen/webpage/WEB-INF/applicationContext/__jobcontrol.xml の末尾に含まれる次の行を削除します。
<!-- extension -->
<bean id="CreateCustomer" scope="prototype"
class="org.springframework.scheduling.quartz.JobDetailBean">
<property name="jobClass">
<value>jp.jasminesoft.wagby.job.CreateCustomerJob</value>
</property>
</bean>
削除したファイルを $(DEVHOME)/customize/webapp/WEB-INF/applicationContext に保存します。つまり、このファイルは今後、カスタマイズフォルダに保存したファイルに上書きされます。このファイルの保守は開発者が行ってください。