/spring-batch

Spring Batch is a framework for writing offline and batch applications using Spring and Java

Primary LanguageJavaApache License 2.0Apache-2.0

Spring Batch build status

Spring Batch is a lightweight, comprehensive batch framework designed to enable the development of robust batch applications vital for the daily operations of enterprise systems. Spring Batch builds upon the productivity, POJO-based development approach, and general ease of use capabilities people have come to know from the Spring Framework, while making it easy for developers to access and leverage more advanced enterprise services when necessary.

If you are looking for a runtime orchestration tool for your Batch applications, or need a management console to view current and historic executions, take a look at Spring Cloud Data Flow. It is an orchestration tool for deploying and executing data integration based microservices including Spring Batch applications.

Code of Conduct

Please see our code of conduct.

Reporting Security Vulnerabilities

Please see our Security policy.

Building from Source

Clone the git repository using the URL on the Github home page:

$ git clone git@github.com:spring-projects/spring-batch.git
$ cd spring-batch

Command Line

Maven is the build tool used for Spring Batch. You can build the project with the following command:

$ ./mvnw package

If you want to perform a full build with all integration tests, then run:

$ ./mvnw verify

Please note that some integration tests are based on Docker, so please make sure to have Docker up and running before running a full build.

To generate the reference documentation, run the following commands:

$ ./mvnw javadoc:aggregate
$ cd spring-batch-docs
$ ../mvnw site

The reference documentation can be found in spring-batch-docs/target.

Spring Tool Suite (STS)

In STS (or any Eclipse distro or other IDE with Maven support), import the module directories as existing projects. They should compile and the tests should run with no additional steps.

Using Docker

If you want to build the project in a Docker container, you can proceed as follows:

$> docker run -it --mount type=bind,source="$(pwd)",target=/spring-batch maven:3-openjdk-17 bash
#> cd spring-batch
#> ./mvnw package

This will mount the source code that you cloned previously on the host inside the container. If you want to work on a copy of the source code inside the container (no side effects on the host), you can proceed as follows:

$> docker run -it maven:3-openjdk-17 bash
#> git clone https://github.com/spring-projects/spring-batch.git
#> cd spring-batch
#> ./mvnw package

Getting Started Using Spring Boot

This is the quickest way to get started with a new Spring Batch project. You find the Getting Started Guide for Spring Batch on Spring.io: Creating a Batch Service

Getting Started Using Spring Tool Suite (STS)

It requires an internet connection for download, and access to a Maven repository (remote or local).

  • Download STS version 3.4.* (or better) from the Spring website. STS is a free Eclipse bundle with many features useful for Spring developers.
  • Go to File->New->Spring Template Project from the menu bar (in the Spring perspective).
  • The wizard has a drop down with a list of template projects. One of them is a "Simple Spring Batch Project". Select it and follow the wizard.
  • A project is created with all dependencies and a simple input/output job configuration. It can be run using a unit test, or on the command line (see instructions in the pom.xml).

Getting Help

Read the main project website and the User Guide. Look at the source code and the Javadocs. For more detailed questions, use StackOverflow. If you are new to Spring as well as to Spring Batch, look for information about Spring projects.

Contributing to Spring Batch

Here are some ways for you to get involved in the community:

  • Get involved with the Spring Batch community on Twitter and StackOverflow by responding to questions and joining the debate.
  • Create issues for bugs and new features and comment and vote on the ones that you are interested in.
  • Github is for social coding: if you want to write code, we encourage contributions through pull requests from forks of this repository. If you want to contribute code this way, please familiarize yourself with the process outlined for contributing to Spring projects here: Contributor Guidelines.
  • Watch for upcoming articles on Spring by subscribing to spring.io.

Before we accept a non-trivial patch or pull request we will need you to sign the contributor's agreement. Signing the contributor's agreement does not grant anyone commit rights to the main repository, but it does mean that we can accept your contributions, and you will get an author credit if we do. Active contributors might be asked to join the core team, and given the ability to merge pull requests.