Overview

This module provides reusable batch components for common batch tasks. To use a jberet-support batch component, you will typically need to do the following:

• include dependencies needed by the component;
• reference the component in job XML in either of the following ways:
  • by its CDI bean name, typically the short class name de-capitalized;
  • by the name declared for the component in batch.xml in your application;
  • by the fully-qualified class name of the component.
• configure any batch properties in job XML for the component.

The following is a list of reusable components in jberet-support:

• REST resources:

  • RestItemReader
  • RestItemWriter

• Fixed-width files and other formats supported by BeanIO:

  • BeanIOItemReader
  • BeanIOItemWriter

• CSV with supercsv or Jackson CSV

  • CsvItemReader
  • CsvItemWriter
  • JacksonCsvItemReader
  • JacksonCsvItemWriter

• Excel

  • ExcelEventItemReader
  • ExcelStreamingItemReader
  • ExcelStreamingItemWriter
  • ExcelUserModelItemReader
  • ExcelUserModelItemWriter

• JDBC

  • JdbcItemReader
  • JdbcItemWriter

• MongoDB NoSQL

  • MongoItemReader
  • MongoItemWriter

• Messaging

  • JmsItemReader
  • JmsItemWriter
  • KafkaItemReader
  • KafkaItemWriter
  • ArtemisItemReader
  • ArtemisItemWriter

• JSON

  • JsonItemReader
  • JsonItemWriter

• XML

  • XmlItemReader
  • XmlItemWriter

• Jasper Reports

  • JasperReportsBatchlet

• JNDI ObjectFactory classes for custom JNDI resources in Java EE

  • MappingJsonFactoryObjectFactory
  • MongoClientObjectFactory
  • NoMappingJsonFactoryObjectFactory
  • XmlFactoryObjectFactory

• DynamoDB (AWS NoSQL database)

  • DynamoDbItemReader
  • DynamoDbItemWriter

Documentation

JBeret Docs contains JBeret User Guide and jberet-support Java Docs, which describes how to use and configure jberet-support batch components.

Build and Test

All tests in this module run batch jobs in Java SE environment, and therefore no application server is needed. There are 2 maven profiles for different testing setup:

• allTests: include tests that need MongoDB and DynamoDbLocal server running. So users will need to start MongoDB and DynamoDb Local servers before running these tests. A docker-compose.yml is provided to easily start those servers.
• default: exclude all tests that need additional server running.

To clean, build, and run the default maven profile:

    mvn clean install

To clean, build, and run allTests maven profile:

    [in a Mongo terminal]
    $MONGO_HOME/bin/mongod   

    [in a DynamoDB terminal]
    export AWS_ACCESS_KEY_ID="JBeret"
    export AWS_SECRET_ACCESS_KEY="JBeret"
    export AWS_REGION="eu-west-1"   
    java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -sharedDb
    
    mvn clean install -PallTests -Djberet.tmp.dir=/tmp

Or with Docker compose

    docker-compose up -d    
    mvn clean install -PallTests -Djberet.tmp.dir=/tmp

Other Examples

• wildfly-jberet-samples module contains sample web applications that use jberet-support components in Java EE, WildFly and JBoss EAP environment.

• tests directory contains tests for every jberet-support component running in Java SE environment.

• Search in JBeret JIRA Issue Track