doc.walkthru
Interface AlbumService

All Superinterfaces:

org.benow.java.spec.Markup, org.benow.service.Service

All Known Implementing Classes:

AlbumServiceImpl

public interface AlbumService
extends org.benow.service.Service

Methods for interacting with the music library

Author:

andy

Nested Class Summary

Nested classes/interfaces inherited from interface org.benow.java.spec.Markup

org.benow.java.spec.Markup.ParamName, org.benow.java.spec.Markup.ReturnDescription

Method Summary

AlbumTrack	addTrack(Album album, Track track) Adds the given track to the given album.
Album	createAlbum(Album album)
Album	createAlbum(java.lang.String title, Performer performer) Create a new album with a given title and performer.
boolean	deleteAlbum(Album album) Deletes a given album
Album	getAlbumByKey(java.lang.Object key) Gets a specific album by key
java.util.List<Album>	getAlbums()
AlbumTrack	insertTrack(java.lang.Object albumKey, Track track, int pos) Inserts the given track to the given album at the given position

Method Detail

getAlbums

java.util.List<Album> getAlbums()

Returns:

known albums

createAlbum

Album createAlbum(java.lang.String title,
                  Performer performer)

Create a new album with a given title and performer.

Parameters:

title -

performer -

Returns:

the created album.

createAlbum

Album createAlbum(Album album)

addTrack

AlbumTrack addTrack(Album album,
                    Track track)

Adds the given track to the given album.

Parameters:

album -

track -

Returns:

added track on album

insertTrack

AlbumTrack insertTrack(java.lang.Object albumKey,
                       Track track,
                       int pos)

Inserts the given track to the given album at the given position

Parameters:

album -

track -

pos -

Returns:

inserted track on album

deleteAlbum

boolean deleteAlbum(Album album)

Deletes a given album

Parameters:

album -

Returns:

true if successfully deleted

getAlbumByKey

Album getAlbumByKey(java.lang.Object key)
                    throws org.benow.repository.NoSuchObjectException

Gets a specific album by key

Parameters:

key -

Returns:

Throws:

org.benow.repository.NoSuchObjectException