File	Date	Author	Commit
jdbcimporter-ant	2013-04-24	Chris Nagy	[1a58b5] [maven-release-plugin] prepare for next develop...
jdbcimporter-core	2013-04-24	Chris Nagy	[1a58b5] [maven-release-plugin] prepare for next develop...
jdbcimporter-samples	2013-04-22	Chris Nagy	[bcd7e5] Initial restruction for Maven
.gitignore	2013-04-23	Chris Nagy	[a8caca] Added target folder
README	2009-06-30	Christopher Nagy	[b660e9] Updated version number
build.properties	2009-06-28	Christopher Nagy	[92f96b] Added jxl.jar to samples classpath
build.xml	2009-06-30	Christopher Nagy	[b660e9] Updated version number
changes.txt	2009-06-30	Christopher Nagy	[b660e9] Updated version number
lgpl.txt	2002-07-05	Christopher Nagy	[24eeac] initial check-in
pom.xml	2013-04-24	Chris Nagy	[1a58b5] [maven-release-plugin] prepare for next develop...

Read Me

JDBCImporter v0.74
==============================

Contents of this Release
------------------------

README   - this file

lgpl.txt - license

build.xml, build.properties - Ant build script

lib/
  jdbcimporter.jar           - JDBC Importer framework
  jdbcimporter-anttask.jar   - JDBC Importer Ant tasks
  jdbcimporter-unittests.jar - JDBC Importer unit tests
  jdbcimporter-webtest.war   - JDBC Importer web test (see tests/webtest/README)
  commons-logging.jar        - Apache Commons Logging 1.0.2 (see commons-logging.license.txt)

docs/           - architecture and tutorial documents
  api           - javadoc

src/            - java source code  

samples/        - sample data and jdbcimporter xml configs

tests/          - additional tests

Installation
------------------------

Below are the installation steps for installing JDBCImporter:
 
- unzip the jdbcimporter.zip file 

- add jdbcimporter.jar and commons-logging.jar to the CLASSPATH.
  For example: set CLASSPATH=%CLASSPATH%;INSTALL_DIR\lib\jdbcimporter.jar;INSTALL_DIR\lib\commons-logging.jar 

JDBC Importer 
------------------------

Basic Usage


> java [options] net.sourceforge.jdbcimporter.Importer <config file> [plugin file] 

where :
   - config file : the import config file
   - plugin file : the (optional) property file that describes the
                   plugins available during the import
   - options : two system properties may be set (both are optional)
      1. jdbcimporter.engine = The import engine to use
      2. jdbcimporter.failonerror = Flag indicating that the import should end if an error occurrs
      
Extending 

There are 5 ways to extend JDBC Importer:

- creating a custom delimiter parser
- creating a custom row translator
- creating a custom column translator
- creating a custom connection definition
- creating a custom import engine

JDBC Exporter 
------------------------

Basic Usage


> java [options] net.sourceforge.jdbcexporter.Exporter <config file> [plugin file] 

where :
   - config file : the export config file
   - plugin file : the (optional) property file that describes the
                   plugins available during the export
   - options : one system properties may be set (optional)
      1. jdbcexporter.engine = The export engine to use

Extending 

There are 4 ways to extend JDBC Exporter:

- creating a custom delimiter formatter
- creating a custom column translator
- creating a custom connection definition
- creating a custom export engine

Data Generator 
------------------------

Basic Usage


> java net.sourceforge.datagenerator.DataGenerator <config file> [plugin file] 

where :
   - config file : the generate config file
   - plugin file : the (optional) property file that describes the
                   plugins available during the data generation

Extending 

There are 3 ways to extend Data Generator:

- creating a custom delimiter formatter
- creating a custom column value generator

Please see the tutorials and architecture document for more details.

Third Party Libraries
------------------------

- Apache Commons Logging (used for logging, included, see http://jakarta.apache.org/commons/logging)
- Apache Commons File Upload (used for webtest, included, see http://jakarta.apache.org/commons/fileupload)
- JUnit (used for unit testing, not included, see http://www.junit.org)