org.sourceforge.vlibrary.user.dao

Interface SubjectDAO

All Known Implementing Classes:

SubjectDAOSpringJDBCImpl

public interface SubjectDAO

Version:

$Revision$ $Date$

Method Summary

Modifier and Type	Method and Description
Long	getSubjectIdByDescription(Subject subject)
ArrayList	getSubjects() Retrieves all subjects from the database
Subject	insert(Subject subject) Inserts *this* into the database.
void	setSubjectIds(ArrayList subjects) Walks input ArrayList pf Subject instances, looking up and setting ID properties for each Subject in the list.

Method Detail

insert

Subject insert(Subject subject)
        throws LibraryException

Inserts *this* into the database. Has the side effect of setting this.id to the sequentially generated id of the new record. First checks to see if a subject with this.description exists. If so, no insert is performed, but this.id is updated to the id of the previously existing record. Delegates to insert(Connection).

Throws:

LibraryException

setSubjectIds

void setSubjectIds(ArrayList subjects)
            throws LibraryException

Walks input ArrayList pf Subject instances, looking up and setting ID properties for each Subject in the list. Lookup is based on the description property. If a Subject is not found, a new entry is inserted into the database and the ID of the newly created record is assigned to the instance.

Parameters:

subjects - = ArrayList of Subjects

Throws:

LibraryException - if the list contains objects that are not Subject instances or a data access error occurs

getSubjects

ArrayList getSubjects()
               throws LibraryException

Retrieves all subjects from the database

Returns:

ArrayList of Subject object, if none found returns empty ArrayList

Throws:

LibraryException

getSubjectIdByDescription

Long getSubjectIdByDescription(Subject subject)
                        throws LibraryException

Throws:

LibraryException