After the recent efforts made in jOOX, developments of jOOQ have been continued. The main new feature of the upcoming release 1.6.5 is the support for loading of CSV data. The jOOQ Factory will now provide access to a dedicated fluent API for loading CSV files into generated tables, specifying a field mapping and various other parameters related to the batch-processing of bulk loads. Some sample code of what the API might look like:
// The typical jOOQ factory Factory create = new Factory(connection, SQLDialect.ORACLE); // Configure and execute a Loader object Loader<TAuthor> loader = create.loadInto(AUTHOR) .onDuplicateKeyError() .onErrorAbort() .commitAll() .loadCSV("1;'Kafka'\n" + "2;Frisch") .fields(Author.ID, Author.LAST_NAME) .quote('\'') .separator(';') .ignoreRows(0) .execute(); // The resulting Loader object then holds various // information about the loading process: // The number of processed rows int processed = loader.processed(); // The number of stored rows (INSERT or UPDATE) int stored = loader.stored(); // The number of ignored rows (due to errors, or duplicate rule) int ignored = loader.ignored(); // The errors that may have occurred during loading List<LoaderError> errors = loader.errors(); LoaderError error = errors.get(0); // The exception that caused the error SQLException exception = error.exception(); // The row that caused the error int rowIndex = error.rowIndex(); String row = error.row(); // The query that caused the error Query query = error.query();
Along with the previously implemented export API, it is easy to export results from org.jooq.Result into CSV, let users modify them in Excel or any other office software, and upload the CSV again. Other ideas for future versions of jOOQ will also include loading data from XML and JSON data sources, “merging” data (i.e. including DELETE operations), etc.
Feedback is very welcome.