2.II.3.a.) MARCOS TEÓRICOS
5.) LAS INTERPRETACIONES POSTPROCESUALES
Object (abstract) InterfacePart Controller ENFINController LogonWindowController ORDBLogonController
Class usage information
ORDBLogonController displays the UniSQL Server logon window. This window allows you to enter a UniSQL Server user name and a password. The UniSQL Server logon window displays on the ObjectStudio desktop when the UniSQL Server database wrapper is loaded.
ORDBLogonController class variables None
Database User's Guide, P40-3203-03 168
Chapter: UniSQL Server
ORDBLogonController instance variables
Cancel
Description: Cancel push-button controller item on the logon dialog box that cancels a UniSQL Server logon attempt.
Logoff
Description: Logoff push-button controller item on the logon dialog box that stops access to the current UniSQL Server database.
OK
Description: OK push-button controller item on the logon dialog box that proceeds to log in to a UniSQL Server database with the specified user name and password.
password
Description: Password entry-field text value from the logon dialog box.
userName
Description: User name entry-field text value from the logon dialog box.
Database User's Guide, P40-3203-03 169
Chapter: UniSQL Server
ORDBLogonController class methods
description
Description: Contains the class reference description. To view the description, select the class name in the Class Browser and then select the Class ⇒ Reference menu option.
Assumptions: None
Return value: The receiver. Receiver modified: No
initialize
Description: Executes when the ORDBLogonController class is loaded into the system. Initializes the UniSQL Server Logon dialog box.
Assumptions: None
Return value: The receiver. Receiver modified: Yes
Database User's Guide, P40-3203-03 170
Chapter: UniSQL Server
ORDBLogonController instance methods
createItems
Description: Defines the forms, controller items, and methods for the UniSQL Server Logon dialog box.
Assumptions: None
Return value: The receiver. Receiver modified: Yes
database
Description: Sets the default database to ORDBDatabase.
Assumptions: None
Return value: ORDBDatabase, which represents the global variable for the UniSQL Server database.
Receiver modified: No defaultMethod
Description: Sets the default action for the controller to the loginUser:password: method.
Assumptions: None
Return value: A symbol representing the loginUser:password: method.
Receiver modified: No
Database User's Guide, P40-3203-03 171
Chapter: UniSQL Server
desktopWpObjIconSource
Description: Returns a string containing the pathname for the ORDBLogonWindowView object icon’s source.
Assumptions: None
Return value: An object of class String. Receiver modified: No
desktopWpObjName
Description: Returns the string “UniSQL Server” for the ORDBLogonWindowView object name.
Assumptions: None
Return value: An object of class String. Receiver modified: No
dropOnDesktop
Description: Returns true indicating that this controller is to be shown on the ObjectStudio desktop.
Assumptions: None
Return value: An object of class Boolean. Receiver modified: No
initializeBindings
Description: Creates the bindings between the controller items and the methods associated with those controller items.
Assumptions: None
Return value: The receiver. Receiver modified: Yes
Database User's Guide, P40-3203-03 172
Chapter: UniSQL Server
logoff
Description: Ignores input from the logon window and stops access to the currently connected UniSQL Server.
Assumptions: None
Return value: An object of class ORDBDatabase or class Message.
Receiver modified: Yes ok
Description: Accepts input from the logon window and connects to the server.
Assumptions: None
Return value: An object of class ORDBDatabase or class Message.
Receiver modified: Yes
Database User's Guide, P40-3203-03 173
Chapter: UniSQL Server
ORDBScrollableCursor class
The ORDBScrollableCursor class provides the implementation details for UniSQL Server scrollable cursors.
Class summary
Module ordbsc.cls SuperClass ExtDbScrollableCursor
Description Support for UniSQL Server database scrollable cursors. Version 2.0
Class hierarchy
Cursor (abstract class)
ExternalDatabaseCursor (abstract)
ORDBDatabaseCursor
ExtDbScrollableCursor (abstract)
ORDBScrollableCursor
Class usage information
The UniSQL Server API does not support absolute positioning of scrollable cursors, which leads to inefficiency if the number of instances for a class is large. Therefore, try to keep the number of instances for a class reasonable. You can usually do this with the SQL WHERE clause.
ORDBScrollableCursor class variables
cursors
Description: Array of the UniSQL Server scrollable cursors. Scrollable cursors in use will be named; unused cursors will be nil.
ORDBScrollableCursor instance variables
queryResult
Description: Table (or array of tables) containing the results of the query.
Database User's Guide, P40-3203-03 174
Chapter: UniSQL Server
ORDBScrollableCursor class methods
description
Description: Contains the class reference description. To view the description, select the class name in the Class Browser and then select the Class ⇒ Reference menu option.
Assumptions: None
Return value: The receiver. Receiver modified: No
initialize
Description: Assigns an empty array object to the class variable cursors. This variable is used to store database cursors.
Assumptions: None Return value: The receiver. Receiver modified: Yes
maxCursors (primitive)
Description: Returns the maximum number of cursors that can be opened concurrently.
Assumptions: None
Return value: An object of class SmallInteger. Receiver modified: No
nextCursor
Description: Returns an uninitialized cursor at the next available index and sets its index position.
Assumptions: None
Return value: An object of class ORDBDatabaseCursor, or nil if no cursor is available.
Receiver modified: Yes
Database User's Guide, P40-3203-03 175
Chapter: UniSQL Server
ORDBScrollableCursor instance methods
at: name put: newValue
Description: Updates the value of a field at the current cursor position. Valid only if the cursor was opened using “for update of.”
Assumptions: name must be an object of class Symbol. (name specifies the field whose
contents are to be changed.)
Return value: The receiver or an object of class Message. Receiver modified: No
message (primitive)
Description: Returns the last error message.
Assumptions: None
Return value: An object of class Message. Receiver modified: No
name (primitive)
Description: Returns a string object containing the name of the cursor.
Assumptions: None
Return value: An object of class String. Receiver modified: No
privateClose (primitive)
Description: Frees allocated resources for the cursor and initializes the cursor position to 0.
Assumptions: None Return value: The receiver. Receiver modified: No
Database User's Guide, P40-3203-03 176
Chapter: UniSQL Server
privateDelete (primitive)
Description: Deletes the record at the current cursor position.
Assumptions: None
Return value: A return code of class Integer. Receiver modified: No
privateDeleteUpdate: update
Description: Deletes the record at the current cursor position. The update parameter is used to determine whether to send an update message to dependents.
Assumptions: update must be an object of class Boolean.
Return value: The contents of the fieldValues instance variable, or an object of class
Message.
Receiver modified: No
privateExecNoSelect: sqlString (primitive)
Description: Executes the SQL statement specified by the sqlString parameter.
Assumptions: sqlString is an object of class String and contains the SQL statement to be
executed. sqlString may not contain a SELECT statement.
Return value: The receiver or an error code of class Integer. Receiver modified: No
privateExecUpdate: sqlString (primitive)
Description: Executes the SQL statement specified by the sqlString parameter.
Assumptions: sqlString is an object of class String. Return value: A return code of class Integer. Receiver modified: No
Database User's Guide, P40-3203-03 177
Chapter: UniSQL Server
privateNext (primitive)
Description: Returns a dictionary with the next data record.
Assumptions: None
Return value: An object of class Dictionary, or an error code of class Integer. Receiver modified: No
privateSetPositionTo: newPos (primitive)
Description: Updates the position instance variable with the contents of the newPos parameter.
Assumptions: newPos must be an object of class Integer. Return value: The receiver or an error code of class Integer. Receiver modified: Yes
refresh (primitive)
Description: Closes the cursor and opens it again using the stored SQL string in the sqlString instance variable. This is a time-consuming process and should be used only if absolutely necessary.
Assumptions: None Return value: The receiver. Receiver modified: Yes
updateWith: newValueDict
Description: Updates the value of all fields at the current cursor position that differs from the value in newValueDict. Valid only if the cursor was opened using “for update of.”
Assumptions: None
Return value: The receiver or an object of class Message. Receiver modified: No
Database User's Guide, P40-3203-03 178
Chapter: UniSQL Server