Abator generates DAO classes of several types. For each table in the configuration, Abator
generates a Java Interface that describes DAO methods, and a Java Class that implements the
generated interface. Generating DAO objects is optional, and is controlled by the
<daoGenerator>
configuration element. Abator can generate DAOs of the following
types:
Every field and method generated by Abator includes the non-standard JavaDoc tag
@abatorgenerated
. On subsequent runs of Abator, every field and method that
includes this JavaDoc tag will be deleted and replaced. Any other field or method in the
class will be untouched by Abator.
With this in mind, you can add other fields and methods to the classes without fear of losing them in
subsequent runs of Abator - simply DO NOT include the @abatorgenerated
JavaDoc tag on anything that you add to the class.
Note: in the following descriptions, the term "BLOB" is used to refer to any column with a data type of BLOB, CLOB, LONGVARCHAR, or LONGVARBINARY.
Depending on the specifics of the table, and the configuration options, the DAO generator will generate these methods:
Abator attempts to make it easier to deal with tables that contain BLOBs by generating different objects and methods so that you can use the BLOB fields, or ignore them, depending on the situation.
See the
Example Class Usage
page for an example of using the selectByExample
method.
iBATIS DAOs depend on the iBATIS DAO framework (an optional part of iBATIS). They extend the SqlMapDaoTemplate class and are constructed with an instance of the DAOManager object, and call methods in their super class to execute the different statements.
Abator does not update the "dao.xml" file for you - you must add the appropriate entries manually.
The iBATIS DAO framework is a very elementary IoC container and is useful if you are not already using something like Spring or PicoContainer to manage dependencies.
SPRING DAOs depend on the Spring framework. They extend Spring's SqlMapClientDaoSupport class, and are constructed by the Spring container.
GENERIC-CI DAOs call methods in iBATIS' SqlMapClient interface directly. An instance of the interface is supplied through constructor injection.
GENERIC-SI DAOs call methods in iBATIS' SqlMapClient interface directly. An instance of the interface is supplied through setter injection.