Package com.tagtraum.beatunes.library.itunes

Class ITLibraryDescriptor

java.lang.Object

com.tagtraum.beatunes.library.LibraryDescriptor

com.tagtraum.beatunes.library.itunes.ITLibraryDescriptor

public class ITLibraryDescriptor
extends LibraryDescriptor

Descriptor for an ITLibrary-based iTunes/Music.app library.

Author:

Hendrik Schreiber

Constructor Summary

Constructors

Constructor	Description
ITLibraryDescriptor(long id)
ITLibraryDescriptor(String id)

Method Summary

Modifier and Type	Method	Description
LibraryLoader	createLibraryLoader()	Creates a library loader appropriate for this kind of library.
boolean	equals(Object o)
boolean	exists()	Indicates whether the library described by this instance actually exists.
String	getIdAsString()	Library id as String.
long	getLastModified()	If this library descriptor describes a document or is capable of determining the last modification of the library as a whole, this method returns the date.
String	getName()	Name.
int	hashCode()
boolean	needsRefresh(long lastSync)	Indicates whether we might want to sync this library.
String	toString()
AudioSong	wrap(AudioSong audioSong)	Wraps an internal database song into another AudioSong that is capable of writing/reading data to external databases or files (e.g.
PlayList	wrap(PlayList playList)	Wraps an internal database playlist into another PlayList that is capable of writing/reading data to external databases or files.

Methods inherited from class com.tagtraum.beatunes.library.LibraryDescriptor

getId, getMediaLibrary, setMediaLibrary

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ITLibraryDescriptor

public ITLibraryDescriptor(String id)

ITLibraryDescriptor

public ITLibraryDescriptor(long id)

Method Detail

getLastModified

public long getLastModified()
                     throws IOException

Description copied from class: LibraryDescriptor

If this library descriptor describes a document or is capable of determining the last modification of the library as a whole, this method returns the date.

Specified by:

getLastModified in class LibraryDescriptor

Returns:

date of last modification or 0 if unknown

Throws:

IOException

needsRefresh

public boolean needsRefresh(long lastSync)
                     throws IOException

Description copied from class: LibraryDescriptor

Indicates whether we might want to sync this library. If this cannot determined accurately, this method returns true.

Specified by:

needsRefresh in class LibraryDescriptor

Parameters:

lastSync - date of last sync

Returns:

true, if we should probably sync

Throws:

IOException

getIdAsString

public String getIdAsString()

Description copied from class: LibraryDescriptor

Library id as String.

Specified by:

getIdAsString in class LibraryDescriptor

Returns:

id

See Also:

PersistentId.idStringToLong(String)

getName

public String getName()

Description copied from class: LibraryDescriptor

Name. E.g. "iTunes".

Specified by:

getName in class LibraryDescriptor

Returns:

library name

exists

public boolean exists()

Description copied from class: LibraryDescriptor

Indicates whether the library described by this instance actually exists. Defaults to true.

Overrides:

exists in class LibraryDescriptor

Returns:

true or false

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

createLibraryLoader

public LibraryLoader createLibraryLoader()

Description copied from class: LibraryDescriptor

Creates a library loader appropriate for this kind of library.

Specified by:

createLibraryLoader in class LibraryDescriptor

Returns:

library loader

wrap

public AudioSong wrap(AudioSong audioSong)

Description copied from class: LibraryDescriptor

Wraps an internal database song into another AudioSong that is capable of writing/reading data to external databases or files (e.g. Track or AudioMetaData). Depending on the kind of library, this wrapper might be quite different.

Specified by:

wrap in class LibraryDescriptor

Parameters:

audioSong - song object to be wrapped, e.g. Song

Returns:

wrapper

wrap

public PlayList wrap(PlayList playList)

Description copied from class: LibraryDescriptor

Wraps an internal database playlist into another PlayList that is capable of writing/reading data to external databases or files. Depending on the kind of library, this wrapper might be quite different.

Specified by:

wrap in class LibraryDescriptor

Parameters:

playList - song object to be wrapped, e.g. HibernatePlayList

Returns:

wrapper