net.didion.jwnl.dictionary

Class Dictionary

java.lang.Object

net.didion.jwnl.dictionary.Dictionary

All Implemented Interfaces:

Installable

Direct Known Subclasses:

AbstractCachingDictionary, MapBackedDictionary

public abstract class Dictionary
extends java.lang.Object
implements Installable

Abstract representation of a WordNet dictionary. See the architecture documentation for information on subclassing Dictionary.

Field Summary

Fields

Modifier and Type	Field and Description
private static Dictionary	_dictionary The singleton instance of the dictionary to be used throughout the system.
private static MessageLog	_log
private MorphologicalProcessor	_morph

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Dictionary() Create a Dictionary that does not do morphological processing.
protected	Dictionary(MorphologicalProcessor morph) Create a Dictionary using the specified MorphologicalProcessor.

Method Summary

Modifier and Type	Method and Description
abstract void	close() Shut down the dictionary
abstract Exc	getException(POS pos, java.lang.String derivation) Lookup derivation in the exceptions file of part-of-speech pos and return an Exc object containing the results.
abstract java.util.Iterator	getExceptionIterator(POS pos) Return an Iterator over all the Exceptions in the database.
abstract IndexWord	getIndexWord(POS pos, java.lang.String lemma) Look up a word in the database.
abstract java.util.Iterator	getIndexWordIterator(POS pos) Return an Iterator over all the IndexWords of part-of-speech pos in the database.
abstract java.util.Iterator	getIndexWordIterator(POS pos, java.lang.String substring) Return an Iterator over all the IndexWords of part-of-speech pos whose lemmas contain substring as a substring.
static Dictionary	getInstance()
MorphologicalProcessor	getMorphologicalProcessor()
abstract IndexWord	getRandomIndexWord(POS pos)
abstract Synset	getSynsetAt(POS pos, long offset) Return the Synset at offset offset from the database.
abstract java.util.Iterator	getSynsetIterator(POS pos) Return an Iterator over all the Synsets of part-of-speech pos in the database.
IndexWordSet	lookupAllIndexWords(java.lang.String lemma) Return a set of IndexWords, with each element in the set corresponding to a part-of-speech of word.
IndexWord	lookupIndexWord(POS pos, java.lang.String lemma) Main word lookup procedure.
protected static java.lang.String	prepareQueryString(java.lang.String lemma) Prepares the lemma for being used in a lookup operation.
protected static void	setDictionary(Dictionary dictionary)
static void	uninstall()

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.didion.jwnl.util.factory.Installable

install

Field Detail

_log

private static final MessageLog _log

_dictionary

private static Dictionary _dictionary

The singleton instance of the dictionary to be used throughout the system.

_morph

private MorphologicalProcessor _morph

Constructor Detail

Dictionary

protected Dictionary()

Create a Dictionary that does not do morphological processing.

Dictionary

protected Dictionary(MorphologicalProcessor morph)

Create a Dictionary using the specified MorphologicalProcessor.

Method Detail

getInstance

public static Dictionary getInstance()

setDictionary

protected static void setDictionary(Dictionary dictionary)

uninstall

public static void uninstall()

prepareQueryString

protected static java.lang.String prepareQueryString(java.lang.String lemma)

Prepares the lemma for being used in a lookup operation. Specifically, this method trims whitespace and converts the lemma to lower case.

Parameters:

lemma - the lemma to be prepared

Returns:

String the prepared lemma

getIndexWordIterator

public abstract java.util.Iterator getIndexWordIterator(POS pos)
                                                 throws JWNLException

Return an Iterator over all the IndexWords of part-of-speech pos in the database.

Parameters:

pos - The part-of-speech

Returns:

An iterator over IndexWords

Throws:

JWNLException

getIndexWordIterator

public abstract java.util.Iterator getIndexWordIterator(POS pos,
                                                        java.lang.String substring)
                                                 throws JWNLException

Return an Iterator over all the IndexWords of part-of-speech pos whose lemmas contain substring as a substring.

Parameters:

pos - The part-of-speech.

Returns:

An iterator over IndexWords.

Throws:

JWNLException

getIndexWord

public abstract IndexWord getIndexWord(POS pos,
                                       java.lang.String lemma)
                                throws JWNLException

Look up a word in the database. The search is case-independent, and phrases are separated by spaces ("look up", not "look_up"). Note: this method does not subject lemma to any morphological processing. If you want this, use lookupIndexWord(POS, String).

Parameters:

pos - The part-of-speech.

lemma - The orthographic representation of the word.

Returns:

An IndexWord representing the word, or null if no such entry exists.

Throws:

JWNLException

getRandomIndexWord

public abstract IndexWord getRandomIndexWord(POS pos)
                                      throws JWNLException

Throws:

JWNLException

getSynsetIterator

public abstract java.util.Iterator getSynsetIterator(POS pos)
                                              throws JWNLException

Return an Iterator over all the Synsets of part-of-speech pos in the database.

Parameters:

pos - The part-of-speech.

Returns:

An iterator over Synsets.

Throws:

JWNLException

getSynsetAt

public abstract Synset getSynsetAt(POS pos,
                                   long offset)
                            throws JWNLException

Return the Synset at offset offset from the database.

Parameters:

pos - The part-of-speech file to look in

offset - The offset of the synset in the file

Returns:

A synset containing the parsed line from the database

Throws:

JWNLException

getExceptionIterator

public abstract java.util.Iterator getExceptionIterator(POS pos)
                                                 throws JWNLException

Return an Iterator over all the Exceptions in the database.

Parameters:

pos - the part-of-speech

Returns:

Iterator An iterator over Strings

Throws:

JWNLException

getException

public abstract Exc getException(POS pos,
                                 java.lang.String derivation)
                          throws JWNLException

Lookup derivation in the exceptions file of part-of-speech pos and return an Exc object containing the results.

Parameters:

pos - the exception file to look in

derivation - the word to look up

Returns:

Exc the Exc object

Throws:

JWNLException

close

public abstract void close()

Shut down the dictionary

getMorphologicalProcessor

public MorphologicalProcessor getMorphologicalProcessor()

lookupIndexWord

public IndexWord lookupIndexWord(POS pos,
                                 java.lang.String lemma)
                          throws JWNLException

Main word lookup procedure. First try a normal lookup. If that doesn't work, try looking up the stemmed form of the lemma.

Parameters:

pos - the part-of-speech of the word to look up

lemma - the lemma to look up

Returns:

IndexWord the IndexWord found by the lookup procedure, or null if an IndexWord is not found

Throws:

JWNLException

lookupAllIndexWords

public IndexWordSet lookupAllIndexWords(java.lang.String lemma)
                                 throws JWNLException

Return a set of IndexWords, with each element in the set corresponding to a part-of-speech of word.

Parameters:

lemma - the word for which to lookup senses

Returns:

An array of IndexWords, each of which is a sense of word

Throws:

JWNLException