songcollection.java

Java的面向对象数据库系统的源代码

package song;

// $Id: song.SongCollection.java,v 1.2 2002/07/18 09:08:03 per_nyfelt Exp $



import org.ozoneDB.OzoneRemote;

import java.util.AbstractMap;

/**
 * The external interface of the database object song.SongCollection
 * A song.SongCollection is the catalog of songs an artist plays.
 *
 * NOTE:  Maybe this should be based on an Ozone collection...
 *
 * @version $Revision: 1.2 $ $Date: 2002/07/18 09:08:03 $
 * @author James Stiefel
 */
public interface SongCollection extends OzoneRemote {
    /**
     * Retrieves the object's unique (database) Handle
     *
     * @return the object handle
     */
    public String handle();

    /**
     * Adds a song.Song to the song.SongCollection
     * You can add a song.Song with whatever title you choose.
     * We suggest using it's own title.
     * "Nicknames" (multiple entries for the same song) may work,
     * but they may cause problems too (especially in MasterCollection).
     *
     */
    public void         addSong(String title, Song song) throws Exception ;      /*update*/


    /**
     * Deletes a song.Song from the song.SongCollection
     *
     */
    public Song         deleteSong(String title);          /*update*/

    /**
     * Finds a song in song.SongCollection
     *
     */
    public Song         findSong(String song_title);

    /**
     * Returns the collection of songs in the song.SongCollection.
     * Modifications to that collection ought to be reflected
     * in this song.SongCollection, but one should make changes to the
     * song.SongCollection to ensure they persist.
     */
    public AbstractMap   getAllSongs();
}