ApacheCon Europe 2012

Rhein-Neckar-Arena, Sinsheim, Germany

5–8 November 2012

Is your index reader really atomic or maybe slow?

Uwe Schindler

Audience level:
Lucene, Solr & Friends

Wednesday noon–12:45 p.m. in Level 1 Right


This talk will introduce the major changes in Apache Lucene 4.0 affecting a lot of end-user code. It will help developers using Apache Lucene 3.x to migrate to Lucene 4.0.


Since the first day Apache Lucene exposed the two fundamental concepts of reading and writing an index directly through IndexReader & IndexWriter. However, the API did not reflect reality; from the IndexWriter perspective this was desirable but when reading the index this caused several problems in the past. In reality a Lucene index is not a single index while logically treated as a such. This talk will introduce the new API classes AtomicReader and CompositeReader added in Lucene 4.0 as very general interfaces, and DirectoryReader, which most people know as the segment-based “Lucene index on disk”. The talk will also cover more changes and improvements to the search API like reader contexts that allow to convert local document ids to global ones from IndexSearcher. Lucene changed all IndexReaders to be read-only, so it’s no longer possible to modify indexes using those classes.