org.apache.cayenne.dba.derby

Class DerbyAdapter

java.lang.Object

org.apache.cayenne.dba.JdbcAdapter

org.apache.cayenne.dba.derby.DerbyAdapter

All Implemented Interfaces:

DbAdapter

public class DerbyAdapter
extends JdbcAdapter

DbAdapter implementation for the Derby RDBMS . Sample connection settings to use with Derby are shown below.

Embedded

  test-derby.jdbc.url = jdbc:derby:testdb;create=true
  test-derby.jdbc.driver = org.apache.derby.jdbc.EmbeddedDriver
 

Network Server

  derbynet.jdbc.url = jdbc:derby://localhost/cayenne
  derbynet.jdbc.driver = org.apache.derby.jdbc.ClientDriver
  derbynet.jdbc.username = someuser
  derbynet.jdbc.password = secret;
 

Field Summary

Fields inherited from class org.apache.cayenne.dba.JdbcAdapter

batchQueryBuilderFactory, caseInsensitiveCollations, ejbqlTranslatorFactory, extendedTypes, logger, quotingStrategy, resourceLocator, supportsBatchUpdates, supportsGeneratedKeys, supportsUniqueConstraints, typesHandler

Constructor Summary

Constructors

Constructor and Description
DerbyAdapter(RuntimeProperties runtimeProperties, List<ExtendedType> defaultExtendedTypes, List<ExtendedType> userExtendedTypes, List<ExtendedTypeFactory> extendedTypeFactories, ResourceLocator resourceLocator)

Method Summary

Methods

Modifier and Type	Method and Description
void	bindParameter(PreparedStatement statement, Object object, int pos, int sqlType, int precision) Binds an object value to PreparedStatement's numbered parameter.
protected void	configureExtendedTypes(ExtendedTypeMap map) Installs appropriate ExtendedTypes as converters for passing values between JDBC and Java layers.
protected EJBQLTranslatorFactory	createEJBQLTranslatorFactory() Creates and returns an EJBQLTranslatorFactory used to generate visitors for EJBQL to SQL translations.
protected PkGenerator	createPkGenerator() Creates and returns a primary key generator.
void	createTableAppendColumn(StringBuffer sqlBuffer, DbAttribute column) Appends SQL for column creation to CREATE TABLE buffer.
QualifierTranslator	getQualifierTranslator(QueryAssembler queryAssembler) Returns a trimming translator.
MergerFactory	mergerFactory()
boolean	typeSupportsLength(int type) Returns true if supplied type can have a length attribute as a part of column definition

Methods inherited from class org.apache.cayenne.dba.JdbcAdapter

buildAttribute, createFkConstraint, createQuotingStrategy, createTable, createTableAppendPKClause, createUniqueConstraint, dropTableStatements, externalTypesForJdbcType, findResource, getAction, getBatchQueryBuilderFactory, getBatchTerminator, getEjbqlTranslatorFactory, getExtendedTypes, getJdbcEventLogger, getPkGenerator, getQuotingStrategy, getQuotingStrategy, getType, initExtendedTypes, setBatchQueryBuilderFactory, setEjbqlTranslatorFactory, setPkGenerator, setSupportsBatchUpdates, setSupportsGeneratedKeys, setSupportsUniqueConstraints, sizeAndPrecision, supportsBatchUpdates, supportsGeneratedKeys, supportsUniqueConstraints, tableTypeForTable, tableTypeForView, unwrap

Methods inherited from class java.lang.Object

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

Constructor Detail

DerbyAdapter

public DerbyAdapter(RuntimeProperties runtimeProperties,
            List<ExtendedType> defaultExtendedTypes,
            List<ExtendedType> userExtendedTypes,
            List<ExtendedTypeFactory> extendedTypeFactories,
            ResourceLocator resourceLocator)

Method Detail

createPkGenerator

protected PkGenerator createPkGenerator()

Description copied from class: JdbcAdapter

Creates and returns a primary key generator. This factory method should be overriden by JdbcAdapter subclasses to provide custom implementations of PKGenerator.

Overrides:

createPkGenerator in class JdbcAdapter

configureExtendedTypes

protected void configureExtendedTypes(ExtendedTypeMap map)

Installs appropriate ExtendedTypes as converters for passing values between JDBC and Java layers.

Overrides:

configureExtendedTypes in class JdbcAdapter

createTableAppendColumn

public void createTableAppendColumn(StringBuffer sqlBuffer,
                           DbAttribute column)

Appends SQL for column creation to CREATE TABLE buffer. Only change for Derby is that " NULL" is not supported.

Specified by:

createTableAppendColumn in interface DbAdapter

Overrides:

createTableAppendColumn in class JdbcAdapter

Parameters:

sqlBuffer - the StringBuffer to append the column type to

column - the DbAttribute defining the column to append type for

Since:

1.2

typeSupportsLength

public boolean typeSupportsLength(int type)

Description copied from class: JdbcAdapter

Returns true if supplied type can have a length attribute as a part of column definition

Specified by:

typeSupportsLength in interface DbAdapter

Overrides:

typeSupportsLength in class JdbcAdapter

getQualifierTranslator

public QualifierTranslator getQualifierTranslator(QueryAssembler queryAssembler)

Returns a trimming translator.

Specified by:

getQualifierTranslator in interface DbAdapter

Overrides:

getQualifierTranslator in class JdbcAdapter

createEJBQLTranslatorFactory

protected EJBQLTranslatorFactory createEJBQLTranslatorFactory()

Description copied from class: JdbcAdapter

Creates and returns an EJBQLTranslatorFactory used to generate visitors for EJBQL to SQL translations. This method should be overriden by subclasses that need to customize EJBQL generation.

Overrides:

createEJBQLTranslatorFactory in class JdbcAdapter

Since:

3.1

mergerFactory

public MergerFactory mergerFactory()

Specified by:

mergerFactory in interface DbAdapter

Overrides:

mergerFactory in class JdbcAdapter

bindParameter

public void bindParameter(PreparedStatement statement,
                 Object object,
                 int pos,
                 int sqlType,
                 int precision)
                   throws SQLException,
                          Exception

Description copied from interface: DbAdapter

Binds an object value to PreparedStatement's numbered parameter.

Specified by:

bindParameter in interface DbAdapter

Overrides:

bindParameter in class JdbcAdapter

Throws:

SQLException

Exception