This tutorial shows how to implement a Spring Batch to load all the stock symbols in a database.

Here you can find the github project:

In the project I’ve included the files containing the list of symbols


You can download the updated version of these files from the web site.

Example of the content:


The goal of the tutorial is to read the files and transform the content in Java Objects to save in a MySQL database.

In spring-batch.xml we define how the batch has to work:

  1. Load multiple files

SpringBatch easily reads data from more than 1 file. You have to implement a MultiResourceItemReader. The reading action is delegated to symbolItemReader:

<bean id="multiResourceReader" class="org.springframework.batch.item.file.MultiResourceItemReader">
    <property name="resources" value="classpath*:/*.csv"/>
    <property name="delegate" ref="symbolItemReader"/>
<!-- spring already has a standard flat file reader -->
    <bean id = "symbolItemReader" class="org.springframework.batch.item.file.FlatFileItemReader">
        <!-- the name of the file in the resources directory that contains the symbols -->

        <!-- the first line contains the name of the columns, skip it -->
        <property name="linesToSkip" value="1"/>
        <!-- we use a default line mapper, each line is transformed in a predefined bean -->
        <property name="lineMapper">
            <bean class = "org.springframework.batch.item.file.mapping.DefaultLineMapper">
                <!-- map of the fields -->
                <property name="fieldSetMapper" ref="symbolFieldSetMapper"/>
                <property name="lineTokenizer" ref="symbolLineTokenizer"/>

symbolItemReader uses the already existing FlatFileItemReader. We tells to the ItemReader that the first line contains the titles and has not to be read (linesToSkip=1).

lineMapper defines how the file lines have to be transformed.

lineTokenizer defines what is the content of the file. In this case we simply copy the name of the columns as defined in the file (you can change it) and we define as delimiter the “,”:

<!-- here we can define which is the delimiter of the values in the file and the name of the columns -->
<!-- the names of the columns can change from the original names in the file -->
    <bean id = "symbolLineTokenizer" class="org.springframework.batch.item.file.transform.DelimitedLineTokenizer">
        <property name="delimiter" value=","/>
        <property name="names" value="Symbol, Name, LastSale, MarketCap, ADR TSO, IPOyear, Sector, Industry, Summary Quote, empty"/> 

fieldMapper copy the content of each line of the file and convert it in a java object. The columns are the same declared in the lineTokenizer:

public class EquityFieldSetMapper implements FieldSetMapper {

    public Equity mapFieldSet(FieldSet fieldSet) throws BindException {
        Equity equityImporter = new Equity();
        equityImporter.setSummaryQuote(fieldSet.readString("Summary Quote"));

        return equityImporter;

To write to the database we can use JpaItemWriter:

<bean id="jpaBatchWriter" class = "org.springframework.batch.item.database.JpaItemWriter">
    <property name="entityManagerFactory" ref="entityManagerFactory"/>

We declared how where to read, how to read and how to write. We need to connect all the pieces together in a step.

We had to define an itemProcessor (needed to transform the data) but it doesn’t do anything, it’s just a requirement.

The transactionManager has nothing special, here it’s important to note the commitInterval that defines the frequency of the database commits.

<!-- here we glue together all the pieces -->
    <bean id = "simpleStep" class="org.springframework.batch.core.step.factory.SimpleStepFactoryBean">
        <property name="transactionManager" ref="transactionManager"/>
        <property name="jobRepository"  ref="jobRepository"/>
        <property name="itemReader" ref="multiResourceReader"/>
        <property name="itemProcessor"  ref="simpleProcessor"/>
        <property name="itemWriter" ref="jpaBatchWriter"/>
        <property name="commitInterval" value="10"/>

The step has to be part of a Job:

<bean id="importJob" parent="simpleJob">
    <property name="steps">
            <ref bean="simpleStep"/>

You can launch the job from your Java code:

    @Qualifier(value = "importJob")
    Job job;

    public void testJob() throws Exception{
         JobParametersBuilder builder = new JobParametersBuilder();
        JobExecution jobExecution =, builder.toJobParameters());
        assertEquals("COMPLETED", jobExecution.getExitStatus().getExitCode());