Working Through An Example Search Application

/**
* Applet/application for simple query interface. Can be used as an
* example for those who want to create their own java interface.
* This example demonstrates search only.  Browse, determining
* the schema of the search server and obtaining the taxonomy
* of the search server will be demonstrated in other examples.
*/

public class SearchDemo extends Applet {
    /** Run as an applet. */
    public void init() {
        String rdm = getParameter("RDMServer");
        SimpleSearch ss = new SimpleSearch(rdm);
        SearchPanel sp = new SearchPanel(ss);
        setLayout(new FlowLayout(FlowLayout.CENTER));
        add(sp);
    }
    /** Run as an application. */
    public static void main(String argv[]) throws Exception {
        int args = argv.length;
        String SearchOutputFile = null;
        if (args != 1 && args != 2 && args != 3) {
            System.out.println("args: RDMServer [query]
            [search_output_file_name]");
            return;
        }
        String rdm = argv[0];  // rdm search server, eg,
        // http://portal.siroe.com:2222/ps/search
        SimpleSearch ss = new SimpleSearch(rdm);
        if (args == 3) {
            --args;
            ss.setSearchfile(argv[2]); // dump raw Search results to this file
        }
        if (args == 1) {
            // run from a search box
            Frame f = new Frame();
            SearchPanel sp = new SearchPanel(ss);
            f.add(sp);
            f.pack();
            f.show();
        }
        else {
            // run from command line
            String query = argv[1];
            ss.doSearch(query);
        }
    }
}

/** Performs a simple search and displays its results. */
class SimpleSearch {
    String RDMServer;
    String SearchOutputFile;
    /**
    * SimpleSearch constructor
    * @param rdm - the rdm search server, 
		eg, http://portal.siroe.com:2222/portal/search
    */
    public SimpleSearch(String rdm) {
        System.out.println("Sun Java System Search Java Demo");
        RDMServer = rdm;
    }
    /**
    * @param filename - a file to dump raw Search results into - only
    * use if running from the comand line or an applet with file
    * system access
    */
    public void setSearchfile(String filename) {
        SearchOutputFile = filename;
    }
    /** Execute a search */
    public void doSearch(String scope) throws IOException {
        ...see

...
    }
}

/** Execute a search */
public void doSearch(String scope) throws IOException {
    /* The Search class encapsulates the search.
    ** It’s parameters are:
    **  1) the search string
    **  2) the attributes you want returned, comma delimited
    **  3) sort order, comma delimited, - descending, + ascending
    **  4) first hit
    **  5) number of hits
    **  6) query language, eg search, taxonomy-basic, schema-basic, etc
    **  7) database to search
    **  8) The RDM server URL, eg, http://portal.siroe.com:2222/ps/search
    **  9) Access token (null for anonymous access, or valid iPlanet 
				Directory Server Access Management Edition session id)
    */
    Search  search = new Search(
        scope,
        "score,url,title,description",
        "-score",
        1,
        20,
        "search",
        null,
        RDMServer,
        null
    );

/* Execute the query. */
System.out.println("\\nSearch results for ’" + scope + "’");
 DataOutputStream sos = null;
if (SearchOutputFile != null) {
try {
sos = new DataOutputStream(new FileOutputStream(SearchOutputFile));
}
catch (Exception e1) {
System.out.println("Error: failed to create output file: " + e1);
}
}
int  pagenum = 1;
int  pagesize = 10;
SearchBuffer firstPageSearch = new SearchBuffer();
for (; pagenum <= 5; pagenum++) {
int firstHit = (pagenum-1)*pagesize+1;
try {
search.doQuery(firstHit, pagesize);
}
catch (Exception ex) {
ex.printStackTrace();
break;
}
// Check the result count. -1 indicates an error.
if (search.getResultCount() <= 0)
break;

System.out.println("=========================================");
System.out.println("page " + pagenum
+ ": hits " + search.getFirstHit()
+ " to " + (search.getFirstHit() + search.getResultCount() - 1)
+ " out of " + search.getHitCount()
+ " across " + search.getDocumentCount() + " documents");
System.out.println("=========================================");
System.out.println();

SearchInputStream resultStream = search.getResultStream();
Search search;
/* Examine the results of the search. The following
* code loops through the stream of Search instances. */
for (search = resultStream.readSearch(); search != null; 
search = resultStream.readSearch()) {
    // For illustration, dump out the entire Search on 
			the first page only.
    if (pagenum == 1)
        firstPageSearch.write(search.toByteArray());
        /* Now we use the getValue() method to get
        * the values of each of the requested
        * attributes. URL is special and has
        * its own accessor method.
        */
        String  u = search.getURL();
        String  t   = search.getValue("title");
        String  d   = search.getValue("description");
        String  sc  = search.getValue("score");

        /* do something with the results */
        System.out.println(
            "TITLE:       " + t  + "\\n" +
            "URL:         " + u  + "\\n" +
            "SCORE:       " + sc + "\\n" +
            "DESCRIPTION: " + d  + "\\n" +
            "--------------------------------------------\\n"
        );
        // If there is a Search output file, write the Search 
				data there too...
        if (sos != null) {
            try {
                sos.writeBytes(search.toString());
            }
            catch (Exception e1) {
                System.out.println("Error: failed to write to Search
                output file: " + e1);
            }
        }
    }
    // Break if the largest requested hit has been displayed
    if (search.getHitCount() <= (firstHit + pagesize - 1))
        break;
    }
    if (firstPageSearch == null)
        System.out.println("No matching documents found.");
    }