From a098625c378c2bcfa3525b3ba527844bdc0cf38b Mon Sep 17 00:00:00 2001 From: JiaShuo Date: Fri, 4 Sep 2020 13:47:17 +0800 Subject: [PATCH] fix comment --- .../client/PegasusClientInterface.java | 22 +++---------------- 1 file changed, 3 insertions(+), 19 deletions(-) diff --git a/src/main/java/com/xiaomi/infra/pegasus/client/PegasusClientInterface.java b/src/main/java/com/xiaomi/infra/pegasus/client/PegasusClientInterface.java index b38145be..7402d984 100644 --- a/src/main/java/com/xiaomi/infra/pegasus/client/PegasusClientInterface.java +++ b/src/main/java/com/xiaomi/infra/pegasus/client/PegasusClientInterface.java @@ -44,25 +44,9 @@ public interface PegasusClientInterface { /** * Open a table, and prepare the sessions and route-table to the replica-servers. * - *

Note: this interface is deprecated, retaining it only for compatibility, please see {@link - * PegasusClientInterface#openTable(String, TableOptions)} - * - *

Please notice that pegasus support two kinds of API: 1. the client-interface way, which is - * provided in this class. 2. the table-interface way, which is provided by {@link - * PegasusTableInterface}. With the client-interface, you don't need to create - * PegasusTableInterface by openTable, so you can access the pegasus cluster conveniently. - * However, the client-interface's api also has some restrictions: 1. we don't provide async - * methods in client-interface. 2. the timeout in client-interface isn't as accurate as the - * table-interface. 3. the client-interface may throw an exception when open table fails. It means - * that you may need to handle this exception in every data access operation, which is annoying. - * 4. You can't specify a per-operation timeout. So we recommend you to use the table-interface. - * - * @param tableName the table should be exist on the server, which is created before by the system - * administrator - * @param backupRequestDelayMs the delay time to send backup request. If backupRequestDelayMs <= - * 0, The backup request is disabled. - * @return the table handler - * @throws PException throws exception if any error occurs. + * @deprecated retaining it only for compatibility, we will remove it later, don't use it any + * more. the latest interface please see {@link PegasusClientInterface#openTable(String, + * TableOptions)} */ @Deprecated public PegasusTableInterface openTable(String tableName, int backupRequestDelayMs)