HibernateMusicLibrary (beaTunes 4.6.16 API)

java.lang.Object
- com.tagtraum.beatunes.library.AbstractMusicLibrary<A>
- - com.tagtraum.beatunes.library.HibernateMusicLibrary<A>

All Implemented Interfaces:

ITunesMusicLibrary, ApplicationComponent<A>
```
public class HibernateMusicLibrary<A extends ApplicationComponent>
extends AbstractMusicLibrary<A>
```
Hibernate-based music library.

Author:

Hendrik Schreiber

Field Summary
- Fields inherited from class com.tagtraum.beatunes.library.AbstractMusicLibrary
  AUTO_DETECT_ITUNESLIBRARY, databaseDir, propertyChangeSupport, TEN_MINUTES, TOTALTIME_DEVIATION, wrappingProxy

Constructor Summary

Constructors
Constructor and Description

HibernateMusicLibrary(A application)

Constructors
Constructor and Description
`HibernateMusicLibrary(A application)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addPlayListDataListener(ListDataListener l)`
`void`	`addPlayListPropertyChangeListener(PropertyChangeListener propertyChangeListener)` Lets you register a listener that receives events when a playlist property is changed.
`void`	`addPlayListPropertyChangeListener(String property, PropertyChangeListener propertyChangeListener)` Lets you register a listener that receives events when a playlist property is changed.
`static <T> T`	`callOnDefaultJob(Callable<T> callable, long timeoutInSeconds, T onErrorValue)` Executes the given `Callable` in the default job queue.
`static <T> T`	`callOnDefaultJobWithException(Callable<T> callable, long timeoutInSeconds, RuntimeException rte)` Executes the given `Callable` in the default job queue.
`static <T> T`	`callOnLIFOJob(Callable<T> callable, long timeoutInSeconds, T onErrorValue)` Executes the given `Callable` in the LIFO job queue.
`int`	`countSongs()` Number of songs in the library.
`int`	`countSongsWithPropertyValue(String propertyName, Object propertyValue)` Count all songs with a property `equal` to the given value.
`int`	`countUnprotectedSongsAddedAfter(Date time)`
`PlayList`	`createFolder()` Creates a new folder under the Music playlist/folder.
`PlayList`	`createFolder(Long parentId)` Creates a new folder at a specific location.
`PlayList`	`createPlayList(Long id, Long parentId, String name, boolean folder)` Creates a new `PlayList` object with the given name and id.
`PlayList`	`createPlayList(Long parentId, String name)` Creates a new PlayList at a specific location.
`PlayList`	`createPlayList(String name)` Creates a new PlayList under the Music playlist/folder.
`void`	`deletePlayList(long id)` Deletes a playlist from the library.
`AudioSong`	`fetchCollections(AudioSong audioSong)` Loads dependent collections that otherwise wouldn't have been loaded.
`static void`	`fetchLazyAssociations(List<Song> songs)`
`void`	`flushPendingWrites()` Flush any pending writes (blocks until all writes happened).
`Set<Set<Long>>`	`getAcousticallyIdenticalSongIds()` Returns a collection of sets that each contain song ids of acoustically "identical" songs.
`Set<Set<Long>>`	`getAcousticallyIdenticalSongIds(int maxSubprintMatchAttempts)` Returns a collection of sets that each contain song ids of acoustically "identical" songs.
`Album`	`getAlbum(Album.Key key)` Returns an album.
`Set<Album.Key>`	`getAlbumKeys()` Returns the set of all valid album keys.
`List<Long>`	`getAlbumSongIds(String album, String artist)` Returns a list of song ids for songs specified by the given album and artist.
`List<AudioSong>`	`getAlbumSongs(String album, String artist)` Returns a list of songs specified by the given album and artist.
`Set<Album.Key>`	`getAllTimesFavoriteAlbums(int max)`
`Version`	`getApplicationVersion()` Returns the iTunes application version as specified in the iTunes Music Library.xml.
`File`	`getDatabaseDir()`
`List<String>`	`getDuplicateTitles()` Returns a list of titles that have exact duplicates.
`List<String>`	`getDuplicateTrackIds()` Returns a list of track ids that correspond to more than one song.
`List<String>`	`getGenres()`
`HibernateMusicLibraryDelegate`	`getHibernateMusicLibraryDelegate()`
`HibernateUtil`	`getHibernateUtil()`
`Set<Album.Key>`	`getHighlyRatedAlbums(int max)`
`String`	`getId()` Unique id for each instance of this object.
`PlayList`	`getLibrary()` Returns the master playlist that contains all library objects.
`LibraryLoader`	`getLibraryLoader()`
`Long`	`getPersistentId()` Returns the iTunes library persistent id as specified in the `iTunes Music Library.xml`.
`PropertyChangeListener[]`	`getPlayListPropertyChangeListeners()`
`PropertyChangeListener[]`	`getPlayListPropertyChangeListeners(String property)`
`List<PlayList>`	`getPlayLists()` List of all playlists.
`TagCollection`	`getPopularTagCollection(int numberOfTags)` Returns the `TagCollection` for the X most common tags.
`Set<Album.Key>`	`getRecentlyAddedAlbums(int max)`
`Set<Album.Key>`	`getRecentlyPlayedAlbums(int max)`
`static String`	`getSchemaVersion()`
`Collection<Set<Long>>`	`getSimilarTitles()` Returns a collection of id sets that point to songs with similar or identical titles.
`Song`	`getSong(Long id)` Gets a Song, given its id (`Song.getId()`.
`Song`	`getSong(org.hibernate.Session session, Long playlistId, Long id)`
`List<Long>`	`getSongIds()` Returns an `Iterable` that can be used to iterate over all song ids.
`List<Long>`	`getSongIdsWithoutPropertyValue(String propertyName, Object propertyValue)` Get all song ids of songs with a property `equal` the given value.
`List<Long>`	`getSongIdsWithPropertyLikeValue(String propertyName, String propertyValue)` Get all song ids of songs with a property `like` the given value.
`List<Long>`	`getSongIdsWithPropertyValue(String propertyName, Object propertyValue)` Get all song ids for songs with a property `equal` to the given value.
`<T> List<T>`	`getSongPropertyValues(String propertyName)` All possible values for a given property.
`<T> List<T>`	`getSongPropertyValues(String propertyName, List<T> valueList)` All possible values for a given property.
`<T> List<T>`	`getSongPropertyValues(String propertyName, String restrictionPropertyName, Object restrictionPropertyValue)` Gets all property values of property `propertyName` for songs with `restrictionPropertyName` equaling `restrictionPropertyValue`.
`Iterable<AudioSong>`	`getSongs(Collection<Long> ids)` Returns an `Iterable` that can be used to iterate over the specified songs.
`List<Song>`	`getSongs(org.hibernate.Session session, Long playlistId, Long... ids)`
`List<AudioSong>`	`getSongsWithFileAndSize(String filename, int size)`
`List<AudioSong>`	`getSongsWithNameArtistAlbumTotalTime(String name, String artist, String album, int time)`
`List<AudioSong>`	`getSongsWithoutPropertyValue(String propertyName, Object propertyValue)` Get all songs with a property `not equal` to the given value.
`List<AudioSong>`	`getSongsWithPropertyLikeValue(String propertyName, String propertyValue)` Get all songs with a property `like` the given value.
`List<AudioSong>`	`getSongsWithPropertyValue(String propertyName, Object propertyValue)` Get all songs with a property `equal` to the given value.
`Set<AudioSong>`	`getSongsWithTrackIdTotalTime(Set<AudioId> ids, int time)`
`TagCollection`	`getTagCollection()` Returns the `TagCollection` for the entire library.
`List<AudioSong>`	`getUnprotectedSongsAddedAfter(Date time)`
`void`	`init()` Initializes this component and its sub-components.
`boolean`	`isCoalesceWrites()`
`protected boolean`	`isProgressDialogVisible(boolean firstTime, boolean manuallyInitiated)`
`void`	`openDatabase()` Opens the underlying database that has the descriptor set with `AbstractMusicLibrary.setLibraryDescriptor(LibraryDescriptor)`.
`void`	`removePlayListDataListener(ListDataListener l)`
`void`	`removePlayListPropertyChangeListener(PropertyChangeListener propertyChangeListener)`
`void`	`removePlayListPropertyChangeListener(String property, PropertyChangeListener propertyChangeListener)`
`static void`	`runOnDefaultJob(Callable<?> callable)` Executes the given `Callable` in the default job queue.
`void`	`setApplicationVersion(Version applicationVersion)`
`void`	`setCoalesceWrites(boolean coalesceWrites)`
`void`	`setHibernateMusicLibraryDelegate(HibernateMusicLibraryDelegate hibernateMusicLibraryDelegate)`
`void`	`setHibernateUtil(HibernateUtil hibernateUtil)`
`void`	`setPlayLists(List<PlayList> playLists)`
`void`	`shutdown()` Shuts down this component and its sub-components.
`void`	`store(AudioSong song, String changedProperty)` Stores a song in the beaTunes database and clears any sortorder caches in the playlist objects this song might be in, if the playlist is sorted by the changed property.
`void`	`store(Iterable<AudioSong> songs)` Stores a collection of songs in the beaTunes database.
`void`	`store(MatchListInfo matchListInfo)` Store the given info.
`void`	`store(PlayList playList)` Stores a playlist in the beaTunes database.
`void`	`updateSelectivity()` Update the selectivity for columns, so that the query plan cost optimizer can work as well as possible.

Methods inherited from class com.tagtraum.beatunes.library.AbstractMusicLibrary
addITunesMusicLibraryListener, addPropertyChangeListener, addPropertyChangeListener, fireAsynchronousSynchronizationEvent, fireLibrarySynchronizedEvent, fireSynchronousSynchronizationEvent, getApplication, getAudioMetaDataExecutor, getImplementation, getLastSynchronizationTimestamp, getLibraryDescriptor, getLock, getPlayList, getPreviousToLastSynchronizationTimestamp, getPropertyChangeListeners, getPropertyChangeListeners, getSongIds, getSongs, getTunes, getTunesExecutor, getUIDelegate, getWrappingProxy, getWrappingProxyFactory, isEmbedAudioMetaData, isNewDatabase, isOneWeekOld, isRebuildPlayLists, isSynchronizing, lock, needsRefresh, refresh, refresh, refreshOnNextUpdate, removePropertyChangeListener, removePropertyChangeListener, serialExecute, serialExecute, setApplication, setDatabaseDir, setEmbedAudioMetaData, setLibraryDescriptor, setNewDatabase, setRebuildPlayLists, setUIDelegate, smuggle, store

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - HibernateMusicLibrary
```
public HibernateMusicLibrary(A application)
```
- Method Detail
  - getId
```
public String getId()
```
    Description copied from interface: ApplicationComponent
    
    Unique id for each instance of this object.
    
    Returns:
    
    id
  - getHibernateMusicLibraryDelegate
```
public HibernateMusicLibraryDelegate getHibernateMusicLibraryDelegate()
```
  - setHibernateMusicLibraryDelegate
```
public void setHibernateMusicLibraryDelegate(HibernateMusicLibraryDelegate hibernateMusicLibraryDelegate)
```
  - getSchemaVersion
```
public static String getSchemaVersion()
```
  - getHibernateUtil
```
public HibernateUtil getHibernateUtil()
```
  - setHibernateUtil
```
public void setHibernateUtil(HibernateUtil hibernateUtil)
```
  - getDatabaseDir
```
public File getDatabaseDir()
```
  - init
```
public void init()
```
    Description copied from interface: ITunesMusicLibrary
    
    Initializes this component and its sub-components.
  - shutdown
```
public void shutdown()
```
    Description copied from interface: ITunesMusicLibrary
    
    Shuts down this component and its sub-components.
  - isCoalesceWrites
```
public boolean isCoalesceWrites()
```
  - setCoalesceWrites
```
public void setCoalesceWrites(boolean coalesceWrites)
```
  - openDatabase
```
public void openDatabase()
```
    Opens the underlying database that has the descriptor set with AbstractMusicLibrary.setLibraryDescriptor(LibraryDescriptor). Nothing should really happen, if the database with the same id is already open.
  - isProgressDialogVisible
```
protected boolean isProgressDialogVisible(boolean firstTime,
                                          boolean manuallyInitiated)
```
    Specified by:
    
    isProgressDialogVisible in class AbstractMusicLibrary<A extends ApplicationComponent>
  - createPlayList
```
public PlayList createPlayList(Long parentId,
                               String name)
```
    Description copied from interface: ITunesMusicLibrary
    
    Creates a new PlayList at a specific location.
    
    Parameters:
    
    parentId - persistent id of the parent, i.e. the location of the playlist to newly create
    
    name - name
    
    Returns:
    
    new playlist object.
  - createPlayList
```
public PlayList createPlayList(String name)
```
    Description copied from interface: ITunesMusicLibrary
    
    Creates a new PlayList under the Music playlist/folder.
    
    Parameters:
    
    name - name
    
    Returns:
    
    new playlist object.
  - createFolder
```
public PlayList createFolder(Long parentId)
```
    Description copied from interface: ITunesMusicLibrary
    
    Creates a new folder at a specific location.
    
    Parameters:
    
    parentId - persistent id of the parent, i.e. the location of the folder to newly create
    
    Returns:
    
    new folder object.
  - createFolder
```
public PlayList createFolder()
```
    Description copied from interface: ITunesMusicLibrary
    
    Creates a new folder under the Music playlist/folder.
    
    Returns:
    
    new folder object.
  - createPlayList
```
public PlayList createPlayList(Long id,
                               Long parentId,
                               String name,
                               boolean folder)
```
    Description copied from interface: ITunesMusicLibrary
    
    Creates a new PlayList object with the given name and id.
    
    Parameters:
    
    id - persistentId
    
    parentId - parent playlist persistent id - may be null, if there is no parent
    
    name - name
    
    folder - is folder
    
    Returns:
    
    a new persistent playlist
  - getApplicationVersion
```
public Version getApplicationVersion()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the iTunes application version as specified in the iTunes Music Library.xml.
    
    Returns:
    
    iTunes application version
  - setApplicationVersion
```
public void setApplicationVersion(Version applicationVersion)
```
  - getPersistentId
```
public Long getPersistentId()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the iTunes library persistent id as specified in the iTunes Music Library.xml.
    
    Returns:
    
    persistent library id as long
  - getLibraryLoader
```
public LibraryLoader getLibraryLoader()
```
    Specified by:
    
    getLibraryLoader in class AbstractMusicLibrary<A extends ApplicationComponent>
  - countSongs
```
public int countSongs()
```
    Description copied from interface: ITunesMusicLibrary
    
    Number of songs in the library.
    
    Returns:
    
    number of songs in the library.
  - getSong
```
public Song getSong(Long id)
```
    Description copied from interface: ITunesMusicLibrary
    
    Gets a Song, given its id (Song.getId().
    
    Parameters:
    
    id - id
    
    Returns:
    
    song or null, if not found
  - getSong
```
public Song getSong(org.hibernate.Session session,
                    Long playlistId,
                    Long id)
```
  - getSongs
```
public List<Song> getSongs(org.hibernate.Session session,
                           Long playlistId,
                           Long... ids)
```
  - fetchCollections
```
public AudioSong fetchCollections(AudioSong audioSong)
```
    Loads dependent collections that otherwise wouldn't have been loaded. Default impl. does nothing.
    
    Parameters:
    
    audioSong - song to 'complete'
    
    Returns:
    
    song complete with associated collections
  - getPopularTagCollection
```
public TagCollection getPopularTagCollection(int numberOfTags)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the TagCollection for the X most common tags.
    
    Parameters:
    
    numberOfTags - max number of tags to return
    
    Returns:
    
    tag collection for strongest tags in the library
  - getTagCollection
```
public TagCollection getTagCollection()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the TagCollection for the entire library.
    
    Returns:
    
    tag collection for the library
  - getSongPropertyValues
```
public <T> List<T> getSongPropertyValues(String propertyName,
                                         String restrictionPropertyName,
                                         Object restrictionPropertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Gets all property values of property propertyName for songs with restrictionPropertyName equaling restrictionPropertyValue.
    
    Parameters:
    
    propertyName - properties whose values are going to be returned
    
    restrictionPropertyName - property that is used to select the return set
    
    restrictionPropertyValue - property value that is used to select the return set
    
    Returns:
    
    values of propertyName
  - getSimilarTitles
```
public Collection<Set<Long>> getSimilarTitles()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a collection of id sets that point to songs with similar or identical titles.
    
    Returns:
    
    collection of id sets
    
    See Also:
    
    ITunesMusicLibrary.getDuplicateTitles()
  - getDuplicateTitles
```
public List<String> getDuplicateTitles()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a list of titles that have exact duplicates.
    
    Returns:
    
    list of duplicate titles
    
    See Also:
    
    ITunesMusicLibrary.getSimilarTitles()
  - getDuplicateTrackIds
```
public List<String> getDuplicateTrackIds()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a list of track ids that correspond to more than one song.
    
    Returns:
    
    list of duplicate ids
    
    See Also:
    
    ITunesMusicLibrary.getSimilarTitles()
  - getAcousticallyIdenticalSongIds
```
public Set<Set<Long>> getAcousticallyIdenticalSongIds()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a collection of sets that each contain song ids of acoustically "identical" songs. Only songs that have fingerprints (see AudioSong.setFingerprint(byte[])) can be found.
    
    Returns:
    
    set of id sets
    
    See Also:
    
    ITunesMusicLibrary.getAcousticallyIdenticalSongIds(int)
  - getAcousticallyIdenticalSongIds
```
public Set<Set<Long>> getAcousticallyIdenticalSongIds(int maxSubprintMatchAttempts)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a collection of sets that each contain song ids of acoustically "identical" songs. Only songs that have fingerprints (see AudioSong.setFingerprint(byte[])) can be found.
    
    Parameters:
    
    maxSubprintMatchAttempts - maximum number of attempts to match a subprint. Negative values cause an exhaustive search (longer runtime). The default value used in ITunesMusicLibrary.getAcousticallyIdenticalSongIds() is 15.
    
    Returns:
    
    set of id sets
    
    See Also:
    
    ITunesMusicLibrary.getAcousticallyIdenticalSongIds()
  - getSongPropertyValues
```
public <T> List<T> getSongPropertyValues(String propertyName)
```
    Description copied from interface: ITunesMusicLibrary
    
    All possible values for a given property.
    
    Parameters:
    
    propertyName - property
    
    Returns:
    
    values for a given property
  - getSongPropertyValues
```
public <T> List<T> getSongPropertyValues(String propertyName,
                                         List<T> valueList)
```
    Description copied from interface: ITunesMusicLibrary
    
    All possible values for a given property.
    
    Parameters:
    
    propertyName - property
    
    valueList - list that this method will add the results to. Before the results are added, the list is cleared.
    
    Returns:
    
    values for a given property
  - getGenres
```
public List<String> getGenres()
```
    Returns:
    
    unsorted list of all non-null genre names.
  - countSongsWithPropertyValue
```
public int countSongsWithPropertyValue(String propertyName,
                                       Object propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Count all songs with a property equal to the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a property
    
    Returns:
    
    list of songs whose property has the required value
  - getSongsWithPropertyValue
```
public List<AudioSong> getSongsWithPropertyValue(String propertyName,
                                                 Object propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all songs with a property equal to the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a property
    
    Returns:
    
    list of songs whose property has the required value
  - getSongsWithoutPropertyValue
```
public List<AudioSong> getSongsWithoutPropertyValue(String propertyName,
                                                    Object propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all songs with a property not equal to the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a property
    
    Returns:
    
    list of songs whose property does not have the given value
    
    See Also:
    
    ITunesMusicLibrary.getSongIdsWithoutPropertyValue(String, Object)
  - getSongIdsWithPropertyValue
```
public List<Long> getSongIdsWithPropertyValue(String propertyName,
                                              Object propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all song ids for songs with a property equal to the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a property
    
    Returns:
    
    list of song ids whose property has the required value
  - getSongIdsWithoutPropertyValue
```
public List<Long> getSongIdsWithoutPropertyValue(String propertyName,
                                                 Object propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all song ids of songs with a property equal the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a property
    
    Returns:
    
    list of song ids whose property does not have the given value
    
    See Also:
    
    ITunesMusicLibrary.getSongsWithoutPropertyValue(String, Object)
  - getSongsWithPropertyLikeValue
```
public List<AudioSong> getSongsWithPropertyLikeValue(String propertyName,
                                                     String propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all songs with a property like the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a string property
    
    Returns:
    
    list of songs whose string property contains the given value
    
    See Also:
    
    ITunesMusicLibrary.getSongIdsWithPropertyLikeValue(String, String)
  - getSongIdsWithPropertyLikeValue
```
public List<Long> getSongIdsWithPropertyLikeValue(String propertyName,
                                                  String propertyValue)
```
    Description copied from interface: ITunesMusicLibrary
    
    Get all song ids of songs with a property like the given value.
    
    Parameters:
    
    propertyName - name of a property
    
    propertyValue - value of a string property
    
    Returns:
    
    list of song ids whose string property contains the given value
    
    See Also:
    
    ITunesMusicLibrary.getSongsWithPropertyLikeValue(String, String)
  - getAlbumSongIds
```
public List<Long> getAlbumSongIds(String album,
                                  String artist)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a list of song ids for songs specified by the given album and artist. At least on of the two parameters must be a non-empty string. The lookup is case-sensitive. To find valid album/artist combinations, check ITunesMusicLibrary.getAlbumKeys().
    
    Parameters:
    
    album - album
    
    artist - artist or album artist
    
    Returns:
    
    list of ids
    
    See Also:
    
    ITunesMusicLibrary.getAlbumSongs(String, String), ITunesMusicLibrary.getAlbumKeys()
  - getAlbumSongs
```
public List<AudioSong> getAlbumSongs(String album,
                                     String artist)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns a list of songs specified by the given album and artist. At least one of the two parameters must be a non-empty string. The lookup is case-sensitive. To find valid album/artist combinations, check ITunesMusicLibrary.getAlbumKeys().
    
    Parameters:
    
    album - album
    
    artist - artist or album artist
    
    Returns:
    
    list of songs
    
    See Also:
    
    ITunesMusicLibrary.getAlbumSongIds(String, String), ITunesMusicLibrary.getAlbumKeys()
  - getAlbumKeys
```
public Set<Album.Key> getAlbumKeys()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the set of all valid album keys. To qualify for the set, both an album and either an artist or an album artist must be set.
    
    Returns:
    
    album keys
  - getSongs
```
public Iterable<AudioSong> getSongs(Collection<Long> ids)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns an Iterable that can be used to iterate over the specified songs.
    
    Parameters:
    
    ids - collection of ids
    
    Returns:
    
    an object from which one can get an iterator
  - getSongIds
```
public List<Long> getSongIds()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns an Iterable that can be used to iterate over all song ids.
    
    Returns:
    
    an object from which one can get an iterator
  - getLibrary
```
public PlayList getLibrary()
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns the master playlist that contains all library objects. This may also be unexpected objects like apps. For just Music objects, get the playlist with kind PlayList.Kind.MUSIC (testable via PlayList.getDistinguishedKind()).
    
    Returns:
    
    master playlist
  - getPlayLists
```
public List<PlayList> getPlayLists()
```
    Description copied from interface: ITunesMusicLibrary
    
    List of all playlists.
    
    Returns:
    
    list of all playlists in the library
  - setPlayLists
```
public void setPlayLists(List<PlayList> playLists)
```
  - getAlbum
```
public Album getAlbum(Album.Key key)
```
    Description copied from interface: ITunesMusicLibrary
    
    Returns an album. The songs contained in this album are not properly wrapped. Writing to them most likely does not work as expected.
    
    Parameters:
    
    key - album key, interpreted case-insensitively
    
    Returns:
    
    album
    
    See Also:
    
    ITunesMusicLibrary.getAlbumSongs(String, String)
  - getSongsWithFileAndSize
```
public List<AudioSong> getSongsWithFileAndSize(String filename,
                                               int size)
```
  - getSongsWithNameArtistAlbumTotalTime
```
public List<AudioSong> getSongsWithNameArtistAlbumTotalTime(String name,
                                                            String artist,
                                                            String album,
                                                            int time)
```
  - fetchLazyAssociations
```
public static void fetchLazyAssociations(List<Song> songs)
```
  - getSongsWithTrackIdTotalTime
```
public Set<AudioSong> getSongsWithTrackIdTotalTime(Set<AudioId> ids,
                                                   int time)
```
  - countUnprotectedSongsAddedAfter
```
public int countUnprotectedSongsAddedAfter(Date time)
```
  - getUnprotectedSongsAddedAfter
```
public List<AudioSong> getUnprotectedSongsAddedAfter(Date time)
```
  - getAllTimesFavoriteAlbums
```
public Set<Album.Key> getAllTimesFavoriteAlbums(int max)
```
  - getRecentlyPlayedAlbums
```
public Set<Album.Key> getRecentlyPlayedAlbums(int max)
```
  - getHighlyRatedAlbums
```
public Set<Album.Key> getHighlyRatedAlbums(int max)
```
  - getRecentlyAddedAlbums
```
public Set<Album.Key> getRecentlyAddedAlbums(int max)
```
  - store
```
public void store(PlayList playList)
```
    Description copied from interface: ITunesMusicLibrary
    
    Stores a playlist in the beaTunes database.
    
    Parameters:
    
    playList - playlist to save
  - store
```
public void store(AudioSong song,
                  String changedProperty)
```
    Description copied from interface: ITunesMusicLibrary
    
    Stores a song in the beaTunes database and clears any sortorder caches in the playlist objects this song might be in, if the playlist is sorted by the changed property.
    
    The write-process is asynchronous, i.e. this method may return before the songs has actually been written.
    
    Parameters:
    
    song - song to save
    
    changedProperty - property that has been changed (may be null, if multiple properties have changed or the change is unknown)
  - flushPendingWrites
```
public void flushPendingWrites()
                        throws InterruptedException
```
    Description copied from interface: ITunesMusicLibrary
    
    Flush any pending writes (blocks until all writes happened).
    
    Throws:
    
    InterruptedException
  - store
```
public void store(Iterable<AudioSong> songs)
```
    Description copied from interface: ITunesMusicLibrary
    
    Stores a collection of songs in the beaTunes database.
    
    The write-process is asynchronous, i.e. this method may return before the songs has actually been written.
    
    Parameters:
    
    songs - songs to save
  - deletePlayList
```
public void deletePlayList(long id)
```
    Description copied from interface: ITunesMusicLibrary
    
    Deletes a playlist from the library.
    
    Parameters:
    
    id - id
  - store
```
public void store(MatchListInfo matchListInfo)
```
    Description copied from interface: ITunesMusicLibrary
    
    Store the given info.
    
    Parameters:
    
    matchListInfo - match list info
  - updateSelectivity
```
public void updateSelectivity()
```
    Update the selectivity for columns, so that the query plan cost optimizer can work as well as possible.
  - addPlayListPropertyChangeListener
```
public void addPlayListPropertyChangeListener(PropertyChangeListener propertyChangeListener)
```
    Description copied from interface: ITunesMusicLibrary
    
    Lets you register a listener that receives events when a playlist property is changed. Unlike listeners bound to individual, transient playlist objects, this registration is permanent as long as this library is available.
    
    Parameters:
    
    propertyChangeListener - listener
  - addPlayListPropertyChangeListener
```
public void addPlayListPropertyChangeListener(String property,
                                              PropertyChangeListener propertyChangeListener)
```
    Description copied from interface: ITunesMusicLibrary
    
    Lets you register a listener that receives events when a playlist property is changed. Unlike listeners bound to individual, transient playlist objects, this registration is permanent as long as this library is available.
    
    Parameters:
    
    property - property
    
    propertyChangeListener - listener
  - removePlayListPropertyChangeListener
```
public void removePlayListPropertyChangeListener(PropertyChangeListener propertyChangeListener)
```
  - removePlayListPropertyChangeListener
```
public void removePlayListPropertyChangeListener(String property,
                                                 PropertyChangeListener propertyChangeListener)
```
  - getPlayListPropertyChangeListeners
```
public PropertyChangeListener[] getPlayListPropertyChangeListeners()
```
  - getPlayListPropertyChangeListeners
```
public PropertyChangeListener[] getPlayListPropertyChangeListeners(String property)
```
  - addPlayListDataListener
```
public void addPlayListDataListener(ListDataListener l)
```
  - removePlayListDataListener
```
public void removePlayListDataListener(ListDataListener l)
```
  - callOnLIFOJob
```
public static <T> T callOnLIFOJob(Callable<T> callable,
                                  long timeoutInSeconds,
                                  T onErrorValue)
```
    Executes the given Callable in the LIFO job queue. All exceptions are caught.
    
    Type Parameters:
    
    T - type of return value
    
    Parameters:
    
    callable - callable
    
    timeoutInSeconds - timeout, negative values are interpreted as infinite timeout
    
    onErrorValue - value to return in case an exception occurs. All exceptions are caught.
    
    Returns:
    
    return value, may be onErrorValue in case of an exception
  - callOnDefaultJob
```
public static <T> T callOnDefaultJob(Callable<T> callable,
                                     long timeoutInSeconds,
                                     T onErrorValue)
```
    Executes the given Callable in the default job queue. All exceptions are caught.
    
    Type Parameters:
    
    T - type of return value
    
    Parameters:
    
    callable - callable
    
    timeoutInSeconds - timeout, negative values are interpreted as infinite timeout
    
    onErrorValue - value to return in case an exception occurs. All exceptions are caught.
    
    Returns:
    
    return value, may be onErrorValue in case of an exception
  - callOnDefaultJobWithException
```
public static <T> T callOnDefaultJobWithException(Callable<T> callable,
                                                  long timeoutInSeconds,
                                                  RuntimeException rte)
```
    Executes the given Callable in the default job queue.
    
    Type Parameters:
    
    T - type of return value
    
    Parameters:
    
    callable - callable
    
    timeoutInSeconds - timeout, negative values are interpreted as infinite timeout
    
    rte - exception to throw, in case we encounter an exception that is not a RuntimeException
    
    Returns:
    
    return value
  - runOnDefaultJob
```
public static void runOnDefaultJob(Callable<?> callable)
```
    Executes the given Callable in the default job queue.
    
    Parameters:
    
    callable - callable

Class HibernateMusicLibrary<A extends ApplicationComponent>

Field Summary

Fields inherited from class com.tagtraum.beatunes.library.AbstractMusicLibrary

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Constructor Detail

HibernateMusicLibrary

Method Detail

getId

getHibernateMusicLibraryDelegate

setHibernateMusicLibraryDelegate

getSchemaVersion

getHibernateUtil

setHibernateUtil

getDatabaseDir

init

shutdown

isCoalesceWrites

setCoalesceWrites

openDatabase

isProgressDialogVisible

createPlayList

createPlayList

createFolder

createFolder

createPlayList

getApplicationVersion

setApplicationVersion

getPersistentId

getLibraryLoader

countSongs

getSong

getSong

getSongs

fetchCollections

getPopularTagCollection

getTagCollection

getSongPropertyValues

getSimilarTitles

getDuplicateTitles

getDuplicateTrackIds

getAcousticallyIdenticalSongIds

getAcousticallyIdenticalSongIds

getSongPropertyValues

getSongPropertyValues

getGenres

countSongsWithPropertyValue

getSongsWithPropertyValue

getSongsWithoutPropertyValue

getSongIdsWithPropertyValue

getSongIdsWithoutPropertyValue

getSongsWithPropertyLikeValue

getSongIdsWithPropertyLikeValue

getAlbumSongIds

getAlbumSongs

getAlbumKeys

getSongs

getSongIds

getLibrary

getPlayLists

setPlayLists

getAlbum

getSongsWithFileAndSize

getSongsWithNameArtistAlbumTotalTime

fetchLazyAssociations

getSongsWithTrackIdTotalTime

countUnprotectedSongsAddedAfter

getUnprotectedSongsAddedAfter

getAllTimesFavoriteAlbums

getRecentlyPlayedAlbums

getHighlyRatedAlbums

getRecentlyAddedAlbums

store

store

flushPendingWrites

store

deletePlayList

store