【深入理解TcaplusDB技术】更替列表指定位置数据接口说明——[List表]
摘要
实现更替表格中指定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表示操作异常，参见响应码含义说明。 |
