java.sql
Interface ConflictingRow<T>

public interface ConflictingRow<T>

A ConflictingRow object is obtained by iterating over a DataSetResolver object. Each ConflictingRow object represents a row whose update could not be propagated to the underlying data store by an invocation of the method DataSet.sync.

Since:

1.6

Method Summary
List < String	getConflictedColumnNames ()           Retrieves the list of column names for the current row of this ConflictingRow object that caused a conflict on a call to DataSet.sync
Object	getConflictedValue ( String           Retrieves the value in the designated column in the current row of this ConflictingRow object that caused a conflict on a call to DataSet.sync
DataSetSyncStatus	getDataSetSyncStatus ()           Returns the conflict status of the current row of this ConflictingRow, which indicates the operation the DataSet.sync was attempting when the conflict occured.
T	getRow ()           Retrieves an object representing a row within the DataSet which could not be successfully updated in the underlying data source.
void	setResolvedValue ( String  columnName, Object           Specifies the new value for the column columnName in the current row of the ConflictingRow object that caused the conflict during a call to DataSet.sync
SQLException	getSQLException ()           Retrieves the SQLException object that resulted during the update to the underlying data source for the given row.

getRow getSQLException

 TSQLExceptiongetRow getSQLException ()

Retrieves an object representing a row within the DataSet which could not be successfully updated in the underlying data source. Retrieves the SQLException object that resulted during the update to the underlying data source for the given row.

Returns:

a row of type T the SQLException object that occured.

Throws: Since:

SQLRuntimeException - if an error occurs retrieving the row 1.6

Since: See Also:

1.6

SQLException

getDataSetSyncStatus getRow

 DataSetSyncStatusTgetDataSetSyncStatus getRow ()

Returns the conflict status of the current row of this ConflictingRow, which indicates the operation the DataSet.sync was attempting when the conflict occured. Retrieves an object representing a row within the DataSet which could not be successfully updated in the underlying data source.

Returns:

The status indicting the reason for the conflict for the current row. a row of type T

Throws:

SQLRuntimeException - if an error occurs retrieving the row

Since:

1.6

getConflictedColumnNames

 
 List< String> getConflictedColumnNames () 

Retrieves the list of column names for the current row of this ConflictingRow object that caused a conflict on a call to DataSet.sync

Returns:

the value of the designated column in the current row of this ConflictingRow object

Since:

1.6

getConflictedValue

 
 ObjectgetConflictedValue ( String columnName) 

Retrieves the value in the designated column in the current row of this ConflictingRow object that caused a conflict on a call to DataSet.sync

Parameters:

columnName - the column name containing the value to be resolved

Returns:

the value of the designated column in the current row of this ConflictingRow object

Throws:

SQLRuntimeException - if an invalid column name is specified or database access error occurs

Since:

1.6

setResolvedValue

 
void setResolvedValue ( String columnName,
 Object newValue) 

Specifies the new value for the column columnName in the current row of the ConflictingRow object that caused the conflict during a call to DataSet.sync

Parameters:

columnName - the column name to be resolved

newValue - the value that is to be used to resolve the conflict for the specified column

Throws:

SQLRuntimeException - if a database access error occurs, an invalid column name is specified or a problem occurs setting the resolved value.

Since:

1.6