Package de.umass.lastfm.cache

Interface ScrobbleCache

All Known Implementing Classes:
FileSystemCache
public interface ScrobbleCache
A ScrobbleCache is able to cache SubmissionData instances for later submission to the Last.fm servers.
Author:
Janni Kovacs

  • Method Details

    • cacheScrobble

      void cacheScrobble(SubmissionData... submissions)
      Caches one or more SubmissionData.
      Parameters:
      submissions - The submissions

    • cacheScrobble

      void cacheScrobble(Collection<SubmissionData> submissions)
      Caches a collection of SubmissionData.
      Parameters:
      submissions - The submissions

    • isEmpty

      boolean isEmpty()
      Checks if the cache contains any scrobbles.
      Returns:
      true if this cache is empty

    • scrobble

      void scrobble(Scrobbler scrobbler) throws IOException
      Tries to scrobble all cached scrobbles. If it succeeds the cache will be empty afterwards. If this method fails an IOException is thrown and no entries are removed from the cache.
      Parameters:
      scrobbler - A Scrobbler instance
      Throws:
      IOException - on I/O errors
      IllegalStateException - if the Scrobbler is not fully initialized (i.e. no handshake performed)

    • clearScrobbleCache

      void clearScrobbleCache()
      Clears all cached scrobbles from this cache.