Giter VIP home page Giter VIP logo

spring-batch's Introduction

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 [email protected]: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.

spring-batch's People

Contributors

mminella avatar fmbenhassine avatar dsyer avatar chrisjs avatar spring-builds avatar jpraet avatar hpoettker avatar robokaso avatar drumonii avatar marschall avatar ghillert avatar willschipp avatar parikshitdutta avatar wilkinsona avatar wlund-pivotal avatar acktsap avatar quaff avatar cppwfs avatar mdeinum avatar garyrussell avatar tobiasflohre avatar magott avatar snicoll avatar dimitrisli avatar davidthexton avatar ddebree avatar spring-operator avatar benelog avatar lcmarvin avatar lucaslward avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.