JSaPar is a Java library providing a schema based parser and composer of CSV (Comma Separated Values) and flat files.
The goal of this project is to create a java library that contains a parser of flat files and csv files. The library should be simple to use and possible to extend.
- Support for flat files with fixed positions.
- Support for CSV files.
- The schema can be expressed with xml notation or created directly within the java code.
- The parser can either produce a Document class, representing the content of the file, or you can choose to receive events for each line that has been successfully parsed.
- Can handle huge files without loading everything into memory.
- The output Document class contains a list of lines which contains a list of cells.
- The Document class can be transformed into a Java object (via reflection) if the schema is carefully written.
- It is also possible to produce java objects directly from the parser.
- It is possible convert a list of java objects into a file according to a schema if the schema is carefully written.
- The Document class can be built from a xml file (according to an internal xml schema).
- The input and outputs are given by java.io.Reader and java.io.Writer which means that it is not necessarily files that are parsed or generated.
- The file parsing schema contains information about how to parse each cell regarding data type and syntax.
- Parsing errors can either be handled by exceptions thrown at first error or the errors can be collected during parsing to be able to deal with them later.
- JUnit tests for most classes within the library.
- Support for localisation.
Javadocs API documentation
This project has no dependencies to other external libraries in runtime.
However if you plan to build and test the source consider the following:
- To build the source it is recommended to use Apache Ant or Maven. An Ant build.xml and a Maven pom.xml are provided. As of version 1.6, the library is published in the public Maven repository.
- The provided test classes require JUnit4 in order to run.
- Since JSaPar 1.5.0 the library in the download packages are built with java 1.7. Earlier versions of the library in the download packages are built with java 1.6 but with target compatibility level 1.5. It is no guarantee that the library will work for earlier version of Java.
- The upcoming JSaPar version 2.0 will require Java 1.8.