This document is intended as a "getting started" guide to using and running the Lucene demos. It walks you through some basic installation and configuration.

The Lucene command-line demo code consists of two applications that demonstrate various functionalities of Lucene and how one should go about adding Lucene to their applications.

First, you should download the latest Lucene distribution and then extract it to a working directory. Alternatively, you can check out the sources from Subversion, and then run ant war-demo to generate the JARs and WARs.

You should see the Lucene JAR file in the directory you created when you extracted the archive. It should be named something like lucene-core-{version}.jar. You should also see a file called lucene-demos-{version}.jar. If you checked out the sources from Subversion then the JARs are located under the build subdirectory (after running ant successfully). Put both of these files in your Java CLASSPATH.

Once you've gotten this far you're probably itching to go. Let's build an index! Assuming you've set your CLASSPATH correctly, just type:

    java org.apache.lucene.demo.IndexFiles {full-path-to-lucene}/src

This will produce a subdirectory called index which will contain an index of all of the Lucene source code.

To search the index type:

    java org.apache.lucene.demo.SearchFiles

You'll be prompted for a query. Type in a swear word and press the enter key. You'll see that the Lucene developers are very well mannered and get no results. Now try entering the word "vector". That should return a whole bunch of documents. The results will page at every tenth result and ask you whether you want more results.

read on>>>