Tair (Redis® OSS-Compatible):exZset を使用して分散型リーダーボードを実装する

コード例

このソリューションには、Tair によって開発された TairJedis クライアントが必要です。

1. pom.xml 構成を追加します。

           <dependency>
               <groupId>com.aliyun.tair</groupId>
               <artifactId>alibabacloud-tairjedis-sdk</artifactId>
               <version>5.3.1</version>
           </dependency>

2. サンプルコード。

   import io.valkey.JedisPool;
   import io.valkey.JedisPoolConfig;
   import com.aliyun.tair.tairzset.*;
   
   public class DistributedLeaderBoardExample {
       // インスタンスのエンドポイント、ポート、パスワード、およびその他の情報を構成します。
       private static final int DEFAULT_CONNECTION_TIMEOUT = 5000;
       private static final int DEFAULT_SO_TIMEOUT = 2000;
       private static final String HOST = "<r-bp1mx0ydsivrbp****.redis.rds.aliyuncs.com>";
       private static final int PORT = 6379;
       private static final String PASSWORD = "<Pass****word>";
       private static final JedisPoolConfig config = new JedisPoolConfig();
   
       // 分散型リーダーボードを構成します。
       private static final int shardKeySize = 10;  // 基になるサブリーダーボードの数。
       private static final int pageSize = 10;      // リーダーボードの各ページのメンバー数。
       private static final boolean reverse = true; // この例では、メンバーは降順でソートされます。
       private static final boolean useZeroIndexForRank = false; // この例では、ランクは 1 から始まります。
   
       public static void main(String[] args) {
           JedisPool jedisPool = new JedisPool(config, HOST, PORT, DEFAULT_CONNECTION_TIMEOUT,
                   DEFAULT_SO_TIMEOUT, PASSWORD, 0, null);
                   
           // 分散型リーダーボードを作成します。この例では、キーの名前は distributed_leaderboard です。
           DistributedLeaderBoard dlb = new DistributedLeaderBoard("distributed_leaderboard", jedisPool,
               shardKeySize, pageSize, reverse, useZeroIndexForRank);
   
           // 金メダルの数が同じ場合は、銀メダルの数でソートします。銀メダルの数も同じ場合は、銅メダルの数でソートします。
           //                    金 銀 銅
           dlb.addMember("A",     32,  21, 16);
           dlb.addMember("D",     14,  4,  16);
           dlb.addMember("C",     20,  7,  12);
           dlb.addMember("B",     25,  29, 21);
           dlb.addMember("E",     13,  21, 18);
           dlb.addMember("F",     13,  17,  14);
   
           // A のランクを取得します。
           dlb.rankFor("A"); // 1
           System.out.println(dlb.rankFor("A"));
   
           // 上位 3 件を取得します。
           dlb.top(3);
           System.out.println(dlb.top(3));
           // [{"member":"A","score":"32#21#16","rank":1},
           // {"member":"B","score":"25#29#21","rank":2},
           // {"member":"C","score":"20#7#12","rank":3}]
       }
   }

   パラメーター:

   パラメーター	タイプ	説明
   shardKeySize	int	基になるサブリーダーボードの数。デフォルト値は 10 です。この数は動的にスケールアウトできません。サービスの初期段階でこの数を計画してください。
   pageSize	int	リーダーボードの各ページのメンバー数。デフォルト値は 10 です。
   reverse	boolean	有効な値: false (デフォルト): 昇順でソートします。 true: 降順でソートします。
   useZeroIndexForRank	boolean	有効な値: true (デフォルト): ランクは 0 から始まります。 false: ランクは 1 から始まります。

   詳細については、「alibabacloud-tairjedis-sdk の com.aliyun.tair.tairzset.DistributedLeaderBoard クラス」をご参照ください。

付録: 従来のリーダーボードと分散型リーダーボードの比較

次の表は、従来のリーダーボードと分散型リーダーボードの基本機能の実装を比較したものです。