Spring/spring-batch
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

BATCH-1069: Added section to Step chapter about standalone steps.

Browse Source
This commit is contained in:
lucasward
2009-02-11 17:04:03 +00:00
parent 5fd6288ba6
commit 47747b58ab
1 changed files with 38 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/src/site/docbook/reference/step.xml
View File

@@ -123,6 +123,44 @@
directly passed from the reader to the writer.</para>
</section>
<section>
<title>Referencing a Standalone Step</title>
<para>While steps must exist within a Job to define the flow, it can
sometimes be useful to reference a 'standalone' Step. For example, if a
Step is used by multiple jobs it can be useful to declare it once and
reference it from multiple jobs. This can be achieved with the ref
attribute:</para>
<programlisting>
&lt;job id="sampleJob"&gt;
&lt;step id="step1" <emphasis role="bold">ref="standaloneStep"</emphasis> /&gt;
&lt;/job&gt;
&lt;step id="standaloneStep" job-repository="jobRepository" transaction-manager="transactionManager"&gt;
&lt;tasklet reader="itemReader" writer="itemWriter" commit-interval="10"/&gt;
&lt;/step&gt;
</programlisting>
<para>It should be noted that the id attribute is still required on the
step within the job element. This is for two reasons:</para>
<orderedlist>
<listitem>
<para>The Id will be used as the step name when persisting the
StepExecution, if the same standalone step is referenced in more
than one step in the job, an error will occur.</para>
</listitem>
<listitem>
<para>When creating job flows, as described later in this chapter,
the next attribute should be referring to the step in the flow, not
the standalone step.</para>
</listitem>
</orderedlist>
</section>
<section>
<title>The Commit Interval</title>