ar.com.asanteit.bundler

Class Bundler

java.lang.Object

ar.com.asanteit.bundler.Bundler

public class Bundler
extends Object

A small API for Object-Relational mapping.

Author:

mschonaker

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Bundler.Transaction

Constructor Summary

Constructors

Constructor and Description
Bundler()

Method Summary

Methods

Modifier and Type	Method and Description
static void	assertConnected()
static void	dumpDB(DataSource ds, PrintWriter writer, Character identifierQuote) Helper method that dumps all the tables in the database, including the Java types that should be used in mapping.
static <T> T	inflate(Class<T> type) "Inflates" the given type with the given DataSource.
static <T> T	inflate(Class<T> type, InputStream is)
static <T> T	inflate(Class<T> type, InputStream is, String dialect)
static <T> T	inflate(Class<T> type, Reader reader)
static <T> T	inflate(Class<T> type, Reader reader, String dialect)
static <T> T	inflate(Class<T> type, String dialect) "Inflates" the given type with the given DataSource.
static Bundler.Transaction	inheritReadTransaction(DataSource ds)
static Bundler.Transaction	inheritWriteTransaction(DataSource ds)
static Bundler.Transaction	readTransaction(DataSource ds)
static void	registerPrimitiveType(Class<?> type) Allows to register types, beside JRE primitive types, to be treated as primitive types instead of java beans.
static void	validate(Object o) Validates an already inflated object's bindings.
static Bundler.Transaction	writeTransaction(DataSource ds)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Bundler

public Bundler()

Method Detail

registerPrimitiveType

public static void registerPrimitiveType(Class<?> type)

Allows to register types, beside JRE primitive types, to be treated as primitive types instead of java beans.

inflate

public static <T> T inflate(Class<T> type)
                 throws IOException

"Inflates" the given type with the given DataSource.

Where inflate means creating a Proxy with the capability of mapping methods to queries.

Since the name of the file to load is not provided, the file is searched in the classpath with the name of the class followed by the "-bundler.xml" extension instead of the ".class" extension.

This method is the same than invoking inflate(Class, Reader, String), but taking the reader from the classpath and with null dialect.

Throws:

IOException

See Also:

inflate(Class, Reader, String)

inflate

public static <T> T inflate(Class<T> type,
            String dialect)
                 throws IOException

"Inflates" the given type with the given DataSource.

Where inflate means creating a Proxy with the capability of mapping methods to queries.

Since the name of the file to load is not provided, the file is searched in the classpath with the name of the class followed by the "-bundler.xml" extension instead of the ".class" extension.

This method allows to specify a "dialect" string to filter queries from the queries file.

Throws:

IOException

inflate

public static <T> T inflate(Class<T> type,
            InputStream is)
                 throws IOException

Throws:

IOException

inflate

public static <T> T inflate(Class<T> type,
            InputStream is,
            String dialect)
                 throws IOException

Throws:

IOException

inflate

public static <T> T inflate(Class<T> type,
            Reader reader)
                 throws IOException

Throws:

IOException

inflate

public static <T> T inflate(Class<T> type,
            Reader reader,
            String dialect)
                 throws IOException

Throws:

IOException

validate

public static void validate(Object o)

Validates an already inflated object's bindings.

Throws:

IllegalArgumentException - if the provided object is not a valid inflated object.

BundlerValidationException - if there is an inconsistency between methods and queries.

readTransaction

public static Bundler.Transaction readTransaction(DataSource ds)

inheritReadTransaction

public static Bundler.Transaction inheritReadTransaction(DataSource ds)

writeTransaction

public static Bundler.Transaction writeTransaction(DataSource ds)

inheritWriteTransaction

public static Bundler.Transaction inheritWriteTransaction(DataSource ds)

assertConnected

public static void assertConnected()

dumpDB

public static void dumpDB(DataSource ds,
          PrintWriter writer,
          Character identifierQuote)

Helper method that dumps all the tables in the database, including the Java types that should be used in mapping.