【TcaplusDB知識庫】[Generic表]更新資料介面說明
阿新 • • 發佈：2021-12-16
概述
更新表格中指定Key的資料。
當表格中不存在指定Key的資料時，資料將更新失敗。
示例程式碼
同步呼叫參見章節：[
非同步呼叫參見章節：
Request物件方法說明
注：如有未列出來的Request物件方法，即表示該方法在更新資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
void setCmd(int cmd) |
設定請求型別（指令）。cmd：請求型別，固定為TcaplusProtocolCsConstants.TCAPLUS_CMD_UPDATE_REQ。 |
void setTableName(String tableName) |
設定目標表名。tableName：目標表名，不能為null。 |
Record addRecord() |
獲取資料物件（Record），用於設定要更新的資料的Key和新Value值，使用者可以呼叫該物件的setKeyXXX方法設定各Key欄位的值，通過setValueXXX設定各Value欄位的新值。 |
Request中的Record物件方法說明
注：如有未列出來的Record物件方法，即表示該方法在更新資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
| 方法簽名 | 方法說明 |
void setVersion(int version) |
設定記錄的版本號。version：如果設定為負數，表示當前資料不啟動版本控制。 |
void setKeyByte(String fieldName, byte value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyShort(String fieldName, short value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的short型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyInt(String fieldName, int value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的int型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyLong(String fieldName, long value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的long型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyFloat(String fieldName, float value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的float型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyDouble(String fieldName, double value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的double型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyString(String fieldName, String value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的String型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setKeyBlob(String fieldName, byte[] value) |
設定指定名稱的Key欄位的值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte[]型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueByte(String fieldName, byte value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueShort(String fieldName, short value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的short型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueInt(String fieldName, int value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的int型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueLong(String fieldName, long value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的long型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueFloat(String fieldName, float value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的float型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueDouble(String fieldName, double value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的double型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueString(String fieldName, String value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的String型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
void setValueBlob(String fieldName, byte[] value) |
設定指定名稱的Value欄位的新值。注意：當TDR表描述檔案中定義的欄位型別與Java的byte[]型別對應時，才可呼叫該方法設定欄位值，否則服務端在處理請求時會引數錯誤。參見 |
Response物件方法說明
注：如有未列出來的Response物件方法，即表示該方法在更新資料的場景下是無效的。
| 方法簽名 | 方法說明 |
|---|---|
int getResult() |
獲取更新資料請求的響應碼。0表示操作成功。非0表示操作異常，參見 |
TcaplusDB是騰訊出品的分散式NoSQL資料庫，儲存和排程的程式碼完全自研。具備快取+落地融合架構、PB級儲存、毫秒級時延、無損水平擴充套件和複雜資料結構等特性。同時具備豐富的生態、便捷的遷移、極低的運維成本和五個九高可用等特點。客戶覆蓋遊戲、網際網路、政務、金融、製造和物聯網等領域。