aboutsummaryrefslogtreecommitdiff
path: root/src/uk/org/ury/library/LibraryUtils.java
diff options
context:
space:
mode:
Diffstat (limited to 'src/uk/org/ury/library/LibraryUtils.java')
-rw-r--r--src/uk/org/ury/library/LibraryUtils.java144
1 files changed, 0 insertions, 144 deletions
diff --git a/src/uk/org/ury/library/LibraryUtils.java b/src/uk/org/ury/library/LibraryUtils.java
deleted file mode 100644
index 9b4471a..0000000
--- a/src/uk/org/ury/library/LibraryUtils.java
+++ /dev/null
@@ -1,144 +0,0 @@
-/**
- *
- */
-package uk.org.ury.library;
-
-import java.sql.ResultSet;
-import java.sql.SQLException;
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-import uk.org.ury.database.DatabaseDriver;
-import uk.org.ury.database.exceptions.QueryFailureException;
-
-import uk.org.ury.library.exceptions.EmptySearchException;
-import uk.org.ury.library.item.LibraryItem;
-import uk.org.ury.library.item.LibraryItemProperty;
-
-
-/**
- * A set of common utility routines to facilitate the extraction of
- * library items from the library areas of the URY database.
- *
- * @author Matt Windsor
- */
-
-public class LibraryUtils
-{
- /**
- * Perform a library search.
- *
- * @param db The database to query.
- *
- * @param search The search fragment to include in the search.
- * Can be empty or null.
- *
- * @throws IllegalArgumentException if the search term is
- * are null.
- *
- * @throws QueryFailureException if the database backend
- * yielded an error while executing the search
- * query.
- *
- * @throws EmptySearchException if the search term is
- * empty (to be handled as a user error).
- *
- * @return a list of LibraryItems matching the search terms.
- */
-
- public static List<LibraryItem>
- search (DatabaseDriver db, String search)
- throws QueryFailureException, EmptySearchException
- {
- if (db == null)
- throw new IllegalArgumentException ("Database handle is null.");
-
- if (search == null)
- throw new IllegalArgumentException ("Search string is null.");
-
- List<LibraryItem> results = new ArrayList<LibraryItem> ();
-
-
- // Return empty set if the search term is null.
-
- if (search.equals(""))
- throw new EmptySearchException ();
-
-
- ResultSet rs = null;
-
- Object[] params = {"%" + search + "%", "%" + search + "%", "%" + search + "%"};
-
- try
- {
- rs = db.executeQuery (
- "SELECT r.title AS album, t.title,"
- + " t.artist, recordlabel AS label, status, media AS medium, format,"
- + " datereleased, EXTRACT(EPOCH FROM dateadded) as dateadded,"
- + " EXTRACT(EPOCH FROM datetime_lastedit) AS dateedited,"
- + " shelfletter, shelfnumber, cdid, digitised, clean"
- + " FROM rec_record AS r"
- + " INNER JOIN rec_track AS t ON (r.recordid = t.recordid)"
- + " WHERE t.title ILIKE ?"
- + " OR t.artist ILIKE ?"
- + " OR r.title ILIKE ?"
- + " ORDER BY digitised DESC, medium ASC, r.title ASC,"
- + " t.artist ASC, t.title ASC;", params, 50);
- }
- catch (SQLException e)
- {
- throw new QueryFailureException (e.getMessage ());
- }
-
- try
- {
- while (rs.next ())
- {
- results.add (translateRow (rs));
- }
- }
- catch (SQLException e)
- {
- throw new QueryFailureException (e.getMessage ());
- }
-
- return results;
- }
-
-
- /**
- * Translate a row retrieved from the database into a LibraryItem.
- *
- * @param rs The result-set, or database cursor, pointing to the
- * row to translate.
- *
- * @return A new LibraryItem containing the properties extracted
- * from the translated row.
- */
-
- private static LibraryItem
- translateRow (ResultSet rs)
- {
- // Translate SQL columns into a list of properties.
-
- Map<LibraryItemProperty, String> properties = new HashMap<LibraryItemProperty, String> ();
-
- for (LibraryItemProperty p : LibraryItemProperty.values ())
- {
- try
- {
- properties.put (p, rs.getString (p.sql));
- }
- catch (SQLException e)
- {
- // Ignore this, as it is almost certainly just a non-existent
- // property.
- }
- }
-
-
- return new LibraryItem (properties);
- }
-}