legstar core V2

A COBOL to Java conversion framework.

A new take on the original legstar project

Objectives

• Provide conversion capabilities for data described by COBOL copybooks

• Provide a faster alternative to legstar for use cases that require massive conversions (Hadoop, ETL, ...)

• Provide a simpler API than legstar, using java generics, explicit thread safety and use Builder pattern/Fluent interfaces

• Extract out dependency on JAXB. While still supporting JAXB, the API should be usable in environments that has no JAXB at all

• Provide a validation API that allows checking preemptively that host data is compatible with a given COBOL copybook

Non objectives

• Backward compatibility with legstar. The API V2 is not compatible.

• Complete functional equivalence to legstar. Rarely used legstar features will not be ported to V2.

• Recognizes the IBM COBOL for z/OS syntax only. It may or may not work for other COBOL compilers.

Requirements

• Java JDK 6 and above (It is important that this is a JDK not a simple JRE)

• Maven 3 (If you build from sources)

• Ant 1.9.x (To run samples)

Build from sources

1. Clone the GIT repository

2. From a command window, while located in the folder where you cloned the repo, type:

mvn clean install

Run the base sample

If you built the project from sources, you will find the distribution zip file under legstar-core2/legstar-base-generator/target.

Otherwise you can get the latest released zip here.

Unzip the zip file in a location of your choice.

Go to the samples folder and type:

ant

Run the JAXB sample

If you built the project from sources, you will find the distribution zip file under legstar-core2/legstar-jaxb-generator/target.

Otherwise you can get the latest released zip here.

Unzip the zip file in a location of your choice.

Go to the samples folder and type:

ant