SybaseContext
Inherits from: EOAdaptorContext : NSObject
Declared in: SybaseEOAdaptor/SybaseContext.h
Class Description
A SybaseContext represents a single transaction scope on the database server to which its adaptor object is connected. Since a Sybase server supports multiple concurrent transaction sessions, the adaptor may have several adaptor contexts. A SybaseContext may in turn have a SybaseChannel, which handles actual access to the data on the server.
The features the SybaseContext class adds to EOAdaptorContext are methods for returning Sybase-specific data structures that describe characteristics of the context. The method contextPointer returns the Sybase global context pointer, so that you can make direct calls to the Sybase client library. The method connection returns the SybaseContext's CT library connection (CS_CONNECTION *).
The SybaseContext can have a delegate, which gives you access to all messages returned from the Sybase client library or from the Sybase Server. See the SybaseContext Delegate protocol specification for a complete description.
Method Types
- Getting the context pointer
- + contextPointer
- Setting the login time out interval
- + loginTimeOutInterval
- + setLoginTimeOutInterval:
- Setting the time out interval
- + setTimeOutInterval:
- + timeOutInterval
- Managing the connection
- - connect
- - connection
- - currentChannel
- - disconnect
- - isConnected
- + setMaximumConnections:
- + maximumConnections
- Setting the max text size default
- - maxTextSizeDefault
- - setMaxTextSizeDefault:
- Setting the current exception
- - raiseCurrentException
- - setCurrentException:
Class Methods
contextPointer
+ (void *)contextPointer
maximumConnections
public static int maximumConnections()
+ (int)maximumConnections
loginTimeOutInterval
+ (int)loginTimeOutInterval
See Also: + setLoginTimeOutInterval:
setLoginTimeOutInterval:
+ (void)setLoginTimeOutInterval:(int)seconds
See Also: + loginTimeOutInterval
setMaximumConnections:
+(BOOL)setMaximumConnections:(int)value
setTimeOutInterval:
+ (void)setTimeOutInterval:(int)seconds
See Also: + timeOutInterval
timeOutInterval
+ (int)timeOutInterval
Instance Methods
connect
- (void)connect
See Also: - disconnect
connection
- (void *)connection
currentChannel
- (SybaseChannel *)currentChannel
disconnect
- (void)disconnect
See Also: - connect
isConnected
- (BOOL)isConnected
See Also: - connect, - disconnect
maxTextSizeDefault
- (int)maxTextSizeDefault
raiseCurrentException
- (void)raiseCurrentException
See Also: - setCurrentException:
setCurrentException:
- (void)setCurrentException:(NSException
*)exception
When the SybaseAdaptor encounters an error, it uses the error message to build an NSException and stores the exception in the SybaseContext using this method. The exception can then be reviewed by other components to determine if the error is fatal.
See Also: - raiseCurrentException
setMaxTextSizeDefault:
- (void)setMaxTextSizeDefault:(int)textSize