RequestLite (service-api 3.62.0SP06 API)

java.lang.Object
- com.tencent.tcaplus.client.impl.RequestLite

All Implemented Interfaces:: Request

public class RequestLite
extends Object
implements Request

Constructor Summary

Constructors
Constructor and Description

RequestLite()

Constructors
Constructor and Description
`RequestLite()`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`AddElementIndex(int index)` 添加LIST记录的元素索引值。该函数只对于TCAPLUS_API_LIST_DELETE_BATCH_REQ有效
`void`	`addFieldName(String fieldName)` 增加一个需要查询或更新的value字段名称列表，即部分value字段查询和更新。可用于get、batchget、partkeyget、listget、listgetall、listreplace、replace、update、tabletraverse操作。
`Record`	`addRecord()` 向请求中添加一条记录，设置默认index为-1
`Record`	`addRecord(int index)` 向请求中添加一条记录
`void`	`assemble(TCaplusPkg pkg)`
`int`	`getAppId()`
`long`	`getAsynId()`
`int`	`getCmd()` 获得请求命令字
`String`	`getCondition()` 获取当前设置的过滤条件。
`int`	`getMultiResponseFlag()` 获得自动响应多个应答包标志
`List<RecordLite>`	`getRecords()`
`int`	`getResultFlag()` 获得响应标志
`int`	`getResultFlagForFail()` 获得操作失败响应标志，未使用`Request.setResultFlagForFail(int)`设置过时返回0
`int`	`getResultFlagForSuccess()` 获得操作成功响应标志，未使用`Request.setResultFlagForSuccess(int)`设置过时返回0
`String`	`getTableName()` 获得请求表名
`byte[]`	`getUserData()` 获得设置的用户附加数据
`int`	`getZoneId()`
`long`	`routeHash()`
`void`	`setAddableIncreaseFlag(int increaseFlag)` 设置空记录自增允许标志。用于Generic表的increase操作。
`void`	`setAppId(int appId)`
`void`	`setAsynId(long asynId)`
`void`	`SetCheckDataVersionPolicy(int type)` 设置记录版本的检查类型，版本号version通过使用SetVersion()函数设置
`void`	`setCmd(int cmd)` 设置请求命令字
`void`	`setCondition(String condition)` 设置过滤条件，操作（查询，更新等）前，记录满足条件则操作，如果不满足，则不操作。
`void`	`setExpireTime(int expireTime)` 当设置了 `TcaplusProtocolCsConstants.TCAPLUS_FLAG_FETCH_ONLY_IF_EXPIRED` 标志位时，用于指定记录过期时间，目前仅batchget 操作支持指定记录过期时间。
`void`	`setFieldName(List<String> fieldNames)` 批量设置需要查询或更新的Value字段名称列表
`void`	`setFlags(int flag)` 设置请求的通用标志位，可以通过"按位或"操作同时设定多个值
`void`	`setListShiftFlag(int flag)` 设置LIST满时，插入元素时，删除旧元素的模式
`void`	`setMultiResponseFlag(int multiFlag)` 设置是否允许一个请求包可以自动响应多个应答包，仅对listgetall、batchget、partkeyget协议有效。
`void`	`setPartkeyGetParam(int offset, int num)` Deprecated.
`void`	`setResultFlag(int resultFlag)` 设置响应标志。主要用于Generic表的insert、increase、replace、update、 delete操作和list表的单个delete、replace操作。
`void`	`setResultFlagForFail(int resultFlag)` 设置响应标志。主要是本次请求执行失败后返回给前端的数据
`void`	`setResultFlagForSuccess(int resultFlag)` 设置响应标志。主要是本次请求成功执行后返回给前端的数据
`void`	`setResultLimit(int limit, int offset)` 如果此请求会返回多条记录，通过此接口对返回的记录做一些限制，仅对listgetall、partkeyget协议有效
`void`	`setSql(String sql)` 设置查询SQL语句，目前只支持SELECT
`void`	`setTableName(String tableName)` 设置请求表名
`void`	`setTraverseParam(long traverseOffset, long totalLimit, long traversedCnt, int shardId)` 设置generic_table 遍历参数，仅对`TcaplusProtocolCsConstants.TCAPLUS_CMD_TABLE_TRAVERSE_REQ`与 `TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_TABLE_TRAVERSE_REQ`有效
`void`	`setUserData(byte[] data)` 设置用户附加数据，该数据可以在响应消息中通过getUserData方法获再次获得。
`void`	`setZoneId(int zoneId)`
`String`	`toString()` 可视化对象

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - RequestLite
```
public RequestLite()
```
- Method Detail
  - setCmd
```
public void setCmd(int cmd)
            throws TCaplusException
```
    Description copied from interface: Request
    
    设置请求命令字
    
    Specified by:
    
    setCmd in interface Request
    
    Parameters:
    
    cmd - 请求命令字，支持下列命令字：
    TcaplusProtocolCsConstants.TCAPLUS_CMD_INSERT_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_REPLACE_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_INCREASE_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_GET_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_BATCH_GET_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_GET_BY_PARTKEY_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_DELETE_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_ADDAFTER_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_REPLACE_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_GET_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_GETALL_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_DELETE_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_DELETE_BATCH_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_DELETEALL_REQ
    TcaplusProtocolCsConstants.TCAPLUS_CMD_TABLE_TRAVERSE_REQ
    
    Throws:
    
    TCaplusException
    
    See Also:
    
    TcaplusProtocolCsConstants
  - getCmd
```
public int getCmd()
```
    Description copied from interface: Request
    
    获得请求命令字
    
    Specified by:
    
    getCmd in interface Request
    
    Returns:
    
    请求命令字
  - setAppId
```
public void setAppId(int appId)
```
  - getAppId
```
public int getAppId()
```
  - setZoneId
```
public void setZoneId(int zoneId)
```
  - getZoneId
```
public int getZoneId()
```
  - setTableName
```
public void setTableName(String tableName)
                  throws TCaplusException
```
    Description copied from interface: Request
    
    设置请求表名
    
    Specified by:
    
    setTableName in interface Request
    
    Parameters:
    
    tableName - 请求表名，包括'\0'结束符，最大不超过32字节
    
    Throws:
    
    TCaplusException
  - getTableName
```
public String getTableName()
```
    Description copied from interface: Request
    
    获得请求表名
    
    Specified by:
    
    getTableName in interface Request
    
    Returns:
    
    请求表名
  - setUserData
```
public void setUserData(byte[] data)
                 throws TCaplusException
```
    Description copied from interface: Request
    
    设置用户附加数据，该数据可以在响应消息中通过getUserData方法获再次获得。
    
    Specified by:
    
    setUserData in interface Request
    
    Parameters:
    
    data - 用户附加数据，最大长度不超过1024字节
    
    Throws:
    
    TCaplusException
  - getUserData
```
public byte[] getUserData()
```
    Description copied from interface: Request
    
    获得设置的用户附加数据
    
    Specified by:
    
    getUserData in interface Request
    
    Returns:
    
    设置的用户附加数据
  - setResultFlag
```
public void setResultFlag(int resultFlag)
                   throws TCaplusException
```
    Description copied from interface: Request
    
    设置响应标志。主要用于Generic表的insert、increase、replace、update、 delete操作和list表的单个delete、replace操作。
    
    Specified by:
    
    setResultFlag in interface Request
    
    Parameters:
    
    resultFlag - 请求标志
    TcaplusProtocolCsConstants.TCaplusValueFlag_NOVALUE 只需返回操作执行成功与否
    TcaplusProtocolCsConstants.TCaplusValueFlag_SAMEWITHREQUEST 返回与请求字段一致
    TcaplusProtocolCsConstants.TCaplusValueFlag_ALLVALUE 如果是generic表，则返回变更记录的所有字段最新数据；如果是list表，则返回变更记录的所有字段旧数据
    TcaplusProtocolCsConstants.TCaplusValueFlag_ALLOLDVALUE 返回变更记录的所有字段旧数据
    
    对于batch_get请求，该字段设置为大于0时，某个key查询记录不存在或svr端产生其它错误时会返回对应的key，从而知道是哪个key对应的记录失败了。
    
    Throws:
    
    TCaplusException
  - setResultFlagForSuccess
```
public void setResultFlagForSuccess(int resultFlag)
                             throws TCaplusException
```
    Description copied from interface: Request
    
    设置响应标志。主要是本次请求成功执行后返回给前端的数据
    下面是各个支持的命令字在设置不同的result_flag下执行成功后返回给API端的数据详细情况:
    1. TCAPLUS_API_INSERT_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回本次insert操作后的数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回空数据
    2. TCAPLUS_API_REPLACE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回本次replace操作后的数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据, 如果tcapsvr端没有数据,即返回为空
    3. TCAPLUS_API_UPDATE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回本次update操作后的数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据
    4. TCAPLUS_API_INCREASE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回本次increase操作后的数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据, 如果tcapsvr端没有数据,即返回为空
    5. TCAPLUS_API_DELETE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回空数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据
    6. TCAPLUS_API_LIST_DELETE_BATCH_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据, 凡是本次成功删除的index对应的数据都会返回
    7. TCAPLUS_API_LIST_ADDAFTER_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后, 返回本次插入的记录和本次淘汰的数据记录如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后不返回数据
    8. TCAPLUS_API_LIST_DELETE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回空数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端listdelete前的数据
    9. TCAPLUS_API_LIST_REPLACE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作成功后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作成功后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 则操作成功后返回tcapsvr端listreplace后的数据如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端listreplace前的数据
    
    Specified by:
    
    setResultFlagForSuccess in interface Request
    
    Parameters:
    
    resultFlag - 请求标志 TCaplusValueFlag_NOVALUE = 0, // 不返回任何返回值，只需返回操作执行成功与否 TCaplusValueFlag_SAMEWITHREQUEST = 1, // 返回同请求一致的值 TCaplusValueFlag_ALLVALUE = 2, // 返回tcapsvr端操作后所有字段的值，变更记录的所有字段最新数据 TCaplusValueFlag_ALLOLDVALUE = 3, // 返回tcapsvr端操作前所有字段的值，变更记录的所有字段旧数据
    
    Throws:
    
    TCaplusException
  - setResultFlagForFail
```
public void setResultFlagForFail(int resultFlag)
                          throws TCaplusException
```
    Description copied from interface: Request
    
    设置响应标志。主要是本次请求执行失败后返回给前端的数据
    下面是各个支持的命令字在设置不同的result_flag下执行失败后返回给API端的数据详细情况:
    1. TCAPLUS_API_INSERT_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    2. TCAPLUS_API_REPLACE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    3. TCAPLUS_API_UPDATE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    4. TCAPLUS_API_INCREASE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    5. TCAPLUS_API_DELETE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    6. TCAPLUS_API_LIST_DELETE_BATCH_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 则操作成功后返回tcapsvr端操作前的数据, 凡是本次成功删除的index对应的数据都会返回
    7. TCAPLUS_API_LIST_ADDAFTER_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 不返回数据
    8. TCAPLUS_API_LIST_DELETE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    9. TCAPLUS_API_LIST_REPLACE_REQ 如果设置的是TCaplusValueFlag_NOVALUE, 则操作失败后不返回数据如果设置的是TCaplusValueFlag_SAMEWITHREQUEST, 则操作失败后返回和请求一致的数据, 暂时没有实现如果设置的是TCaplusValueFlag_ALLVALUE, 不合理场景如果设置的是TCaplusValueFlag_ALLOLDVALUE, 如果获取到了tcapsvr端的数据则返回tcpasvr端的数据,如果没有获取到tcapsvr端的数据则返回空
    
    Specified by:
    
    setResultFlagForFail in interface Request
    
    Parameters:
    
    resultFlag - 请求标志 TCaplusValueFlag_NOVALUE = 0, // 不返回任何返回值，只需返回操作执行成功与否 TCaplusValueFlag_SAMEWITHREQUEST = 1, // 返回同请求一致的值. note: DELETE命令请求数据中只有key, 没有value，故返回结果中没有数据 TCaplusValueFlag_ALLVALUE = 2, // 返回tcapsvr端操作后所有字段的值，变更记录的所有字段最新数据 TCaplusValueFlag_ALLOLDVALUE = 3, // 返回tcapsvr端操作前所有字段的值，变更记录的所有字段旧数据
    
    Throws:
    
    TCaplusException
  - getResultFlag
```
public int getResultFlag()
```
    Description copied from interface: Request
    
    获得响应标志
    
    Specified by:
    
    getResultFlag in interface Request
    
    Returns:
    
    响应标志
  - getResultFlagForSuccess
```
public int getResultFlagForSuccess()
```
    Description copied from interface: Request
    
    获得操作成功响应标志，未使用Request.setResultFlagForSuccess(int)设置过时返回0
    
    Specified by:
    
    getResultFlagForSuccess in interface Request
    
    Returns:
    
    响应标志
  - getResultFlagForFail
```
public int getResultFlagForFail()
```
    Description copied from interface: Request
    
    获得操作失败响应标志，未使用Request.setResultFlagForFail(int)设置过时返回0
    
    Specified by:
    
    getResultFlagForFail in interface Request
    
    Returns:
    
    响应标志
  - addRecord
```
public Record addRecord()
                 throws TCaplusException
```
    Description copied from interface: Request
    
    向请求中添加一条记录，设置默认index为-1
    
    Specified by:
    
    addRecord in interface Request
    
    Returns:
    
    记录对象
    
    Throws:
    
    TCaplusException
    
    See Also:
    
    Request.addRecord(int index)
  - addRecord
```
public Record addRecord(int index)
                 throws TCaplusException
```
    Description copied from interface: Request
    
    向请求中添加一条记录
    
    Specified by:
    
    addRecord in interface Request
    
    Parameters:
    
    index - 元素索引，用于List操作，通常>=0表示该Record在所属List中的Index(注意，非位置下标，第一个元素index从0开始)。
    index是辅助key，tcaplus会自动维护其唯一性，新插入的记录index会往上自增。当cmd是TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_ADDAFTER_REQ时，表示记录插入在该index所在的记录之后(隐含约束： index对应的记录必须已存在)，此时index还支持以下特殊值：
    TcaplusProtocolCsConstants.TCAPLUS_LIST_PRE_FIRST_INDEX 插入元素位置在最前面
    TcaplusProtocolCsConstants.TCAPLUS_LIST_LAST_INDEX 插入元素位置在最后面
    
    对于Generic表，index无意义将被忽略。
    
    Returns:
    
    记录对象
    
    Throws:
    
    TCaplusException
  - setFieldName
```
public void setFieldName(List<String> fieldNames)
                  throws TCaplusException
```
    Description copied from interface: Request
    
    批量设置需要查询或更新的Value字段名称列表
    
    Specified by:
    
    setFieldName in interface Request
    
    Parameters:
    
    fieldNames - 多个字段名
    
    Throws:
    
    TCaplusException
    
    See Also:
    
    Request.addFieldName(java.lang.String)
  - addFieldName
```
public void addFieldName(String fieldName)
                  throws TCaplusException
```
    Description copied from interface: Request
    
    增加一个需要查询或更新的value字段名称列表，即部分value字段查询和更新。可用于get、batchget、partkeyget、listget、listgetall、listreplace、replace、update、tabletraverse操作。
    注意：在使用该函数设置字段名时，字段名只能包含value字段名，不能包含key字段名
    
    Specified by:
    
    addFieldName in interface Request
    
    Parameters:
    
    fieldName - 字段名，包括'\0'结束符，最大不超过32字节
    
    Throws:
    
    TCaplusException
  - setMultiResponseFlag
```
public void setMultiResponseFlag(int multiFlag)
                          throws TCaplusException
```
    Description copied from interface: Request
    
    设置是否允许一个请求包可以自动响应多个应答包，仅对listgetall、batchget、partkeyget协议有效。
    注意：在使用该函数设置字段名时，字段名只能包含value字段名，不能包含key字段名
    
    Specified by:
    
    setMultiResponseFlag in interface Request
    
    Parameters:
    
    multiFlag - 多响应包标示，1表示允许一个请求包可以自动响应多个应答包, 0表示不允许一个请求包自动响应多个应答包
    
    Throws:
    
    TCaplusException
  - getMultiResponseFlag
```
public int getMultiResponseFlag()
```
    Description copied from interface: Request
    
    获得自动响应多个应答包标志
    
    Specified by:
    
    getMultiResponseFlag in interface Request
    
    Returns:
    
    多响应包标示
  - setPartkeyGetParam
```
@Deprecated
public void setPartkeyGetParam(int offset,
                                           int num)
                                    throws TCaplusException
```
    Deprecated.
    
    Description copied from interface: Request
    
    set the parameter for partkeyget operation
    
    Specified by:
    
    setPartkeyGetParam in interface Request
    
    Parameters:
    
    offset - : the offset from where you want to get the records
    
    num - : the record num you want to get in one request. If the result size > 256K, the response will only include 256K content, so the records num will < num .
    
    Throws:
    
    TCaplusException
  - setResultLimit
```
public void setResultLimit(int limit,
                           int offset)
                    throws TCaplusException
```
    Description copied from interface: Request
    
    如果此请求会返回多条记录，通过此接口对返回的记录做一些限制，仅对listgetall、partkeyget协议有效
    对于partkeyget查询，limit表示所要获取Record的条数，offset表示所要获取Record的开始下标(下标从0开始)。
    对于listgetall查询，limit表示所要获取Record的条数，offset表示所要获取Record的开始下标(下标从0开始)。
    
    Specified by:
    
    setResultLimit in interface Request
    
    Parameters:
    
    limit - 需要查询的记录条数，limit若等于-1表示操作或返回所有匹配的数据记录
    
    offset - 记录起始编号，若设置为负值(-N, N>0)，则从倒数第N个记录开始返回结果
    
    Throws:
    
    TCaplusException
  - setTraverseParam
```
public void setTraverseParam(long traverseOffset,
                             long totalLimit,
                             long traversedCnt,
                             int shardId)
```
    Description copied from interface: Request
    
    设置generic_table 遍历参数，仅对TcaplusProtocolCsConstants.TCAPLUS_CMD_TABLE_TRAVERSE_REQ与 TcaplusProtocolCsConstants.TCAPLUS_CMD_LIST_TABLE_TRAVERSE_REQ有效
    
    Specified by:
    
    setTraverseParam in interface Request
    
    Parameters:
    
    traverseOffset - tcapsvr游标位置
    
    totalLimit - 此次遍历器最多遍历多少个记录
    
    traversedCnt - 此次遍历器已经遍历的记录个数
    
    shardId - 当前遍历的shardId
  - SetCheckDataVersionPolicy
```
public void SetCheckDataVersionPolicy(int type)
                               throws TCaplusException
```
    Description copied from interface: Request
    
    设置记录版本的检查类型，版本号version通过使用SetVersion()函数设置
    此函数只适合replace、update、increase、listaddafter、listdelete、listreplace、listdeletebatch操作
    
    Specified by:
    
    SetCheckDataVersionPolicy in interface Request
    
    Parameters:
    
    type - 版本检测类型，取值如下:
    TcaplusProtocolCsConstants.CHECKDATAVERSION_AUTOINCREASE 表示检测记录版本号
    设置version<=0则仍然表示不关注版本号，设置version>0那么只有当该版本号与服务器端的版本号相同时， replace、update、increase、 listaddafter、listdelete、listreplace、listdeletebatch 操作才会成功同时在服务器端该版本号会自增1，默认为该类型。
    TcaplusProtocolCsConstants.NOCHECKDATAVERSION_OVERWRITE表示不检测记录版本号
    设置version<=0，则会把版本号1写入服务端的数据记录版本号(服务器端成功写入的数据记录的版本号最少为1)，设置version>0那么会把该版本号写入服务端的数据记录版本号。
    TcaplusProtocolCsConstants.NOCHECKDATAVERSION_AUTOINCREASE表示不检测记录版本号
    将服务器端的数据记录版本号自增1，若服务器端新写入数据记录则新写入的数据记录的版本号为1。当设置该值且resultFlag设置TcaplusProtocolCsConstants.TCaplusValueFlag_ALLVALUE时， insert主键冲突响应消息会返回最新记录， increase、replace、update、listdelete、listreplace、listdeletebatch在版本号不正确出错时，响应消息会返回最新记录。
    
    Throws:
    
    TCaplusException
  - AddElementIndex
```
public void AddElementIndex(int index)
                     throws TCaplusException
```
    Description copied from interface: Request
    
    添加LIST记录的元素索引值。该函数只对于TCAPLUS_API_LIST_DELETE_BATCH_REQ有效
    
    Specified by:
    
    AddElementIndex in interface Request
    
    Parameters:
    
    index - LIST元素索引值，不可取值:
    TcaplusProtocolCsConstants.TCAPLUS_LIST_PRE_FIRST_INDEX
    TcaplusProtocolCsConstants.TCAPLUS_LIST_LAST_INDEX
    
    Throws:
    
    TCaplusException
  - setListShiftFlag
```
public void setListShiftFlag(int flag)
                      throws TCaplusException
```
    Description copied from interface: Request
    
    设置LIST满时，插入元素时，删除旧元素的模式
    
    Specified by:
    
    setListShiftFlag in interface Request
    
    Parameters:
    
    flag - 删除旧元素的模式，可取值:
    TcaplusProtocolCsConstants.TCAPLUS_LIST_SHIFT_NONE 不允许删除元素，若LIST满，插入失败。
    TcaplusProtocolCsConstants.TCAPLUS_LIST_SHIFT_HEAD 移除最前面的元素(默认设置)。
    TcaplusProtocolCsConstants.TCAPLUS_LIST_SHIFT_TAIL 移除最后面的元素
    
    Throws:
    
    TCaplusException
  - setExpireTime
```
public void setExpireTime(int expireTime)
                   throws TCaplusException
```
    Description copied from interface: Request
    
    当设置了 TcaplusProtocolCsConstants.TCAPLUS_FLAG_FETCH_ONLY_IF_EXPIRED 标志位时，用于指定记录过期时间，目前仅batchget 操作支持指定记录过期时间。
    
    Specified by:
    
    setExpireTime in interface Request
    
    Parameters:
    
    expireTime - 过期时间，单位为秒
    
    Throws:
    
    TCaplusException
  - setFlags
```
public void setFlags(int flag)
              throws TCaplusException
```
    Description copied from interface: Request
    
    设置请求的通用标志位，可以通过"按位或"操作同时设定多个值
    TcaplusProtocolCsConstants.TCAPLUS_FLAG_FETCH_ONLY_IF_MODIFIED:
    "数据变更才取回"标志位。在发起读操作之前，用户代码通过 TcaplusServiceRecord::SetVersion() 带上本地缓存数据的版本号，并将此标志置位，那么存储端检测到当前数据与API本地缓存的数据版本一致时，表明该记录未发生过修改，API缓存的数据是最新的，因此在响应中将不会携带实际的数据，只是返回 TcapErrCode::COMMON_INFO_DATA_NOT_MODIFIED 的错误码。
    在请求中设置了此标志位之后，收到响应后应首先通过 TcaplusServiceResponse::GetFlags() 来获知发送请求时是否设置了TCAPLUS_FLAG_FETCH_ONLY_IF_MODIFIED标志。只有get、listget、listgetall请求支持设置此标志。
    TcaplusProtocolCsConstants.TCAPLUS_FLAG_FETCH_ONLY_IF_EXPIRED:
    "数据过期才取回"标志位。在发起读操作之前，用户代码通过 SetExpireTime() 设定数据过期时间，并将此标志置位，那么存储端若检测到记录在指定时间内发生过更新，则将数据返回，否则不返回实际数据，只是返回 TcapErrCode::COMMON_INFO_DATA_NOT_MODIFIED 的错误码。
    在请求中设置了此标志位之后，收到响应后应首先通过 TcaplusServiceResponse::GetFlags() 来获知发送请求时是否设置了 TCAPLUS_FLAG_FETCH_ONLY_IF_EXPIRED 标志。只有batchget请求支持设置此标志。
    TcaplusProtocolCsConstants.TCAPLUS_FLAG_ONLY_READ_FROM_SLAVE:
    设置此标志后，读请求将会直接发送给Tcapsvr Slave 节点。Tcapsvr Slave 通常比较空闲，设置此标志有助于充分利用Tcapsvr Slave 资源。
    适用场景: 对于数据实时性要求不高的读请求、包括generic表和list表的所有读请求以及batchget、遍历请求。
    TcaplusProtocolCsConstants.TCAPLUS_FLAG_LIST_RESERVE_INDEX_HAVING_NO_ELEMENTS:
    设置此标志后，List表删除最后一个元素时需要保留index和version。listdelete、listdeletebatch、listdeleteall操作在删除list表最后一个元素时设置此标志，再写入新的List记录时，版本号依次增长，不会被重置为1。
    适用场景:业务需要确定某个表在删除最后一个元素时是否需要保留index和version
    TcaplusProtocolCsConstants.TCAPLUS_FLAG_PRIORITY_READ_FROM_SLAVE:
    设置此标志后，读请求将会直接发送给Tcapsvr Slave 节点。Slave读失败，请求会转发给master处理。
    适用场景: 对于数据实时性要求不高的读请求、包括generic表和list表的所有读请求以及batchget、遍历请求。
    
    Specified by:
    
    setFlags in interface Request
    
    Parameters:
    
    flag - 通用标志
    
    Throws:
    
    TCaplusException
  - setAddableIncreaseFlag
```
public void setAddableIncreaseFlag(int increaseFlag)
                            throws TCaplusException
```
    Description copied from interface: Request
    
    设置空记录自增允许标志。用于Generic表的increase操作。
    
    Specified by:
    
    setAddableIncreaseFlag in interface Request
    
    Parameters:
    
    increaseFlag - 空记录自增允许标志。0表示不允许。1表示允许，当记录不存在时，将按字段默认值创建新记录再自增；若无默认值则返回错误
    
    Throws:
    
    TCaplusException
  - setSql
```
public void setSql(String sql)
            throws TCaplusException
```
    Description copied from interface: Request
    
    设置查询SQL语句，目前只支持SELECT
    
    Specified by:
    
    setSql in interface Request
    
    Throws:
    
    TCaplusException
  - getCondition
```
public String getCondition()
```
    Description copied from interface: Request
    
    获取当前设置的过滤条件。
    
    Specified by:
    
    getCondition in interface Request
    
    Returns:
    
    返回当前设置的过滤条件，如果返回null表示当前没有设置过滤条件
  - setCondition
```
public void setCondition(String condition)
                  throws TCaplusException
```
    Description copied from interface: Request
    
    设置过滤条件，操作（查询，更新等）前，记录满足条件则操作，如果不满足，则不操作。
    
    Specified by:
    
    setCondition in interface Request
    
    Throws:
    
    TCaplusException
  - setAsynId
```
public void setAsynId(long asynId)
```
  - getAsynId
```
public long getAsynId()
```
  - getRecords
```
public List<RecordLite> getRecords()
```
  - assemble
```
public void assemble(TCaplusPkg pkg)
              throws TdrException
```
    Throws:
    
    TdrException
  - routeHash
```
public long routeHash()
```
  - toString
```
public String toString()
```
    Description copied from interface: Request
    
    可视化对象
    
    Specified by:
    
    toString in interface Request
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    可视化内容

Class RequestLite

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RequestLite

Method Detail

setCmd

getCmd

setAppId

getAppId

setZoneId

getZoneId

setTableName

getTableName

setUserData

getUserData

setResultFlag

setResultFlagForSuccess

setResultFlagForFail

getResultFlag

getResultFlagForSuccess

getResultFlagForFail

addRecord

addRecord

setFieldName

addFieldName

setMultiResponseFlag

getMultiResponseFlag

setPartkeyGetParam

setResultLimit

setTraverseParam

SetCheckDataVersionPolicy

AddElementIndex

setListShiftFlag

setExpireTime

setFlags

setAddableIncreaseFlag

setSql

getCondition

setCondition

setAsynId

getAsynId

getRecords

assemble

routeHash

toString