Introduction to Ibator

Ibator is a code generator for iBATIS. Ibator will introspect a database table (or many tables) and will generate iBATIS artifacts that can be used to access the table(s). This abates some of the initial nuisance of setting up objects and configuration files to interact with database tables. Ibator seeks to make a major impact on the large percentage of database operations that are simple CRUD (Create, Retrieve, Update, Delete). You will still need to hand code SQL and objects for custom queries, or stored procedures.

Ibator will generate:

Ibator can run as a standalone JAR file, or as an Ant task, or as an Eclipse plugin.

About the Name

Ibator is an iBATIS stylized version of the English word "abator". Abator means "one who abates a nuisance".

Ibator News

(December 22, 2008) Ibator version 1.2.1 is released. This version fixes a couple of bugs that manifested in the Eclipse plugin, enhances the Plugin API, and adds a couple of features to the Eclipse plugin. Even though this is a relatively minor release, we recommend that everyone upgrade.

(December 11, 2008) Ibator version 1.2.0 is released. This version has several important enhancements over Abator 1.1.0. See the What's New? section of the online documentation for full details. Note that Ibator requires Java 5.0 or greater. The Eclipse plugin requires Eclipse 3.4.1 or greater. Ibator generates code compatible with iBATIS version 2.2.0 or greater.

(April 14, 2008) Due to a trade registration dispute, Abator is renamed to Ibator. iBATOR is currently under development. The initial source code drop can be checked out from SVN at http://svn.apache.org/repos/asf/ibatis/java/ibator/

(March 20, 2008) Updated Abator and the Eclipse plugin to version 1.1.0. This is an extensive update that includes quite a few minor enhancements, two major enhancements (two new methods can be generated), and a few bug fixes. See the What's New? section of the online documentation for full details.

(August 20, 2006) Updated Abator and the Eclipse plugin to version 1.0.0. This is an extensive update that includes many new features including the ability to generate code for Java 5, generate different types of domain models, and hugely improved "by example" methods. See the "What's New?" section of the online documentation for full details.

Ibator Software Downloads and Documentation

Download the standalone JAR if you are using an IDE other than Eclipse. The standalone JAR includes an Ant task to run Ibator, or you can run Ibator from the command line of from Java code.

Documentation for the core functions of Ibator is available online. This documentation set is also included in the downloads, and is integrated into the Eclipse help system if you are using the Eclipse plugin.

Documentation for the Eclipse specific features is integrated into the Eclipse help system and is not available online.

Eclipse Plugin

When run as an Eclipse plugin, Ibator will persist the generated Java classes and SqlMap files in Eclipse projects. Ibator can be run iteratively multiple time as the database design matures - and any hand coded additions to generated Java classes or SqlMap files will remain undisturbed.

Documentation for Ibator is integrated into the Eclipse help system.

Requirements

Automatic Eclipse Install

If you've already installed a prior version of Ibator, simply run the Eclipse Update tool and the new version will be found automatically.

If you've not previously installed Ibator, use the built in Eclipse install support by following these steps:

  1. Take the "Help>Software Updates..." Menu Option
  2. Select the "Available Software" Tab
  3. Press the "Add Site" button
  4. Enter the following information:
    Location:
    http://ibatis.apache.org/tools/ibator
  5. Press OK
  6. Check the box next to "Apache iBATIS Ibator Feature"
  7. Press the "Install" button
  8. Follow the remainder of the install wizard

Manual Eclipse Install

The automatic install is much preferred, but you can also install Ibator manually if you desire. To install manually, download the file IbatorForEclipse1.2.1.zip and unzip the file to some convenient location. After unzipping the update site archive, follow these steps in Eclipse:

  1. Take the "Help>Software Updates..." Menu Option
  2. Select the "Available Software" Tab
  3. Press the "Add Site" button
  4. Press the "Local" button
  5. Navigate to the location where you unzipped the site archive
  6. Press OK
  7. Check the box next to "Apache iBATIS Ibator Feature"
  8. Press the "Install" button
  9. Follow the remainder of the install wizard

Legacy Abator Software Downloads and Documentation

Download the standalone JAR if you are using an IDE other than Eclipse. The standalone JAR includes an Ant task to run Abator, or you can run Abator from the command line of from Java code.

Documentation for the core functions of Abator is available online. This documentation set is also included in the downloads, and is integrated into the Eclipse help system if you are using the Eclipse plugin.

Documentation for the Eclipse specific features is integrated into the Eclipse help system and is not available online.

Legacy Abator Eclipse Plugin

When run as an Eclipse plugin, Abator will persist the generated Java classes and SqlMap files in Eclipse projects. Abator can be run iteratively multiple time as the database design matures - and any hand coded additions to generated Java classes or SqlMap files will remain undisturbed.

Documentation for Abator is integrated into the Eclipse help system.

Requirements

Automatic Eclipse Install

If you've already installed a prior version of Abator, simply run the Eclipse Install/Update tool and the new version will be found automatically.

If you've not already installed Abator, then you can use the built in Eclipse install support by following these steps:

  1. Take the "Help>Software Updates>Find and Install" Menu Option
  2. Select the "Search for new features to install" radio button, press "Next"
  3. Press the "New Remote Site" button
  4. Enter the following information:
    Name:
    Abator for Eclipse Update Site
    URL:
    http://ibatis.apache.org/tools/abator
  5. Press OK
  6. Check the box next to "Abator for Eclipse Update Site"
  7. Follow the remainder of the install wizard

Manual Eclipse Install

The automatic install is much preferred, but you can also install Abator manually if you desire. To install manually, download the file AbatorForEclipse1.1.0.zip and unzip the file to some convenient location. After unzipping the update site archive, follow these steps in Eclipse:

  1. Take the "Help>Software Updates>Find and Install" Menu Option
  2. Select the "Search for new features to install" radio button, press "Next"
  3. Press the "New Local Site" button
  4. Navigate to the location where you unzipped the file.
  5. Press OK
  6. Follow the remainder of the install wizard