Tair (Redis® OSS-Compatible):Implement distributed leaderboards by using exZset

Step 1: Add the Maven dependency

Add the following to your pom.xml:

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

Step 2: Configure and run the leaderboard

The following example creates a distributed leaderboard, adds six members with multi-dimensional scores (gold, silver, and bronze medal counts), and retrieves one member's rank and the overall top three.

import io.valkey.JedisPool;
import io.valkey.JedisPoolConfig;
import com.aliyun.tair.tairzset.*;

public class DistributedLeaderBoardExample {
    // Instance connection settings
    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();

    // Leaderboard settings
    private static final int shardKeySize = 10;          // Number of sub-leaderboards
    private static final int pageSize = 10;              // Members per page
    private static final boolean reverse = true;         // true = descending order (highest score first)
    private static final boolean useZeroIndexForRank = false; // false = ranks start from 1

    public static void main(String[] args) {
        JedisPool jedisPool = new JedisPool(config, HOST, PORT, DEFAULT_CONNECTION_TIMEOUT,
                DEFAULT_SO_TIMEOUT, PASSWORD, 0, null);

        // Create the distributed leaderboard
        DistributedLeaderBoard dlb = new DistributedLeaderBoard("distributed_leaderboard", jedisPool,
            shardKeySize, pageSize, reverse, useZeroIndexForRank);

        // Add members with multi-dimensional scores: gold, silver, bronze
        // Members are sorted by gold first, then silver, then bronze
        dlb.addMember("A", 32, 21, 16);
        dlb.addMember("B", 25, 29, 21);
        dlb.addMember("C", 20,  7, 12);
        dlb.addMember("D", 14,  4, 16);
        dlb.addMember("E", 13, 21, 18);
        dlb.addMember("F", 13, 17, 14);

        // Get the rank of member A
        System.out.println(dlb.rankFor("A")); // 1

        // Get the top 3 members
        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}]
    }
}

Replace the following placeholders with your actual values:

Parameters

For the full list of available methods, see the com.aliyun.tair.tairzset.DistributedLeaderBoard class in the alibabacloud-tairjedis-sdk Javadoc.