feat: add ranking getter for API

Author: sysnote8main

src/main/java/net/azisaba/kdstatusreloaded/api/KDSAPI.java

@@ -1,16 +1,30 @@
 package net.azisaba.kdstatusreloaded.api;
 
 import net.azisaba.kdstatusreloaded.KDStatusReloaded;
+import net.azisaba.kdstatusreloaded.playerkd.PlayerKD;
 import net.azisaba.kdstatusreloaded.playerkd.model.KDUserData;
 import org.jspecify.annotations.NullMarked;
 
+import java.util.List;
 import java.util.Optional;
 import java.util.UUID;
 
 @NullMarked
 public class KDSAPI {
+    private static PlayerKD playerKd() {
+        return KDStatusReloaded.getPlugin().getPlayerKd();
+    }
+
     public static KDUserData getPlayerData(UUID uuid) {
-        Optional<KDUserData> data = KDStatusReloaded.getPlugin().getPlayerKd().getPlayerDataWithNoCaching(uuid);
+        Optional<KDUserData> data = playerKd().getPlayerDataWithNoCaching(uuid);
         return data.orElseGet(() -> new KDUserData(uuid, ""));
     }
+
+    public static int getPlayerRanking(KillCountType type, UUID uuid) {
+        return playerKd().getRanking(type, uuid);
+    }
+
+    public static List<KDUserData> getTops(KillCountType type, int limit) {
+        return playerKd().getTops(type, limit);
+    }
 }

src/main/java/net/azisaba/kdstatusreloaded/api/KillCountType.java

@@ -0,0 +1,38 @@
+package net.azisaba.kdstatusreloaded.api;
+
+import java.util.Calendar;
+
+public enum KillCountType {
+    DAILY("daily_kills"),
+    MONTHLY("monthly_kills"),
+    YEARLY("yearly_kills"),
+    TOTAL("kills");
+
+    public String columnName;
+    KillCountType(String columnName) {
+        this.columnName = columnName;
+    }
+
+    public long getFirstMilliSecond() {
+        Calendar cal = Calendar.getInstance();
+        cal.set(Calendar.MILLISECOND, 0);
+        cal.set(Calendar.SECOND, 0);
+        cal.set(Calendar.MINUTE, 0);
+        cal.set(Calendar.HOUR_OF_DAY, 0);
+
+        if (this == DAILY)
+            return cal.getTimeInMillis();
+
+        cal.set(Calendar.DATE, 1);
+
+        if (this == MONTHLY)
+            return cal.getTimeInMillis();
+
+        cal.set(Calendar.MONTH, 0);
+
+        if (this == YEARLY)
+            return cal.getTimeInMillis();
+
+        return -1;
+    }
+}

src/main/java/net/azisaba/kdstatusreloaded/playerkd/PlayerKD.java

@@ -1,6 +1,7 @@
 package net.azisaba.kdstatusreloaded.playerkd;
 
 import net.azisaba.kdstatusreloaded.KDStatusReloaded;
+import net.azisaba.kdstatusreloaded.api.KillCountType;
 import net.azisaba.kdstatusreloaded.playerkd.model.KDUserData;
 import net.azisaba.kdstatusreloaded.playerkd.cache.KDCache;
 import net.azisaba.kdstatusreloaded.playerkd.db.KDDatabase;
@@ -40,6 +41,14 @@ public Optional<KDUserData> getPlayerDataWithNoCaching(UUID uuid) {
         return kdDatabase.kdUserDataRepository().findById(uuid);
     }
 
+    public int getRanking(KillCountType type, UUID uuid) {
+        return kdDatabase.kdUserDataRepository().getRanking(type.columnName, type.getFirstMilliSecond(), uuid);
+    }
+
+    public List<KDUserData> getTops(KillCountType type, int limit) {
+        return kdDatabase.kdUserDataRepository().findTop(type.columnName, limit);
+    }
+
     public void migrate() {
         kdDatabase.migrate();
     }

src/main/java/net/azisaba/kdstatusreloaded/playerkd/db/KDUserDataRepository.java

@@ -17,8 +17,11 @@ public interface KDUserDataRepository {
     @SqlQuery("SELECT * FROM kill_death_data WHERE uuid = :uuid")
     Optional<KDUserData> findById(@Bind("uuid") UUID uuid);
 
-    @SqlQuery("SELECT * FROM kill_death_data ORDER BY kills DESC LIMIT :limit")
-    List<KDUserData> findTopByTotalKills(@Bind("limit") int limit);
+    @SqlQuery("SELECT * FROM kill_death_data ORDER BY :targetColumn DESC LIMIT :limit")
+    List<KDUserData> findTop(@Bind("targetColumn") String columnName, @Bind("limit") int limit);
+
+    @SqlQuery("SELECT * FROM (SELECT uuid, :targetColumn, last_updated, RANK() over (ORDER BY :targetColumn DESC) as 'rank' FROM kill_death_data WHERE last_updated > :unitFirstMilli ) s WHERE s.uuid = :uuid")
+    int getRanking(@Bind("targetColumn") String columnName, @Bind("unitFirstMilli") long unitFirstMilliSecond, @Bind("uuid") UUID uuid);
 
     @SqlUpdate("INSERT INTO kill_death_data (uuid, name, kills, deaths, daily_kills, monthly_kills, yearly_kills, last_updated) " +
             "VALUES (:uuid, :name, :totalKills, :deaths, :dailyKills, :monthlyKills, :yearlyKills, :lastUpdated) " +