multiGetSortKeys

获取某个HashKey下SortKey列表。

  1. /**
  2.  * Get multiple sort keys under the same hash key.
  3.  * @param tableName table name
  4.  * @param hashKey used to decide which partition to put this k-v,
  5.  *                should not be null or empty.
  6.  * @param maxFetchCount max count of k-v pairs to be fetched.
  7.  *                      max_fetch_count <= 0 means no limit. default value is 100.
  8.  * @param maxFetchSize max size of k-v pairs to be fetched.
  9.  *                     max_fetch_size <= 0 means no limit. default value is 1000000.
  10.  * @param sortKeys output sort keys.
  11.  * @return true if all data is fetched; false if only partial data is fetched.
  12.  * @throws PException
  13.  */
  14. public boolean multiGetSortKeys(String tableName, byte[] hashKey, int maxFetchCount, int maxFetchSize, List<byte[]> sortKeys) throws PException;
  15. public boolean multiGetSortKeys(String tableName, byte[] hashKey, List<byte[]> sortKeys) throws PException;

注：

  • 提供了两个版本的接口，其中第一个接口可以指定maxFetchCount和maxFetchSize。
  • 参数：
    • 传入参数：需传入TableName、HashKey；选择性传入maxFetchCount、maxFetchSize。
    • 传出参数：数据通过sortKeys传出，sortKeys由用户在调用前new出来。
    • maxFetchCount和maxFetchSize用于限制读取的数据量，maxFetchCount表示最多读取的数据条数，maxFetchSize表示最多读取的数据字节数，两者任一达到限制就停止读取。
  • 返回值：如果用户指定了maxFetchCount或者maxFetchSize，单次查询可能只获取到部分结果。如果所有满足条件的数据都已经获取到，则返回true；否则返回false。
  • 异常：如果出现异常，譬如网络错误、超时错误、服务端错误等，会抛出 PException。