Monday, December 1, 2008

Getting Started with Apache Lucene

Apache Lucene is a high-performance, full-featured text search engine library.

The API of lucene is very simple to use. Here is overview of some of the objects required to start using Apache Lucene.

Document and Fields

The class "org.apache.lucene.document.Document" is necessary container for the index. Lucene requires all indexed objects to provide an instance of Document. Each document defines one or several fields ( (org.apache.lucene.document.Field). Fields contain classified information about the document or metadata related to document. A sample classification is for example the creation date of a file, author of the document etc. These fields allow you to search later for a specific information in this classification.


The class org.apache.lucene.index.IndexWriter creates the index. Via the method addDocument you can add an existing Document to the index. The constructor for IndexWriter expects the directory to store the index, and the analyzer for the content of the files. In addition a boolean flag is handed over which indicates if the index should be created new or if an existing index should be extended.


The class org.apache.lucene.analysis.standard.StandardAnalyzer provides a standard analyzer. This part is responsible to analyse the text and to filter out certain fill-words, e.g. "and".

Searcher and Query

The class provides the search functionality. searches over an index. What is to be searched is provided via the query ( class. The search allows wildcard search, e.g. *, ?, logical operations (AND, OR, NOT) and much more, e.g. fussy.

Here's a simple example how to use Lucene for indexing and searching.

public class TestMyLucene
public static void main(String[] args) throws Exception
Analyzer analyzer = new StandardAnalyzer();

// Store the index in memory:
Directory directory = new RAMDirectory();

// To store an index on disk, use this instead (note that the
// parameter true will overwrite the index in that directory
// if one exists):
//Directory directory = FSDirectory.getDirectory("/tmp/testindex", true);
IndexWriter iwriter = new IndexWriter(directory, analyzer, true);

Document doc = new Document();
String text = "This is the text to be indexed.";
doc.add(new Field("fieldname", text, Field.Store.YES, Field.Index.TOKENIZED));

// Now search the index:
IndexSearcher isearcher = new IndexSearcher(directory);

// Parse a simple query that searches for "text":
Query query = QueryParser.parse("text", "fieldname", analyzer);
Hits hits =;

// Iterate through the results:
for (int i = 0; i < hits.length(); i++)
Document hitDoc = hits.doc(i);


In the above example, hits return the matching documents for the query provided.

No comments:

Post a Comment