【深入理解TcaplusDB技術】將資料插入到列表指定位置介面說明——[List表]
阿新 • • 發佈：2022-04-22
概述
實現插入一條新資料到表格指定Key的列表中的指定位置。
示例程式碼
同步呼叫參見章節：[List表]插入資料到列表指定位置示例程式碼。
非同步呼叫參見章節：非同步呼叫介面示例程式碼。
Request物件方法說明
注：如有未列出來的Request物件方法，即表示該方法在插入資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
void setCmd(int cmd) |
設定請求型別（指令）。cmd：請求型別，固定為TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_ADDAFTER_REQ。 |
void setTableName(String tableName) |
設定目標表名。tableName：目標表名，不能為null。 |
Record addRecord(int index) |
建立並設定新資料物件（Record），使用者可以呼叫該物件的setXXX方法設定新資料各欄位的值。index：新資料要插入的位置序號，-1表示插入到列表尾部，0表示插入到列表第1個元素之後，以此類推。 |
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型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
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表示操作異常，參見響應碼含義說明。 |