ptdb.kernel.bl.search

Class SearchManager

java.lang.Object

ptdb.kernel.bl.search.SearchManager

public class SearchManager
extends java.lang.Object

Business layer interface class that mainly handles the search models function. It constructs and configures the actual searcher classes according to the search criteria, and triggers the searching.

For different requirement for search configuration, this class can be modified to add more searchers chain configuration.

Since:

Ptolemy II 10.0

Version:

$Id$

Author:

Alek Wang

Pt.AcceptedRating:

red (wenjiaow)

Pt.ProposedRating:

red (wenjiaow)

Constructor Summary

Constructors

Constructor and Description
SearchManager()

Method Summary

Modifier and Type	Method and Description
void	search(SearchCriteria searchCriteria, ResultHandler searchResultBuffer) This method is used to be called by the GUI layer class to pass the search criteria.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SearchManager

public SearchManager()

Method Detail

search

public void search(SearchCriteria searchCriteria,
                   ResultHandler searchResultBuffer)
            throws DBConnectionException,
                   DBExecutionException

This method is used to be called by the GUI layer class to pass the search criteria. It is invoked by the Search GUI frame.

Algorithm: The search manager first creates all the searchers needed in the search, and configures them in the order of attribute searcher -> command searcher -> graph searcher.
Once all the results are searched and found, the results will be passed to the hierarchy fetcher to fetch the referencing information.
After the hierarchy of the results are fetched, the results will be written to the result buffer together with the hierarchy.

Parameters:

searchCriteria - The search criteria input by the user.

searchResultBuffer - The buffer that is used to store the search results. The search result buffer extends the class Observable. The GUI layer has registered some listener for checking search result before passing the buffer to this method.

Throws:

DBConnectionException - Thrown from the database layer when the database layer fails to create a connection to the database.

DBExecutionException - Thrown from the database layer when the database layer fails to execute the searching in the database.