Sunday, October 6, 2013

Spring Batch "Hello World" 3

Posted in Java by Tareq Abedrabbo on Monday November 03, 2008
In part 1 and part 2 of this tutorial we saw the basic concepts of Spring Batch and implemented a simple tasklet based job . The focus of this last part is on item-oriented batch processing. This approach consists of reading bulk data, performing some calculation and outputting the result, one item at a time. As an example think of processing a large flat file composed of records and writing the output to a database. Each line in the file corresponds to an item: it will be read, transformed and output separately.
Spring Batch provides a solid foundation to implement item-oriented jobs and includes a collection of ready-to-use objects for common scenarios. Let's try to sum up the main objects that are involved here. First we have ItemReader, which is responsible of reading input data. Its main method is Object read() which returns the next item each time it is invoked, and null when the data is exhausted. This returned item is usually expected to map to a domain object. The counterpart of ItemReader is ItemWriter. As you can expect, its main role is to process and output items. Quite logically, its main method is void write(Object item).
Here is where ItemOrientedStep comes into play: it associates an ItemReader and anItemWriter and orchestrates the data flow between them: it calls repeatedly itsItemReader and hands the returned item to its ItemWriter until no more items are left. These read/wrtie couples are grouped into chunks, meaning that a transaction is started at the beginning of a chunk and committed at its end. The size of a chunk is configurable. Note also that ItemOrientedSteps support advanced behaviour such as restarting and fault tolerance.
Let's put all of this into practice with yet another marvelous Hello World example.

Hello World, Again

We will define a job that reads from a file formed of comma-separated records. Our job will replace the commas with spaces and write the output to a new file. Our file looks like this:


And the expected output is as follows:

Hello World !
Hello World !

Impressed? At least we are not going to write a single line of Java. We will be configuring objects provided by the framework instead!
We will use FlatFileItemReader and FlatFileItemWriter to implement our job, but first a word about FieldSetsFlatFileItemReader and FlatFileItemWriter read and write from text files but in-between we will be handling java domain objects with typed attributes. We need an object that abstracts this transformation; something similar toResultSets in JDBC. This is exactly the role of FieldSet. To put it in other words,FlatFileItemReader transforms (indirectly) a line into a FieldSet and then to a domain object whereas FlatFileItemWriter transforms back (indirectly again) a domain object to a FieldSet and then to a line (String) again.
Let's get back to our FlatFileItemReader now. Here's the bean definition:
  1. <bean id="itemReader" class="org.springframework.batch.item.file.FlatFileItemReader">  
  2.   <property name="resource" value="file:./hello.txt" />  
  3.   <property name="lineTokenizer" ref="lineTokenizer"/>  
  4.   <property name="fieldSetMapper" ref="fieldSetMapper"/>  
  5. </bean>  
The resource parameter is obviously the file to read. You notice that we wired 2 collaborators. LineTokenizer is responsible for transforming a line into a FieldSet. As for FieldSetMapper, it maps the obtained FieldSet to a domain object. Their bean definitions are the following:
  1. <bean id="lineTokenizer" class="org.springframework.batch.item.file.transform.DelimitedLineTokenizer"/>  
The DelimitedLineTokenizer delimiter defaults to comma, which is just what we need. Let's define our FieldSetMapper:
  1. <bean id="fieldSetMapper" class="org.springframework.batch.item.file.mapping.PassThroughFieldSetMapper"/>  
PassThroughFieldSetMapper passes the FieldSet directly without mapping it to an object. In our case this is fine since we don't really have domain objects and the transformation we are implementing is simple.
Let's define the FlatFileItemWriter now:
  1. <bean id="itemWriter" class="org.springframework.batch.item.file.FlatFileItemWriter">  
  2.   <property name="fieldSetCreator" ref="fieldSetMapper"/>  
  3.   <property name="lineAggregator" ref="lineAggregator"/>  
  4.   <property name="resource" value="file:./hello2.txt" />  
  5. </bean>  
You might have noticed how similar it is to the FlatFileItemReader's definition. Theresource property is the output file and again we have 2 collaborators. First, aFieldSetCreator is needed to transform the domain object to a FieldSet but because we kept the FieldSet as our object in the reading phase, we need aFieldSetCreator the does nothing. It happens that PassThroughFieldSetMapperimplements FieldSetCreator and does what we want so we will just inject it. Finally, we will dfine the LineAggregator:
  1. <bean id="lineAggregator" class="org.springframework.batch.item.file.transform.DelimitedLineAggregator">  
  2.   <property name="delimiter" value=" "/>  
  3. </bean>  
LineAggregator is the counterpart of LineTokenizer; its role is to transform aFieldSet to a String. We are replacing commas with spaces hence the value of the delimiter property.
Now we need to define our ItemOrientedStep. The simplest way is to useSimpleStepFactoryBean, which instantiate an ItemOrientedStep with sensible defaults. Notice that a transaction manager is also needed (for chunk management and job repository operations). In this example we will use aResourcelessTransactionManager which does nothing. Needles to say, this is completely inappropriate in most real scenarios.
  1. <bean id="transactionManager" class=""/>  
  3. <bean id="step" class="org.springframework.batch.core.step.item.SimpleStepFactoryBean">  
  4.   <property name="transactionManager" ref="transactionManager" />  
  5.   <property name="jobRepository" ref="jobRepository" />  
  6.   <property name="itemReader" ref="itemReader" />  
  7.   <property name="itemWriter" ref="itemWriter" />  
  8. </bean>  
We have our step ready. We just need to define the job:
  1. <bean id="simpleJob" class="org.springframework.batch.core.job.SimpleJob">  
  2.   <property name="name" value="simpleJob" />  
  3.   <property name="steps">  
  4.     <list>  
  5.       <ref local="step"/>  
  6.     </list>  
  7.   </property>  
  8.   <property name="jobRepository" ref="jobRepository"/>  
  9. </bean>  
We're done!

Running the Code

We will run the job as usual with Maven:

mvn exec:java -Dexec.mainClass= 
-Dexec.args="itemOrientedJob.xml simpleJob"

The code source can be downloaded here.

What's Next?

What's next is up to you! Don't hesitate to run the Spring Batch samples, to learn about the advanced features or simply to experiment. Good luck!


Anna said...

Great and Useful Article.

Online Java Course

Java Online Training

Java Course Online

Best Recommended books for Spring framework

Java Interview Questions

Java Training Institutes in Chennai

Java Training in Chennai

J2EE Training in Chennai

java j2ee training institutes in chennai

Java Course in Chennai

Zheng junxai5 said...

michael kors outlet clearance
jordan retro 4
kobe 8
coach factory outlet online
rolex watches
nike free uk
coach factory outlet
air max
kate spade handbags
louis vuitton outlet stores
cheap ray ban sunglasses
kd 8
ralph lauren polo
air jordan 4
jordan 6s
air jordan homme
michael kors outlet clearance
rolex watches
louis vuitton handbags
designer handbags
coach outlet online
cheap basketball shoes
oakley canada
kate spade outlet
louis vuitton bags
cheap jordans
toms wedges
longchamp handbags
ralph lauren home
coach outlet
louis vuitton outlet
michael kors outlet
kate spade outlet
nike air max uk
michael kors outlet
louis vuitton outlet stores
montblanc pen
true religion outlet

raybanoutlet001 said...

adidas stan smith uk
jordan retro
michael kors handbags
tiffany and co
kobe basketball shoes
ray ban sunglasses
michael kors outlet store
fitflops clearance
cheap rolex watches
fitflops outlet
adidas tubular UK
cheap nfl jerseys
yeezy boost 350
jordans for cheap
tiffany and co jewellery
cheap jordan shoes
nike huarache
adidas tubular
cheap oakleys
adidas nmd runner
michael kors handbags clearamce
coach outlet online
jordans for cheap