com.amazon.carbonado.repo.jdbc

Class JDBCStorableIntrospector

java.lang.Object

com.amazon.carbonado.info.StorableIntrospector

com.amazon.carbonado.repo.jdbc.JDBCStorableIntrospector

public class JDBCStorableIntrospector
extends StorableIntrospector

Provides additional metadata for a Storable type needed by JDBCRepository. The storable type must match to a table in an external database. All examined data is cached, so repeat examinations are fast, unless the examination failed.

Author:

Brian S O'Neill, Adam D Bradley, Tobias Holgers, Archit Shivaprakash, Matt Carlson

Constructor Summary

Constructors

Constructor and Description
JDBCStorableIntrospector()

Method Summary

Methods

Modifier and Type	Method and Description
static <S extends Storable> JDBCStorableInfo<S>	examine(java.lang.Class<S> type, javax.sql.DataSource ds, java.lang.String catalog, java.lang.String schema) Examines the given class and returns a JDBCStorableInfo describing it.

Methods inherited from class com.amazon.carbonado.info.StorableIntrospector

examine, inferType, main

Methods inherited from class java.lang.Object

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

Constructor Detail

JDBCStorableIntrospector

public JDBCStorableIntrospector()

Method Detail

examine

public static <S extends Storable> JDBCStorableInfo<S> examine(java.lang.Class<S> type,
                                               javax.sql.DataSource ds,
                                               java.lang.String catalog,
                                               java.lang.String schema)
                                                    throws java.sql.SQLException,
                                                           SupportException

Examines the given class and returns a JDBCStorableInfo describing it. A MalformedTypeException is thrown for a variety of reasons if the given class is not a well-defined Storable type or if it can't match up with an entity in the external database.

Parameters:

type - Storable type to examine

ds - source of JDBC connections to use for matching to a table

catalog - optional catalog to search

schema - optional schema to search

Throws:

MalformedTypeException - if Storable type is not well-formed

RepositoryException - if there was a problem in accessing the database

java.lang.IllegalArgumentException - if type is null

java.sql.SQLException

SupportException