OFBiz执行后台任务的类在org.ofbiz.service.job中。
JobPoller和JobInvoker是主要的两个类，一个负责查询可以执行的Job，另一个执行Job任务。Job类图如下所示。
![]()
1.Job轮询
创建JobManager时，会创建JobPoller的一个实例。JobPoller实现了Runnable接口，以此创建线程后
通过JobManager一直轮询是否有Job需要执行，如果有奖将其放入队列中。
queueNow方法将要执行job放入到队列中，如果队列中的等待执行的job数量很多，那么就创建一定数量的线程执行这些job。
JobInvoker就是执行的线程，它从queue中取job并执行。JobInvoker线程不是一直运行下去，运行的时间长度超过一定的值（见serviceengine.xml中ttl的值）线程就会停止并从pool中删除。JobInvoker的run方法中job.exec()执行具体的任务。
2.Job执行
Job类都有一个exec方法，用户执行Job的service。如GenericServiceJob中的exec方法如下：
在执行service执行，有一个init方法，在PersistedServiceJob类中init方法主要是生成下一个执行的任务，如果有的话。也即是说每一个job是由当时执行的这个job生成的，根据是什么呢？主要是两个变量：tempExprId和maxRecurrenceCount，init方法中：
TemporalExpressionWorker里面有一个makeTemporalExpression方法很重要，从这个方法可以知道怎么配置TemporalExpression实体数据了，当然要结合TemporalExpressions类，里面定义了各种配置的细节。
tempExprTypeId有如下几种：
DateRange
DayInMonth
DayOfMonthRange
DayOfWeekRange
Difference
Frequency
Intersection
MonthRange
TimeOfDayRange
Union
比如如果希望服务只执行一次，可以如下配置：
<TemporalExpression tempExprId="RUNONCE" tempExprTypeId="FREQUENCY" integer1="1" integer2="1"/>
<JobSandbox jobId="CurrencyRateSynAll" jobName="Currency Rate SynAll" runTime="2010-02-26 09:38:00.000" serviceName="currencyRateSynAll" poolId="pool" runAsUser="system" tempExprId="RUNONCE" maxRecurrenceCount="0"/>
maxRecurrenceCount="0" 表示，不重复。tempExprTypeId="FREQUENCY" integer1="1" integer2="1"表示一年执行一次。所以总共执行一次就结束了。
每天都执行可以这样配置：
<TemporalExpression tempExprId="MIDNIGHT_DAILY" tempExprTypeId="TIME_OF_DAY_RANGE" string1="20:00:00" string2="20:00:00"/>
<JobSandbox jobId="MailNotification" jobName="Mail Notification Job" runTime="2010-02-25 18:00:00.000" serviceName="mailNotificantion" poolId="pool" runAsUser="system" tempExprId="MIDNIGHT_DAILY" maxRecurrenceCount="-1"/>
maxRecurrenceCount="-1"表示无限循环下去。tempExprId="MIDNIGHT_DAILY" tempExprTypeId="TIME_OF_DAY_RANGE" string1="20:00:00" string2="20:00:00"/>表示每天晚上八点执行。
每个月一次任务可以如下配置：
<TemporalExpression tempExprId="ONCEINMONTH" tempExprTypeId="FREQUENCY" date1="2010-02-26 11:05:00.000" integer1="2" integer2="1"/>
<JobSandbox jobId="CurrencyRateSyn" jobName="Currency Rate Syn" runTime="2010-02-26 11:05:00.000" serviceName="currencyRateSyn" poolId="pool" runAsUser="system" tempExprId="ONCEINMONTH" maxRecurrenceCount="-1"/>
tempExprTypeId="FREQUENCY" date1="2010-02-26 11:05:00.000" integer1="2" integer2="1"表示每月一次，时间就是date1定义的时间，如果没用定义date1，那么就是当前时间。
这里的配置相当灵活，好好掌握。
JobPoller和JobInvoker是主要的两个类，一个负责查询可以执行的Job，另一个执行Job任务。Job类图如下所示。
1.Job轮询
创建JobManager时，会创建JobPoller的一个实例。JobPoller实现了Runnable接口，以此创建线程后
通过JobManager一直轮询是否有Job需要执行，如果有奖将其放入队列中。
1
public
synchronized
void
run() {
2 try {
3 // wait 30 seconds before the first poll
4 java.lang.Thread.sleep( 30000 );
5 } catch (InterruptedException e) {
6 }
7 while (isRunning) {
8 try {
9 // grab a list of jobs to run.
10 List < Job > pollList = jm.poll();
11 // Debug.logInfo("Received poll list from JobManager [" + pollList.size() + "]", module);
12
13 for (Job job : pollList) {
14 if (job.isValid()) {
15 queueNow(job);
16 // Debug.logInfo("Job [" + job.getJobId() + "] is queued", module);
17 }
18 }
19 // NOTE: using sleep instead of wait for stricter locking
20 java.lang.Thread.sleep(pollWaitTime());
21 } catch (InterruptedException e) {
22 Debug.logError(e, module);
23 stop();
24 }
25 }
26 }
27
2 try {
3 // wait 30 seconds before the first poll
4 java.lang.Thread.sleep( 30000 );
5 } catch (InterruptedException e) {
6 }
7 while (isRunning) {
8 try {
9 // grab a list of jobs to run.
10 List < Job > pollList = jm.poll();
11 // Debug.logInfo("Received poll list from JobManager [" + pollList.size() + "]", module);
12
13 for (Job job : pollList) {
14 if (job.isValid()) {
15 queueNow(job);
16 // Debug.logInfo("Job [" + job.getJobId() + "] is queued", module);
17 }
18 }
19 // NOTE: using sleep instead of wait for stricter locking
20 java.lang.Thread.sleep(pollWaitTime());
21 } catch (InterruptedException e) {
22 Debug.logError(e, module);
23 stop();
24 }
25 }
26 }
27
queueNow方法将要执行job放入到队列中，如果队列中的等待执行的job数量很多，那么就创建一定数量的线程执行这些job。
1
public
void
queueNow(Job job) {
2 synchronized (run) {
6 run.add(job);
7 }
8 if (Debug.verboseOn()) Debug.logVerbose( " New run queue size: " + run.size(), module);
9 if (run.size() > pool.size() && pool.size() < maxThreads()) {
10 synchronized (pool) {
11 if (run.size() > pool.size() && pool.size() < maxThreads()) {
12 int calcSize = (run.size() / jobsPerThread()) - (pool.size());
13 int addSize = calcSize > maxThreads() ? maxThreads() : calcSize;
14
15 for ( int i = 0 ; i < addSize; i ++ ) {
16 JobInvoker iv = new JobInvoker( this , invokerWaitTime());
17 pool.add(iv);
18 }
19 }
20 }
21 }
22 }
2 synchronized (run) {
6 run.add(job);
7 }
8 if (Debug.verboseOn()) Debug.logVerbose( " New run queue size: " + run.size(), module);
9 if (run.size() > pool.size() && pool.size() < maxThreads()) {
10 synchronized (pool) {
11 if (run.size() > pool.size() && pool.size() < maxThreads()) {
12 int calcSize = (run.size() / jobsPerThread()) - (pool.size());
13 int addSize = calcSize > maxThreads() ? maxThreads() : calcSize;
14
15 for ( int i = 0 ; i < addSize; i ++ ) {
16 JobInvoker iv = new JobInvoker( this , invokerWaitTime());
17 pool.add(iv);
18 }
19 }
20 }
21 }
22 }
JobInvoker就是执行的线程，它从queue中取job并执行。JobInvoker线程不是一直运行下去，运行的时间长度超过一定的值（见serviceengine.xml中ttl的值）线程就会停止并从pool中删除。JobInvoker的run方法中job.exec()执行具体的任务。
2.Job执行
Job类都有一个exec方法，用户执行Job的service。如GenericServiceJob中的exec方法如下：
1
public
void
exec()
throws
InvalidJobException {
2 init();
3
4 // no transaction is necessary since runSync handles this
5 try {
6 // get the dispatcher and invoke the service via runSync -- will run all ECAs
7 LocalDispatcher dispatcher = dctx.getDispatcher();
8 Map < String, Object > result = dispatcher.runSync(getServiceName(), getContext());
9
10 // check for a failure
11 boolean isError = ModelService.RESPOND_ERROR.equals(result.get(ModelService.RESPONSE_MESSAGE));
12 if (isError) {
13 String errorMessage = (String) result.get(ModelService.ERROR_MESSAGE);
14 this .failed( new Exception(errorMessage));
15 }
16
17 if (requester != null ) {
18 requester.receiveResult(result);
19 }
20
21 } catch (Throwable t) {
22 // pass the exception back to the requester.
23 if (requester != null ) {
24 requester.receiveThrowable(t);
25 }
26
27 // call the failed method
28 this .failed(t);
29 }
30
31 // call the finish method
32 this .finish();
33 }
34
2 init();
3
4 // no transaction is necessary since runSync handles this
5 try {
6 // get the dispatcher and invoke the service via runSync -- will run all ECAs
7 LocalDispatcher dispatcher = dctx.getDispatcher();
8 Map < String, Object > result = dispatcher.runSync(getServiceName(), getContext());
9
10 // check for a failure
11 boolean isError = ModelService.RESPOND_ERROR.equals(result.get(ModelService.RESPONSE_MESSAGE));
12 if (isError) {
13 String errorMessage = (String) result.get(ModelService.ERROR_MESSAGE);
14 this .failed( new Exception(errorMessage));
15 }
16
17 if (requester != null ) {
18 requester.receiveResult(result);
19 }
20
21 } catch (Throwable t) {
22 // pass the exception back to the requester.
23 if (requester != null ) {
24 requester.receiveThrowable(t);
25 }
26
27 // call the failed method
28 this .failed(t);
29 }
30
31 // call the finish method
32 this .finish();
33 }
34
在执行service执行，有一个init方法，在PersistedServiceJob类中init方法主要是生成下一个执行的任务，如果有的话。也即是说每一个job是由当时执行的这个job生成的，根据是什么呢？主要是两个变量：tempExprId和maxRecurrenceCount，init方法中：
1
TemporalExpression expr
=
null
;
2 ……
3
4 if (expr == null && UtilValidate.isNotEmpty(job.getString( " tempExprId " ))) {
5 try {
6 expr = TemporalExpressionWorker.getTemporalExpression( this .delegator, job.getString( " tempExprId " ));
7 } catch (GenericEntityException e) {
8 throw new RuntimeException(e.getMessage());
9 }
10 }
11
2 ……
3
4 if (expr == null && UtilValidate.isNotEmpty(job.getString( " tempExprId " ))) {
5 try {
6 expr = TemporalExpressionWorker.getTemporalExpression( this .delegator, job.getString( " tempExprId " ));
7 } catch (GenericEntityException e) {
8 throw new RuntimeException(e.getMessage());
9 }
10 }
11
TemporalExpressionWorker里面有一个makeTemporalExpression方法很重要，从这个方法可以知道怎么配置TemporalExpression实体数据了，当然要结合TemporalExpressions类，里面定义了各种配置的细节。
tempExprTypeId有如下几种：
DateRange
DayInMonth
DayOfMonthRange
DayOfWeekRange
Difference
Frequency
Intersection
MonthRange
TimeOfDayRange
Union
比如如果希望服务只执行一次，可以如下配置：
<TemporalExpression tempExprId="RUNONCE" tempExprTypeId="FREQUENCY" integer1="1" integer2="1"/>
<JobSandbox jobId="CurrencyRateSynAll" jobName="Currency Rate SynAll" runTime="2010-02-26 09:38:00.000" serviceName="currencyRateSynAll" poolId="pool" runAsUser="system" tempExprId="RUNONCE" maxRecurrenceCount="0"/>
maxRecurrenceCount="0" 表示，不重复。tempExprTypeId="FREQUENCY" integer1="1" integer2="1"表示一年执行一次。所以总共执行一次就结束了。
每天都执行可以这样配置：
<TemporalExpression tempExprId="MIDNIGHT_DAILY" tempExprTypeId="TIME_OF_DAY_RANGE" string1="20:00:00" string2="20:00:00"/>
<JobSandbox jobId="MailNotification" jobName="Mail Notification Job" runTime="2010-02-25 18:00:00.000" serviceName="mailNotificantion" poolId="pool" runAsUser="system" tempExprId="MIDNIGHT_DAILY" maxRecurrenceCount="-1"/>
maxRecurrenceCount="-1"表示无限循环下去。tempExprId="MIDNIGHT_DAILY" tempExprTypeId="TIME_OF_DAY_RANGE" string1="20:00:00" string2="20:00:00"/>表示每天晚上八点执行。
每个月一次任务可以如下配置：
<TemporalExpression tempExprId="ONCEINMONTH" tempExprTypeId="FREQUENCY" date1="2010-02-26 11:05:00.000" integer1="2" integer2="1"/>
<JobSandbox jobId="CurrencyRateSyn" jobName="Currency Rate Syn" runTime="2010-02-26 11:05:00.000" serviceName="currencyRateSyn" poolId="pool" runAsUser="system" tempExprId="ONCEINMONTH" maxRecurrenceCount="-1"/>
tempExprTypeId="FREQUENCY" date1="2010-02-26 11:05:00.000" integer1="2" integer2="1"表示每月一次，时间就是date1定义的时间，如果没用定义date1，那么就是当前时间。
这里的配置相当灵活，好好掌握。