PATH  WebObjects 4.0 Documentation > SybaseEOAdaptor Reference



OracleAdaptor

Inherits From:
EOAdaptor : NSObject

Declared in: OracleEOAdaptor/OracleAdaptor.h


Class Description

An OracleAdaptor represents a single connection to an Oracle database server, and is responsible for keeping login and model information, performing Oracle-specific formatting of SQL expressions, and reporting errors.

The OracleAdaptor class has these restrictions: You can't have nested transactions, and the adaptor doesn't support full outer joins.


Method Types

Mapping external types to internal types
+ externalTypesWithModel:
+ internalTypeForExternalType:model:
Working with channels and contexts
- adaptorChannelClass
- adaptorContextClass
Testing the connection dictionary
- assertConnectionDictionaryIsValid
Getting information from the connection dictionary
- connectionKeys
- oracleConnectionString
Coercing fetched values
- fetchedValueForDataValue:attribute:
- fetchedValueForDateValue:attribute:
- fetchedValueForNumberValue:attribute:
- fetchedValueForStringValue:attribute:
Returning the default expression class
- defaultExpressionClass
Verifying a qualifier type
- isValidQualifierType:model:

Class Methods


externalTypesWithModel:

+ (NSArray *)externalTypesWithModel:(EOModel *)model

Overrides the EOAdaptor method externalTypesWithModel: to return the Oracle database types.

See also: - internalTypeForExternalType:model:


internalTypeForExternalType:model:

+ (NSString *)internalTypeForExternalType:(NSString *)externalType model:(EOModel *)model

Overrides the EOAdaptor method internalTypeForExternalType:model: to return the name of the Objective-C class used to represent values stored in the database as externalType.

See also: + externalTypesWithModel:


Instance Methods


adaptorChannelClass

- (Class)adaptorChannelClass

Returns the OracleChannel class.


adaptorContextClass

- (Class)adaptorContextClass

Returns the OracleContext class.


assertConnectionDictionaryIsValid

- (void)assertConnectionDictionaryIsValid

Overrides the EOAdaptor method assertConnectionDictionaryIsValid to verify that the receiver can connect to the database with its connection dictionary. Briefly forms a connection to the server to validate the connection dictionary and then closes the connection. The adaptor uses this method in conjunction with displaying a server login panel. Raises an exception if an error occurs.

Note that this method doesn't open a connection to the database-that happens when the first adaptor channel is sent an message.


connectionKeys

- (NSArray *)connectionKeys

Returns an NSArray containing the keys in the receiver's connection dictionary. You can use this method to prompt the user to supply values for the connection dictionary.


defaultExpressionClass

- (Class)defaultExpressionClass

Returns the OracleSQLExpression class.


fetchedValueForDataValue:attribute:

- (NSData *)fetchedValueForDataValue:(NSData *)value attribute:(EOAttribute *)attribute

Returns value.


fetchedValueForDateValue:attribute:

- (NSCalendarDate *)fetchedValueForDateValue:(NSCalendarDate *)date attribute:(EOAttribute *)attribute

Returns an NSCalendarDate based on date whose millisecond value is set to 0.


fetchedValueForNumberValue:attribute:

- (NSNumber *)fetchedValueForNumberValue:(NSNumber *)numberValue
attribute:(EOAttribute *)attribute

Returns an NSNumber based on numberValue that has been rounded according to the precision and scale specified for attribute.


fetchedValueForStringValue:attribute:

- (NSString *)fetchedValueForStringValue:(NSString *)value attribute:(EOAttribute *)attribute

Provides default processing for string values. Trims trailing spaces and returns nil for 0 length strings.


isValidQualifierType:model:

- (BOOL)isValidQualifierType:(NSString *)typeName model:(EOModel *)model

Overrides the EOAdaptor method isValidQualifierType:model: to return YES if an attribute of type typeName can be used in a qualifier (a SQL WHERE clause) sent to the database server, NO otherwise. typeName is the name of a type as required by the database server, such as an Oracle "NUMBER".


oracleConnectionString

- (NSString *)oracleConnectionString

Returns the user name, password, host machine, and server id as a string suitable to be supplied as an argument to orlon().





Copyright © 1998, Apple Computer, Inc. All rights reserved.