[jbpm-commits] JBoss JBPM SVN: r6235 - in jbpm3/branches/jbpm-3.2-soa/modules: core/src/main/resources/org/jbpm and 1 other directories.

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>&lt;boolean name="jbpm.hide.stale.object.exceptions" value="false" /&gt;</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.