1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<meta content="Apache Forrest" name="Generator">
6
<meta name="Forrest-version" content="0.8">
7
<meta name="Forrest-skin-name" content="pelt">
9
Apache Lucene - Getting Started Guide
11
<link type="text/css" href="skin/basic.css" rel="stylesheet">
12
<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
13
<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
14
<link type="text/css" href="skin/profile.css" rel="stylesheet">
15
<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
16
<link rel="shortcut icon" href="images/favicon.ico">
18
<body onload="init()">
19
<script type="text/javascript">ndeSetTextSize();</script>
24
<div class="breadtrail">
25
<a href="http://www.apache.org/">Apache</a> > <a href="http://lucene.apache.org/">Lucene</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
34
<div class="grouplogo">
35
<a href="http://lucene.apache.org/"><img class="logoImage" alt="Lucene" src="http://www.apache.org/images/asf_logo_simple.png" title="Apache Lucene"></a>
43
<div class="projectlogo">
44
<a href="http://lucene.apache.org/java/"><img class="logoImage" alt="Lucene" src="http://lucene.apache.org/images/lucene_green_300.gif" title="Apache Lucene is a high-performance, full-featured text search engine library written entirely in
45
Java. It is a technology suitable for nearly any application that requires full-text search, especially cross-platform."></a>
53
<div class="searchbox">
54
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
55
<input value="lucene.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
56
<input name="Search" value="Search" type="submit">
67
<a class="selected" href="http://lucene.apache.org/java/docs/">Main</a>
70
<a class="unselected" href="http://wiki.apache.org/lucene-java">Wiki</a>
73
<a class="selected" href="index.html">Lucene 2.3.1 Documentation</a>
82
<div id="publishedStrip">
86
<div id="level2tabs"></div>
90
<script type="text/javascript"><!--
91
document.write("Last Published: " + document.lastModified);
97
<div class="breadtrail">
102
|start Menu, mainarea
108
<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Documentation</div>
109
<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
110
<div class="menuitem">
111
<a href="index.html">Overview</a>
113
<div onclick="SwitchMenu('menu_1.1.2', 'skin/')" id="menu_1.1.2Title" class="menutitle">Javadocs</div>
114
<div id="menu_1.1.2" class="menuitemgroup">
115
<div class="menuitem">
116
<a href="api/index.html">All</a>
118
<div class="menuitem">
119
<a href="api/core/index.html">Core</a>
121
<div class="menuitem">
122
<a href="api/demo/index.html">Demo</a>
124
<div onclick="SwitchMenu('menu_1.1.2.4', 'skin/')" id="menu_1.1.2.4Title" class="menutitle">Contrib</div>
125
<div id="menu_1.1.2.4" class="menuitemgroup">
126
<div class="menuitem">
127
<a href="api/contrib-analyzers/index.html">Analyzers</a>
129
<div class="menuitem">
130
<a href="api/contrib-ant/index.html">Ant</a>
132
<div class="menuitem">
133
<a href="api/contrib-bdb/index.html">Bdb</a>
135
<div class="menuitem">
136
<a href="api/contrib-bdb-je/index.html">Bdb-je</a>
138
<div class="menuitem">
139
<a href="api/contrib-benchmark/index.html">Benchmark</a>
141
<div class="menuitem">
142
<a href="api/contrib-highlighter/index.html">Highlighter</a>
144
<div class="menuitem">
145
<a href="api/contrib-lucli/index.html">Lucli</a>
147
<div class="menuitem">
148
<a href="api/contrib-memory/index.html">Memory</a>
150
<div class="menuitem">
151
<a href="api/contrib-misc/index.html">Miscellaneous</a>
153
<div class="menuitem">
154
<a href="api/contrib-queries/index.html">Queries</a>
156
<div class="menuitem">
157
<a href="api/contrib-regex/index.html">Regex</a>
159
<div class="menuitem">
160
<a href="api/contrib-snowball/index.html">Snowball</a>
162
<div class="menuitem">
163
<a href="api/contrib-spellchecker/index.html">Spellchecker</a>
165
<div class="menuitem">
166
<a href="api/contrib-surround/index.html">Surround</a>
168
<div class="menuitem">
169
<a href="api/contrib-swing/index.html">Swing</a>
171
<div class="menuitem">
172
<a href="api/contrib-wikipedia/index.html">Wikipedia</a>
174
<div class="menuitem">
175
<a href="api/contrib-wordnet/index.html">Wordnet</a>
177
<div class="menuitem">
178
<a href="api/contrib-xml-query-parser/index.html">XML Query Parser</a>
182
<div class="menuitem">
183
<a href="benchmarks.html">Benchmarks</a>
185
<div class="menuitem">
186
<a href="contributions.html">Contributions</a>
188
<div class="menuitem">
189
<a href="http://wiki.apache.org/lucene-java/LuceneFAQ">FAQ</a>
191
<div class="menuitem">
192
<a href="fileformats.html">File Formats</a>
194
<div class="menupage">
195
<div class="menupagetitle">Getting Started</div>
197
<div class="menuitem">
198
<a href="lucene-sandbox/index.html">Lucene Sandbox</a>
200
<div class="menuitem">
201
<a href="queryparsersyntax.html">Query Syntax</a>
203
<div class="menuitem">
204
<a href="scoring.html">Scoring</a>
206
<div class="menuitem">
207
<a href="http://wiki.apache.org/lucene-java">Wiki</a>
210
<div id="credit"></div>
211
<div id="roundbottom">
212
<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
216
<div id="credit2"></div>
225
<div title="Portable Document Format" class="pdflink">
226
<a class="dida" href="gettingstarted.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
230
Apache Lucene - Getting Started Guide
232
<div id="minitoc-area">
235
<a href="#Getting Started">Getting Started</a>
241
<a name="N10013"></a><a name="Getting Started"></a>
242
<h2 class="boxed">Getting Started</h2>
243
<div class="section">
245
This document is intended as a "getting started" guide. It has three audiences: first-time users
246
looking to install Apache Lucene in their application or web server; developers looking to modify or base
247
the applications they develop on Lucene; and developers looking to become involved in and contribute
248
to the development of Lucene. This document is written in tutorial and walk-through format. The
249
goal is to help you "get started". It does not go into great depth on some of the conceptual or
250
inner details of Lucene.
253
Each section listed below builds on one another. More advanced users
254
may wish to skip sections.
259
<a href="demo.html">About the command-line Lucene demo and its usage</a>. This section
260
is intended for anyone who wants to use the command-line Lucene demo.</li>
265
<a href="demo2.html">About the sources and implementation for the command-line Lucene
266
demo</a>. This section walks through the implementation details (sources) of the
267
command-line Lucene demo. This section is intended for developers.</li>
272
<a href="demo3.html">About installing and configuring the demo template web
273
application</a>. While this walk-through assumes Tomcat as your container of choice,
274
there is no reason you can't (provided you have the requisite knowledge) adapt the
275
instructions to your container. This section is intended for those responsible for the
276
development or deployment of Lucene-based web applications.</li>
281
<a href="demo4.html">About the sources used to construct the demo template web
282
application</a>. Please note the template application is designed to highlight features of
283
Lucene and is <b>not</b> an example of best practices. (One would hopefully use MVC
284
architecture such as provided by Jakarta Struts and taglibs, but showing you how to do that
285
would be WAY beyond the scope of this guide.) This section is intended for developers and
286
those wishing to customize the demo template web application to their needs. </li>
297
<div class="clearboth"> </div>
303
<div class="lastmodified">
304
<script type="text/javascript"><!--
305
document.write("Last Published: " + document.lastModified);
308
<div class="copyright">
310
2006 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>