Package at.stefangeyer.challonge.service.implementation

Class SimpleChallongeService

java.lang.Object
at.stefangeyer.challonge.service.implementation.SimpleChallongeService
All Implemented Interfaces:
ChallongeService
public class SimpleChallongeService
extends java.lang.Object
implements ChallongeService
Challonge Service Implementation

  • Constructor Details

  • Method Details

    • getTournaments

      public java.util.List<Tournament> getTournaments​(TournamentQueryState state, TournamentType type, java.time.OffsetDateTime createdAfter, java.time.OffsetDateTime createdBefore, java.lang.String subdomain) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a set of tournaments created with your account.
      Specified by:
      getTournaments in interface ChallongeService
      Parameters:
      state - Only get tournaments with this state
      type - Only get tournaments with this type
      createdAfter - Get tournaments created after this date
      createdBefore - Get tournaments created before this date
      subdomain - Only get tournaments with this subdomain
      Returns:
      The filtered tournaments
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getTournaments

      public void getTournaments​(TournamentQueryState state, TournamentType type, java.time.OffsetDateTime createdAfter, java.time.OffsetDateTime createdBefore, java.lang.String subdomain, Callback<java.util.List<Tournament>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a set of tournaments created with your account.
      Specified by:
      getTournaments in interface ChallongeService
      Parameters:
      state - Only get tournaments with this state
      type - Only get tournaments with this type
      createdAfter - Get tournaments created after this date
      createdBefore - Get tournaments created before this date
      subdomain - Only get tournaments with this subdomain
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getTournament

      public Tournament getTournament​(java.lang.String tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a single tournament record created with your account.
      Specified by:
      getTournament in interface ChallongeService
      Parameters:
      tournament - Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for challonge.com/single_elim). If assigned to a subdomain, URL format must be :subdomain-:tournament_url (e.g. 'test-mytourney' for test.challonge.com/mytourney)
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The matching tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getTournament

      public void getTournament​(java.lang.String tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a single tournament record created with your account.
      Specified by:
      getTournament in interface ChallongeService
      Parameters:
      tournament - Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for challonge.com/single_elim). If assigned to a subdomain, URL format must be :subdomain-:tournament_url (e.g. 'test-mytourney' for test.challonge.com/mytourney)
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • createTournament

      public Tournament createTournament​(TournamentQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Create a new tournament.
      Specified by:
      createTournament in interface ChallongeService
      Parameters:
      data - An object with all the necessary information to create the tournament
      Returns:
      The created tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • createTournament

      public void createTournament​(TournamentQuery data, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Create a new tournament.
      Specified by:
      createTournament in interface ChallongeService
      Parameters:
      data - An object with all the necessary information to create the tournament
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • updateTournament

      public Tournament updateTournament​(Tournament tournament, TournamentQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Update a tournament's attributes.
      Specified by:
      updateTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to update. Must contain tournament id
      data - An object with all the necessary information to update the tournament
      Returns:
      The updated tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • updateTournament

      public void updateTournament​(Tournament tournament, TournamentQuery data, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Update a tournament's attributes.
      Specified by:
      updateTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to update. Must contain tournament id
      data - An object with all the necessary information to update the tournament
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • deleteTournament

      public Tournament deleteTournament​(Tournament tournament) throws DataAccessException
      Description copied from interface: ChallongeService
      Deletes a tournament along with all its associated records. There is no undo, so use with care!
      Specified by:
      deleteTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to delete. Must contain tournament id
      Returns:
      The deleted tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • deleteTournament

      public void deleteTournament​(Tournament tournament, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Deletes a tournament along with all its associated records. There is no undo, so use with care!
      Specified by:
      deleteTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to delete. Must contain tournament id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • processCheckIns

      public Tournament processCheckIns​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      This should be invoked after a tournament's check-in window closes before the tournament is started.

      1. Marks participants who have not checked in as inactive. 2. Moves inactive participants to bottom seeds (ordered by original seed). 3. Transitions the tournament state from 'checking_in' to 'checked_in'

      NOTE: Checked in participants on the waiting list will be promoted if slots become available.

      Specified by:
      processCheckIns in interface ChallongeService
      Parameters:
      tournament - The tournament to process check ins for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The updated tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • processCheckIns

      public void processCheckIns​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      This should be invoked after a tournament's check-in window closes before the tournament is started.

      1. Marks participants who have not checked in as inactive. 2. Moves inactive participants to bottom seeds (ordered by original seed). 3. Transitions the tournament state from 'checking_in' to 'checked_in'

      NOTE: Checked in participants on the waiting list will be promoted if slots become available.

      Specified by:
      processCheckIns in interface ChallongeService
      Parameters:
      tournament - The tournament to process check ins for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • abortCheckIn

      public Tournament abortCheckIn​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      When your tournament is in a 'checking_in' or 'checked_in' state, there's no way to edit the tournament's start time (start_at) or check-in duration (check_in_duration). You must first abort check-in, then you may edit those attributes.

      1. Makes all participants active and clears their checked_in_at times. 2. Transitions the tournament state from 'checking_in' or 'checked_in' to 'pending'

      Specified by:
      abortCheckIn in interface ChallongeService
      Parameters:
      tournament - The tournament to abort check in for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The updated tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • abortCheckIn

      public void abortCheckIn​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      When your tournament is in a 'checking_in' or 'checked_in' state, there's no way to edit the tournament's start time (start_at) or check-in duration (check_in_duration). You must first abort check-in, then you may edit those attributes.

      1. Makes all participants active and clears their checked_in_at times. 2. Transitions the tournament state from 'checking_in' or 'checked_in' to 'pending'

      Specified by:
      abortCheckIn in interface ChallongeService
      Parameters:
      tournament - The tournament to abort check in for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • startTournament

      public Tournament startTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Start a tournament, opening up first round matches for score reporting. The tournament must have at least 2 participants.
      Specified by:
      startTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to start. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The started tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • startTournament

      public void startTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Start a tournament, opening up first round matches for score reporting. The tournament must have at least 2 participants.
      Specified by:
      startTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to start. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • finalizeTournament

      public Tournament finalizeTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Finalize a tournament that has had all match scores submitted, rendering its results permanent.
      Specified by:
      finalizeTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to finalize. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The finalized tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • finalizeTournament

      public void finalizeTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Finalize a tournament that has had all match scores submitted, rendering its results permanent.
      Specified by:
      finalizeTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to finalize. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • resetTournament

      public Tournament resetTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Reset a tournament, clearing all of its scores and attachments. You can then add/remove/edit participants before starting the tournament again.
      Specified by:
      resetTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to reset. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The reset tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • resetTournament

      public void resetTournament​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Reset a tournament, clearing all of its scores and attachments. You can then add/remove/edit participants before starting the tournament again.
      Specified by:
      resetTournament in interface ChallongeService
      Parameters:
      tournament - The tournament to reset. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • openTournamentForPredictions

      public Tournament openTournamentForPredictions​(Tournament tournament, boolean includeParticipants, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Sets the state of the tournament to start accepting predictions. Your tournament's 'prediction_method' attribute must be set to 1 (exponential scoring) or 2 (linear scoring) to use this option. Note: Once open for predictions, match records will be persisted, so participant additions and removals will no longer be permitted.
      Specified by:
      openTournamentForPredictions in interface ChallongeService
      Parameters:
      tournament - The tournament to open predictions for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      Returns:
      The reset tournament
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • openTournamentForPredictions

      public void openTournamentForPredictions​(Tournament tournament, boolean includeParticipants, boolean includeMatches, Callback<Tournament> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Sets the state of the tournament to start accepting predictions. Your tournament's 'prediction_method' attribute must be set to 1 (exponential scoring) or 2 (linear scoring) to use this option. Note: Once open for predictions, match records will be persisted, so participant additions and removals will no longer be permitted.
      Specified by:
      openTournamentForPredictions in interface ChallongeService
      Parameters:
      tournament - The tournament to open predictions for. Must contain tournament id
      includeParticipants - Include a list of participants in the response
      includeMatches - Include a list of matches in the response
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getParticipants

      public java.util.List<Participant> getParticipants​(Tournament tournament) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a tournament's participant list.
      Specified by:
      getParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to get the participants from. Must contain tournament id
      Returns:
      The tournaments participants
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getParticipants

      public void getParticipants​(Tournament tournament, Callback<java.util.List<Participant>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a tournament's participant list.
      Specified by:
      getParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to get the participants from. Must contain tournament id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getParticipant

      public Participant getParticipant​(Tournament tournament, long participantId, boolean includeMatches) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a single participant record for a tournament.
      Specified by:
      getParticipant in interface ChallongeService
      Parameters:
      tournament - The tournament to get the participant from. Must contain tournament id
      participantId - The participant's unique ID
      includeMatches - Includes an array of associated match records
      Returns:
      The requested participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getParticipant

      public void getParticipant​(Tournament tournament, long participantId, boolean includeMatches, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a single participant record for a tournament.
      Specified by:
      getParticipant in interface ChallongeService
      Parameters:
      tournament - The tournament to get the participant from. Must contain tournament id
      participantId - The participant's unique ID
      includeMatches - Includes an array of associated match records
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • addParticipant

      public Participant addParticipant​(Tournament tournament, ParticipantQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Add a participant to a tournament (up until it is started).
      Specified by:
      addParticipant in interface ChallongeService
      Parameters:
      tournament - The tournament to add the participant to. Must contain tournament id
      data - The participant data
      Returns:
      The added participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • addParticipant

      public void addParticipant​(Tournament tournament, ParticipantQuery data, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Add a participant to a tournament (up until it is started).
      Specified by:
      addParticipant in interface ChallongeService
      Parameters:
      tournament - The tournament to add the participant to. Must contain tournament id
      data - The participant data
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • bulkAddParticipants

      public java.util.List<Participant> bulkAddParticipants​(Tournament tournament, java.util.List<ParticipantQuery> data) throws DataAccessException
      Description copied from interface: ChallongeService
      Bulk add participants to a tournament (up until it is started). If an invalid participant is detected, bulk participant creation will halt and any previously added participants (from this API request) will be rolled back.
      Specified by:
      bulkAddParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to add the participants to. Must contain tournament id
      data - The participant data
      Returns:
      The added participants
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • bulkAddParticipants

      public void bulkAddParticipants​(Tournament tournament, java.util.List<ParticipantQuery> data, Callback<java.util.List<Participant>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Bulk add participants to a tournament (up until it is started). If an invalid participant is detected, bulk participant creation will halt and any previously added participants (from this API request) will be rolled back.
      Specified by:
      bulkAddParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to add the participants to. Must contain tournament id
      data - The participant data
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • updateParticipant

      public Participant updateParticipant​(Participant participant, ParticipantQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Update the attributes of a tournament participant.
      Specified by:
      updateParticipant in interface ChallongeService
      Parameters:
      participant - The participant to update. Must contain the tournament id and the participant's id
      data - The participant data
      Returns:
      The updates participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • updateParticipant

      public void updateParticipant​(Participant participant, ParticipantQuery data, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Update the attributes of a tournament participant.
      Specified by:
      updateParticipant in interface ChallongeService
      Parameters:
      participant - The participant to update. Must contain the tournament id and the participant's id
      data - The participant data
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • checkInParticipant

      public Participant checkInParticipant​(Participant participant) throws DataAccessException
      Description copied from interface: ChallongeService
      Checks a participant in, setting checked_in_at to the current time.
      Specified by:
      checkInParticipant in interface ChallongeService
      Parameters:
      participant - The participant to check in. Must contain the tournament id and the participant's id
      Returns:
      The checked in participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • checkInParticipant

      public void checkInParticipant​(Participant participant, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Checks a participant in, setting checked_in_at to the current time.
      Specified by:
      checkInParticipant in interface ChallongeService
      Parameters:
      participant - The participant to check in. Must contain the tournament id and the participant's id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • undoCheckInParticipant

      public Participant undoCheckInParticipant​(Participant participant) throws DataAccessException
      Description copied from interface: ChallongeService
      Marks a participant as having not checked in, setting checked_in_at to nil.
      Specified by:
      undoCheckInParticipant in interface ChallongeService
      Parameters:
      participant - The participant to check in. Must contain the tournament id and the participant's id
      Returns:
      The checked out participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • undoCheckInParticipant

      public void undoCheckInParticipant​(Participant participant, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Marks a participant as having not checked in, setting checked_in_at to nil.
      Specified by:
      undoCheckInParticipant in interface ChallongeService
      Parameters:
      participant - The participant to check in. Must contain the tournament id and the participant's id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • deleteParticipant

      public Participant deleteParticipant​(Participant participant) throws DataAccessException
      Description copied from interface: ChallongeService
      If the tournament has not started, delete a participant, automatically filling in the abandoned seed number. If tournament is underway, mark a participant inactive, automatically forfeiting his/her remaining matches.
      Specified by:
      deleteParticipant in interface ChallongeService
      Parameters:
      participant - The participant to delete. Must contain the tournament id and the participant's id
      Returns:
      The deleted participant
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • deleteParticipant

      public void deleteParticipant​(Participant participant, Callback<Participant> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      If the tournament has not started, delete a participant, automatically filling in the abandoned seed number. If tournament is underway, mark a participant inactive, automatically forfeiting his/her remaining matches.
      Specified by:
      deleteParticipant in interface ChallongeService
      Parameters:
      participant - The participant to delete. Must contain the tournament id and the participant's id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • randomizeParticipants

      public java.util.List<Participant> randomizeParticipants​(Tournament tournament) throws DataAccessException
      Description copied from interface: ChallongeService
      Randomize seeds among participants. Only applicable before a tournament has started.
      Specified by:
      randomizeParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to randomize. Must contain the tournament id
      Returns:
      The randomized participants
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • randomizeParticipants

      public void randomizeParticipants​(Tournament tournament, Callback<java.util.List<Participant>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Randomize seeds among participants. Only applicable before a tournament has started.
      Specified by:
      randomizeParticipants in interface ChallongeService
      Parameters:
      tournament - The tournament to randomize. Must contain the tournament id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getMatches

      public java.util.List<Match> getMatches​(Tournament tournament, Participant participant, MatchState state) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a tournament's match list.
      Specified by:
      getMatches in interface ChallongeService
      Parameters:
      tournament - The tournament to get the matches from. Must contain id or url with an optional subdomain
      participant - Only retrieve matches that include the specified participant. This parameter is optional. Provide null if you want to skip it.
      state - all (default), pending, open, complete. This parameter is optional. Provide null if you want to skip it.
      Returns:
      The tournament's matches
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getMatches

      public void getMatches​(Tournament tournament, Participant participant, MatchState state, Callback<java.util.List<Match>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a tournament's match list.
      Specified by:
      getMatches in interface ChallongeService
      Parameters:
      tournament - The tournament to get the matches from. Must contain id or url with an optional subdomain
      participant - Only retrieve matches that include the specified participant. This parameter is optional. Provide null if you want to skip it.
      state - all (default), pending, open, complete. This parameter is optional. Provide null if you want to skip it.
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getMatch

      public Match getMatch​(Tournament tournament, long matchId, boolean includeAttachments) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a single match record for a tournament.
      Specified by:
      getMatch in interface ChallongeService
      Parameters:
      tournament - The tournament to get the match from. Must contain tournament id
      matchId - The match's unique ID
      includeAttachments - Include an array of associated attachment records
      Returns:
      The requested match
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • getMatch

      public void getMatch​(Tournament tournament, long matchId, boolean includeAttachments, Callback<Match> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a single match record for a tournament.
      Specified by:
      getMatch in interface ChallongeService
      Parameters:
      tournament - The tournament to get the match from. Must contain tournament id
      matchId - The match's unique ID
      includeAttachments - Include an array of associated attachment records
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • updateMatch

      public Match updateMatch​(Match match, MatchQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Update/submit the score(s) for a match.
      Specified by:
      updateMatch in interface ChallongeService
      Parameters:
      match - The match to update. Must contain the tournament- and match id
      data - The new match data
      Returns:
      The updated match
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • updateMatch

      public void updateMatch​(Match match, MatchQuery data, Callback<Match> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Update/submit the score(s) for a match.
      Specified by:
      updateMatch in interface ChallongeService
      Parameters:
      match - The match to update. Must contain the tournament- and match id
      data - The new match data
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • markMatchAsUnderway

      public Match markMatchAsUnderway​(Match match) throws DataAccessException
      Description copied from interface: ChallongeService
      Marks a match as underway
      Specified by:
      markMatchAsUnderway in interface ChallongeService
      Parameters:
      match - The match to mark as underway. Must contain the tournament- and match id
      Returns:
      The updated match
      Throws:
      DataAccessException - Exchange with the rest api failed

    • markMatchAsUnderway

      public void markMatchAsUnderway​(Match match, Callback<Match> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Marks a match as underway
      Specified by:
      markMatchAsUnderway in interface ChallongeService
      Parameters:
      match - The match to mark as underway. Must contain the tournament- and match id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • unmarkMatchAsUnderway

      public Match unmarkMatchAsUnderway​(Match match) throws DataAccessException
      Description copied from interface: ChallongeService
      Unmarks a match as underway
      Specified by:
      unmarkMatchAsUnderway in interface ChallongeService
      Parameters:
      match - The match to unmark as underway. Must contain the tournament- and match id
      Returns:
      The updated match
      Throws:
      DataAccessException - Exchange with the rest api failed

    • unmarkMatchAsUnderway

      public void unmarkMatchAsUnderway​(Match match, Callback<Match> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Unmarks a match as underway
      Specified by:
      unmarkMatchAsUnderway in interface ChallongeService
      Parameters:
      match - The match to unmark as underway. Must contain the tournament- and match id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • reopenMatch

      public Match reopenMatch​(Match match) throws DataAccessException
      Description copied from interface: ChallongeService
      Reopens a match that was marked completed, automatically resetting matches that follow it.
      Specified by:
      reopenMatch in interface ChallongeService
      Parameters:
      match - The match to reopen. Must contain the tournament- and match id
      Returns:
      The reopened match
      Throws:
      DataAccessException - Exchange with the rest api or validation failed

    • reopenMatch

      public void reopenMatch​(Match match, Callback<Match> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Reopens a match that was marked completed, automatically resetting matches that follow it.
      Specified by:
      reopenMatch in interface ChallongeService
      Parameters:
      match - The match to reopen. Must contain the tournament- and match id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getAttachments

      public java.util.List<Attachment> getAttachments​(Match match) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a match's attachments.
      Specified by:
      getAttachments in interface ChallongeService
      Parameters:
      match - The match to get the attachments from. Must contain the tournament- and match id
      Returns:
      The match attachments
      Throws:
      DataAccessException - Exchange with the rest api failed

    • getAttachments

      public void getAttachments​(Match match, Callback<java.util.List<Attachment>> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a match's attachments.
      Specified by:
      getAttachments in interface ChallongeService
      Parameters:
      match - The match to get the attachments from. Must contain the tournament- and match id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • getAttachment

      public Attachment getAttachment​(Match match, long attachmentId) throws DataAccessException
      Description copied from interface: ChallongeService
      Retrieve a single match attachment record.
      Specified by:
      getAttachment in interface ChallongeService
      Parameters:
      match - The match to get the attachment from. Must contain the tournament- and match id
      attachmentId - The attachment's unique ID
      Returns:
      The requested attachment
      Throws:
      DataAccessException - Exchange with the rest api failed

    • getAttachment

      public void getAttachment​(Match match, long attachmentId, Callback<Attachment> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Retrieve a single match attachment record.
      Specified by:
      getAttachment in interface ChallongeService
      Parameters:
      match - The match to get the attachment from. Must contain the tournament- and match id
      attachmentId - The attachment's unique ID
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • createAttachment

      public Attachment createAttachment​(Match match, AttachmentQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Add a file, link, or text attachment to a match. NOTE: The associated tournament's "accept_attachments" attribute must be true for this action to succeed.

      At least 1 of the 3 optional parameters (asset, url or description in the enumeration object) must be provided. Files up to 25MB are allowed for tournaments hosted by Challonge Premier subscribers.

      Specified by:
      createAttachment in interface ChallongeService
      Parameters:
      match - The match to create the attachment for. Must contain the tournament- and match id
      data - The attachment to create
      Returns:
      The created attachment
      Throws:
      DataAccessException - Exchange with the rest api failed

    • createAttachment

      public void createAttachment​(Match match, AttachmentQuery data, Callback<Attachment> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Add a file, link, or text attachment to a match. NOTE: The associated tournament's "accept_attachments" attribute must be true for this action to succeed.

      At least 1 of the 3 optional parameters (asset, url or description in the enumeration object) must be provided. Files up to 25MB are allowed for tournaments hosted by Challonge Premier subscribers.

      Specified by:
      createAttachment in interface ChallongeService
      Parameters:
      match - The match to create the attachment for. Must contain the tournament- and match id
      data - The attachment to create
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • updateAttachment

      public Attachment updateAttachment​(Match match, Attachment attachment, AttachmentQuery data) throws DataAccessException
      Description copied from interface: ChallongeService
      Update the attributes of a match attachment.

      Sending the asset does neither work with base64 nor with a multipart-form-data request

      At least 1 of the 3 optional parameters (asset, url or description in the enumeration object) must be provided. Files up to 25MB are allowed for tournaments hosted by Challonge Premier subscribers.

      Specified by:
      updateAttachment in interface ChallongeService
      Parameters:
      match - The match to delete the attachment from. Must contain the tournament- and match id
      attachment - The attachment to update. Must contain the tournament- and match id
      data - The attachment to update
      Returns:
      The updated attachment
      Throws:
      DataAccessException - Exchange with the rest api failed

    • updateAttachment

      public void updateAttachment​(Match match, Attachment attachment, AttachmentQuery data, Callback<Attachment> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Update the attributes of a match attachment.

      Sending the asset does neither work with base64 nor with a multipart-form-data request

      At least 1 of the 3 optional parameters (asset, url or description in the enumeration object) must be provided. Files up to 25MB are allowed for tournaments hosted by Challonge Premier subscribers.

      Specified by:
      updateAttachment in interface ChallongeService
      Parameters:
      match - The match to delete the attachment from. Must contain the tournament- and match id
      attachment - The attachment to update. Must contain the tournament- and match id
      data - The attachment to update
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful

    • deleteAttachment

      public Attachment deleteAttachment​(Match match, Attachment attachment) throws DataAccessException
      Description copied from interface: ChallongeService
      Delete a match attachment.
      Specified by:
      deleteAttachment in interface ChallongeService
      Parameters:
      match - The match to delete the attachment from. Must contain the tournament- and match id
      attachment - The attachment to delete. Must contain the tournament- and match id
      Returns:
      The deleted attachment
      Throws:
      DataAccessException - Exchange with the rest api failed

    • deleteAttachment

      public void deleteAttachment​(Match match, Attachment attachment, Callback<Attachment> onSuccess, Callback<DataAccessException> onFailure)
      Description copied from interface: ChallongeService
      Delete a match attachment.
      Specified by:
      deleteAttachment in interface ChallongeService
      Parameters:
      match - The match to delete the attachment from. Must contain the tournament- and match id
      attachment - The attachment to delete. Must contain the tournament- and match id
      onSuccess - Called with result if call was successful
      onFailure - Called with exception if call was not successful