planetj.database.connection
Class ConnectionRow

java.lang.Object
  planetj.database.Row
      planetj.database.connection.ConnectionRow

All Implemented Interfaces:

java.lang.Cloneable, IActionObject, IBatchProcessObject, IBusinessObject, IConnections, ICSVRow, IFDFObject, IGuarded, ILogin, INamedCollection, INavigationObject, IOwner, IRowCreator, IXMLObject, java.io.Serializable

Direct Known Subclasses:

AS400ConnectionRow

public class ConnectionRow

extends Row

implements IConnections, IOwner, ILogin

Class generated by planetj.dataengine.RowClassGenerator Created at: Wed Apr 10 19:24:10 PDT 2002

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class planetj.database.Row

Row.SpacingRow

Field Summary

static java.lang.String	ACTION_RESTART
static java.lang.String	ACTION_START
static java.lang.String	ACTION_STOP

Fields inherited from class planetj.database.Row

className, DISPLAY_ORDER_COMPARATOR, MODE_ALTER, MODE_COPY, MODE_DELETE, MODE_INSERT, MODE_READ, MODE_SEARCH, MODE_UNKNOWN, MODE_UPDATE, mRowEventListeners

Fields inherited from interface planetj.database.connection.IConnections

ALIAS, AUTO_VERIFY, CLEAN_UP_TIMEOUT, CONNECTION_CLASS, CONNECTION_TABLE_NAME, DRIVER, ENCODED_USER_PASSWORD, FD_MANAGER, MAX_CONNECTIONS, MAX_SYSTEM_ALIAS_NAME_LENGTH, MIN_CONNECTIONS, ORPHAN_TIMEOUT, OWNER_ID, PASSWORD, PROPERTIES, STATUS, URL, USER_ID, VIEW_ADVANCED_SETTINGS

Fields inherited from interface planetj.dataengine.security.IGuarded

TYPE_ID_UNKNOWN, TYPE_NAME_FIELD, TYPE_NAME_SQLOPERATION, TYPE_SECURED_BY_LEVEL, TYPE_SECURED_BY_OPERATION, TYPE_UNSECURED

Constructor Summary

ConnectionRow()

Method Summary

void	closeConnectionPool() Close the connection pool for this ConnectionRow exists.
ConnectionRow	createConnectionPool() Create a connection pool based on the specific values of this Row.
Row	createRow(Row pDefaultRow) Creates a new Row.
boolean	doesConnectionPoolExist() Return a boolean indicating if the connection pool for this ConnectionRow exists.
ActionDescriptor	getActionDescriptor(AbstractAction action) Get an action descriptor for the given action type and name.
java.lang.String	getAlias() Getter method for the Alias property
int	getCleanUpTimeout() Getter method for the CleanUpTimeout property
java.lang.Class	getConnectionClass() Gets the Java class for this Connection.
java.lang.String	getConnectionClassName() Gets the Java class name for this Connection.
static ConnectionRow	getConnectionRow(java.lang.String pMetaDataAlias, java.lang.String pConnectionRowSystemAlias)
static ConnectionRow	getConnectionRow(java.lang.String metaDataAlias, java.lang.String alias, java.lang.String libraryName) Get the connection row for the given alias.
static Table	getConnectionTable(java.lang.String pSystemAlias)
java.lang.String	getDeleteConfirmationMessage() Get the delete confirmation message.
java.lang.String	getDriver() Getter method for the Driver property
java.lang.Object	getFieldDefaultValue(Field field, ExecutingContext ec) Get the field's default value as a String.
java.lang.String	getHeaderText(ExecutingContext ec) Returns information for the user that will be displayed in the header of the Row
int	getMaxConnections() Getter method for the MaxConnections property
int	getMinConnections() Getter method for the MinConnections property
int	getOrphanTimeout() Getter method for the OrphanTimeout property
int	getOwnerId() Getter method for the OwnerId property
Field	getOwnerIdField() Returns the Owner Id Field
java.lang.String	getPassword() Getter method for the Password property
java.lang.String	getProperties() Getter method for the Properties property
java.util.List	getRowHandledActionNames() Get a list of action's this connection row supports.
java.lang.String	getSystem() Returns the system.
java.lang.String	getUrl() Getter method for the Url property
static java.lang.String	getURLFormatForDriver(java.lang.String driverClass) Gets an expected URL format for a driver class
java.lang.String	getUserId() Getter method for the UserId property
java.lang.String	getUserMessageForOperation(int changeCount, int mode) Returns a message for the user based on the Mode of the Row
java.lang.Object	handleAction(java.lang.String action, ExecutingContext ec) Handles the given action.
int	insert(SQLContext context) Inserts this Row into the specified database.
boolean	isActionApplicable(java.lang.String action, ExecutingContext ec) Check to see if the action is applicable for this connection row
boolean	isFieldApplicable(Field field, ExecutingContext ec) Tests if a field is applicable in the current scenario
boolean	isFieldRequired(Field field, ExecutingContext pContext) Tests if a field is required or not.
boolean	isInitializeDerivedFieldEnabled(java.lang.String fieldName) Tells whether or not to initialize a Derived FD upon row creation.
static boolean	isShared(java.lang.String alias) Check whether or not this connection is shared
boolean	isValidConnection() This method will verify this ConnectionRow contains valid connection properties and using these properties actually establishes a connection to a database.
protected void	populate(java.sql.ResultSet pResults, java.util.List pPhysicalNames, java.sql.ResultSetMetaData pMetaData, SQLContext pContext) Populates this Row with the data from the result set.
ConnectionRow	setAlias(java.lang.String newValue) Setter method for the Alias property
ConnectionRow	setCleanUpTimeout(int newValue) Setter method for the CleanUpTimeout property
protected void	setConnectionClassInternal(java.lang.Class newConnClass) Sets the Java class for this Connection.
ConnectionRow	setDriver(java.lang.String newValue) Setter method for the Driver property
ConnectionRow	setMaxConnections(int newValue) Setter method for the MaxConnections property
ConnectionRow	setMinConnections(int newValue) Setter method for the MinConnections property
ConnectionRow	setOrphanTimeout(int newValue) Setter method for the OrphanTimeout property
ConnectionRow	setOwnerId(int newValue) Setter method for the OwnerId property
void	setPassword(java.lang.String newValue) Setter method for the Password property
ConnectionRow	setProperties(java.lang.String newValue) Setter method for the Properties property
ConnectionRow	setUrl(java.lang.String newValue) Setter method for the Url property
void	setUserId(java.lang.String newValue) Setter method for the UserId property
Row	statusChanged(Field pField, ExecutingContext ec) Invoked when a status change takes place on of this Row's fields.
int	update(java.sql.Connection conn, ExecutingContext ec) Updates the database with the values in this Row.
boolean	validate(ExecutingContext ec) Validate this Row based on its configuration and field values.
ValidationExceptionCollection	verifyConnection() This method will verify this ConnectionRow contains valid connection properties and using these properties actually establishes a connection to a database.

Methods inherited from class planetj.database.Row

add, add, addObject, addPropertyChangeListener, addPropertyChangeListener, addRowEventListener, addRowEventListeners, addTable, addToRowCollection, appendDisplayType, batchProcess, clearFields, clearTables, clearValidationException, clone, cloneRow, commitFieldValues, commitFieldValues, commitFieldValues, concatenateFieldFullLengthValues, concatenateFieldValues, containsField, copy, copyIntoRowFieldsWithCommonFieldNames, copyIntoRowFieldsWithCommonFieldNames, copyIntoRowFieldsWithCommonUsageIds, copyIntoRowFieldsWithGivenFieldNames, copyIntoRowFieldsWithGivenFieldNames, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, createAction, createNamedActionRequest, createSQLContextForDelete, createSQLContextForInsert, createSQLContextForUpdate, dataTransferred, defaultMerge, delete, delete, delete, delete, deleteObject, divide, duplicateKey, duplicateKey, enforceExclusiveOr, equals, equals, equalsInstance, fieldHasPossibleValuesSQLOperation, firePropertyChange, fireRowEvent, getActionDefaultLocation, getActionRequest, getActionRequest, getActions, getActionsForFields, getActionsForOperation, getAssociation, getAssociation, getAssociationByOperationUsageId, getAssociationOperation, getAttribute, getAutoIncrementDatabaseDrivenField, getBackgroundColor, getChangedFields, getChildren, getColumnSpan, getCompleteRow, getCompleteRow, getConcurrentFields, getConfigProperty, getCopiedFieldValues, getCreationContext, getCSVRow, getCSVRow, getDatabaseRow, getDatabaseRow, getDatabaseRow, getDatabaseRow, getDBSystem, getDeleteConfirmation, getDisjointRowClass, getDisplayValue, getDisplayValueByUsageId, getDisplayValueForKey, getErrorMessageForOperation, getExternalName, getExternalNames, getFDFData, getFDTable, getField, getField, getField, getFieldAssociationOperation, getFieldCollection, getFieldDescriptor, getFieldDescriptor, getFieldDescriptor, getFieldDescriptorsWithUsage, getFieldDescriptorsWithUsageId, getFieldDescriptorWithUsageId, getFieldDisplayComponent, getFieldDisplayOrder, getFieldDisplayValue, getFieldDisplayValue, getFieldExternalName, getFieldFieldClassParameters, getFieldFieldSetName, getFieldIncrementor, getFieldMaxLength, getFieldNames, getFieldNames, getFieldPossibleValues, getFields, getFields, getFieldSearchDefaultValue, getFieldSets, getFieldsForInsert, getFieldSQLObject, getFieldStatusChange, getFieldsToDisplay, getFieldsToDisplayStrict, getFieldsToDisplayStrict, getFieldStyleClass, getFieldsWithUsageId, getFieldUsageIds, getFieldValue, getFieldValueWithUsageId, getFieldWithUsageId, getHorizontalAlignment, getJSPFor, getKeyFieldNames, getKeyFields, getKeyFields, getLibraryName, getMaxFieldLengths, getMaxFieldLengths, getMaxInsertRetries, getMetaDataSystemAlias, getNamed, getNamed, getNamesOfUpdatedFields, getNavigationKey, getNavigationListKey, getNextOperationToRun, getOperation, getOperation, getOperationFromDB, getOperationFromDBByUsage, getPercentage, getPhysicalFieldNames, getPossibleValueClass, getPossibleValueClass, getPossibleValues, getPossibleValuesKey, getPossibleValuesOperation, getPropertyChangeSupport, getPropertyGroup, getPropertyGroups, getPropertyGroups, getReplacementFieldsToDisplay, getReplacementFieldsToDisplay, getRequiredFields, getRow, getRowCollection, getRowDisplayAttributes, getRowDisplayAttributes, getRowKey, getSecuredTypeId, getSecuredTypeName, getSecurityType, getSQL, getSQLContext, getStaticAttribute, getStaticAttributes, getSum, getSystemAlias, getTabbedOperation, getTable, getTable, getTableName, getTables, getTimestamp, getUpdatedFields, getUserMessageForOperation, getUseWOWLibrary, getValidationExceptions, getValueAsBoolean, getValueAsByte, getValueAsDate, getValueAsDate, getValueAsDouble, getValueAsDouble, getValueAsFloat, getValueAsFullLengthString, getValueAsInt, getValueAsInt, getValueAsLong, getValueAsNumber, getValueAsNumber, getValueAsShort, getValueAsString, getValueAsString, getValueAsStringByUsageId, getValueByUsageId, getValueForKey, getValues, getXMLData, getXMLData, getXMLHeaderData, goToNextOperation, hasAssociationOperation, hasChildRows, hasMultipleStyleClasses, hasPossibleValuesKeyClassOrOp, hasPossibleValuesOperation, hasPropertyChangeListeners, incrementFieldValue, initializeRow, initializeRow, initializeRow, initializeRow, initializeRow, initializeRow, insert, insert, insert, is, isActionRepeatable, isARow, isARowCollection, isChanged, isChanged, isChangedRealTime, isChangedSinceLastCheck, isCloneNeeded, isContainsAllFields, isCopyable, isCurrent, isDeletable, isDistinctRow, isEditable, isEmpty, isFieldAuthorizedForEdit, isFieldAuthorizedForRead, isFieldAutoIncrement, isFieldAutoIncrementDatabaseDriven, isFieldAutoIncrementWOWDriven, isFieldDisplayable, isFieldPresent, isFieldReadOnly, isFieldReadOnlyOnSearch, isFieldRequiredOnSearch, isFieldsChanged, isFieldUpdateable, isFieldValueNotBlank, isFieldValuePossibleValue, isFieldValuesDatabaseDefaults, isGenerateChildRows, isGroupByRow, isGuarded, isHasColumnNames, isInARowCollection, isIncrementorResetAfterMaxInsertRetries, isInitializeDerivedFieldsEnabled, isJoinedRow, isKeyFieldsPresent, isLogicalRow, isMultipleDeleteEnabled, isParameterRow, isPersistent, isPhysicalRow, isPrepareFieldValue, isPropertyChangeEventsEnabled, isReturningFromPossibleValuesSearch, isRowDisplayable, isRowKeyed, isSelectable, isStatusChange, isToBeSelected, isUnionRow, isUpdateable, isUseRowForFieldSets, isValidateDerivedFields, isValidateRequired, isValidationRequiredForAutoPopulate, isViewable, iterator, joinedDatabaseAccessFailure, joinedDelete, joinedDelete, joinedInsert, joinedInsert, joinedUpdate, joinedUpdate, merge, newField, newField, newField, newField, openFor, persist, populate, populate, populateFD, postCreate, postDelete, postExtract, postInsert, postInsert, postUpdate, postUpdate, preDelete, preInsert, prepareForDetails, prepareForParameters, prepareForResultsDisplay, prepareFromFieldNames, preUpdate, removeField, removeField, removeNavigationKey, removePropertyChangeListener, removePropertyChangeListener, removeRowEventListener, removeRowEventListeners, replaceField, replaceFields, replaceFieldValues, replaceNumbersWithNames, reread, rereadIfNeeded, resetDisplayValues, rollbackChanges, runSQLQuery, runSQLQuery, runSQLStatement, runSQLStatement, setAttribute, setAutoUpdateFieldValues, setCreationContext, setCreationOperation, setFieldInitialValue, setFieldValue, setFieldValue, setFieldValue, setFieldValue, setFieldValueAsString, setFieldValueAsString, setFieldValuesAsDate, setFieldValuesToDefault, setFieldValuesWithCommonFieldNames, setFieldValuesWithCommonFieldNames, setFieldValuesWithCommonFieldNames, setFieldValuesWithCommonUsageIds, setFieldValueToDefault, setMultipleDeleteEnabled, setNavigationKey, setParameterRow, setPersistent, setPropertyChangeEventsEnabled, setPropertyGroups, setReturningFromPossibleValuesSearch, setRowDisplayAttributes, setSavepoint, setSavepoint, setSavepoint, setStaticAttribute, setTables, setTables, setUseWOWLibrary, setValidateDerivedFields, setValidateRequired, setValues, size, splitAndSetFieldValues, swapFieldValues, toCSV, toDOC, toDOC, toFDF, toPDF, toPDF, toString, toUpperCase, toXML, transferDataTo, transferDataTo, update, update, update, updateFieldValues, updateGlobalValues, updateObject, validate, validate, validateField, validateRowOperation

Methods inherited from class java.lang.Object

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

Field Detail

ACTION_START

public static final java.lang.String ACTION_START

See Also:

Constant Field Values

ACTION_STOP

public static final java.lang.String ACTION_STOP

See Also:

Constant Field Values

ACTION_RESTART

public static final java.lang.String ACTION_RESTART

See Also:

Constant Field Values

Constructor Detail

ConnectionRow

public ConnectionRow()

Method Detail

getHeaderText

public java.lang.String getHeaderText(ExecutingContext ec)

Description copied from class: Row

Returns information for the user that will be displayed in the header of the Row

Overrides:

getHeaderText in class Row

Returns:

String

createConnectionPool

public ConnectionRow createConnectionPool()
                                   throws CMException

Create a connection pool based on the specific values of this Row. Logic was moved to the ConnectionRow to allow subclasses to provide other forms of ConnectionPools such as AS400ConnectionPool.

Throws:

CMException

createRow

public Row createRow(Row pDefaultRow)
              throws CMException

Creates a new Row. Information from the database is read into a default Row by the DataEngine; this method is then invoked to get a Row of the correct type based on the information in the default Row. Typically the data in the Row is examined by this method, a Row of the appropriate type is created, and then the transferDataTo() method is used to move the data from the default Row to the newly created Row. Override this method if the type of Row to add needs to be dynamically determined from the retrieved data.

Specified by:

createRow in interface IRowCreator

Overrides:

createRow in class Row

Parameters:

pDefaultRow - A Row containing data read from the database (it will always be equal to this)

Returns:

A Row which the DataEngine will add to a RowCollection

Throws:

CMException

doesConnectionPoolExist

public boolean doesConnectionPoolExist()
                                throws CMException

Return a boolean indicating if the connection pool for this ConnectionRow exists. Logic was moved to the ConnectionRow to allow subclasses to provide other forms of ConnectionPools such as AS400ConnectionPool.

Throws:

CMException

closeConnectionPool

public void closeConnectionPool()
                         throws CMException

Close the connection pool for this ConnectionRow exists. Logic was moved to the ConnectionRow to allow subclasses to provide other forms of ConnectionPools such as AS400ConnectionPool.

Throws:

CMException

getActionDescriptor

public ActionDescriptor getActionDescriptor(AbstractAction action)

Description copied from interface: IActionObject

Get an action descriptor for the given action type and name.

Specified by:

getActionDescriptor in interface IActionObject

Overrides:

getActionDescriptor in class Row

getRowHandledActionNames

public java.util.List getRowHandledActionNames()

Get a list of action's this connection row supports.

Overrides:

getRowHandledActionNames in class Row

getAlias

public java.lang.String getAlias()

Getter method for the Alias property

getCleanUpTimeout

public int getCleanUpTimeout()

Getter method for the CleanUpTimeout property

getConnectionClass

public java.lang.Class getConnectionClass()

Gets the Java class for this Connection.

getConnectionRow

public static ConnectionRow getConnectionRow(java.lang.String pMetaDataAlias,
                                             java.lang.String pConnectionRowSystemAlias)
                                      throws CMException

Throws:

CMException

getConnectionClassName

public java.lang.String getConnectionClassName()

Gets the Java class name for this Connection.

getConnectionRow

public static ConnectionRow getConnectionRow(java.lang.String metaDataAlias,
                                             java.lang.String alias,
                                             java.lang.String libraryName)
                                      throws CMException

Get the connection row for the given alias.

Throws:

CMException

getConnectionTable

public static Table getConnectionTable(java.lang.String pSystemAlias)
                                throws CMException

Throws:

CMException

getDriver

public java.lang.String getDriver()

Getter method for the Driver property

getFieldDefaultValue

public java.lang.Object getFieldDefaultValue(Field field,
                                             ExecutingContext ec)
                                      throws CMException

Description copied from class: Row

Get the field's default value as a String.

Overrides:

getFieldDefaultValue in class Row

Throws:

CMException

getMaxConnections

public int getMaxConnections()

Getter method for the MaxConnections property

getDeleteConfirmationMessage

public java.lang.String getDeleteConfirmationMessage()

Description copied from class: Row

Get the delete confirmation message.

Overrides:

getDeleteConfirmationMessage in class Row

getMinConnections

public int getMinConnections()

Getter method for the MinConnections property

getOrphanTimeout

public int getOrphanTimeout()

Getter method for the OrphanTimeout property

getOwnerId

public int getOwnerId()

Getter method for the OwnerId property

getOwnerIdField

public Field getOwnerIdField()

Returns the Owner Id Field

Specified by:

getOwnerIdField in interface IOwner

Returns:

planetj.database.Field

See Also:

IOwner

getPassword

public java.lang.String getPassword()

Getter method for the Password property

getProperties

public java.lang.String getProperties()

Getter method for the Properties property

getSystem

public java.lang.String getSystem()

Returns the system. This is the string after the jdbc:as400: of the URL Example jdbc:as400:CYBRA3 would return CYBRA3 Creation date: (6/18/2002 6:04:25 PM)

getUrl

public java.lang.String getUrl()

Getter method for the Url property

getURLFormatForDriver

public static java.lang.String getURLFormatForDriver(java.lang.String driverClass)

Gets an expected URL format for a driver class

getUserId

public java.lang.String getUserId()

Getter method for the UserId property

Specified by:

getUserId in interface ILogin

getUserMessageForOperation

public java.lang.String getUserMessageForOperation(int changeCount,
                                                   int mode)

Returns a message for the user based on the Mode of the Row

Overrides:

getUserMessageForOperation in class Row

Returns:

String message for the user

See Also:

(see Row constants to find the modes.

handleAction

public java.lang.Object handleAction(java.lang.String action,
                                     ExecutingContext ec)
                              throws CMException

Handles the given action.

Specified by:

handleAction in interface IActionObject

Overrides:

handleAction in class Row

Throws:

CMException

insert

public int insert(SQLContext context)
           throws CMException

Inserts this Row into the specified database.

Overrides:

insert in class Row

Returns:

The number of Rows that were inserted

Throws:

CMException

isActionApplicable

public boolean isActionApplicable(java.lang.String action,
                                  ExecutingContext ec)
                           throws CMException

Check to see if the action is applicable for this connection row

Specified by:

isActionApplicable in interface IActionObject

Overrides:

isActionApplicable in class Row

Throws:

CMException

isFieldApplicable

public boolean isFieldApplicable(Field field,
                                 ExecutingContext ec)
                          throws CMException

Description copied from class: Row

Tests if a field is applicable in the current scenario

Overrides:

isFieldApplicable in class Row

Parameters:

field - The field which may or may not be applicable

Throws:

CMException

isFieldRequired

public boolean isFieldRequired(Field field,
                               ExecutingContext pContext)

Description copied from class: Row

Tests if a field is required or not. The default behavior is to ask the FD, but subclasses may override this method and implement a different behavior

Overrides:

isFieldRequired in class Row

Parameters:

field - The whose required status is being tested

pContext - The current executing context which may be null

isInitializeDerivedFieldEnabled

public boolean isInitializeDerivedFieldEnabled(java.lang.String fieldName)

Description copied from class: Row

Tells whether or not to initialize a Derived FD upon row creation. The default behavior is false. Subclassing rows can change this behavior.

Overrides:

isInitializeDerivedFieldEnabled in class Row

isShared

public static boolean isShared(java.lang.String alias)

Check whether or not this connection is shared

Returns:

boolean

isValidConnection

public boolean isValidConnection()

This method will verify this ConnectionRow contains valid connection properties and using these properties actually establishes a connection to a database. Creation date: (6/18/2002 1:38:26 PM)

populate

protected void populate(java.sql.ResultSet pResults,
                        java.util.List pPhysicalNames,
                        java.sql.ResultSetMetaData pMetaData,
                        SQLContext pContext)
                 throws CMException

Populates this Row with the data from the result set. This method will completely wipe out any existing values in this row.

Overrides:

populate in class Row

Parameters:

pResults - The result set containing data which will be used to populate this Row. The cursor must be pointing to the row in the result set which will be used to populate this Row object.

pMetaData - The result set's metadata.

Returns:

The populated Row. If the returned Row is different than this Row, the returned Row is used instead of this Row.

Throws:

CMException

setAlias

public ConnectionRow setAlias(java.lang.String newValue)
                       throws CMException

Setter method for the Alias property

Throws:

CMException

setCleanUpTimeout

public ConnectionRow setCleanUpTimeout(int newValue)
                                throws CMException

Setter method for the CleanUpTimeout property

Throws:

CMException

setConnectionClassInternal

protected void setConnectionClassInternal(java.lang.Class newConnClass)
                                   throws CMException

Sets the Java class for this Connection.

Throws:

CMException

setDriver

public ConnectionRow setDriver(java.lang.String newValue)
                        throws CMException

Setter method for the Driver property

Throws:

CMException

setMaxConnections

public ConnectionRow setMaxConnections(int newValue)
                                throws CMException

Setter method for the MaxConnections property

Throws:

CMException

setMinConnections

public ConnectionRow setMinConnections(int newValue)
                                throws CMException

Setter method for the MinConnections property

Throws:

CMException

setOrphanTimeout

public ConnectionRow setOrphanTimeout(int newValue)
                               throws CMException

Setter method for the OrphanTimeout property

Throws:

CMException

setOwnerId

public ConnectionRow setOwnerId(int newValue)
                         throws CMException

Setter method for the OwnerId property

Throws:

CMException

setPassword

public void setPassword(java.lang.String newValue)
                 throws CMException

Setter method for the Password property

Specified by:

setPassword in interface ILogin

Throws:

CMException

setProperties

public ConnectionRow setProperties(java.lang.String newValue)
                            throws CMException

Setter method for the Properties property

Throws:

CMException

setUrl

public ConnectionRow setUrl(java.lang.String newValue)
                     throws CMException

Setter method for the Url property

Throws:

CMException

setUserId

public void setUserId(java.lang.String newValue)
               throws CMException

Setter method for the UserId property

Specified by:

setUserId in interface ILogin

Throws:

CMException

statusChanged

public Row statusChanged(Field pField,
                         ExecutingContext ec)
                  throws CMException

Invoked when a status change takes place on of this Row's fields. Subclasses may override this method, but they should call it on the superclass when they do.

Overrides:

statusChanged in class Row

Parameters:

pField - The field whose status has changed

ec - The current executing context

Returns:

The "new" row resulting from the status change. Usually this is this same row, but a row may choose to replace itself with another row and return that other row.

Throws:

CMException

update

public int update(java.sql.Connection conn,
                  ExecutingContext ec)
           throws CMException

Updates the database with the values in this Row. If concurrent alterations to the database prevent this row from being updated, a ConcurrentAlterationException is thrown.

Overrides:

update in class Row

Parameters:

conn - The connection to use for the update

Returns:

The number of updated rows

Throws:

CMException

validate

public boolean validate(ExecutingContext ec)
                 throws CMException

Validate this Row based on its configuration and field values.

Overrides:

validate in class Row

Parameters:

ec - current context in which application is executing

Returns:

true, if Row and Fields are valid; false otherwise.

Throws:

CMException

verifyConnection

public ValidationExceptionCollection verifyConnection()

This method will verify this ConnectionRow contains valid connection properties and using these properties actually establishes a connection to a database. Creation date: (6/18/2002 1:38:26 PM)