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 Summary
Modifier and TypeMethodDescriptionvoid
cacheScrobble
(SubmissionData... submissions) Caches one or moreSubmissionData
.void
cacheScrobble
(Collection<SubmissionData> submissions) Caches a collection ofSubmissionData
.void
Clears all cached scrobbles from this cache.boolean
isEmpty()
Checks if the cache contains any scrobbles.void
Tries to scrobble all cached scrobbles.
-
Method Details
-
cacheScrobble
Caches one or moreSubmissionData
.- Parameters:
submissions
- The submissions
-
cacheScrobble
Caches a collection ofSubmissionData
.- Parameters:
submissions
- The submissions
-
isEmpty
boolean isEmpty()Checks if the cache contains any scrobbles.- Returns:
true
if this cache is empty
-
scrobble
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
- AScrobbler
instance- Throws:
IOException
- on I/O errorsIllegalStateException
- if theScrobbler
is not fully initialized (i.e. no handshake performed)
-
clearScrobbleCache
void clearScrobbleCache()Clears all cached scrobbles from this cache.
-