org.sourceforge.vlibrary.user.dao

Interface AuthorDAO

All Known Implementing Classes:

AuthorDAOSpringJDBCImpl

public interface AuthorDAO

Author data access interface.

Version:

$Revision$ $Date$

Method Summary

Modifier and Type	Method and Description
Long	findAuthorByFirstLastName(Author author) Finds the id of the given Author object in the database, using the firstName and lastName properties to lookup the record.
void	insert(Author author) Inserts the given author into the database.
void	setAuthorIds(ArrayList authors) Walks input ArrayList, looking up and setting ID properties for each Author in the list.

Method Detail

insert

void insert(Author author)
     throws LibraryException

Inserts the given author into the database. Has the side effect of setting the id field of author to the sequentially generated ID of the new record.

First checks to see if an author with the same firstName and lastName as author exists. If so, no insert is performed; but author.id is updated to the id of the previously existing record.

Throws:

LibraryException - if a data access error occurs

setAuthorIds

void setAuthorIds(ArrayList authors)
           throws LibraryException

Walks input ArrayList, looking up and setting ID properties for each Author in the list. Lookup is based on first name + last name. If an Author 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:

authors - = ArrayList of Authors

Throws:

LibraryException

findAuthorByFirstLastName

Long findAuthorByFirstLastName(Author author)
                        throws LibraryException

Finds the id of the given Author object in the database, using the firstName and lastName properties to lookup the record.

Parameters:

author - Author to lookup by name

Returns:

Long id of the Author

Throws:

LibraryException