com.webobjects.jdbcadaptor
Class MicrosoftPlugIn

java.lang.Object
  com.webobjects.jdbcadaptor.JDBCPlugIn
      com.webobjects.jdbcadaptor.MicrosoftPlugIn

Direct Known Subclasses:

MerantPlugIn

public class MicrosoftPlugIn
extends JDBCPlugIn

Nested Class Summary

static class	MicrosoftPlugIn.MicrosoftExpression
static class	MicrosoftPlugIn.MicrosoftSynchronizationFactory

Nested classes/interfaces inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

JDBCPlugIn.LobEntry

Field Summary

Fields inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

DefaultPlugInClassName, DefaultPlugInSuffix

Constructor Summary

MicrosoftPlugIn(JDBCAdaptor adaptor)

Method Summary

String	connectionURL() Returns the JDBC URL to use for connecting to the database.
EOSchemaSynchronizationFactory	createSchemaSynchronizationFactory() Creates a new EOSynchronizationFactory using the plugin's response to adaptor().
String	databaseProductName() Returns a string identifying the database.
String	defaultDriverName() Returns a fully qualified name of the JDBC driver class that this plugin prefers to use.
Class	defaultExpressionClass() Returns the Java Class to use as the expression class.
boolean	isDroppedConnectionException(JDBCAdaptorException exception) Returns true if exception is considered a "dropped" connection; otherwise false.
NSDictionary	jdbcInfo() Returns database-specific information about the JDBC data source.
String	name() Returns the plugin's name.
String	newPrimaryKeySelectString(String pkTableName, String entityRootName) The statement for selecting the primary key for a given entity.

Methods inherited from class com.webobjects.jdbcadaptor.JDBCPlugIn

adaptor, assignTypeForAttribute, canDescribeStoredProcedure, connectionPropertiesForConnectionDictionary, createAttributeForRow, createExpressionFactory, createSynchronizationFactory, databaseInformation, expressionFactory, fetchBLOB, fetchCLOB, isPseudoColumnName, jdbcTypeForUnknownExternalType, newPrimaryKeys, plugInNameForURL, plugInValueForValue, primaryKeyLockString, primaryKeyTableCreateString, primaryKeyTableName, removePlugInNameForSubprotocol, schemaNameForEntity, schemaSynchronizationFactory, setPlugInNameForSubprotocol, sqlStatementForGettingProcedureNames, sqlStatementForGettingTableNames, sqlStatementForTableNamed, storedProcedureCatalogPattern, storedProcedureNamed, storedProcedureSchemaPattern, synchronizationFactory, tableTypes, updateLOBs, wildcardPatternForAttributes, wildcardPatternForSchema, wildcardPatternForTables

Methods inherited from class java.lang.Object

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

Constructor Detail

MicrosoftPlugIn

public MicrosoftPlugIn(JDBCAdaptor adaptor)

Method Detail

name

public String name()

Description copied from class: JDBCPlugIn

Returns the plugin's name. Subclasses of JDBCPlugIn need to override this method.

Overrides:

name in class JDBCPlugIn

Returns:

The name of the receiver.

defaultDriverName

public String defaultDriverName()

Description copied from class: JDBCPlugIn

Returns a fully qualified name of the JDBC driver class that this plugin prefers to use. The adaptor will attempt to load this class when making a connection. Subclasses should override.

Overrides:

defaultDriverName in class JDBCPlugIn

Returns:

JDBC driver class name

databaseProductName

public String databaseProductName()

Description copied from class: JDBCPlugIn

Returns a string identifying the database. Subclasses should override.

Overrides:

databaseProductName in class JDBCPlugIn

Returns:

a String identifying the database

connectionURL

public String connectionURL()

Description copied from class: JDBCPlugIn

Returns the JDBC URL to use for connecting to the database. The default implementation gets the URL from the adaptor.

Overrides:

connectionURL in class JDBCPlugIn

Returns:

a JDBC URL

See Also:

JDBCAdaptor.connectionDictionaryURL()

defaultExpressionClass

public Class defaultExpressionClass()

Description copied from class: JDBCPlugIn

Returns the Java Class to use as the expression class. The default is JDBCExpression. Subclasses will typically override to use their own subclass of JDBCExpression.

Overrides:

defaultExpressionClass in class JDBCPlugIn

Returns:

a Java Class (subclass of JDBCExpression)

See Also:

JDBCExpression, JDBCAdaptor.defaultExpressionClass()

createSchemaSynchronizationFactory

public EOSchemaSynchronizationFactory createSchemaSynchronizationFactory()

Description copied from class: JDBCPlugIn

Creates a new EOSynchronizationFactory using the plugin's response to adaptor(). The default EOSynchronizationFactory supports only basic SQL table generation. Subclasses need to override this method to support schema synchronization.

Overrides:

createSchemaSynchronizationFactory in class JDBCPlugIn

Returns:

a JDBCExpressionFactory

See Also:

JDBCPlugIn.synchronizationFactory()

jdbcInfo

public NSDictionary jdbcInfo()

Description copied from class: JDBCPlugIn

Returns database-specific information about the JDBC data source. Subclasses may want to return a modified copy of the dictionary returned by calling super.

Overrides:

jdbcInfo in class JDBCPlugIn

Returns:

an NSDictionary describing database-specific information about the JDBC data source

newPrimaryKeySelectString

public String newPrimaryKeySelectString(String pkTableName,
                                        String entityRootName)

Description copied from class: JDBCPlugIn

The statement for selecting the primary key for a given entity. Statement can be overridden in subclassers. By default return null. SELECT PK FROM EO_PK_TABLE WHERE NAME = 'MOVIE' FOR UPDATE

Overrides:

newPrimaryKeySelectString in class JDBCPlugIn

Returns:

SQL string for selecting primary key from EO_PK_TABLE for a given table

isDroppedConnectionException

public boolean isDroppedConnectionException(JDBCAdaptorException exception)

Description copied from class: JDBCPlugIn

Returns true if exception is considered a "dropped" connection; otherwise false. The adaptor will try to reconnect automatically from a dropped connection. The decision is based on the SQLState of the underlying SQLException that is wrapped by the JDBCAdaptorException. For any other type of Exception, this method returns false.

Overrides:

isDroppedConnectionException in class JDBCPlugIn

Returns:

true if exception is a "dropped" connection; otherwise false