【深入理解TcaplusDB技術】更替列表指定位置資料介面說明——[List表]
阿新 • • 發佈：2022-04-22
摘要
實現更替表格中指定Key的列表中指定位置的資料。
示例程式碼
同步呼叫參見章節：[List表]替換列表指定位置資料示例程式碼。
非同步呼叫參見章節：非同步呼叫介面示例程式碼。
Request物件方法說明
注：如有未列出來的Request物件方法，即表示該方法在替換資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
void setCmd(int cmd) |
設定請求型別（指令）。cmd：請求型別，固定為TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_REPLACE_REQ。 |
void setTableName(String tableName) |
設定目標表名。tableName：目標表名，不能為null。 |
Record addRecord(int index) |
獲取資料物件（Record），用於設定要更新的資料的Key和新Value值，使用者可以呼叫該物件的setKeyXXX方法設定各Key欄位的值，通過setValueXXX設定各Value欄位的新值。index：要讀取的資料在列表中的序號，從0開始，不能是負數。 |
Request中的Record物件方法說明
注：如有未列出來的Record物件方法，即表示該方法在替換資料的場景下是無效的。
| 方法簽名 |
方法說明 |
|---|---|
void setVersion(int version) |
設定記錄的版本號。version：如果設定為負數，表示當前資料不啟動版本控制。 |
void setKeyByte(String fieldName, byte value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyShort(String fieldName, short value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的short型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyInt(String fieldName, int value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的int型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyLong(String fieldName, long value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的long型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyFloat(String fieldName, float value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的float型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyDouble(String fieldName, double value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的double型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyString(String fieldName, String value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的String型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setKeyBlob(String fieldName, byte[] value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte[]型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueByte(String fieldName, byte value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueShort(String fieldName, short value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的short型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueInt(String fieldName, int value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的int型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueLong(String fieldName, long value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的long型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueFloat(String fieldName, float value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的float型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueDouble(String fieldName, double value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的double型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueString(String fieldName, String value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的String型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
void setValueBlob(String fieldName, byte[] value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte[]型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見TDR表字段型別與Java型別對應關係。fieldName：欄位名稱，不可為null。value：欄位的新值。 |
Response物件方法說明
注：如有未列出來的Response物件方法，即表示該方法在替換資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
int getResult() |
獲取替換資料請求的響應碼。0表示操作成功。非0表示操作異常，參見響應碼含義說明。 |