Class LeaderboardService

java.lang.Object

it.unisa.diem.wordageddon_g16.services.LeaderboardService

public class LeaderboardService
extends Object

Classe che gestisce la classifica globale e filtrata per difficoltà nel gioco.

Recupera i dati dei punteggi dei giocatori tramite JDBCGameReportDAO e costruisce statistiche aggregate come punteggio medio, totale, e numero di partite giocate. Evidenzia l'utente corrente nella lista e determina la difficoltà preferita se non filtrata.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	LeaderboardService.LeaderboardEntry	Record interno che rappresenta una voce nella classifica.

Field Summary

Fields

Modifier and Type	Field	Description
private final User	currentUser
private final JDBCGameReportDAO	gameReportDAO
private final Collection<User>	users

Constructor Summary

Constructors

Constructor	Description
LeaderboardService(AppContext context, JDBCGameReportDAO gameReportDAO, UserDAO userDAO)	Costruttore della classe LeaderboardService.

Method Summary

Modifier and Type	Method	Description
List<LeaderboardService.LeaderboardEntry>	getGlobalLeaderboard()	Restituisce la classifica globale di tutti gli utenti, indipendentemente dalla difficoltà.
private List<LeaderboardService.LeaderboardEntry>	getLeaderboardBase(Difficulty difficulty)	Metodo interno che costruisce la classifica base, utilizzata sia globalmente che per singola difficoltà.
List<LeaderboardService.LeaderboardEntry>	getLeaderboardByDifficulty(Difficulty difficulty)	Restituisce la classifica filtrata per una specifica difficoltà.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

gameReportDAO

private final JDBCGameReportDAO gameReportDAO

users

private final Collection<User> users

currentUser

private final User currentUser

Constructor Details

LeaderboardService

public LeaderboardService(AppContext context,
 JDBCGameReportDAO gameReportDAO,
 UserDAO userDAO)

Costruttore della classe LeaderboardService.

Parameters:

context - il contesto applicativo corrente contenente l'utente attivo

gameReportDAO - DAO per i report di gioco

userDAO - DAO per la selezione degli utenti

Method Details

getGlobalLeaderboard

public List<LeaderboardService.LeaderboardEntry> getGlobalLeaderboard()

Restituisce la classifica globale di tutti gli utenti, indipendentemente dalla difficoltà.

Ogni voce include punteggio medio, totale e statistiche aggregate.

Returns:

lista ordinata di LeaderboardService.LeaderboardEntry per tutti gli utenti

getLeaderboardByDifficulty

public List<LeaderboardService.LeaderboardEntry> getLeaderboardByDifficulty(Difficulty difficulty)

Restituisce la classifica filtrata per una specifica difficoltà.

Parameters:

difficulty - difficoltà da considerare per la classifica

Returns:

lista ordinata di LeaderboardService.LeaderboardEntry relativa alla difficoltà selezionata

Throws:

IllegalArgumentException - se difficulty è null

getLeaderboardBase

private List<LeaderboardService.LeaderboardEntry> getLeaderboardBase(Difficulty difficulty)

Metodo interno che costruisce la classifica base, utilizzata sia globalmente che per singola difficoltà. Per ogni utente:

• Recupera i report di gioco filtrati (se richiesto)
• Calcola media, totale e numero di partite
• Determina la difficoltà preferita se non filtrato
• Evidenzia l'utente corrente apponendo "(Tu)"

Parameters:

difficulty - difficoltà da filtrare, null per classifica globale

Returns:

lista ordinata di LeaderboardService.LeaderboardEntry