When the user issues a query, a hitlist containing query results is
returned. The user can select a document to view from the hitlist. A
hitlist can include HTML documents, files, database table content, or
archived emails. The Ultra Search query application
also incorporates an email browser for reading and browsing emails.
The Ultra Search Administration Tool and the Ultra Search query application
are part of the Ultra Search Middle-tier Components module. However,
the Ultra Search Administration Tool is independent from the Ultra Search
Query Application. Therefore, they can be hosted on different machines
to enhance security or scalability.
If you do not want to use the Ultra Search Query
Application, you can build your own query application by directly
invoking the Ultra Search Java Query
API. Because the API is coded in Java, you can invoke the
API methods from any Java based appication such as
from a Java Servlet or a Java Server Page (as in the case of
the provided sample query application).
For rendering emails that have been crawled and indexed,
you can also directly invoke the Ultra
Search Java Email API methods.
The sample query application files are listed in
a readme file located at $ORACLE_HOME/ultrasearch/sample/sample_readme.html.
Java Server Page (JSP) Query Application
You can find the JSP sample query application in the $ORACLE_HOME/ultrasearch/sample/jsp
directory. This directory contains a non-framed global search gsearch.jsp
and a framed global search gsearchf.jsp. You can also find the JSP pages
that enable email rendering.
Java Server Page Concepts
As mentioned above, you can use JSP code and the supplied
Java APIs to create your web application. Typically, your
web application will run within an application server such
as Oracle Internet Application Server. The application
server typically runs on a separate machine from the
Oracle 9i Server for performance and scalability
reasons. The Oracle 9i Server holds the Ultra Search indexes.
JSP applications are compiled into Java Servlets at
runtime. The compiled Servlets run within one or more Java
Virtual Machine processes. The JSP application communicates
with the Oracle 9i Server via the Oracle JDBC driver.
As in any Java application, you must
include the following files in your Servlet
engine classpath to use the Java Query and Email APIs:
You must also set up an alias (virtual
path) on your web server to map URLs to your JSP query
application root directory.
If you install Ultra Search with the Oracle HTTP Server, these customizations
are automatically done for you.
Figure 9 shows how your web query application calls the Ultra Search
Java Query API.
Figure 9: Calling
Java Server Pages
Text description of the illustration