|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object edu.mit.jwi.DataSourceDictionary
public class DataSourceDictionary
Basic implementation of the IDictionary
interface. A path to the
Wordnet dictionary files must be provided. If no IDataProvider
is
specified, it uses the default implementation provided with the distribution.
Nested Class Summary | |
---|---|
class |
DataSourceDictionary.DataFileIterator
Iterates over data files. |
class |
DataSourceDictionary.ExceptionFileIterator
Iterates over exception files. |
class |
DataSourceDictionary.FileIterator<T,N>
Abstract class used for iterating over line-based files. |
class |
DataSourceDictionary.FileIterator2<T>
A file iterator where the data type returned by the iterator is the same as that returned by the backing data source. |
class |
DataSourceDictionary.IndexFileIterator
Iterates over index files. |
class |
DataSourceDictionary.SenseEntryFileIterator
Iterates over the sense file. |
Nested classes/interfaces inherited from interface edu.mit.jwi.data.IHasLifecycle |
---|
IHasLifecycle.LifecycleState, IHasLifecycle.ObjectClosedException, IHasLifecycle.ObjectOpenException |
Constructor Summary | |
---|---|
DataSourceDictionary(IDataProvider provider)
Constructs a dictionary with a caller-specified IDataProvider . |
Method Summary | |
---|---|
protected void |
checkOpen()
An internal method for assuring compliance with the dictionary interface that says that methods will throw ObjectClosedException s if
the dictionary has not yet been opened. |
void |
close()
This closes the object by disposing of data backing objects or connections. |
java.nio.charset.Charset |
getCharset()
Returns the character set associated with this object. |
IDataProvider |
getDataProvider()
Returns the data provider for this dictionary. |
IExceptionEntry |
getExceptionEntry(IExceptionEntryID id)
Retrieves the exception entry for the specified id from the database. |
IExceptionEntry |
getExceptionEntry(java.lang.String surfaceForm,
POS pos)
Retrieves the exception entry for the specified surface form and part of speech from the database. |
java.util.Iterator<IExceptionEntry> |
getExceptionEntryIterator(POS pos)
Returns an iterator that will iterate over all exception entries of the specified part of speech. |
IIndexWord |
getIndexWord(IIndexWordID id)
Retrieves the specified index word object from the database. |
IIndexWord |
getIndexWord(java.lang.String lemma,
POS pos)
This method is identical to getIndexWord(IIndexWordID) and
is provided as a convenience. |
java.util.Iterator<IIndexWord> |
getIndexWordIterator(POS pos)
Returns an iterator that will iterate over all index words of the specified part of speech. |
ISenseEntry |
getSenseEntry(ISenseKey key)
Retrieves the sense entry for the specified sense key from the database. |
java.util.Iterator<ISenseEntry> |
getSenseEntryIterator()
Returns an iterator that will iterate over all sense entries in the dictionary. |
ISynset |
getSynset(ISynsetID id)
Retrieves the synset with the specified id from the database. |
java.util.Iterator<ISynset> |
getSynsetIterator(POS pos)
Returns an iterator that will iterate over all synsets of the specified part of speech. |
IVersion |
getVersion()
Returns the associated version for this object. |
IWord |
getWord(ISenseKey key)
Retrieves the word with the specified sense key from the database. |
IWord |
getWord(IWordID id)
Retrieves the word with the specified id from the database. |
boolean |
isOpen()
Returns true if the dictionary is open, that is, ready to
accept queries; returns false otherwise |
boolean |
open()
This opens the object by performing any required initialization steps. |
void |
setCharset(java.nio.charset.Charset charset)
Sets the character set associated with this dictionary. |
protected void |
setHeadWord(ISynset synset)
This method sets the head word on the specified synset by searching in the dictionary to find the head of its cluster. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DataSourceDictionary(IDataProvider provider)
IDataProvider
.
java.lang.NullPointerException
- if the specified data provider is null
Method Detail |
---|
public IDataProvider getDataProvider()
IDataSourceDictionary
null
.
getDataProvider
in interface IDataSourceDictionary
public IVersion getVersion()
IHasVersion
null
.
getVersion
in interface IHasVersion
null
if none.public boolean open() throws java.io.IOException
IHasLifecycle
false
, then subsequent calls to
IHasLifecycle.isOpen()
will return false
.
open
in interface IHasLifecycle
true
if there were no errors in initialization;
false
otherwise.
java.io.IOException
- if there was IO error while performing initializataionpublic void close()
IClosable
close
in interface IClosable
public boolean isOpen()
IHasLifecycle
true
if the dictionary is open, that is, ready to
accept queries; returns false
otherwise
isOpen
in interface IHasLifecycle
true
if the object is open; false
otherwiseprotected void checkOpen()
ObjectClosedException
s if
the dictionary has not yet been opened.
ObjectClosedException
- if the dictionary is closed.public java.nio.charset.Charset getCharset()
IHasCharset
null
.
getCharset
in interface IHasCharset
null
public void setCharset(java.nio.charset.Charset charset)
IDictionary
null
.
setCharset
in interface IDictionary
charset
- the possibly null
character set to use when
decoding files.public IIndexWord getIndexWord(java.lang.String lemma, POS pos)
IDictionary
getIndexWord(IIndexWordID)
and
is provided as a convenience.
getIndexWord
in interface IDictionary
lemma
- the lemma for the index word requested; may not be
null
, empty, or all whitespacepos
- the part of speech; may not be null
null
if none is foundpublic IIndexWord getIndexWord(IIndexWordID id)
IDictionary
null
.
Note: This call does no stemming on the specified lemma, it is
taken as specified. That is, if you submit the word "dogs", it will
search for "dogs", not "dog"; in the standard Wordnet distribution, there
is no entry for "dogs" and therefore the call will return
null
. This is in contrast to the Wordnet API provided by
Princeton. If you want your searches to capture morphological variation,
use the descendants of the IStemmer
class.
getIndexWord
in interface IDictionary
id
- the id of the index word to search for; may not be
null
null
otherwisepublic IWord getWord(IWordID id)
IDictionary
null
getWord
in interface IDictionary
id
- the id of the word to search for; may not be null
null
otherwisepublic IWord getWord(ISenseKey key)
IDictionary
null
getWord
in interface IDictionary
key
- the sense key of the word to search for; may not be
null
null
otherwisepublic ISenseEntry getSenseEntry(ISenseKey key)
IDictionary
null
getSenseEntry
in interface IDictionary
key
- the sense key of the entry to search for; may not be
null
null
otherwisepublic ISynset getSynset(ISynsetID id)
IDictionary
null
getSynset
in interface IDictionary
id
- the id of the synset to search for; may not be
null
null
otherwiseprotected void setHeadWord(ISynset synset)
public IExceptionEntry getExceptionEntry(java.lang.String surfaceForm, POS pos)
IDictionary
null
getExceptionEntry
in interface IDictionary
surfaceForm
- the surface form to be looked up; may not be null
, empty, or all whitespacepos
- the part of speech; may not be null
null
otherwisepublic IExceptionEntry getExceptionEntry(IExceptionEntryID id)
IDictionary
null
getExceptionEntry
in interface IDictionary
id
- the exception entry id of the entry to search for; may not be
null
public java.util.Iterator<IIndexWord> getIndexWordIterator(POS pos)
IDictionary
getIndexWordIterator
in interface IDictionary
pos
- the part of speech over which to iterate; may not be
null
public java.util.Iterator<ISynset> getSynsetIterator(POS pos)
IDictionary
getSynsetIterator
in interface IDictionary
pos
- the part of speech over which to iterate; may not be
null
public java.util.Iterator<IExceptionEntry> getExceptionEntryIterator(POS pos)
IDictionary
getExceptionEntryIterator
in interface IDictionary
pos
- the part of speech over which to iterate; may not be
null
public java.util.Iterator<ISenseEntry> getSenseEntryIterator()
IDictionary
getSenseEntryIterator
in interface IDictionary
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |