Author: alex.guizar(a)jboss.com
Date: 2010-03-25 22:20:18 -0400 (Thu, 25 Mar 2010)
New Revision: 6235
Modified:
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/java/org/jbpm/job/executor/JobExecutor.java
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/resources/org/jbpm/default.jbpm.cfg.xml
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/async.xml
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/configuration.xml
Log:
SOA-1998: set default value of job executor retries to 3;
move job executor properties documentation to configuration chapter
Modified:
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/java/org/jbpm/job/executor/JobExecutor.java
===================================================================
---
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/java/org/jbpm/job/executor/JobExecutor.java 2010-03-25
20:03:31 UTC (rev 6234)
+++
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/java/org/jbpm/job/executor/JobExecutor.java 2010-03-26
02:20:18 UTC (rev 6235)
@@ -25,7 +25,7 @@
protected JbpmConfiguration jbpmConfiguration;
protected String name;
protected int nbrOfThreads;
- private int retries = 1;
+ private int retries;
protected int idleInterval;
protected int maxIdleInterval;
/** @deprecated property has no effect */
Modified:
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/resources/org/jbpm/default.jbpm.cfg.xml
===================================================================
---
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/resources/org/jbpm/default.jbpm.cfg.xml 2010-03-25
20:03:31 UTC (rev 6234)
+++
jbpm3/branches/jbpm-3.2-soa/modules/core/src/main/resources/org/jbpm/default.jbpm.cfg.xml 2010-03-26
02:20:18 UTC (rev 6235)
@@ -66,7 +66,7 @@
<property name="jbpmConfiguration"><ref
bean="jbpmConfiguration" /></property>
<property name="name"><string value="JbpmJobExecutor"
/></property>
<property name="nbrOfThreads"><int value="1"
/></property>
- <property name="retries"><int value="2"
/></property>
+ <property name="retries"><int value="3"
/></property>
<property name="idleInterval"><!-- 5 seconds --><int
value="5000" /></property>
<property name="maxIdleInterval"><!-- 1 hour --><int
value="3600000" /></property>
<property name="maxLockTime"><!-- 10 minutes --><int
value="600000" /></property>
Modified:
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/async.xml
===================================================================
---
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/async.xml 2010-03-25
20:03:31 UTC (rev 6234)
+++
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/async.xml 2010-03-26
02:20:18 UTC (rev 6235)
@@ -178,76 +178,6 @@
</para>
</section>
- <section id="configuringjobexecutor">
- <title>Configuring the job executor</title>
-
- <para>The job executor exposes a few properties you can tune. To change any of
the
- values described below, edit the <literal>jbpm.job.executor</literal>
bean in
- <literal>jbpm.cfg.xml</literal>.</para>
-
- <table><title>Job executor properties</title>
- <tgroup cols='3'>
- <colspec colname='attr' colwidth="*" />
- <colspec colname='desc' colwidth="4*" />
- <colspec colname="def" colwidth="*"/>
-
- <thead>
- <row>
- <entry>Property</entry>
- <entry>Description</entry>
- <entry>Default</entry>
- </row>
- </thead>
-
- <![CDATA[
- <property name="nbrOfThreads"><int value="1"
/></property>
- <property name="retries"><int value="3"
/></property>
- <property name="idleInterval"><int value="5000"
/></property>
- <property name="maxIdleInterval"><int value="3600000"
/><!-- 1 hour --></property>
- <property name="maxLockTime"><int value="600000"
/><!-- 10 minutes --></property>
- <property name="lockMonitorInterval"><int value="60000"
/><!-- 1 minute --></property>
- <property name="lockBufferTime"><int value="5000"
/><!-- 5 seconds --></property>]]>
-
- <tbody>
- <row>
- <entry>nbrOfThreads</entry>
- <entry>Size of the job executor thread pool</entry>
- <entry>1</entry>
- </row>
- <row>
- <entry>retries</entry>
- <entry>Number of times the job executor retries a failed job</entry>
- <entry>2</entry>
- </row>
- <row>
- <entry>idleInterval</entry>
- <entry>Period between checks for new jobs (milliseconds)</entry>
- <entry>5 seconds</entry>
- </row>
- <row>
- <entry>maxIdleInterval</entry>
- <entry>When a job fails, the affected thread pauses for a period initially
equal
- to <literal>idleInterval</literal>, which is increased twofold until
it reaches
- <literal>maxIdleInterval</literal> (milliseconds)</entry>
- <entry>1 hour</entry>
- </row>
- <row>
- <entry>maxLockTime</entry>
- <entry>Amount of time a job executor thread is allowed to hold a job before
- the job is released and offered to other threads (milliseconds)</entry>
- <entry>10 minutes</entry>
- </row>
- <row>
- <entry>lockMonitorInterval</entry>
- <entry>Period between checks for job lock times
(milliseconds)</entry>
- <entry>1 minute</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
-
- </section>
-
<section id="jbpmsbuiltinasynchronousmessaging">
<title>jBPM's built-in asynchronous messaging</title>
<para>When using jBPM's built-in asynchronous messaging, job messages will
be sent by persisting
Modified:
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/configuration.xml
===================================================================
---
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/configuration.xml 2010-03-25
20:03:31 UTC (rev 6234)
+++
jbpm3/branches/jbpm-3.2-soa/modules/userguide/src/main/docbook/en/modules/configuration.xml 2010-03-26
02:20:18 UTC (rev 6235)
@@ -314,7 +314,69 @@
<programlisting><boolean
name="jbpm.hide.stale.object.exceptions" value="false"
/></programlisting>.
</para>
</section>
-
+
+ <section id="configuringjobexecutor">
+ <title>Configuring the job executor</title>
+
+ <para>The job executor exposes a few properties you can tune. To change any of
the
+ values described below, edit the <literal>jbpm.job.executor</literal>
bean in
+ <literal>jbpm.cfg.xml</literal>. The role of the job executor is
described with
+ great detail in <xref linkend="thejobexecutor"></xref>.
+ </para>
+
+ <table><title>Job executor properties</title>
+ <tgroup cols='3'>
+ <colspec colname='attr' colwidth="*" />
+ <colspec colname='desc' colwidth="4*" />
+ <colspec colname="def" colwidth="*"/>
+
+ <thead>
+ <row>
+ <entry>Property</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry>nbrOfThreads</entry>
+ <entry>Size of the job executor thread pool</entry>
+ <entry>1</entry>
+ </row>
+ <row>
+ <entry>retries</entry>
+ <entry>Number of times the job executor retries a failed job</entry>
+ <entry>3</entry>
+ </row>
+ <row>
+ <entry>idleInterval</entry>
+ <entry>Period between checks for new jobs (milliseconds)</entry>
+ <entry>5 seconds</entry>
+ </row>
+ <row>
+ <entry>maxIdleInterval</entry>
+ <entry>When a job fails, the affected thread pauses for a period initially
equal
+ to <literal>idleInterval</literal>, which is increased twofold until it
reaches
+ <literal>maxIdleInterval</literal> (milliseconds)</entry>
+ <entry>1 hour</entry>
+ </row>
+ <row>
+ <entry>maxLockTime</entry>
+ <entry>Amount of time a job executor thread is allowed to hold a job before
+ the job is released and offered to other threads (milliseconds)</entry>
+ <entry>10 minutes</entry>
+ </row>
+ <row>
+ <entry>lockMonitorInterval</entry>
+ <entry>Period between checks for job lock times (milliseconds)</entry>
+ <entry>1 minute</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+
<section id="objectfactory">
<title>Object factory</title>
<para>The object factory can create objects according to a beans-like xml
configuration file.
Show replies by date