com.buckosoft.PicMan.db

Interface PicsDao

All Known Implementing Classes:

PicsDaoJdbc

public interface PicsDao

Dao interface for the Pics.

Since:

2005/07/31

Author:

Dick Balaska

See Also:

PicsDao.java

Method Summary

Modifier and Type	Method and Description
void	addPic(Pic pic) Add this Pic to the database.
int	getMaxThumbCacheDirUsed() Determine the highest numbered thumb cache subdirectory used.
Pic	getNewestPic() Get the newest pic in the database.
Pic	getPic(int pid) Get a Pic
Pic	getPic(java.lang.String picName) Get a Pic who's name matches this picName.
int	getPicCount(int rid) Return how many pics live in this root.
java.util.List<java.lang.String>	getPicNames() Get a List of names all of the pics in the database.
java.util.List<java.lang.String>	getPicNamesByDateFunc(java.lang.String operator, java.lang.String operand) Get a list of pic names that pass this date function.
java.util.List<java.lang.String>	getPicNamesByRootFunc(java.lang.String operator, int rid)
java.util.List<Pic>	getPics() Get a List of all of the Pics in the database.
java.util.List<Pic>	getPics(java.util.List<java.lang.String> list) Get a List of Pics from this List of picNames.
java.util.List<Pic>	getPics(java.lang.String name) Get a List of all of the Pics in the database that match this name.
java.util.List<Pic>	getPicsByMD5Sum(long md5sum) Return a list of Pics that have this md5Sum
java.util.List<Pic>	getPicsInDir(int rid, java.lang.String dirName) Get a list of Pics that are in this subdirectory
java.util.HashMap<java.lang.String,java.util.Date>	getPicsMap() Get a HashMap of all of the Pic names in the database.
java.util.List<Pic>	getPicsNewerThan(java.util.Calendar calendar) Get a list of Pics that are newer than this date
Pic	getRandomPic() Return a random pic from the database
Pic	getRandomPic(int rid) Return a random pic from the database that lives in this root
int	getThumbCacheFillCount(int cacheDir) Determine how many thumb cache entries are in this thumb dir
void	updatePic(Pic pic) Update this Pic in the database.

Method Detail

getPics

java.util.List<Pic> getPics()

Get a List of all of the Pics in the database.

Returns:

A pretty big List

getPicNames

java.util.List<java.lang.String> getPicNames()

Get a List of names all of the pics in the database.

Returns:

A big List of picNames

getPics

java.util.List<Pic> getPics(java.lang.String name)

Get a List of all of the Pics in the database that match this name. Wildcards are supported.

Parameters:

name - The name (or partial name) of the pics to fetch.

Returns:

A List of Pics.

getPics

java.util.List<Pic> getPics(java.util.List<java.lang.String> list)

Get a List of Pics from this List of picNames.

Parameters:

list - A List of picNames to fetch

Returns:

The List

getPicsInDir

java.util.List<Pic> getPicsInDir(int rid,
                                 java.lang.String dirName)

Get a list of Pics that are in this subdirectory

Parameters:

rid - Root id to search under

dirName - The directory, i.e. "2002/20021225"

Returns:

A List of Pic. The dirname will match any and all Roots

getPicsNewerThan

java.util.List<Pic> getPicsNewerThan(java.util.Calendar calendar)

Get a list of Pics that are newer than this date

Parameters:

calendar - The date to compare to

Returns:

A List of Pics.

getPicsByMD5Sum

java.util.List<Pic> getPicsByMD5Sum(long md5sum)

Return a list of Pics that have this md5Sum

Parameters:

md5sum -

Returns:

The list, may be empty

getPicNamesByDateFunc

java.util.List<java.lang.String> getPicNamesByDateFunc(java.lang.String operator,
                                                       java.lang.String operand)

Get a list of pic names that pass this date function.

Parameters:

operator - An index into the MetaSet rateOps table. i.e. = != < >

operand - the date to check. i.e. "2009-07-26"

Returns:

A List of pic names

getPicNamesByRootFunc

java.util.List<java.lang.String> getPicNamesByRootFunc(java.lang.String operator,
                                                       int rid)

getPicsMap

java.util.HashMap<java.lang.String,java.util.Date> getPicsMap()

Get a HashMap of all of the Pic names in the database.

Returns:

The map

addPic

void addPic(Pic pic)

Add this Pic to the database.

Parameters:

pic - The Pic to add. pid is assumed to be 0.

updatePic

void updatePic(Pic pic)

Update this Pic in the database. Pic is assumed to exist and pid must not be 0.

Parameters:

pic - The Pic to update.

getPic

Pic getPic(int pid)

Get a Pic

Parameters:

pid - The pid to query

Returns:

The Pic

getPic

Pic getPic(java.lang.String picName)

Get a Pic who's name matches this picName.

Parameters:

picName - The name of the Pic to query.

Returns:

The Pic that matches this picName or null.

getNewestPic

Pic getNewestPic()

Get the newest pic in the database.

Returns:

The Pic with the newest Timestamp

getRandomPic

Pic getRandomPic()

Return a random pic from the database

Returns:

Any pic from the database

getRandomPic

Pic getRandomPic(int rid)

Return a random pic from the database that lives in this root

Returns:

Any pic from the database

getMaxThumbCacheDirUsed

int getMaxThumbCacheDirUsed()

Determine the highest numbered thumb cache subdirectory used.

Returns:

the highest number, or 0 if no thumbs are cached.

getThumbCacheFillCount

int getThumbCacheFillCount(int cacheDir)

Determine how many thumb cache entries are in this thumb dir

Parameters:

cacheDir - Which thumb cache directory to check

Returns:

The Count

getPicCount

int getPicCount(int rid)

Return how many pics live in this root.

Parameters:

rid - The root id to query.

Returns:

The number of Pics in this root.