org.mgif.score
Interface ScoreTableManager


public interface ScoreTableManager

Score retrieval interface


Method Summary
 Score getScoreAt(int rank)
          Get an entry from the first or only high score table for this application.
 Score getScoreAt(int table, int rank)
          Get an entry from one of the score tables for this application.
 Score[] getScoresAround(Actor actor, int number)
          Get the given number of entries centered on the best score of the given Actor in the first or only table.
 Score[] getScoresAround(int table, Actor actor, int number)
          Get the given number of entries centered on the best score of the given Actor in the given table.
 Score[] getScoresAround(int rank, int number)
          Get the given number of entries centered on the given position in the first or only table.
 Score[] getScoresAround(int table, int rank, int number)
          Get the given number of entries centered on the given position in the given table.
 Score[] getTopScores(int number)
          Get the given number of entries from the top of the first or only table.
 Score[] getTopScores(int table, int number)
          Get the given number of entries from the top of the given table.
 

Method Detail

getScoreAt

public Score getScoreAt(int rank)
Get an entry from the first or only high score table for this application.
Parameters:
rank - The position in the table to get the score from.
Returns:
The score at that rank or null if not available.

getScoreAt

public Score getScoreAt(int table,
                        int rank)
Get an entry from one of the score tables for this application.
Parameters:
rank - The position in the table to get the score from.
Returns:
The score at that rank or null if not available.

getScoresAround

public Score[] getScoresAround(Actor actor,
                               int number)
Get the given number of entries centered on the best score of the given Actor in the first or only table.
Parameters:
actor - Actor around whose best rank to take the scores.
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.

getScoresAround

public Score[] getScoresAround(int table,
                               Actor actor,
                               int number)
Get the given number of entries centered on the best score of the given Actor in the given table.
Parameters:
actor - Actor around whose best rank to take the scores.
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.

getScoresAround

public Score[] getScoresAround(int rank,
                               int number)
Get the given number of entries centered on the given position in the first or only table.
Parameters:
rank - Rank about which to take the scores.
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.

getScoresAround

public Score[] getScoresAround(int table,
                               int rank,
                               int number)
Get the given number of entries centered on the given position in the given table.
Parameters:
rank - Rank about which to take the scores.
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.

getTopScores

public Score[] getTopScores(int number)
Get the given number of entries from the top of the first or only table.
Parameters:
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.

getTopScores

public Score[] getTopScores(int table,
                            int number)
Get the given number of entries from the top of the given table.
Parameters:
number - Maximum number of scores to retrieve.
Returns:
An array of scores of size >= 0 and <= number.


Copyright © 2002 Mobile Games Interoperability Forum. All rights reserved.
This source code is protected by the legal notice posted at http://www.mgif.org/docs/notice.html