asyncMultiDel

异步删同一HashKey下的多行数据。

  1. public static interface MultiDelListener extends GenericFutureListener<Future<Void>> {
  2. /**
  3. * This function will be called when listened asyncMultiDel future is done.
  4. * @param future the listened future
  5. * @throws Exception
  6. *
  7. * Notice: User shouldn't do any operations that may block or time-consuming
  8. */
  9. @Override
  10. public void operationComplete(Future<Void> future) throws Exception;
  11. }
  12.  
  13. /**
  14. * delete mutiple values for a specific hashKey, async version
  15. * @param hashKey used to decide which partition the key may exist
  16. * if null or empty, means hash key is "".
  17. * @param sortKeys all the sortKeys need to be deleted
  18. * should not be null or empty
  19. * @param timeout how long will the operation timeout in milliseconds.
  20. * if timeout > 0, it is a timeout value for current op,
  21. * else the timeout value in the configuration file will be used.
  22. *
  23. * @return the future for current op
  24. *
  25. * Future return:
  26. * On success: no return
  27. * On failure: a throwable, which is an instance of PException
  28. *
  29. * Thread safety:
  30. * All the listeners for the same table are guaranteed to be dispatched in the same thread, so all the
  31. * listeners for the same future are guaranteed to be executed as the same order as the listeners added.
  32. * But listeners for different tables are not guaranteed to be dispatched in the same thread.
  33. */
  34. public Future<Void> asyncMultiDel(byte[] hashKey, List<byte[]> sortKeys, int timeout/*ms*/);

注:

  • 参数:需传入HashKey、SortKeys、timeout。
    • SortKeys不允许为空,如果不知道该HashKey下面有哪些SortKey,可以通过multiGetSortKeys方法获取。
    • timeout单位为毫秒,如果<=0,表示使用配置文件中的默认超时。
  • 返回值:Future