org.dlese.dpc.index.reader

Class DocumentMap

java.lang.Object

org.dlese.dpc.index.reader.DocumentMap

All Implemented Interfaces:

java.util.Map

public class DocumentMap
extends java.lang.Object
implements java.util.Map

A Map for accessing the data stored in a Lucene Document as field/value pairs. All data is loaded from the index into the Map when any Map accessor method is called (e.g. eager loading), making data available even if the underlying index later changes, but also making access to very large Documents inefficient. Each stored field in the Document corresponds to a key in the Map. For example documentMap.get("title") gets the text that was indexed and stored under the field name "title" for the Document. Supports read operations only. A DocumentMap is available from search results by calling ResultDoc.getDocMap().

Example that uses JSTL inside a JSP page (assumes result is an instance of ResultDoc):

The title is: ${result.docMap["title"]}.

Author:

John Weatherley

See Also:

Document, ResultDoc, LazyDocumentMap

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
DocumentMap() Constructor for the DocumentMap object.
DocumentMap(org.apache.lucene.document.Document doc) Constructor for the DocumentMap object.

Method Summary

Modifier and Type	Method and Description
void	clear() Method not supported.
boolean	containsKey(java.lang.Object fieldName) Determines whether a given field exists in the Lucene Document.
boolean	containsValue(java.lang.Object value) Determines whether the given field value is present in the Lucene Document.
java.util.Set	entrySet() Gets the Set of field/value entries for the Lucene Document.
java.lang.Object	get(java.lang.Object fieldName) Gets the text content of the given Lucene field as a String or null if the given field is not available or was not stored in the index.
boolean	isEmpty() Determines whether there are no fields in this Document.
java.util.Set	keySet() Gets the field names in the Lucene Document.
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Method not supported.
void	putAll(java.util.Map t) Method not supported.
java.lang.Object	remove(java.lang.Object key) Method not supported.
int	size() Gets the number of fields in the Document.
java.util.Collection	values() Gets all field values that are present in the Lucene Document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

DocumentMap

public DocumentMap(org.apache.lucene.document.Document doc)

Constructor for the DocumentMap object.

Parameters:

doc - The Lucene Document that is exposed by this Map.

DocumentMap

public DocumentMap()

Constructor for the DocumentMap object.

Method Detail

get

public java.lang.Object get(java.lang.Object fieldName)

Gets the text content of the given Lucene field as a String or null if the given field is not available or was not stored in the index. Text contains all stored values for the given field.

Specified by:

get in interface java.util.Map

Parameters:

fieldName - A Lucene Document field name

Returns:

The text of the field as a String, a Date, or null if not available.

keySet

public java.util.Set keySet()

Gets the field names in the Lucene Document.

Specified by:

keySet in interface java.util.Map

Returns:

The field names

entrySet

public java.util.Set entrySet()

Gets the Set of field/value entries for the Lucene Document. Each Map.Entry Object in the Set contains the field name (key) and corresponding field value. The field value will be an empty String if the given field was not set to be stored in the index.

Specified by:

entrySet in interface java.util.Map

Returns:

The Set of field/value entries for the Lucene Document

See Also:

Map.Entry

containsKey

public boolean containsKey(java.lang.Object fieldName)

Determines whether a given field exists in the Lucene Document.

Specified by:

containsKey in interface java.util.Map

Parameters:

fieldName - A field name

Returns:

True if the field exists in the Lucene Document

values

public java.util.Collection values()

Gets all field values that are present in the Lucene Document.

Specified by:

values in interface java.util.Map

Returns:

The field values

containsValue

public boolean containsValue(java.lang.Object value)

Determines whether the given field value is present in the Lucene Document.

Specified by:

containsValue in interface java.util.Map

Parameters:

value - A field value

Returns:

True if the field value is present in this Document

isEmpty

public boolean isEmpty()

Determines whether there are no fields in this Document.

Specified by:

isEmpty in interface java.util.Map

Returns:

True if there are no fields in the Document.

size

public int size()

Gets the number of fields in the Document.

Specified by:

size in interface java.util.Map

Returns:

The number of fields in the Document

putAll

public void putAll(java.util.Map t)

Method not supported.

Specified by:

putAll in interface java.util.Map

Parameters:

t - Not supported.

put

public java.lang.Object put(java.lang.Object key,
                            java.lang.Object value)

Method not supported.

Specified by:

put in interface java.util.Map

Parameters:

key - Not supported.

value - Not supported.

Returns:

Not supported.

remove

public java.lang.Object remove(java.lang.Object key)

Method not supported.

Specified by:

remove in interface java.util.Map

Parameters:

key - Not supported.

Returns:

Not supported.

clear

public void clear()

Method not supported.

Specified by:

clear in interface java.util.Map