2002-01-26 11:38:28 -05:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
|
|
|
|
|
|
<!-- Content Stylesheet for Site -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- start the processing -->
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
<!-- Main Page Section -->
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
|
|
|
|
|
|
|
|
|
|
<meta name="author" value="Andrew C. Oliver">
|
|
|
|
|
<meta name="email" value="acoliver@apache.org">
|
|
|
|
|
|
2002-02-11 14:45:24 -05:00
|
|
|
|
|
|
|
|
|
2002-01-26 11:38:28 -05:00
|
|
|
<title>Jakarta Lucene - Jakarta Lucene - Getting Started Guide</title>
|
|
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body bgcolor="#ffffff" text="#000000" link="#525D76">
|
|
|
|
|
<table border="0" width="100%" cellspacing="0">
|
|
|
|
|
<!-- TOP IMAGE -->
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="left">
|
|
|
|
|
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
|
|
|
|
|
</td>
|
|
|
|
|
<td align="right">
|
|
|
|
|
<a href="http://jakarta.apache.org/lucene/"><img src="./images/lucene_green_300.gif" alt="Jakarta Lucene" border="0"/></a>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" width="100%" cellspacing="4">
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<hr noshade="" size="1"/>
|
|
|
|
|
</td></tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<!-- LEFT SIDE NAVIGATION -->
|
|
|
|
|
<td width="20%" valign="top" nowrap="true">
|
|
|
|
|
<p><strong>About</strong></p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li> <a href="./index.html">Overview</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./powered.html">Powered by Lucene</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./whoweare.html">Who We Are</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Resources</strong></p>
|
|
|
|
|
<ul>
|
2002-03-19 20:26:08 -05:00
|
|
|
<li> <a href="http://lucene.sourceforge.net/cgi-bin/faq/faqmanager.cgi">FAQ (Official)</a>
|
2002-01-26 11:38:28 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./gettingstarted.html">Getting Started</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://www.jguru.com/faq/Lucene">JGuru FAQ</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bugs</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Lucene&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=%27Importance%27">Lucene Bugs</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./resources.html">Articles</a>
|
2002-05-16 01:16:10 -04:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./queryparsersyntax.html">Query Syntax</a>
|
2002-01-26 11:38:28 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./api/index.html">Javadoc</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./contributions.html">Contributions</a>
|
2002-02-23 17:03:21 -05:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Plans</strong></p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li> <a href="./luceneplan.html">Application Extensions</a>
|
2002-01-26 11:38:28 -05:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Download</strong></p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Jakarta</strong></p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</td>
|
|
|
|
|
<td width="80%" align="left" valign="top">
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="About this Document"><strong>About this Document</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
This document is intended as a "getting started" guide. It has three basic
|
|
|
|
|
audiences: novices looking to install Jakarta Lucene on their application or
|
|
|
|
|
web server, developers looking to modify or base the applications they develop
|
|
|
|
|
on Lucene, and developers looking to become involved in and contribute to the
|
|
|
|
|
development of Lucene. This document is written in tutorial and walkthrough
|
|
|
|
|
format. It intends to help you in "getting started", but does not go into great
|
|
|
|
|
depth into some of the conceptual or inner details of Jakarta Lucene.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Format of this Guide"><strong>Format of this Guide</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Each section listed below builds on one another. That being said more advanced users may
|
|
|
|
|
wish to skip sections.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="The Simple Demo"><strong>The Simple Demo</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
In <a href="demo.html">this</a> section we walk through the basic Lucene demo and executing it.
|
|
|
|
|
This section is intended for anyone who wants a basic background on using the provided Lucene demos.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Simple Demo Source Walkthrough"><strong>Simple Demo Source Walkthrough</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
In <a href="demo2.html">this</a> section we walk through the sources and implementation
|
|
|
|
|
for the basic Lucene demo. This section is intended for developers.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Template Web Application"><strong>Template Web Application</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
In <a href="demo3.html">this</a> section we walk through installing
|
|
|
|
|
and configuring the template web application. While this walkthough assumes
|
|
|
|
|
Tomcat 4.0.x as your container of choice, there is no reason you can't (provided you have
|
|
|
|
|
the requisite knowledge) adapt the instructions to your container. This section is intended
|
|
|
|
|
for those responsible for the development or deployment of Lucene-based web applications.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Template Web Application sources"><strong>Template Web Application sources</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
In <a href="demo4.html">this</a> section we walk through the sources used to construct the
|
|
|
|
|
template web application. Please note the template application is designed to highlight
|
|
|
|
|
features of Lucene and is <b>not</b> an example of best practices. (One would hopefully
|
|
|
|
|
use MVC architecture such as provided by Jakarta Struts and taglibs, or better yet XML
|
|
|
|
|
with stylesheets, but showing you how to do that would be WAY beyond the scope of this
|
|
|
|
|
demonstration. Additionally once could cache results, and perform other performance
|
|
|
|
|
optimizations, but those are beyond the scope of this demo).
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
This section is intended for developers and those wishing to customize the template web
|
|
|
|
|
application to their needs. The sections useful to developers only are clearly delineated.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<!-- FOOTER -->
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<hr noshade="" size="1"/>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<div align="center"><font color="#525D76" size="-1"><em>
|
|
|
|
|
Copyright © 1999-2002, Apache Software Foundation
|
|
|
|
|
</em></font></div>
|
|
|
|
|
</td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
<!-- end the processing -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2002-02-11 14:45:24 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
