From 866964a764b2f96551ffece9728182e8ee65d729 Mon Sep 17 00:00:00 2001 From: tmont Date: Fri, 25 Feb 2011 23:36:21 +0000 Subject: [PATCH] * compiled my own version of Lucene (2.9 RC1) * got search working --- Lib/Lucene.Net.dll | Bin 294912 -> 745472 bytes Lib/Lucene.Net.xml | 32134 +++++++++++++--- Lib/Portoa.Log4Net.dll | Bin 5120 -> 5120 bytes Lib/Portoa.NHibernate.dll | Bin 16384 -> 16384 bytes Lib/Portoa.Web.dll | Bin 48640 -> 48128 bytes Lib/Portoa.Web.xml | 117 +- Lib/Portoa.dll | Bin 37376 -> 37376 bytes Lib/Portoa.xml | 20 +- Lib/UnityGenerics.dll | Bin 8192 -> 8192 bytes .../Persistence/SearchService.cs | 32 + .../Persistence/UserService.cs | 1 - .../Search/ISearchIndexBuilder.cs | 17 + Src/VideoGameQuotes.Api/Search/ISearcher.cs | 15 + .../Search/Lucene/ILuceneDocumentHandler.cs | 9 + .../Search/Lucene/LuceneEntityIndexBuilder.cs | 45 + .../Search/Lucene/LuceneEntitySearcher.cs | 50 + .../Search/Lucene/QuoteDocumentHandler.cs | 18 + .../Search/SearchIndexException.cs | 10 + .../Search/SearchResult.cs | 4 +- .../VideoGameQuotes.Api.csproj | 12 +- .../UpdateSearchIndexCallHandler.cs | 61 + .../Controllers/QuoteController.cs | 4 +- Src/VideoGameQuotes.Web/Global.asax.cs | 88 +- Src/VideoGameQuotes.Web/Models/SearchModel.cs | 2 +- .../VideoGameQuotes.Web.csproj | 9 +- .../Views/Quote/Search.aspx | 2 +- .../media/images/flag_red.png | Bin 0 -> 665 bytes Src/VideoGameQuotes.Web/media/images/link.png | Bin 0 -> 343 bytes .../VideoGameQuotes.Api.Tests.csproj | 1 - 29 files changed, 26789 insertions(+), 5862 deletions(-) create mode 100644 Src/VideoGameQuotes.Api/Persistence/SearchService.cs create mode 100644 Src/VideoGameQuotes.Api/Search/ISearchIndexBuilder.cs create mode 100644 Src/VideoGameQuotes.Api/Search/ISearcher.cs create mode 100644 Src/VideoGameQuotes.Api/Search/Lucene/ILuceneDocumentHandler.cs create mode 100644 Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntityIndexBuilder.cs create mode 100644 Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntitySearcher.cs create mode 100644 Src/VideoGameQuotes.Api/Search/Lucene/QuoteDocumentHandler.cs create mode 100644 Src/VideoGameQuotes.Api/Search/SearchIndexException.cs create mode 100644 Src/VideoGameQuotes.Web/Configuration/UpdateSearchIndexCallHandler.cs create mode 100644 Src/VideoGameQuotes.Web/media/images/flag_red.png create mode 100644 Src/VideoGameQuotes.Web/media/images/link.png diff --git a/Lib/Lucene.Net.dll b/Lib/Lucene.Net.dll index f10fb3b077a684d0a18e7d3c49b751bf63be5334..7c408870c4299b05e9189a8622244a9a9e34732b 100644 GIT binary patch literal 745472 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

6$ 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%0Aw$=#1rlwNQ2Y?#M(M4>Meoz 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 literal 294912 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 diff --git a/Lib/Lucene.Net.xml b/Lib/Lucene.Net.xml index b450248..8bf1bc8 100644 --- a/Lib/Lucene.Net.xml +++ b/Lib/Lucene.Net.xml @@ -4,2025 +4,229 @@ Lucene.Net - -

This interface describes a character stream that maintains line and - column number positions of the characters. It also has the capability - to backup the stream to some extent. An implementation of this - interface is used in the TokenManager implementation generated by - JavaCCParser. + + Base class for cache implementations. + + + Returns a thread-safe cache backed by the specified cache. + In order to guarantee thread-safety, all access to the backed cache must + be accomplished through the returned cache. + + + + Called by {@link #SynchronizedCache(Cache)}. This method + returns a {@link SynchronizedCache} instance that wraps + this instance by default and can be overridden to return + e. g. subclasses of {@link SynchronizedCache} or this + in case this cache is already synchronized. + + + + Puts a (key, value)-pair into the cache. + + + Returns the value for the given key. + + + Returns whether the given key is in this cache. + + + Closes the cache. + + + Simple Cache wrapper that synchronizes all + calls that access the cache. + + + + Provides support for converting byte sequences to Strings and back again. + The resulting Strings preserve the original byte sequences' sort order. - All the methods except backup can be implemented in any fashion. backup - needs to be implemented correctly for the correct operation of the lexer. - Rest of the methods are all used to get information like line number, - column number and the String that constitutes a token and are not used - by the lexer. Hence their implementation won't affect the generated lexer's - operation. - - - - Returns the next character from the selected input. The method - of selecting the input is the responsibility of the class - implementing this interface. Can throw any java.io.IOException. - - - - Returns the column number of the last character for current token (being - matched after the last call to BeginTOken). - - - - Returns the line number of the last character for current token (being - matched after the last call to BeginTOken). - - - - Returns the column number of the first character for current token (being - matched after the last call to BeginTOken). - - - - Returns the line number of the first character for current token (being - matched after the last call to BeginTOken). - - - - Backs up the input stream by amount steps. Lexer calls this method if it - had already read some characters, but could not use them to match a - (longer) token. So, they will be used again as the prefix of the next - token and it is the implemetation's responsibility to do this right. - - - - Returns the next character that marks the beginning of the next token. - All characters must remain in the buffer between two successive calls - to this method to implement backup correctly. - - - - Returns a string made up of characters from the marked token beginning - to the current buffer position. Implementations have the choice of returning - anything that they want to. For example, for efficiency, one might decide - to just return null, which is a valid implementation. - - - - Returns an array of characters that make up the suffix of length 'len' for - the currently matched token. This is used to build up the matched string - for use in actions in the case of MORE. A simple and inefficient - implementation of this is as follows : + The Strings are constructed using a Base 8000h encoding of the original + binary data - each char of an encoded String represents a 15-bit chunk + from the byte sequence. Base 8000h was chosen because it allows for all + lower 15 bits of char to be used without restriction; the surrogate range + [U+D8000-U+DFFF] does not represent valid chars, and would require + complicated handling to avoid them and allow use of char's high bit. - { - String t = GetImage(); - return t.substring(t.length() - len, t.length()).toCharArray(); + Although unset bits are used as padding in the final char, the original + byte sequence could contain trailing bytes with no set bits (null bytes): + padding is indistinguishable from valid information. To overcome this + problem, a char is appended, indicating the number of encoded bytes in the + final content char. + + This class's operations are defined over CharBuffers and ByteBuffers, to + allow for wrapped arrays to be reused, reducing memory allocation costs for + repeated operations. Note that this class calls array() and arrayOffset() + on the CharBuffers and ByteBuffers it uses, so only wrapped arrays may be + used. This class interprets the arrayOffset() and limit() values returned by + its input buffers as beginning and end+1 positions on the wrapped array, + resprectively; similarly, on the output buffer, arrayOffset() is the first + position written to, and limit() is set to one past the final output array + position. + + + + Returns the number of chars required to encode the given byte sequence. + + + The byte sequence to be encoded. Must be backed by an array. + + The number of chars required to encode the given byte sequence + + IllegalArgumentException If the given ByteBuffer is not backed by an array + + + Returns the number of bytes required to decode the given char sequence. + + + The char sequence to be encoded. Must be backed by an array. + + The number of bytes required to decode the given char sequence + + IllegalArgumentException If the given CharBuffer is not backed by an array + + + Encodes the input byte sequence into the output char sequence. Before + calling this method, ensure that the output CharBuffer has sufficient + capacity by calling {@link #GetEncodedLength(java.nio.ByteBuffer)}. + + + The byte sequence to encode + + Where the char sequence encoding result will go. The limit + is set to one past the position of the final char. + + IllegalArgumentException If either the input or the output buffer + is not backed by an array + + + + Decodes the input char sequence into the output byte sequence. Before + calling this method, ensure that the output ByteBuffer has sufficient + capacity by calling {@link #GetDecodedLength(java.nio.CharBuffer)}. + + + The char sequence to decode + + Where the byte sequence decoding result will go. The limit + is set to one past the position of the final char. + + IllegalArgumentException If either the input or the output buffer + is not backed by an array + + + + Decodes the given char sequence, which must have been encoded by + {@link #Encode(java.nio.ByteBuffer)} or + {@link #Encode(java.nio.ByteBuffer, java.nio.CharBuffer)}. + + + The char sequence to decode + + A byte sequence containing the decoding result. The limit + is set to one past the position of the final char. + + IllegalArgumentException If the input buffer is not backed by an + array + + + + Encodes the input byte sequence. + + + The byte sequence to encode + + A char sequence containing the encoding result. The limit is set + to one past the position of the final char. + + IllegalArgumentException If the input buffer is not backed by an + array + + + + Implements {@link LockFactory} for a single in-process instance, + meaning all locking will take place through this one instance. + Only use this {@link LockFactory} when you are certain all + IndexReaders and IndexWriters for a given index are running + against a single shared in-process Directory instance. This is + currently the default locking for RAMDirectory. + + + + + + +

Base class for Locking implementation. {@link Directory} uses + instances of this class to implement locking.

+ +

Note that there are some useful tools to verify that + your LockFactory is working correctly: {@link + VerifyingLockFactory}, {@link LockStressTest}, {@link + LockVerifyServer}.

+ +

+ + + + + + + + + Set the prefix in use for all locks created in this + LockFactory. This is normally called once, when a + Directory gets this LockFactory instance. However, you + can also call this (after this instance is assigned to + a Directory) to override the prefix in use. This + is helpful if you're running Lucene on machines that + have different mount points for the same shared + directory. + + + + Get the prefix in use for all locks created in this LockFactory. + + + Return a new Lock instance identified by lockName. + name of the lock to be created. + + + + Attempt to clear (forcefully unlock and remove) the + specified lock. Only call this at a time when you are + certain this lock is no longer in use. + + name of the lock to be cleared. + + + + An interprocess mutex lock. +

Typical use might look like:

+            new Lock.With(directory.makeLock("my.lock")) {
+            public Object doBody() {
+            ... code to execute while locked ...
             }
-
- - - The lexer calls this function to indicate that it is done with the stream - and hence implementations can free any resources held by this class. - Again, the body of this function can be just empty and it will not - affect the lexer's operation. - - - - - Constructs from a Reader. - - - This exception is thrown when parse errors are encountered. - You can explicitly create objects of this exception type by - calling the method generateParseException in the generated - parser. + }.run(); + - You can modify this class to customize your error reporting - mechanisms so long as you retain the public fields. - - - - This constructor is used by the method "generateParseException" - in the generated parser. Calling this constructor generates - a new object of this type with the fields "currentToken", - "expectedTokenSequences", and "tokenImage" set. The boolean - flag "specialConstructor" is also set to true to indicate that - this constructor was used to create this object. - This constructor calls its super class with the empty string - to force the "toString" method of parent class "Throwable" to - print the error message in the form: - ParseException: <result of getMessage> - - - - The following constructors are for use by you for whatever - purpose you can think of. Constructing the exception in this - manner makes the exception behave in the normal way - i.e., as - documented in the class "Throwable". The fields "errorToken", - "expectedTokenSequences", and "tokenImage" do not contain - relevant information. The JavaCC generated code does not use - these constructors. - - - - This variable determines which constructor was used to create - this object and thereby affects the semantics of the - "getMessage" method (see below). - - - - This is the last token that has been consumed successfully. If - this object has been created due to a parse error, the token - followng this token will (therefore) be the first error token. - - - - Each entry in this array is an array of integers. Each array - of integers represents a sequence of tokens (by their ordinal - values) that is expected at this point of the parse. - - - - This is a reference to the "tokenImage" array of the generated - parser within which the parse error occurred. This array is - defined in the generated ...Constants interface. - - - - The end of line string for this machine. - - - Used to convert raw characters to their escaped version - when these raw version cannot be used as part of an ASCII - string literal. - - - - This method has the standard behavior when this object has been - created using the standard constructors. Otherwise, it uses - "currentToken" and "expectedTokenSequences" to generate a parse - error message and returns it. If this object has been created - due to a parse error, and you do not catch it (it gets thrown - from the parser), then this method is called during the printing - of the final stack trace, and hence the correct error message - gets displayed. - - - - Filters {@link StandardTokenizer} with {@link StandardFilter}, {@link - LowerCaseFilter} and {@link StopFilter}, using a list of English stop words. - $Id: StandardAnalyzer.java 219090 2005-07-14 20:36:28Z dnaber $ + $Id: Lock.java 769409 2009-04-28 14:05:43Z mikemccand $ - - - - Creates a TokenStream which tokenizes all the text in the provided - Reader. Default implementation forwards to tokenStream(Reader) for - compatibility with older version. Override to allow Analyzer to choose - strategy based on document and/or field. Must be able to handle null - field name for backward compatibility. - - - - Invoked before indexing a Field instance if - terms have already been added to that field. This allows custom - analyzers to place an automatic position increment gap between - Field instances using the same field name. The default value - position increment gap is 0. With a 0 position increment gap and - the typical default token position increment of 1, all terms in a field, - including across Field instances, are in successive positions, allowing - exact PhraseQuery matches, for instance, across Field instance boundaries. - - - Field name being indexed. - - position increment gap, added to the next token emitted from {@link #TokenStream(String,Reader)} - - - - An array containing some common English words that are usually not - useful for searching. - - - - Builds an analyzer with the default stop words ({@link #STOP_WORDS}). - - - Builds an analyzer with the given stop words. - - - Builds an analyzer with the given stop words. - - - Builds an analyzer with the stop words from the given file. - + - - Builds an analyzer with the stop words from the given reader. - - - - - Constructs a {@link StandardTokenizer} filtered by a {@link - StandardFilter}, a {@link LowerCaseFilter} and a {@link StopFilter}. - - - - Normalizes tokens extracted with {@link StandardTokenizer}. - - - - - Returns the next token in the stream, or null at EOS. - - - Releases resources associated with this stream. - - - The source of tokens for this filter. - - - Construct a token stream filtering the given input. - - - Close the input TokenStream. - - - Construct filtering in. - - - - - - The text source for this Tokenizer. - - - Construct a tokenizer with null input. - - - Construct a token stream processing the given input. - - - By default, closes the input Reader. - - - Constructs a tokenizer for this Reader. - - - - By default, closes the input Reader. - - - By default, closes the input Reader. - - - Describes the input token stream. - - - An integer that describes the kind of this token. This numbering - system is determined by JavaCCParser, and a table of these numbers is - stored in the file ...Constants.java. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - The string image of the token. - - - A reference to the next regular (non-special) token from the input - stream. If this is the last token from the input stream, or if the - token manager has not read tokens beyond this one, this field is - set to null. This is true only if this token is also a regular - token. Otherwise, see below for a description of the contents of - this field. - - - - This field is used to access special tokens that occur prior to this - token, but after the immediately preceding regular (non-special) token. - If there are no such special tokens, this field is set to null. - When there are more than one such special token, this field refers - to the last of these special tokens, which in turn refers to the next - previous special token through its specialToken field, and so on - until the first special token (whose specialToken field is null). - The next fields of special tokens refer to other special tokens that - immediately follow it (without an intervening regular token). If there - is no such token, this field is null. - - - - Returns the image. - - - Returns a new Token object, by default. However, if you want, you - can create and return subclass objects based on the value of ofKind. - Simply add the cases to the switch for all those special cases. - For example, if you have a subclass of Token called IDToken that - you want to create if ofKind is ID, simlpy add something like : - - case MyParserConstants.ID : return new IDToken(); - - to the following switch statement. Then you can cast matchedToken - variable to the appropriate type and use it in your lexical actions. - - - - Lexical error occured. - - - An attempt wass made to create a second instance of a static token manager. - - - Tried to change to an invalid lexical state. - - - Detected (and bailed out of) an infinite loop in the token manager. - - - Indicates the reason why the exception is thrown. It will have - one of the above 4 values. - - - - Replaces unprintable characters by their espaced (or unicode escaped) - equivalents in the given string - - - - Returns a detailed message for the Error when it is thrown by the - token manager to indicate a lexical error. - Parameters : - EOFSeen : indicates if EOF caused the lexicl error - curLexState : lexical state in which this error occured - errorLine : line number when the error occured - errorColumn : column number when the error occured - errorAfter : prefix that was seen before this error occured - curchar : the offending character - Note: You can customize the lexical error message by modifying this method. - - - - You can also modify the body of this method to customize your error messages. - For example, cases like LOOP_DETECTED and INVALID_LEXICAL_STATE are not - of end-users concern, so you can return something like : - - "Internal Error : Please file a bug report .... " - - from this method for such cases in the release version of your parser. - - - - An abstract base class for simple, character-oriented tokenizers. - - - Returns true iff a character should be included in a token. This - tokenizer generates as tokens adjacent sequences of characters which - satisfy this predicate. Characters for which this is false are used to - define token boundaries and are not included in tokens. - - - - Called on each token character to normalize it before it is added to the - token. The default implementation does nothing. Subclasses may use this - to, e.g., lowercase tokens. - - - - Returns the next token in the stream, or null at EOS. - - - - To replace accented characters in a String by unaccented equivalents. - - - "Tokenizes" the entire stream as a single token. This is useful - for data like zip codes, ids, and some product names. + + Pass this value to {@link #Obtain(long)} to try + forever to obtain the lock. - - Emits the entire input as a single token. - - - Removes words that are too long and too short from the stream. - - - David Spencer - - $Id: LengthFilter.java 347992 2005-11-21 21:41:43Z dnaber $ - - - - Build a filter that removes words that are too long or too - short from the text. - - - - Returns the next input Token whose termText() is the right len - - - A LetterTokenizer is a tokenizer that divides text at non-letters. That's - to say, it defines tokens as maximal strings of adjacent letters, as defined - by java.lang.Character.isLetter() predicate. - Note: this does a decent job for most European languages, but does a terrible - job for some Asian languages, where words are not separated by spaces. - - - - Construct a new LetterTokenizer. - - - Collects only characters which satisfy - {@link Character#isLetter(char)}. - - - - Normalizes token text to lower case. - - - $Id: LowerCaseFilter.java 150259 2004-03-29 22:48:07Z cutting $ - - - - - Construct a new LowerCaseTokenizer. - - - Collects only characters which satisfy - {@link Character#isLetter(char)}. - - - - - Constructs with default analyzer. - - - Any fields not specifically - defined to use a different analyzer will use the one provided here. - - - - Defines an analyzer to use for the specified field. - - - field name requiring a non-default analyzer - - non-default analyzer to use for field - - - - - Returns the next input Token, after being stemmed - - - - Stemmer, implementing the Porter Stemming Algorithm - - The Stemmer class transforms a word into its root form. The input - word can be provided a character at time (by calling add()), or at once - by calling one of the various stem(something) methods. - - - - reset() resets the stemmer so it can stem another word. If you invoke - the stemmer by calling add(char) and then Stem(), you must call reset() - before starting another word. - - - - Add a character to the word being stemmed. When you are finished - adding characters, you can call Stem(void) to process the word. - - - - After a word has been stemmed, it can be retrieved by toString(), - or a reference to the internal buffer can be retrieved by getResultBuffer - and getResultLength (which is generally more efficient.) - - - - Returns the length of the word resulting from the stemming process. - - - Returns a reference to a character buffer containing the results of - the stemming process. You also need to consult getResultLength() - to determine the length of the result. - - - - Stem a word provided as a String. Returns the result as a String. - - - Stem a word contained in a char[]. Returns true if the stemming process - resulted in a word different from the input. You can retrieve the - result with getResultLength()/getResultBuffer() or toString(). - - - - Stem a word contained in a portion of a char[] array. Returns - true if the stemming process resulted in a word different from - the input. You can retrieve the result with - getResultLength()/getResultBuffer() or toString(). - - - - Stem a word contained in a leading portion of a char[] array. - Returns true if the stemming process resulted in a word different - from the input. You can retrieve the result with - getResultLength()/getResultBuffer() or toString(). - - - - Stem the word placed into the Stemmer buffer through calls to add(). - Returns true if the stemming process resulted in a word different - from the input. You can retrieve the result with - getResultLength()/getResultBuffer() or toString(). - - - - Test program for demonstrating the Stemmer. It reads a file and - stems each word, writing the result to standard out. - Usage: Stemmer file-name - - - - An Analyzer that filters LetterTokenizer with LowerCaseFilter. - - - Filters LetterTokenizer with LowerCaseFilter and StopFilter. - - - An array containing some common English words that are not usually useful - for searching. - - - - Builds an analyzer which removes words in ENGLISH_STOP_WORDS. - - - Builds an analyzer with the stop words from the given set. - - - Builds an analyzer which removes words in the provided array. - - - Builds an analyzer with the stop words from the given file. - - - - - Builds an analyzer with the stop words from the given reader. - - - - - Filters LowerCaseTokenizer with StopFilter. - - - Removes stop words from a token stream. - - - Construct a token stream filtering the given input. - - - Constructs a filter which removes words from the input - TokenStream that are named in the array of words. + + How long {@link #Obtain(long)} waits, in milliseconds, + in between attempts to acquire the lock. - - Construct a token stream filtering the given input. - - - The set of Stop Words, as Strings. If ignoreCase is true, all strings should be lower cased - - -Ignore case when stopping. The stopWords set must be setup to contain only lower case words - - - - Constructs a filter which removes words from the input - TokenStream that are named in the Set. - It is crucial that an efficient Set implementation is used - for maximum performance. - - - - - - - Builds a Set from an array of stop words, - appropriate for passing into the StopFilter constructor. - This permits this stopWords construction to be cached once when - an Analyzer is constructed. - - - - - - - - - - If true, all words are lower cased first. - - a Set containing the words - - - - Returns the next input Token whose termText() is not a stop word. - - - A Token is an occurence of a term from the text of a field. It consists of - a term's text, the start and end offset of the term in the text of the field, - and a type string. - The start and end offsets permit applications to re-associate a token with - its source text, e.g., to display highlighted query terms in a document - browser, or to show matching text fragments in a KWIC (KeyWord In Context) - display, etc. - The type is an interned string, assigned by a lexical analyzer - (a.k.a. tokenizer), naming the lexical or syntactic class that the token - belongs to. For example an end of sentence marker token might be implemented - with type "eos". The default token type is "word". - - - - - - - Returns the position increment of this Token. - - - - - Returns the Token's term text. - - - Returns this Token's starting offset, the position of the first character - corresponding to this token in the source text. - Note that the difference between endOffset() and startOffset() may not be - equal to termText.length(), as the term text may have been altered by a - stemmer or some other filter. - - - - Returns this Token's ending offset, one greater than the position of the - last character corresponding to this token in the source text. - - - - Returns this Token's lexical type. Defaults to "word". - - - An Analyzer that uses WhitespaceTokenizer. - - - A WhitespaceTokenizer is a tokenizer that divides text at whitespace. - Adjacent sequences of non-Whitespace characters form tokens. - - - - Construct a new WhitespaceTokenizer. - - - Collects only characters which do not satisfy - {@link Character#isWhitespace(char)}. - - - - Loader for text files that represent a list of stopwords. - - - Gerhard Schwarz - - $Id: WordlistLoader.java 192989 2005-06-22 19:59:03Z dnaber $ - - - - Loads a text file and adds every line as an entry to a HashSet (omitting - leading and trailing whitespace). Every line of the file should contain only - one word. The words need to be in lowercase if you make use of an - Analyzer which uses LowerCaseFilter (like StandardAnalyzer). - - - File containing the wordlist - - A HashSet with the file's words - - - - Reads lines from a Reader and adds every line as an entry to a HashSet (omitting - leading and trailing whitespace). Every line of the Reader should contain only - one word. The words need to be in lowercase if you make use of an - Analyzer which uses LowerCaseFilter (like StandardAnalyzer). - - - Reader containing the wordlist - - A HashSet with the reader's words - - - - Builds a wordlist table, using words as both keys and values - for backward compatibility. - - - stopword set - - - - - Converts a Date to a string suitable for indexing. - RuntimeException if the date specified in the - method argument is before 1970 - - - - Converts a millisecond time to a string suitable for indexing. - RuntimeException if the time specified in the - method argument is negative, that is, before 1970 - - - - Converts a string-encoded date into a millisecond time. - - - Converts a string-encoded date into a Date object. - - - - Converts a Date to a string suitable for indexing. - - - the date to be converted - - the desired resolution, see - {@link #Round(Date, DateTools.Resolution)} - - a string in format yyyyMMddHHmmssSSS or shorter, - depeding on resolution - - - - Converts a millisecond time to a string suitable for indexing. - - - the date expressed as milliseconds since January 1, 1970, 00:00:00 GMT - - the desired resolution, see - {@link #Round(long, DateTools.Resolution)} - - a string in format yyyyMMddHHmmssSSS or shorter, - depeding on resolution; using UTC as timezone - - - - Converts a string produced by timeToString or - DateToString back to a time, represented as the - number of milliseconds since January 1, 1970, 00:00:00 GMT. - - - the date string to be converted - - the number of milliseconds since January 1, 1970, 00:00:00 GMT - - ParseException if dateString is not in the - expected format - - - - Converts a string produced by timeToString or - DateToString back to a time, represented as a - Date object. - - - the date string to be converted - - the parsed time as a Date object - - ParseException if dateString is not in the - expected format - - - - Limit a date's resolution. For example, the date 2004-09-21 13:50:11 - will be changed to 2004-09-01 00:00:00 when using - Resolution.MONTH. - - - The desired resolution of the date to be returned - - the date with all values more precise than resolution - set to 0 or 1 - - - - Limit a date's resolution. For example, the date 1095767411000 - (which represents 2004-09-21 13:50:11) will be changed to - 1093989600000 (2004-09-01 00:00:00) when using - Resolution.MONTH. - - - The desired resolution of the date to be returned - - the date with all values more precise than resolution - set to 0 or 1, expressed as milliseconds since January 1, 1970, 00:00:00 GMT - - - - Specifies the time granularity. - - - - Constructs a new document with no fields. - - - Returns the number of fields in this document - Added as a helper for Lucene.Net - - - - -

Adds a field to a document. Several fields may be added with - the same name. In this case, if the fields are indexed, their text is - treated as though appended for the purposes of search.

-

Note that add like the removeField(s) methods only makes sense - prior to adding a document to an index. These methods cannot - be used to change the content of an existing index! In order to achieve this, - a document has to be deleted from an index and a new changed version of that - document has to be added.

- - - -

Removes field with the specified name from the document. - If multiple fields exist with this name, this method removes the first field that has been added. - If there is no field with the specified name, the document remains unchanged.

-

Note that the removeField(s) methods like the add method only make sense - prior to adding a document to an index. These methods cannot - be used to change the content of an existing index! In order to achieve this, - a document has to be deleted from an index and a new changed version of that - document has to be added.

- - - -

Removes all fields with the given name from the document. - If there is no field with the specified name, the document remains unchanged.

-

Note that the removeField(s) methods like the add method only make sense - prior to adding a document to an index. These methods cannot - be used to change the content of an existing index! In order to achieve this, - a document has to be deleted from an index and a new changed version of that - document has to be added.

- - - - Returns a field with the given name if any exist in this document, or - null. If multiple fields exists with this name, this method returns the - first value added. - - - - Returns the string value of the field with the given name if any exist in - this document, or null. If multiple fields exist with this name, this - method returns the first value added. If only binary fields with this name - exist, returns null. - - - - Returns an Enumeration of all the fields in a document. - - - Returns an array of {@link Field}s with the given name. - This method can return null. - - - the name of the field - - a Field[] array - - - - Returns an array of values of the field specified as the method parameter. - This method can return null. - - - the name of the field - - a String[] of field values - - - - Returns an array of byte arrays for of the fields that have the name specified - as the method parameter. This method will return null if no - binary fields with the specified name are available. - - - the name of the field - - a byte[][] of binary field values. - - - - Returns an array of bytes for the first (or only) field that has the name - specified as the method parameter. This method will return null - if no binary fields with the specified name are available. - There may be non-binary fields with the same name. - - - the name of the field. - - a byte[] containing the binary field value. - - - - Prints the fields of a document for human consumption. - - - A field is a section of a Document. Each field has two parts, a name and a - value. Values may be free text, provided as a String or as a Reader, or they - may be atomic keywords, which are not further processed. Such keywords may - be used to represent dates, urls, etc. Fields are optionally stored in the - index, so that they may be returned with hits on the document. - - - - - - Returns the name of the field as an interned string. - For example "date", "title", "body", ... - - - - The value of the field as a String, or null. If null, the Reader value - or binary value is used. Exactly one of stringValue(), readerValue(), and - binaryValue() must be set. - - - - The value of the field as a Reader, or null. If null, the String value - or binary value is used. Exactly one of stringValue(), readerValue(), - and binaryValue() must be set. - - - - The value of the field in Binary, or null. If null, the Reader or - String value is used. Exactly one of stringValue(), readerValue() and - binaryValue() must be set. - - - - Create a field by specifying its name, value and how it will - be saved in the index. Term vectors will not be stored in the index. - - - The name of the field - - The string to process - - Whether value should be stored in the index - - Whether the field should be indexed, and if so, if it should - be tokenized before indexing - - NullPointerException if name or value is null - IllegalArgumentException if the field is neither stored nor indexed - - - Create a field by specifying its name, value and how it will - be saved in the index. - - - The name of the field - - The string to process - - Whether value should be stored in the index - - Whether the field should be indexed, and if so, if it should - be tokenized before indexing - - Whether term vector should be stored - - NullPointerException if name or value is null - IllegalArgumentException in any of the following situations: -
    -
  • the field is neither stored nor indexed
    • -
  • the field is not indexed but termVector is TermVector.YES
    • -
- - - - Create a tokenized and indexed field that is not stored. Term vectors will - not be stored. - - - The name of the field - - The reader with the content - - NullPointerException if name or reader is null - - - Create a tokenized and indexed field that is not stored, optionally with - storing term vectors. - - - The name of the field - - The reader with the content - - Whether term vector should be stored - - NullPointerException if name or reader is null - - - Create a stored field with binary value. Optionally the value may be compressed. - - - The name of the field - - The binary value - - How value should be stored (compressed or not.) - - IllegalArgumentException if store is Store.NO - - - True iff the value of the field is to be stored in the index for return - with search hits. It is an error for this to be true if a field is - Reader-valued. - - - - True iff the value of the field is to be indexed, so that it may be - searched on. - - - - True iff the value of the field should be tokenized as text prior to - indexing. Un-tokenized fields are indexed as a single word and may not be - Reader-valued. - - - - True if the value of the field is stored and compressed within the index - - - True iff the term or terms used to index this field are stored as a term - vector, available from {@link IndexReader#GetTermFreqVector(int,String)}. - These methods do not provide access to the original content of the field, - only to terms used to index it. If the original content must be - preserved, use the stored attribute instead. - - - - - - - True iff terms are stored as term vector together with their offsets - (start and end positon in source text). - - - - True iff terms are stored as term vector together with their token positions. - - - True iff the value of the filed is stored as binary - - - True if norms are omitted for this indexed field - - - Expert: - - If set, omit normalization factors associated with this indexed field. - This effectively disables indexing boosts and length normalization for this field. - - - - Prints a Field for human consumption. - - - Specifies whether and how a field should be stored. - - - A serializable Enum class. - - - Resolves the deserialized instance to the local reference for accurate - equals() and == comparisons. - - - a reference to Parameter as resolved in the local VM - - ObjectStreamException - - - Store the original field value in the index in a compressed form. This is - useful for long documents and for binary valued fields. - - - - Store the original field value in the index. This is useful for short texts - like a document's title which should be displayed with the results. The - value is stored in its original form, i.e. no analyzer is used before it is - stored. - - - - Do not store the field value in the index. - - - Specifies whether and how a field should be indexed. - - - Do not index the field value. This field can thus not be searched, - but one can still access its contents provided it is - {@link Field.Store stored}. - - - - Index the field's value so it can be searched. An Analyzer will be used - to tokenize and possibly further normalize the text before its - terms will be stored in the index. This is useful for common text. - - - - Index the field's value without using an Analyzer, so it can be searched. - As no analyzer is used the value will be stored as a single term. This is - useful for unique Ids like product numbers. - - - - Index the field's value without an Analyzer, and disable - the storing of norms. No norms means that index-time boosting - and field length normalization will be disabled. The benefit is - less memory usage as norms take up one byte per indexed field - for every document in the index. - - - - Specifies whether and how a field should have term vectors. - - - Do not store term vectors. - - - Store the term vectors of each document. A term vector is a list - of the document's terms and their number of occurences in that document. - - - - Store the term vector + token position information - - - - - - - Store the term vector + Token offset information - - - - - - - Store the term vector + Token position and offset information - - - - - - - - - - - - Equivalent to longToString(Long.MIN_VALUE) - - - Equivalent to longToString(Long.MAX_VALUE) - - - The length of (all) strings returned by {@link #longToString} - - - Converts a long to a String suitable for indexing. - - - Converts a String that was returned by {@link #longToString} back to a - long. - - - IllegalArgumentException - if the input is null - - NumberFormatException - if the input does not parse (it was not a String returned by - longToString()). - - - - Class for accessing a compound stream. - This class implements a directory, but is limited to only read operations. - Directory methods that would normally modify data throw an exception. - - - Dmitry Serebrennikov - - $Id: CompoundFileReader.java 208905 2005-07-03 10:40:01Z dnaber $ - - - - - Returns an array of strings, one for each file in the directory. - - - Returns true iff a file with the given name exists. - - - Returns the time the named file was last modified. - - - Set the modified time of an existing file to now. - - - Removes an existing file in the directory. - - - Renames an existing file in the directory. - If a file already exists with the new name, then it is replaced. - This replacement should be atomic. - - - - Returns the length of a file in the directory. - - - Creates a new, empty file in the directory with the given name. - Returns a stream writing this file. - - - - Returns a stream reading an existing file. - - - Construct a {@link Lock}. - the name of the lock file - - - - Closes the store. - - - Returns an array of strings, one for each file in the directory. - - - Returns true iff a file with the given name exists. - - - Returns the time the compound file was last modified. - - - Set the modified time of the compound file to now. - - - Not implemented - UnsupportedOperationException - - - Not implemented - UnsupportedOperationException - - - Returns the length of a file in the directory. - IOException if the file does not exist - - - Not implemented - UnsupportedOperationException - - - Not implemented - UnsupportedOperationException - - - Implementation of an IndexInput that reads from a portion of the - compound file. The visibility is left as "package" *only* because - this helps with testing since JUnit test cases in a different class - can then access package fields of this class. - - - - Base implementation class for buffered {@link IndexInput}. - - - Abstract base class for input from a file in a {@link Directory}. A - random-access input stream. Used for all Lucene index input operations. - - - - - - Reads and returns a single byte. - - - - - Reads a specified number of bytes into an array at the specified offset. - the array to read bytes into - - the offset in the array to start storing bytes - - the number of bytes to read - - - - - - Reads four bytes and returns an int. - - - - - Reads an int stored in variable-length format. Reads between one and - five bytes. Smaller values take fewer bytes. Negative numbers are not - supported. - - - - - - Reads eight bytes and returns a long. - - - - - Reads a long stored in variable-length format. Reads between one and - nine bytes. Smaller values take fewer bytes. Negative numbers are not - supported. - - - - Reads a string. - - - - - Reads UTF-8 encoded characters into an array. - the array to read characters into - - the offset in the array to start storing characters - - the number of characters to read - - - - - - Closes the stream to futher operations. - - - Returns the current position in this file, where the next read will - occur. - - - - - - Sets current position in this file, where the next read will occur. - - - - - The number of bytes in the file. - - - - Expert: implements buffer refill. Reads bytes from the current position - in the input. - - the array to read bytes into - - the offset in the array to start storing bytes - - the number of bytes to read - - - - Expert: implements seek. Sets current position in this file, where the - next {@link #ReadInternal(byte[],int,int)} will occur. - - - - - - Expert: implements buffer refill. Reads bytes from the current - position in the input. - - the array to read bytes into - - the offset in the array to start storing bytes - - the number of bytes to read - - - - Expert: implements seek. Sets current position in this file, where - the next {@link #ReadInternal(byte[],int,int)} will occur. - - - - - - Closes the stream to further operations. - - - - Create the compound stream in the specified file. The file name is the - entire name (no extensions are added). - - NullPointerException if dir or name is null - - - Returns the directory of the compound file. - - - Returns the name of the compound file. - - - Add a source stream. file is the string by which the - sub-stream will be known in the compound stream. - - - IllegalStateException if this writer is closed - NullPointerException if file is null - IllegalArgumentException if a file with the same name - has been added already - - - - Merge files with the extensions added up to now. - All files with these extensions are combined sequentially into the - compound stream. After successful merge, the source files - are deleted. - - IllegalStateException if close() had been called before or - if no file has been added to this object - - - - Copy the contents of the file with specified extension into the - provided output stream. Use the provided buffer for moving data - to reduce memory allocation. - - - - source file - - - temporary holder for the start of directory entry for this file - - - temporary holder for the start of this file's data section - - - This ctor used by test code only. - - - The directory to write the document information to - - The analyzer to use for the document - - The Similarity function - - The maximum number of tokens a field may have - - - - If non-null, a message will be printed to this if maxFieldLength is reached. - - - Access to the Field Info file that describes document fields and whether or - not they are indexed. Each segment has a separate Field Info file. Objects - of this class are thread-safe for multiple readers, but only one thread can - be adding documents at a time, with no other reader or writer threads - accessing this object. - - - - Construct a FieldInfos object using the directory and the name of the file - IndexInput - - The directory to open the IndexInput from - - The name of the file to open the IndexInput from in the Directory - - IOException - - - Adds field info for a Document. - - - Add fields that are indexed. Whether they have termvectors has to be specified. - - - The names of the fields - - Whether the fields store term vectors or not - - treu if positions should be stored. - - true if offsets should be stored - - - - Assumes the fields are not storing term vectors. - - - The names of the fields - - Whether the fields are indexed or not - - - - - - - Calls 5 parameter add with false for all TermVector parameters. - - - The name of the Field - - true if the field is indexed - - - - - - Calls 5 parameter add with false for term vector positions and offsets. - - - The name of the field - - true if the field is indexed - - true if the term vector should be stored - - - - If the field is not yet known, adds it. If it is known, checks to make - sure that the isIndexed flag is the same as was given previously for this - field. If not - marks it as being indexed. Same goes for the TermVector - parameters. - - - The name of the field - - true if the field is indexed - - true if the term vector should be stored - - true if the term vector with positions should be stored - - true if the term vector with offsets should be stored - - - - If the field is not yet known, adds it. If it is known, checks to make - sure that the isIndexed flag is the same as was given previously for this - field. If not - marks it as being indexed. Same goes for the TermVector - parameters. - - - The name of the field - - true if the field is indexed - - true if the term vector should be stored - - true if the term vector with positions should be stored - - true if the term vector with offsets should be stored - - true if the norms for the indexed field should be omitted - - - - Return the fieldName identified by its number. - - - - - the fieldName or an empty string when the field - with the given number doesn't exist. - - - - Return the fieldinfo object referenced by the fieldNumber. - - - the FieldInfo object or null when the given fieldNumber - doesn't exist. - - - - Class responsible for access to stored document fields. - - It uses <segment>.fdt and <segment>.fdx; files. - - - $Id: FieldsReader.java 329524 2005-10-30 05:38:46Z yonik $ - - - - A FilterIndexReader contains another IndexReader, which it - uses as its basic source of data, possibly transforming the data along the - way or providing additional functionality. The class - FilterIndexReader itself simply implements all abstract methods - of IndexReader with versions that pass all requests to the - contained index reader. Subclasses of FilterIndexReader may - further override some of these methods and may also provide additional - methods and fields. - - - - - Constructor used if IndexReader is not owner of its directory. - This is used for IndexReaders that are used within other IndexReaders that take care or locking directories. - - - Directory where IndexReader files reside. - - - - Constructor used if IndexReader is owner of its directory. - If IndexReader is owner of its directory, it locks its directory in case of write operations. - - - Directory where IndexReader files reside. - - Used for write-l - - - - - - Returns an IndexReader reading the index in an FSDirectory in the named - path. - - - - Returns an IndexReader reading the index in an FSDirectory in the named - path. - - - - Returns an IndexReader reading the index in the given Directory. - - - Returns the directory this index resides in. - - - Returns the time the index in the named directory was last modified. - Do not use this to check whether the reader is still up-to-date, use - {@link #IsCurrent()} instead. - - - - Returns the time the index in the named directory was last modified. - Do not use this to check whether the reader is still up-to-date, use - {@link #IsCurrent()} instead. - - - - Returns the time the index in the named directory was last modified. - Do not use this to check whether the reader is still up-to-date, use - {@link #IsCurrent()} instead. - - - - Reads version number from segments files. The version number is - initialized with a timestamp and then increased by one for each change of - the index. - - - where the index resides. - - version number. - - IOException if segments file cannot be read - - - Reads version number from segments files. The version number is - initialized with a timestamp and then increased by one for each change of - the index. - - - where the index resides. - - version number. - - IOException if segments file cannot be read - - - Reads version number from segments files. The version number is - initialized with a timestamp and then increased by one for each change of - the index. - - - where the index resides. - - version number. - - IOException if segments file cannot be read. - - - Version number when this IndexReader was opened. - - - Check whether this IndexReader still works on a current version of the index. - If this is not the case you will need to re-open the IndexReader to - make sure you see the latest changes made to the index. - - - IOException - - - Return an array of term frequency vectors for the specified document. - The array contains a vector for each vectorized field in the document. - Each vector contains terms and frequencies for all terms in a given vectorized field. - If no such fields existed, the method returns null. The term vectors that are - returned my either be of type TermFreqVector or of type TermPositionsVector if - positions or offsets have been stored. - - - document for which term frequency vectors are returned - - array of term frequency vectors. May be null if no term vectors have been - stored for the specified document. - - IOException if index cannot be accessed - - - - - Return a term frequency vector for the specified document and field. The - returned vector contains terms and frequencies for the terms in - the specified field of this document, if the field had the storeTermVector - flag set. If termvectors had been stored with positions or offsets, a - TermPositionsVector is returned. - - - document for which the term frequency vector is returned - - field for which the term frequency vector is returned. - - term frequency vector May be null if field does not exist in the specified - document or term vector was not stored. - - IOException if index cannot be accessed - - - - - Returns true if an index exists at the specified directory. - If the directory does not exist or if there is no index in it. - false is returned. - - the directory to check for an index - - true if an index exists; false otherwise - - - - Returns true if an index exists at the specified directory. - If the directory does not exist or if there is no index in it. - - the directory to check for an index - - true if an index exists; false otherwise - - - - Returns true if an index exists at the specified directory. - If the directory does not exist or if there is no index in it. - - the directory to check for an index - - true if an index exists; false otherwise - - IOException if there is a problem with accessing the index - - - Returns the number of documents in this index. - - - Returns one greater than the largest possible document number. - This may be used to, e.g., determine how big to allocate an array which - will have an element for every document number in an index. - - - - Returns the stored fields of the nth - Document in this index. - - - - Returns true if document n has been deleted - - - Returns true if any documents have been deleted - - - Returns true if there are norms stored for this field. - - - Returns the byte-encoded normalization factor for the named field of - every document. This is used by the search code to score documents. - - - - - - - Reads the byte-encoded normalization factor for the named field of every - document. This is used by the search code to score documents. - - - - - - - Expert: Resets the normalization factor for the named field of the named - document. The norm represents the product of the field's {@link - Field#SetBoost(float) boost} and its {@link Similarity#LengthNorm(String, - int) length normalization}. Thus, to preserve the length normalization - values when resetting this, one should base the new value upon the old. - - - - - - - - - Implements setNorm in subclass. - - - Expert: Resets the normalization factor for the named field of the named - document. - - - - - - - - - Returns an enumeration of all the terms in the index. - The enumeration is ordered by Term.compareTo(). Each term - is greater than all that precede it in the enumeration. - - - - Returns an enumeration of all terms after a given term. - The enumeration is ordered by Term.compareTo(). Each term - is greater than all that precede it in the enumeration. - - - - Returns the number of documents containing the term t. - - - - Returns an unpositioned {@link TermDocs} enumerator. - - - - Returns an unpositioned {@link TermPositions} enumerator. - - - Tries to acquire the WriteLock on this directory. - this method is only valid if this IndexReader is directory owner. - - - IOException If WriteLock cannot be acquired. - - - Deletes the document numbered docNum. Once a document is - deleted it will not appear in TermDocs or TermPostitions enumerations. - Attempts to read its field with the {@link #document} - method will result in an error. The presence of this document may still be - reflected in the {@link #docFreq} statistic, though - this will be corrected eventually as the index is further modified. - - - - Implements deletion of the document numbered docNum. - Applications should call {@link #DeleteDocument(int)} or {@link #DeleteDocuments(Term)}. - - - - Deletes all documents containing term. - This is useful if one uses a document field to hold a unique ID string for - the document. Then to delete such a document, one merely constructs a - term with the appropriate field and the unique ID string as its text and - passes it to this method. - See {@link #Delete(int)} for information about when this deletion will - become effective. - - the number of documents deleted - - - - Undeletes all documents currently marked as deleted in this index. - - - Implements actual undeleteAll() in subclass. - - - Commit changes resulting from delete, undeleteAll, or setNorm operations - - - IOException - - - Implements commit. - - - Closes files associated with this index. - Also saves any new deletions to disk. - No other methods should be called after this has been called. - - - - Implements close. - - - Release the write lock, if needed. - - - Get a list of unique field names that exist in this index and have the specified - field option information. - - specifies which field option should be available for the returned fields - - Collection of Strings indicating the names of the fields. - - - - - - Returns true iff the index in the named directory is - currently locked. - - the directory to check for a lock - - IOException if there is a problem with accessing the index - - - Returns true iff the index in the named directory is - currently locked. - - the directory to check for a lock - - IOException if there is a problem with accessing the index - - - - Prints the filename and size of each file within a given compound file. - Add the -extract flag to extract files to the current working directory. - In order to make the extracted version of the index work, you have to copy - the segments file from the compound index into the directory where the extracted files are stored. - - Usage: Lucene.Net.index.IndexReader [-extract] <cfsfile> - - - - Utility class for executing code with exclusive access. - - Attempts to obtain exclusive access and immediately return upon success or failure. @@ -2030,16 +234,29 @@ true iff exclusive access is obtained - - Attempts to obtain an exclusive lock within amount - of time given. Currently polls once per second until - lockWaitTimeout is passed. + + If a lock obtain called, this failureReason may be set + with the "root cause" Exception as to why the lock was + not obtained. - length of time to wait in ms + + + Attempts to obtain an exclusive lock within amount of + time given. Polls once per {@link #LOCK_POLL_INTERVAL} + (currently 1000) milliseconds until lockWaitTimeout is + passed. + + length of time to wait in + milliseconds or {@link + #LOCK_OBTAIN_WAIT_FOREVER} to retry forever true if lock was obtained - IOException if lock wait times out or obtain() throws an IOException + LockObtainFailedException if lock wait times out + IllegalArgumentException if lockWaitTimeout is + out of bounds + + IOException if obtain() throws IOException Releases exclusive access. @@ -2058,1161 +275,1391 @@ Code to execute with exclusive access. - + Calls {@link #doBody} while lock is obtained. Blocks if lock cannot be obtained immediately. Retries to obtain lock once per second until it is obtained, or until it has tried ten times. Lock is released when - {@link #doBody} exits. + {@link #doBody} exits. - - -

Construct a FilterIndexReader based on the specified base reader. - Directory locking for delete, undeleteAll, and setNorm operations is - left to the base reader.

-

Note that base reader is closed if this FilterIndexReader is closed.

+ LockObtainFailedException if lock could not + be obtained - specified base reader. - + IOException if {@link Lock#obtain} throws IOException - - Base class for filtering {@link TermDocs} implementations. - - - - Sets this to the data for a term. - The enumeration is reset to the start of the data for this term. - - - - Sets this to the data for the current term in a {@link TermEnum}. - This may be optimized in some implementations. - - - - - - - - - Frees associated resources. - - - Base class for filtering {@link TermPositions} implementations. - - - - - Base class for filtering {@link TermEnum} implementations. - - - - Increments the enumeration to the next element. True if one exists. - - - Returns the current Term in the enumeration. - - - Returns the docFreq of the current Term in the enumeration. - - - Closes the enumeration to further activity, freeing resources. - - - - Filename filter that accept filenames and extensions only created by Lucene. + + Implements the wildcard search query. Supported wildcards are *, which + matches any character sequence (including the empty one), and ?, + which matches any single character. Note this query can be slow, as it + needs to iterate over many terms. In order to prevent extremely slow WildcardQueries, + a Wildcard term should not start with one of the wildcards * or + ?. + +

This query uses the {@link + MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} + rewrite method.

- Daniel Naber / Bernhard Messer - - $rcs = ' $Id: Exp $ ' ; - - - - Useful constants representing filenames and extensions used by lucene - - - Bernhard Messer - - $rcs = ' $Id: Exp $ ' ; - - - - Name of the index segment file - - - Name of the index deletable file - - - This array contains all filename extensions used by Lucene's index files, with - one exception, namely the extension made up from .f + a number. - Also note that two of Lucene's files (deletable and - segments) don't have any filename extension. - - - - File extensions of old-style index files - - - File extensions for term vector support - - - - Open an index with write access. - - - the index directory - - the analyzer to use for adding new documents - - true to create the index or overwrite the existing one; - false to append to the existing index - - - - Open an index with write access. - - - the index directory - - the analyzer to use for adding new documents - - true to create the index or overwrite the existing one; - false to append to the existing index - - - - Open an index with write access. - - - the index directory - - the analyzer to use for adding new documents - - true to create the index or overwrite the existing one; - false to append to the existing index - - - - Initialize an IndexWriter. - IOException - - - Throw an IllegalStateException if the index is closed. - IllegalStateException - - - Close the IndexReader and open an IndexWriter. - IOException - - - Close the IndexWriter and open an IndexReader. - IOException - - - Make sure all changes are written to disk. - IOException - - - Adds a document to this index, using the provided analyzer instead of the - one specific in the constructor. If the document contains more than - {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are - discarded. - - + - IllegalStateException if the index is closed - - Adds a document to this index. If the document contains more than - {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are - discarded. + + An abstract {@link Query} that matches documents + containing a subset of terms provided by a {@link + FilteredTermEnum} enumeration. + +

This query cannot be used directly; you must subclass + it and define {@link #getEnum} to provide a {@link + FilteredTermEnum} that iterates through the terms to be + matched. + +

NOTE: if {@link #setRewriteMethod} is either + {@link #CONSTANT_SCORE_BOOLEAN_QUERY_REWRITE} or {@link + #SCORING_BOOLEAN_QUERY_REWRITE}, you may encounter a + {@link BooleanQuery.TooManyClauses} exception during + searching, which happens when the number of terms to be + searched exceeds {@link + BooleanQuery#GetMaxClauseCount()}. Setting {@link + #setRewriteMethod} to {@link #CONSTANT_SCORE_FILTER_REWRITE} + prevents this. + +

The recommended rewrite method is {@link + #CONSTANT_SCORE_AUTO_REWRITE_DEFAULT}: it doesn't spend CPU + computing unhelpful scores, and it tries to pick the most + performant rewrite method given the query. + + Note that {@link QueryParser} produces + MultiTermQueries using {@link + #CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} by default.

- + + + The abstract base class for queries. +

Instantiable subclasses are: +

    +
  • {@link TermQuery}
    • +
  • {@link MultiTermQuery}
    • +
  • {@link BooleanQuery}
    • +
  • {@link WildcardQuery}
    • +
  • {@link PhraseQuery}
    • +
  • {@link PrefixQuery}
    • +
  • {@link MultiPhraseQuery}
    • +
  • {@link FuzzyQuery}
    • +
  • {@link TermRangeQuery}
    • +
  • {@link NumericRangeQuery}
    • +
  • {@link Lucene.Net.Search.Spans.SpanQuery}
    • +
+

A parser for queries is contained in: +

    +
  • {@link Lucene.Net.QueryParsers.QueryParser QueryParser}
    • +
+ + + + Sets the boost for this query clause to b. Documents + matching this clause will (in addition to the normal weightings) have + their score multiplied by b. + + + + Gets the boost for this clause. Documents matching + this clause will (in addition to the normal weightings) have their score + multiplied by b. The boost is 1.0 by default. + + + + Prints a query to a string, with field assumed to be the + default field and omitted. +

The representation used is one that is supposed to be readable + by {@link Lucene.Net.QueryParsers.QueryParser QueryParser}. However, + there are the following limitations: +

    +
  • If the query was created by the parser, the printed + representation may not be exactly what was parsed. For example, + characters that need to be escaped will be represented without + the required backslash.
    • +
  • Some of the more complicated queries (e.g. span queries) + don't have a representation that can be parsed by QueryParser.
    • +
+ + + + Prints a query to a string. + + + Expert: Constructs an appropriate Weight implementation for this query. + +

+ Only implemented by primitive queries, which re-write to themselves. +

+ + + Expert: Constructs and initializes a Weight for a top-level query. + + + Expert: called to re-write queries into primitive queries. For example, + a PrefixQuery will be rewritten into a BooleanQuery that consists + of TermQuerys. + + + + Expert: called when re-writing queries under MultiSearcher. + + Create a single query suitable for use by all subsearchers (in 1-1 + correspondence with queries). This is an optimization of the OR of + all queries. We handle the common optimization cases of equal + queries and overlapping clauses of boolean OR queries (as generated + by MultiTermQuery.rewrite()). + Be careful overriding this method as queries[0] determines which + method will be called and is not necessarily of the same type as + the other queries. + + + + Expert: adds all terms occuring in this query to the terms set. Only + works if this query is in its {@link #rewrite rewritten} form. + + + UnsupportedOperationException if this query is not yet rewritten + + + Expert: merges the clauses of a set of BooleanQuery's into a single + BooleanQuery. + +

A utility for use by {@link #Combine(Query[])} implementations. +

+ + + Expert: Returns the Similarity implementation to be used for this query. + Subclasses may override this method to specify their own Similarity + implementation, perhaps one that delegates through that of the Searcher. + By default the Searcher's Similarity implementation is returned. + + + + Returns a clone of this query. + + + A rewrite method that first creates a private Filter, + by visiting each term in sequence and marking all docs + for that term. Matching documents are assigned a + constant score equal to the query's boost. + +

This method is faster than the BooleanQuery + rewrite methods when the number of matched terms or + matched documents is non-trivial. Also, it will never + hit an errant {@link BooleanQuery.TooManyClauses} + exception. + +

+ - IllegalStateException if the index is closed - - Deletes all documents containing term. - This is useful if one uses a document field to hold a unique ID string for - the document. Then to delete such a document, one merely constructs a - term with the appropriate field and the unique ID string as its text and - passes it to this method. Returns the number of documents deleted. + + A rewrite method that first translates each term into + {@link BooleanClause.Occur#SHOULD} clause in a + BooleanQuery, and keeps the scores as computed by the + query. Note that typically such scores are + meaningless to the user, and require non-trivial CPU + to compute, so it's almost always better to use {@link + #CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} instead. + +

NOTE: This rewrite method will hit {@link + BooleanQuery.TooManyClauses} if the number of terms + exceeds {@link BooleanQuery#getMaxClauseCount}. +

- the number of documents deleted + + + + + Like {@link #SCORING_BOOLEAN_QUERY_REWRITE} except + scores are not computed. Instead, each matching + document receives a constant score equal to the + query's boost. + +

NOTE: This rewrite method will hit {@link + BooleanQuery.TooManyClauses} if the number of terms + exceeds {@link BooleanQuery#getMaxClauseCount}. + +

+ + + + + Read-only default instance of {@link + ConstantScoreAutoRewrite}, with {@link + ConstantScoreAutoRewrite#setTermCountCutoff} set to + {@link + ConstantScoreAutoRewrite#DEFAULT_TERM_COUNT_CUTOFF} + and {@link + ConstantScoreAutoRewrite#setDocCountPercent} set to + {@link + ConstantScoreAutoRewrite#DEFAULT_DOC_COUNT_PERCENT}. + Note that you cannot alter the configuration of this + instance; you'll need to create a private instance + instead. + + + + Constructs a query for terms matching term. + check sub class for possible term access - the Term does not + make sense for all MultiTermQuerys and will be removed. + + + + Constructs a query matching terms that cannot be represented with a single + Term. + + + + Returns the pattern term. + check sub class for possible term access - getTerm does not + make sense for all MultiTermQuerys and will be removed. + + + + Construct the enumeration to be used, expanding the pattern term. + + + Expert: Return the number of unique terms visited during execution of the query. + If there are many of them, you may consider using another query type + or optimize your total term count in index. +

This method is not thread safe, be sure to only call it when no query is running! + If you re-use the same query instance for another + search, be sure to first reset the term counter + with {@link #clearTotalNumberOfTerms}. +

On optimized indexes / no MultiReaders, you get the correct number of + unique terms for the whole index. Use this number to compare different queries. + For non-optimized indexes this number can also be achived in + non-constant-score mode. In constant-score mode you get the total number of + terms seeked for all segments / sub-readers. +

+ + + + + Expert: Resets the counting of unique terms. + Do this before executing the query/filter. + + + + + + + + + + Sets the rewrite method to be used when executing the + query. You can use one of the four core methods, or + implement your own subclass of {@link RewriteMethod}. + + + + A rewrite method that tries to pick the best + constant-score rewrite method based on term and + document counts from the query. If both the number of + terms and documents is small enough, then {@link + #CONSTANT_SCORE_BOOLEAN_QUERY_REWRITE} is used. + Otherwise, {@link #CONSTANT_SCORE_FILTER_REWRITE} is + used. + + + + Abstract class that defines how the query is rewritten. + + + If the number of terms in this query is equal to or + larger than this setting then {@link + #CONSTANT_SCORE_FILTER_REWRITE} is used. + + + + + + + + If the number of documents to be visited in the + postings exceeds this specified percentage of the + maxDoc() for the index, then {@link + #CONSTANT_SCORE_FILTER_REWRITE} is used. + + 0.0 to 100.0 + + + + + + + + Returns the pattern term. + + + Prints a user-readable version of this query. + + + Represents hits returned by {@link + * Searcher#search(Query,Filter,int)} and {@link + * Searcher#search(Query,int) + + + + The total number of hits for the query. + + + + + The top hits for the query. + + + Stores the maximum score value encountered, needed for normalizing. + + + Returns the maximum score value encountered. Note that in case + scores are not tracked, this returns {@link Float#NaN}. + + + + Sets the maximum score value encountered. + + + Constructs a TopDocs with a default maxScore=Float.NaN. + + + + + + Base class for span-based queries. + + + Expert: Returns the matches for this query in an index. Used internally + to search for spans. + + + + Returns the name of the field matched by this query. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + + Abstract base class providing a mechanism to restrict searches to a subset + of an index and also maintains and returns position information. + This is useful if you want to compare the positions from a SpanQuery with the positions of items in + a filter. For instance, if you had a SpanFilter that marked all the occurrences of the word "foo" in documents, + and then you entered a new SpanQuery containing bar, you could not only filter by the word foo, but you could + then compare position information for post processing. + + + + Abstract base class for restricting which documents may be returned during searching. +

+ Note: In Lucene 3.0 {@link #Bits(IndexReader)} will be removed + and {@link #GetDocIdSet(IndexReader)} will be defined as abstract. + All implementing classes must therefore implement {@link #GetDocIdSet(IndexReader)} + in order to work with Lucene 3.0. +

+ + + + + Creates a {@link DocIdSet} enumerating the documents that should be + permitted in search results. NOTE: null can be + returned if no documents are accepted by this Filter. +

+ Note: This method will be called once per segment in + the index during searching. The returned {@link DocIdSet} + must refer to document IDs for that segment, not for + the top-level reader. + + @param reader a {@link IndexReader} instance opened on the index currently + searched on. Note, it is likely that the provided reader does not + represent the whole underlying index i.e. if the index has more than + one segment the given reader only represents a single segment. + +

+ a DocIdSet that provides the documents which should be permitted or + prohibited in search results. NOTE: null can be returned if + no documents will be accepted by this Filter. + + + + + + Returns a SpanFilterResult with true for documents which should be permitted in + search results, and false for those that should not and Spans for where the true docs match. + + The {@link Lucene.Net.Index.IndexReader} to load position and DocIdSet information from + + A {@link SpanFilterResult} - - - IllegalStateException if the index is closed - - - Deletes the document numbered docNum. - - - IllegalStateException if the index is closed - - - Returns the number of documents currently in this index. - - - - - IllegalStateException if the index is closed - - - Merges all segments together into a single segment, optimizing an index - for search. + java.io.IOException if there was an issue accessing the necessary information + - - - IllegalStateException if the index is closed - - - IOException - - - - - Setting to turn on usage of a compound file. When on, multiple files - for each segment are merged into a single file once the segment creation - is finished. This is done regardless of what directory is in use. + + Expert: Scoring functionality for phrase queries. +
A document is considered matching if it contains the phrase-query terms + at "valid" positons. What "valid positions" are + depends on the type of the phrase query: for an exact phrase query terms are required + to appear in adjacent locations, while for a sloppy phrase query some distance between + the terms is allowed. The abstract method {@link #PhraseFreq()} of extending classes + is invoked for each document containing all the phrase query terms, in order to + compute the frequency of the phrase query in that document. A non zero frequency + means a match. - - - IllegalStateException if the index is closed - - IOException - - - - - The maximum number of terms that will be indexed for a single field in a - document. This limits the amount of memory required for indexing, so that - collections with very large files will not crash the indexing process by - running out of memory.

- Note that this effectively truncates large documents, excluding from the - index terms that occur further in the document. If you know your source - documents are large, be sure to set this value high enough to accomodate - the expected size. If you set it to Integer.MAX_VALUE, then the only limit - is your memory, but you should anticipate an OutOfMemoryError.

- By default, no more than 10,000 terms will be indexed for a field. -

- - - IllegalStateException if the index is closed - - - IOException - - - - - The maximum number of terms that will be indexed for a single field in a - document. This limits the amount of memory required for indexing, so that - collections with very large files will not crash the indexing process by - running out of memory.

- Note that this effectively truncates large documents, excluding from the - index terms that occur further in the document. If you know your source - documents are large, be sure to set this value high enough to accomodate - the expected size. If you set it to Integer.MAX_VALUE, then the only limit - is your memory, but you should anticipate an OutOfMemoryError.

- By default, no more than 10,000 terms will be indexed for a field. -

- - - IllegalStateException if the index is closed - - - IOException - - - - - - IOException - - - - - Close this index, writing all pending changes to disk. + + Expert: Common scoring functionality for different types of queries. + +

+ A Scorer iterates over documents matching a + query in increasing order of doc Id. +

+

+ Document scores are computed using a given Similarity + implementation. +

+ +

NOTE: The values Float.Nan, + Float.NEGATIVE_INFINITY and Float.POSITIVE_INFINITY are + not valid scores. Certain collectors (eg {@link + TopScoreDocCollector}) will not properly collect hits + with these scores.

- IllegalStateException if the index has been closed before already - - - - Default value for the write lock timeout (1,000). - - - Default value for the commit lock timeout (10,000). - - - Default value is 10. Change using {@link #SetMergeFactor(int)}. - - - Default value is 10. Change using {@link #SetMaxBufferedDocs(int)}. - - - Default value is 10,000. Change using {@link #SetMaxFieldLength(int)}. - - - Default value is 128. Change using {@link #SetTermIndexInterval(int)}. - - - Default value is {@link Integer#MAX_VALUE}. Change using {@link #SetMaxMergeDocs(int)}. - - - Use compound file setting. Defaults to true, minimizing the number of - files used. Setting this to false may improve indexing performance, but - may also cause file handle problems. - - - - Get the current setting of whether to use the compound file format. - Note that this just returns the value you set with setUseCompoundFile(boolean) - or the default. You cannot use this to query the status of an existing index. - - + - - Setting to turn on usage of a compound file. When on, multiple files - for each segment are merged into a single file once the segment creation - is finished. This is done regardless of what directory is in use. + + This abstract class defines methods to iterate over a set of non-decreasing + doc ids. Note that this class assumes it iterates on doc Ids, and therefore + {@link #NO_MORE_DOCS} is set to {@value #NO_MORE_DOCS} in order to be used as + a sentinel object. Implementations of this class are expected to consider + {@link Integer#MAX_VALUE} as an invalid value. - - Expert: Set the Similarity implementation used by this IndexWriter. + + When returned by {@link #NextDoc()}, {@link #Advance(int)} and + {@link #Doc()} it means there are no more docs in the iterator. + + + + Unsupported anymore. Call {@link #DocID()} instead. This method throws + {@link UnsupportedOperationException} if called. - - + use {@link #DocID()} instead. + - - - Expert: Set the interval between indexed terms. Large values cause less - memory to be used by IndexReader, but slow random-access to terms. Small - values cause more memory to be used by an IndexReader, and speed - random-access to terms. - - This parameter determines the amount of computation required per query - term, regardless of the number of documents that contain that term. In - particular, it is the maximum number of other terms that must be - scanned before a term is located and its frequency and position information - may be processed. In a large index with user-entered query terms, query - processing time is likely to be dominated not by term lookup but rather - by the processing of frequency and positional data. In a small index - or when many uncommon query terms are generated (e.g., by wildcard - queries) term lookup may become a dominant cost. - - In particular, numUniqueTerms/interval terms are read into - memory by an IndexReader, and, on average, interval/2 terms - must be scanned for each random term access. + + Returns the following: +
    +
  • -1 or {@link #NO_MORE_DOCS} if {@link #NextDoc()} or + {@link #Advance(int)} were not called yet.
    • +
  • {@link #NO_MORE_DOCS} if the iterator has exhausted.
    • +
  • Otherwise it should return the doc ID it is currently on.
    • +
+

+ NOTE: in 3.0, this method will become abstract.

- - + 2.9 + - - Expert: Return the interval between indexed terms. + + Unsupported anymore. Call {@link #NextDoc()} instead. This method throws + {@link UnsupportedOperationException} if called. - - + use {@link #NextDoc()} instead. This will be removed in 3.0 + - - Constructs an IndexWriter for the index in path. - Text will be analyzed with a. If create - is true, then a new, empty index will be created in - path, replacing the index already there, if any. + + Unsupported anymore. Call {@link #Advance(int)} instead. This method throws + {@link UnsupportedOperationException} if called. - the path to the index directory - - the analyzer to use - - true to create the index or overwrite - the existing one; false to append to the existing - index - - IOException if the directory cannot be read/written to, or - if it does not exist, and create is - false - + use {@link #Advance(int)} instead. This will be removed in 3.0 + - - Constructs an IndexWriter for the index in path. - Text will be analyzed with a. If create - is true, then a new, empty index will be created in - path, replacing the index already there, if any. + + Advances to the next document in the set and returns the doc it is + currently on, or {@link #NO_MORE_DOCS} if there are no more docs in the + set.
- - the path to the index directory - - the analyzer to use - - true to create the index or overwrite - the existing one; false to append to the existing - index - - IOException if the directory cannot be read/written to, or - if it does not exist, and create is - false - - - - Constructs an IndexWriter for the index in d. - Text will be analyzed with a. If create - is true, then a new, empty index will be created in - d, replacing the index already there, if any. + NOTE: in 3.0 this method will become abstract, following the removal + of {@link #Next()}. For backward compatibility it is implemented as: - - the index directory - - the analyzer to use - - true to create the index or overwrite - the existing one; false to append to the existing - index - - IOException if the directory cannot be read/written to, or - if it does not exist, and create is - false - - - - - - - - - The maximum number of terms that will be indexed for a single field in a - document. This limits the amount of memory required for indexing, so that - collections with very large files will not crash the indexing process by - running out of memory.

- Note that this effectively truncates large documents, excluding from the - index terms that occur further in the document. If you know your source - documents are large, be sure to set this value high enough to accomodate - the expected size. If you set it to Integer.MAX_VALUE, then the only limit - is your memory, but you should anticipate an OutOfMemoryError.

- By default, no more than 10,000 terms will be indexed for a field. -

- - - - - - - - - - - - - - - - - If non-null, information about merges and a message when - maxFieldLength is reached will be printed to this. - - - - - - - - Sets the maximum time to wait for a commit lock (in milliseconds). - - - - - - - Sets the maximum time to wait for a write lock (in milliseconds). - - - - - - - Flushes all changes to an index and closes all associated files. - - - Release the write lock, if needed. - - - Returns the Directory used by this index. - - - Returns the analyzer used by this index. - - - Returns the number of documents currently in this index. - - - The maximum number of terms that will be indexed for a single field in a - document. This limits the amount of memory required for indexing, so that - collections with very large files will not crash the indexing process by - running out of memory.

- Note that this effectively truncates large documents, excluding from the - index terms that occur further in the document. If you know your source - documents are large, be sure to set this value high enough to accomodate - the expected size. If you set it to Integer.MAX_VALUE, then the only limit - is your memory, but you should anticipate an OutOfMemoryError.

- By default, no more than 10,000 terms will be indexed for a field. - -

- - - Adds a document to this index. If the document contains more than - {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are - discarded. - - - - Adds a document to this index, using the provided analyzer instead of the - value of {@link #GetAnalyzer()}. If the document contains more than - {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are - discarded. - - - - - - - If non-null, information about merges will be printed to this. - - - Merges all segments together into a single segment, optimizing an index - for search. - - - - - Merges the provided indexes into this index. -

After this completes, the index is optimized.

-

The provided IndexReaders are not closed.

- - - - Merges all RAM-resident segments. - - - Incremental segment merger. - - - Pops segments off of segmentInfos stack down to minSegment, merges them, - and pushes the merged index onto the top of the segmentInfos stack. - - - - Merges the named range of segments, replacing them in the stack with a - single segment. - - - - Describe class MultipleTermPositions here. - - - Anders Nielsen - - 1.0 - - - - Creates a new MultipleTermPositions instance. - - - - - - - Not implemented. - UnsupportedOperationException - - - Not implemented. - UnsupportedOperationException - - - Not implemented. - UnsupportedOperationException - - - A PriorityQueue maintains a partial ordering of its elements such that the - least element can always be found in constant time. Put()'s and pop()'s - require log(size) time. - - - - Determines the ordering of objects in this priority queue. Subclasses - must define this one method. - - - - Subclass constructors must call this. - - - Adds an Object to a PriorityQueue in log(size) time. - If one tries to add more objects than maxSize from initialize - a RuntimeException (ArrayIndexOutOfBound) is thrown. - - - - Adds element to the PriorityQueue in log(size) time if either - the PriorityQueue is not full, or not lessThan(element, top()). - - - - true if element is added, false otherwise. - - - - Returns the least element of the PriorityQueue in constant time. - - - Removes and returns the least element of the PriorityQueue in log(size) - time. - - - - Should be called when the Object at top changes values. Still log(n) - worst case, but it's at least twice as fast to 
-            { pq.top().change(); pq.adjustTop(); }
-
instead of 
-            { o = pq.pop(); o.change(); pq.push(o); }
+            
+            public int nextDoc() throws IOException {
+            return next() ? doc() : NO_MORE_DOCS;
+            }
             

-
- - - Returns the number of elements currently stored in the PriorityQueue. - - - Removes all entries from the PriorityQueue. - - - An IndexReader which reads multiple indexes, appending their content. + + NOTE: after the iterator has exhausted you should not call this + method, as it may result in unpredicted behavior. - $Id: MultiReader.java 355181 2005-12-08 19:53:06Z cutting $ - + 2.9 + - -

Construct a MultiReader aggregating the named set of (sub)readers. - Directory locking for delete, undeleteAll, and setNorm operations is - left to the subreaders.

-

Note that all subreaders are closed if this Multireader is closed.

+ + Advances to the first beyond the current whose document number is greater + than or equal to target. Returns the current document number or + {@link #NO_MORE_DOCS} if there are no more docs in the set. +

+ Behaves as if written: + + 

+            int advance(int target) {
+            int doc;
+            while ((doc = nextDoc()) < target) {
+            }
+            return doc;
+            }
+
+ + Some implementations are considerably more efficient than that. +

+ NOTE: certain implemenations may return a different value (each + time) if called several times in a row with the same target. +

+ NOTE: this method may be called with {@value #NO_MORE_DOCS} for + efficiency by some Scorers. If your implementation cannot efficiently + determine that it should exhaust, it is recommended that you check for that + value in each call to this method. +

+ NOTE: after the iterator has exhausted you should not call this + method, as it may result in unpredicted behavior. +

+ NOTE: in 3.0 this method will become abstract, following the removal + of {@link #SkipTo(int)}. +

- set of (sub)readers + 2.9 + + + + Constructs a Scorer. + The Similarity implementation used by this scorer. - IOException - - Construct reading the named set of readers. + + Returns the Similarity implementation used by this scorer. - - Return an array of term frequency vectors for the specified document. - The array contains a vector for each vectorized field in the document. - Each vector vector contains term numbers and frequencies for all terms - in a given vectorized field. - If no such fields existed, the method returns null. + + Scores and collects all matching documents. + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. +
When this method is used the {@link #Explain(int)} method should not be used. + + use {@link #Score(Collector)} instead. + + + + Scores and collects all matching documents. + The collector to which all matching documents are passed. +
When this method is used the {@link #Explain(int)} method should not be used. + + + + Expert: Collects matching documents in a range. Hook for optimization. + Note that {@link #Next()} must be called once before this method is called + for the first time. + + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. + + Do not score documents past this. + + true if more matching documents may remain. + + use {@link #Score(Collector, int, int)} instead. + + + + Expert: Collects matching documents in a range. Hook for optimization. + Note, firstDocID is added to ensure that {@link #NextDoc()} + was called before this method. + + + The collector to which all matching documents are passed. + + Do not score documents past this. + + + The first document ID (ensures {@link #NextDoc()} is called before + this method. + + true if more matching documents may remain. + + + + Returns the score of the current document matching the query. + Initially invalid, until {@link #Next()} or {@link #SkipTo(int)} + is called the first time, or when called from within + {@link Collector#collect}. - - + + Returns an explanation of the score for a document. +
When this method is used, the {@link #Next()}, {@link #SkipTo(int)} and + {@link #Score(HitCollector)} methods should not be used. + + The document number for the explanation. + + + Please use {@link IndexSearcher#explain} + or {@link Weight#explain} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + For a document containing all the phrase query terms, compute the + frequency of the phrase in that document. + A non zero frequency means a match. +
Note, that containing all phrase terms does not guarantee a match - they have to be found in matching locations. + + frequency of the phrase in current doc, 0 if not found. + + + + Score a candidate doc for all slop-valid position-combinations (matches) + encountered while traversing/hopping the PhrasePositions. +
The score contribution of a match depends on the distance: +
- highest score for distance=0 (exact match). +
- score gets lower as distance gets higher. +
Example: for query "a b"~2, a document "x a b a y" can be scored twice: + once for "a b" (distance=0), and once for "b a" (distance=2). +
Possibly not all valid combinations are encountered, because for efficiency + we always propagate the least PhrasePosition. This allows to base on + PriorityQueue and move forward faster. + As result, for example, document "a b c b a" + would score differently for queries "a b c"~4 and "c b a"~4, although + they really are equivalent. + Similarly, for doc "a b c b a f g", query "c b"~2 + would get same score as "g f"~2, although "c b"~2 could be matched twice. + We may want to fix this in the future (currently not, for performance reasons). + + + + Init PhrasePositions in place. + There is a one time initialization for this scorer: +
- Put in repeats[] each pp that has another pp with same position in the doc. +
- Also mark each such pp by pp.repeats = true. +
Later can consult with repeats[] in termPositionsDiffer(pp), making that check efficient. + In particular, this allows to score queries with no repetitions with no overhead due to this computation. +
- Example 1 - query with no repetitions: "ho my"~2 +
- Example 2 - query with repetitions: "ho my my"~2 +
- Example 3 - query with repetitions: "my ho my"~2 +
Init per doc w/repeats in query, includes propagating some repeating pp's to avoid false phrase detection. + + end (max position), or -1 if any term ran out (i.e. done) + + IOException + + + We disallow two pp's to have the same TermPosition, thereby verifying multiple occurrences + in the query of the same word would go elsewhere in the matched doc. + + null if differ (i.e. valid) otherwise return the higher offset PhrasePositions + out of the first two PPs found to not differ. + + + + A Scorer for queries with a required part and an optional part. + Delays skipTo() on the optional part until a score() is needed. +
+ This Scorer implements {@link Scorer#SkipTo(int)}. + + + + The scorers passed from the constructor. + These are set to null as soon as their next() or skipTo() returns false. + + + + Construct a ReqOptScorer. + The required scorer. This must match. + + The optional scorer. This is used for scoring only. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + Returns the score of the current document matching the query. + Initially invalid, until {@link #Next()} is called the first time. + + The score of the required scorer, eventually increased by the score + of the optional scorer when it also matches the current document. + + + + Explain the score of a document. + TODO: Also show the total score. + See BooleanScorer.explain() on how to do this. + + + + Returns the maximum payload score seen, else 1 if there are no payloads on the doc. +

+ Is thread safe and completely reusable. + + +

+ + + An abstract class that defines a way for Payload*Query instances + to transform the cumulative effects of payload scores for a document. + + + for more information + +

+ This class and its derivations are experimental and subject to change + + - -

Optimized implementation. + + Calculate the score up to this point for this doc and field + The current doc + + The field + + The start position of the matching Span + + The end position of the matching Span + + The number of payloads seen so far + + The current score so far + + The score for the current payload + + The new current Score + + + + - - As yet unoptimized implementation. + + Calculate the final score for all the payloads seen so far for this doc/field + The current doc + + The current field + + The total number of payloads seen on this document + + The raw score for those payloads + + The final score for the payloads + - - - Construct a ParallelReader. - - - Add an IndexReader. - - - Add an IndexReader whose stored fields will not be returned. This can - accellerate search when stored fields are only needed from a subset of - the IndexReaders. + + Expert: obtains float field values from the + {@link Lucene.Net.Search.FieldCache FieldCache} + using getFloats() and makes those values + available as other numeric types, casting as needed. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case.

- IllegalArgumentException if not all indexes contain the same number - of documents - - IllegalArgumentException if not all indexes have the same value - of {@link IndexReader#MaxDoc()} + for requirements" + on the field. + +

NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

+ + + +

Expert: A base class for ValueSource implementations that retrieve values for + a single field from the {@link Lucene.Net.Search.FieldCache FieldCache}. +

+ Fields used herein nust be indexed (doesn't matter if these fields are stored or not). +

+ It is assumed that each such indexed field is untokenized, or at least has a single token in a document. + For documents with multiple tokens of the same field, behavior is undefined (It is likely that current + code would use the value of one of these tokens, but this is not guaranteed). +

+ Document with no tokens in this field are assigned the Zero value. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

 - - The file format version, a negative number. - - - counts how often the index has been changed by adding or deleting docs. - starting with the current time in milliseconds forces to create unique version numbers. - - - - version number when this SegmentInfos was generated. - - - Current version number from segments file. - - - - This ctor used only by test code. + + Expert: source of values for basic function queries. +

At its default/simplest form, values - one per doc - are used as the score of that doc. +

Values are instantiated as + {@link Lucene.Net.Search.Function.DocValues DocValues} for a particular reader. +

ValueSource implementations differ in RAM requirements: it would always be a factor + of the number of documents, but for each document the number of bytes can be 1, 2, 4, or 8. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. +

- The Directory to merge the other segments into + + + Return the DocValues used by the function query. + the IndexReader used to read these values. + If any caching is involved, that caching would also be IndexReader based. - The name of the new segment + IOException for any error. + + + description of field, used in explain() + + + Needed for possible caching of query results - used by {@link ValueSourceQuery#equals(Object)}. + + + + + Needed for possible caching of query results - used by {@link ValueSourceQuery#hashCode()}. + + + + + Create a cached field source for the input field. + + + Return cached DocValues for input field and reader. + FieldCache so that values of a field are loaded once per reader (RAM allowing) + + Field for which values are required. + + + + + + Check if equals to another {@link FieldCacheSource}, already knowing that cache and field are equal. + + + + + Return a hash code of a {@link FieldCacheSource}, without the hash-codes of the field + and the cache (those are taken care of elsewhere). + + + + + + Create a cached float field source with default string-to-float parser. + + + Create a cached float field source with a specific string-to-float parser. + + + Expert: represents field values as different types. + Normally created via a + {@link Lucene.Net.Search.Function.ValueSource ValueSuorce} + for a particular field and reader. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + + +

+ + + Return doc value as a float. +

Mandatory: every DocValues implementation must implement at least this method. +

+ document whose float value is requested. - - Add an IndexReader to the collection of readers that are to be merged + + Return doc value as an int. +

Optional: DocValues implementation can (but don't have to) override this method. +

+ document whose int value is requested. + + + + Return doc value as a long. +

Optional: DocValues implementation can (but don't have to) override this method. +

+ document whose long value is requested. + + + + Return doc value as a double. +

Optional: DocValues implementation can (but don't have to) override this method. +

+ document whose double value is requested. + + + + Return doc value as a string. +

Optional: DocValues implementation can (but don't have to) override this method. +

+ document whose string value is requested. + + + + Return a string representation of a doc value, as reuired for Explanations. + + + Explain the scoring value for the input doc. + + + Expert: for test purposes only, return the inner array of values, or null if not applicable. +

+ Allows tests to verify that loaded values are: +

    +
  1. indeed cached/reused.
    2. +
  2. stored in the expected size/type (byte/short/int/float).
    3. +
+ Note: implementations of DocValues must override this method for + these test elements to be tested, Otherwise the test would not fail, just + print a warning. + + + + Returns the minimum of all values or Float.NaN if this + DocValues instance does not contain any value. +

+ This operation is optional +

+ +

+ the minimum of all values or Float.NaN if this + DocValues instance does not contain any value. + + + + Returns the maximum of all values or Float.NaN if this + DocValues instance does not contain any value. +

+ This operation is optional +

+ +

+ the maximum of all values or Float.NaN if this + DocValues instance does not contain any value. + + + + Returns the average of all values or Float.NaN if this + DocValues instance does not contain any value. * +

+ This operation is optional +

+ +

+ the average of all values or Float.NaN if this + DocValues instance does not contain any value + + + + A query that scores each document as the value of the numeric input field. +

+ The query matches all documents, and scores each document according to the numeric + value of that field. +

+ It is assumed, and expected, that: +

    +
  • The field used here is indexed, and has exactly + one token in every scored document.
    • +
  • Best if this field is un_tokenized.
    • +
  • That token is parsable to the selected type.
    • +
+

+ Combining this query in a FunctionQuery allows much freedom in affecting document scores. + Note, that with this freedom comes responsibility: it is more than likely that the + default Lucene scoring is superior in quality to scoring modified as explained here. + However, in some cases, and certainly for research experiments, this capability may turn useful. +

+ When contructing this query, select the appropriate type. That type should match the data stored in the + field. So in fact the "right" type should be selected before indexing. Type selection + has effect on the RAM usage: +

    +
  • {@link Type#BYTE} consumes 1 * maxDocs bytes.
    • +
  • {@link Type#SHORT} consumes 2 * maxDocs bytes.
    • +
  • {@link Type#INT} consumes 4 * maxDocs bytes.
    • +
  • {@link Type#FLOAT} consumes 8 * maxDocs bytes.
    • +
+

+ Caching: + Values for the numeric field are loaded once and cached in memory for further use with the same IndexReader. + To take advantage of this, it is extremely important to reuse index-readers or index-searchers, + otherwise, for instance if for each query a new index reader is opened, large penalties would be + paid for loading the field values into memory over and over again! + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. +

+ + + Expert: A Query that sets the scores of document to the + values obtained from a {@link Lucene.Net.Search.Function.ValueSource ValueSource}. +

+ This query provides a score for each and every undeleted document in the index. +

+ The value source can be based on a (cached) value of an indexed field, but it + can also be based on an external source, e.g. values read from an external database. +

+ Score is set as: Score(doc,query) = query.getBoost()2 * valueSource(doc). + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. +

+ + + Create a value source query + provides the values defines the function to be used for scoring + + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + + + Expert: Calculate query weights and build query scorers. +

+ The purpose of {@link Weight} is to ensure searching does not + modify a {@link Query}, so that a {@link Query} instance can be reused.
+ {@link Searcher} dependent state of the query should reside in the + {@link Weight}.
+ {@link IndexReader} dependent state should reside in the {@link Scorer}. +

+ A Weight is used in the following way: +

    +
  1. A Weight is constructed by a top-level query, given a + Searcher ({@link Query#CreateWeight(Searcher)}).
    2. +
  2. The {@link #SumOfSquaredWeights()} method is called on the + Weight to compute the query normalization factor + {@link Similarity#QueryNorm(float)} of the query clauses contained in the + query.
    3. +
  3. The query normalization factor is passed to {@link #Normalize(float)}. At + this point the weighting is complete.
    4. +
  4. A Scorer is constructed by {@link #Scorer(IndexReader,boolean,boolean)}.
    5. +
+ + + 2.9 + + + + An explanation of the score computation for the named document. + + + sub-reader containing the give doc + + + + an Explanation for the score + + IOException + + + The query that this concerns. + + + The weight for this query. + + + Assigns the query normalization factor to this. + + + Returns a {@link Scorer} which scores documents in/out-of order according + to scoreDocsInOrder. +

+ NOTE: even if scoreDocsInOrder is false, it is + recommended to check whether the returned Scorer indeed scores + documents out of order (i.e., call {@link #ScoresDocsOutOfOrder()}), as + some Scorer implementations will always return documents + in-order.
+ NOTE: null can be returned if no documents will be scored by this + query. + +

+ the {@link IndexReader} for which to return the {@link Scorer}. - - - - The index of the reader to return + specifies whether in-order scoring of documents is required. Note + that if set to false (i.e., out-of-order scoring is required), + this method can return whatever scoring mode it supports, as every + in-order scorer is also an out-of-order one. However, an + out-of-order scorer may not support {@link Scorer#NextDoc()} + and/or {@link Scorer#Advance(int)}, therefore it is recommended to + request an in-order scorer if use of these methods is required. - The ith reader to be merged - - - - Merges the readers specified by the {@link #add} method into the directory passed to the constructor - The number of documents that were merged + + if true, {@link Scorer#Score(Collector)} will be called; if false, + {@link Scorer#NextDoc()} and/or {@link Scorer#Advance(int)} will + be called. + + a {@link Scorer} which scores documents in/out-of order. IOException - - close all IndexReaders that have been added. - Should not be called before merge(). - - IOException + + The sum of squared weights of contained query clauses. - - - The number of documents in all of the readers + + Returns true iff this implementation scores docs only out of order. This + method is used in conjunction with {@link Collector}'s + {@link Collector#AcceptsDocsOutOfOrder() acceptsDocsOutOfOrder} and + {@link #Scorer(Lucene.Net.Index.IndexReader, boolean, boolean)} to + create a matching {@link Scorer} instance for a given {@link Collector}, or + vice versa. +

+ NOTE: the default implementation returns false, i.e. + the Scorer scores documents in-order. +

+ + + A scorer that (simply) matches all documents, and scores each document with + the value of the value soure in effect. As an example, if the value source + is a (cached) field source, then value of that field in that document will + be used. (assuming field is indexed for this doc, with a single token.) + + + + use {@link #NextDoc()} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #Advance(int)} instead. + + + + Create a FieldScoreQuery - a query that scores each document as the value of the numeric input field. +

+ The type param tells how to parse the field string values into a numeric score value. +

+ the numeric field to be used. + + the type of the field: either + {@link Type#BYTE}, {@link Type#SHORT}, {@link Type#INT}, or {@link Type#FLOAT}. + + + + Type of score field, indicating how field values are interpreted/parsed. +

+ The type selected at search search time should match the data stored in the field. + Different types have different RAM requirements: +

    +
  • {@link #BYTE} consumes 1 * maxDocs bytes.
    • +
  • {@link #SHORT} consumes 2 * maxDocs bytes.
    • +
  • {@link #INT} consumes 4 * maxDocs bytes.
    • +
  • {@link #FLOAT} consumes 8 * maxDocs bytes.
    • +
+ + + + field values are interpreted as numeric byte values. + + + field values are interpreted as numeric short values. + + + field values are interpreted as numeric int values. + + + field values are interpreted as numeric float values. + + + Provides a {@link FieldComparator} for custom field sorting. + + NOTE: This API is experimental and might change in + incompatible ways in the next release. + + + + + Creates a comparator for the field in the given index. + + + Name of the field to create comparator for. + + FieldComparator. IOException + If an error occurs reading the index. + - - Merge the TermVectors from each of the segments into the new one. - IOException + + A {@link Filter} that only accepts documents whose single + term value in the specified field is contained in the + provided set of allowed terms. + +

+ + This is the same functionality as TermsFilter (from + contrib/queries), except this filter requires that the + field contains only a single term for all documents. + Because of drastically different implementations, they + also have different performance characteristics, as + described below. + +

+ + The first invocation of this filter on a given field will + be slower, since a {@link FieldCache.StringIndex} must be + created. Subsequent invocations using the same field + will re-use this cache. However, as with all + functionality based on {@link FieldCache}, persistent RAM + is consumed to hold the cache, and is not freed until the + {@link IndexReader} is closed. In contrast, TermsFilter + has no persistent RAM consumption. + + +

+ + With each search, this filter translates the specified + set of Terms into a private {@link OpenBitSet} keyed by + term number per unique {@link IndexReader} (normally one + reader per segment). Then, during matching, the term + number for each docID is retrieved from the cache and + then checked for inclusion using the {@link OpenBitSet}. + Since all testing is done using RAM resident data + structures, performance should be very fast, most likely + fast enough to not require further caching of the + DocIdSet for each possible combination of terms. + However, because docIDs are simply scanned linearly, an + index with a great many small documents may find this + linear scan too costly. + +

+ + In contrast, TermsFilter builds up an {@link OpenBitSet}, + keyed by docID, every time it's created, by enumerating + through all matching docs using {@link TermDocs} to seek + and scan through each term's docID list. While there is + no linear scan of all docIDs, besides the allocation of + the underlying array in the {@link OpenBitSet}, this + approach requires a number of "disk seeks" in proportion + to the number of terms, which can be exceptionally costly + when there are cache misses in the OS's IO cache. + +

+ + Generally, this filter will be slower on the first + invocation for a given field, but subsequent invocations, + even if you change the allowed set of Terms, should be + faster than TermsFilter, especially as the number of + Terms being matched increases. If you are matching only + a very small number of terms, and those terms in turn + match a very small number of documents, TermsFilter may + perform faster. + +

+ + Which filter is best is very application dependent. +

- - Merge one term found in one or more segments. The array smis - contains segments that are positioned at the same term. N - is the number of cells in the array actually occupied. + + A DocIdSet contains a set of doc ids. Implementing classes must + only implement {@link #iterator} to provide access to the set. + + + + An empty {@code DocIdSet} instance for easy use, e.g. in Filters that hit no documents. + + + Provides a {@link DocIdSetIterator} to access the set. + This implementation can return null or + {@linkplain #EMPTY_DOCIDSET}.iterator() if there + are no docs that match. + + + + This method is a hint for {@link CachingWrapperFilter}, if this DocIdSet + should be cached without copying it into a BitSet. The default is to return + false. If you have an own DocIdSet implementation + that does its iteration very effective and fast without doing disk I/O, + override this method and return true. + + + + This DocIdSet implementation is cacheable. + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + An efficient implementation of JavaCC's CharStream interface.

Note that + this does not do line-number counting, but instead keeps track of the + character position of the token in the input, as required by Lucene's {@link + Lucene.Net.Analysis.Token} API.

- array of segments - - number of cells in the array actually occupied - - - - Process postings from multiple segments all positioned on the - same term. Writes out merged entries into freqOutput and - the proxOutput streams. - - - array of segments - - number of cells in the array actually occupied - - number of documents across all segments where this term was found - - - - $Id: SegmentReader.java 329523 2005-10-30 05:37:11Z yonik $ - - - - The class which implements SegmentReader. - - - - - - - Read norms into a pre-allocated array. - - - Create a clone from the initial TermVectorsReader and store it in the ThreadLocal. - TermVectorsReader - - - - Return a term frequency vector for the specified document and field. The - vector returned contains term numbers and frequencies for all terms in - the specified field of this document, if the field had storeTermVector - flag set. If the flag was not set, the method returns null. - - IOException - - - Return an array of term frequency vectors for the specified document. - The array contains a vector for each vectorized field in the document. - Each vector vector contains term numbers and frequencies for all terms - in a given vectorized field. - If no such fields existed, the method returns null. - - IOException - - - Optimized implementation. - - - Overridden by SegmentTermPositions to skip in prox stream. - - - Optimized implementation. - - - Increments the enumeration to the next element. True if one exists. - - - Optimized scan, without allocating new terms. - - - Returns the current Term in the enumeration. - Initially invalid, valid after next() called for the first time. - - - - Returns the previous Term enumerated. Initially null. - - - Returns the current TermInfo in the enumeration. - Initially invalid, valid after next() called for the first time. - - - - Sets the argument to the current TermInfo in the enumeration. - Initially invalid, valid after next() called for the first time. - - - - Returns the docFreq from the current TermInfo in the enumeration. - Initially invalid, valid after next() called for the first time. - - - - Closes the enumeration to further activity, freeing resources. - - - Called by super.skipTo(). - - - Provides access to stored term vector of - a document field. - - - - - The field this vector is associated with. - - - - - The number of terms in the term vector. - - - - An Array of term texts in ascending order. - - - - Array of term frequencies. Locations of the array correspond one to one - to the terms in the array obtained from getTerms - method. Each location in the array contains the number of times this - term occurs in the document or the document field. - - - - Return an index in the term numbers array returned from - getTerms at which the term with the specified - term appears. If this term does not appear in the array, - return -1. - - - - Just like indexOf(int) but searches for a number of terms - at the same time. Returns an array that has the same size as the number - of terms searched for, each slot containing the result of searching for - that term number. - - - array containing terms to look for - - index in the array where the list of terms starts - - the number of terms in the list - - - - - The number of the field this vector is associated with - - - - Extends TermFreqVector to provide additional information about - positions in which each of the terms is found. A TermPositionVector not necessarily - contains both positions and offsets, but at least one of these arrays exists. - - - - Returns an array of positions in which the term is found. - Terms are identified by the index at which its number appears in the - term String array obtained from the indexOf method. - May return null if positions have not been stored. - - - - Returns an array of TermVectorOffsetInfo in which the term is found. - May return null if offsets have not been stored. - - - - - - The position in the array to get the offsets from - - An array of TermVectorOffsetInfo objects or the empty list - - - - Returns an array of TermVectorOffsetInfo in which the term is found. - - - The position in the array to get the offsets from - - An array of TermVectorOffsetInfo objects or the empty list - - - - - - Returns an array of positions in which the term is found. - Terms are identified by the index at which its number appears in the - term String array obtained from the indexOf method. - - - - A Term represents a word from text. This is the unit of search. It is - composed of two elements, the text of the word, as a string, and the name of - the field that the text occured in, an interned string. - Note that terms may represent more than words from text fields, but also - things like dates, email addresses, urls, etc. - - - - Constructs a Term with the given field and text. - - - Returns the field of this term, an interned string. The field indicates - the part of a document which this term came from. - - - - Returns the text of this term. In the case of words, this is simply the - text of the word. In the case of dates and other types, this is an - encoding of the object as a string. - - - - Optimized construction of new Terms by reusing same field as this Term - - avoids field.intern() overhead - - The text of the new term (field is implicitly same as this Term instance) - - A new Term - - - - Compares two terms, returning true iff they have the same - field and text. - - - - Combines the hashCode() of the field and the text. - - - Compares two terms, returning a negative integer if this - term belongs before the argument, zero if this term is equal to the - argument, and a positive integer if this term belongs after the argument. - The ordering of terms is first by field, then by text. - - - - Resets the field and text of a Term. - - - A TermInfo is the record of information stored for a term. - - - The number of documents which contain the term. - - - - Returns the number of term/value pairs in the set. - - - Returns the offset of the greatest index entry which is less than or equal to term. - - - Returns the TermInfo for a Term in the set, or null. - - - Scans within block for matching term. - - - Returns the nth term in the set. - - - Returns the position of a Term in the set or -1. - - - Returns an enumeration of all the Terms and TermInfos in the set. - - - Returns an enumeration of terms starting at or after the named term. - - - - The file format version, a negative number. - - - Expert: The fraction of terms in the "dictionary" which should be stored - in RAM. Smaller values use more memory, but make searching slightly - faster, while larger values use less memory and make searching slightly - slower. Searching is typically not dominated by dictionary lookup, so - tweaking this is rarely useful. - - - - Expert: The fraction of {@link TermDocs} entries stored in skip tables, - used to accellerate {@link TermDocs#SkipTo(int)}. Larger values result in - smaller indexes, greater acceleration, but fewer accelerable cases, while - smaller values result in bigger indexes, less acceleration and more - accelerable cases. More detailed experiments would be useful here. - - - - - Called to complete TermInfos creation. - - - $Id: TermVectorsReader.java 170226 2005-05-15 15:04:39Z bmesser $ - - - - - The number of documents in the reader - - - - Retrieve the term vector for the given document and field - The document number to retrieve the vector for - - The field within the document to retrieve - - The TermFreqVector for the document and field or null if there is no termVector for this field. - - IOException if there is an error reading the term vector files - - - Return all term vectors stored for this document or null if the could not be read in. - - - The document number to retrieve the vector for - - All term frequency vectors - - IOException if there is an error reading the term vector files - - - - The field to read in - - The pointer within the tvf file where we should start reading - - The TermVector located at that position - - IOException - - - Writer works by opening a document and then opening the fields within the document and then - writing out the vectors for each field. - - Rough usage: - - - for each document - { - writer.openDocument(); - for each field on the document - { - writer.openField(field); - for all of the terms - { - writer.addTerm(...) - } - writer.closeField - } - writer.closeDocument() - } - - - - $Id: TermVectorsWriter.java 150689 2004-11-29 21:42:02Z bmesser $ - - - - - Start processing a field. This can be followed by a number of calls to - addTerm, and a final call to closeField to indicate the end of - processing of this field. If a field was previously open, it is - closed automatically. - - - - Finished processing current field. This should be followed by a call to - openField before future calls to addTerm. - - - - Return true if a field is currently open. - - - Add term to the field's term vector. Field must already be open. - Terms should be added in - increasing order of terms, one call per unique termNum. ProxPointer - is a pointer into the TermPosition file (prx). Freq is the number of - times this term appears in this field, in this document. - - IllegalStateException if document or field is not open - - - Add a complete document specified by all its term vectors. If document has no - term vectors, add value for tvx. - - - - - IOException - - - Close all streams. This interface describes a character stream that maintains line and @@ -3235,6 +1682,20 @@ implementing this interface. Can throw any java.io.IOException. + + Returns the column position of the character last read. + + + + + + + Returns the line number of the character last read. + + + + + Returns the column number of the last character for current token (being matched after the last call to BeginTOken). @@ -3269,7 +1730,7 @@ - Returns a string made up of characters from the marked token beginning + Returns a string made up of characters from the marked token beginning to the current buffer position. Implementations have the choice of returning anything that they want to. For example, for efficiency, one might decide to just return null, which is a valid implementation. @@ -3294,1683 +1755,2056 @@ affect the lexer's operation. - Constructs from a Reader. - - A QueryParser which constructs queries to search multiple fields. + + Add a complete document specified by all its term vectors. If document has no + term vectors, add value for tvx. - Kelvin Tan, Daniel Naber - - $Revision: 295117 $ - - - - - Alternative form of QueryParser.Operator.AND - - - Alternative form of QueryParser.Operator.OR - - - The actual operator that parser uses to combine query terms - - - Constructs a query parser. - the default field for query terms. - - used to find terms in the query text. - - - - Parses a query string, returning a {@link Lucene.Net.search.Query}. - the query string to be parsed. - - ParseException if the parsing fails - - - Returns the analyzer. - - - - Returns the field. - - - - Get the minimal similarity for fuzzy queries. - - - Set the minimum similarity for fuzzy queries. - Default is 0.5f. - - - - Get the prefix length for fuzzy queries. - Returns the fuzzyPrefixLength. - - - - Set the prefix length for fuzzy queries. Default is 0. - The fuzzyPrefixLength to set. - - - - Sets the default slop for phrases. If zero, then exact phrase matches - are required. Default value is zero. - - - - Gets the default slop for phrases. - - - Sets the boolean operator of the QueryParser. - In default mode (OR_OPERATOR) terms without any modifiers - are considered optional: for example capital of Hungary is equal to - capital OR of OR Hungary.
- In AND_OPERATOR mode terms are considered to be in conjuction: the - above mentioned query is parsed as capital AND of AND Hungary - - - - Gets implicit operator setting, which will be either AND_OPERATOR - or OR_OPERATOR. - - - - Whether terms of wildcard, prefix, fuzzy and range queries are to be automatically - lower-cased or not. Default is true. - - - - - - - - Set locale used by date range parsing. - - - Returns current locale, allowing access by subclasses. - - - throw in overridden method to disallow - - - - Base implementation delegates to {@link #GetFieldQuery(String,String)}. - This method may be overridden, for example, to return - a SpanNearQuery instead of a PhraseQuery. - - - throw in overridden method to disallow - - - - throw in overridden method to disallow - - - - Factory method for generating query, given a set of clauses. - By default creates a boolean query composed of clauses passed in. - - Can be overridden by extending classes, to modify query being - returned. - - - Vector that contains {@link BooleanClause} instances - to join. - - - Resulting {@link Query} object. - - throw in overridden method to disallow - - - - Factory method for generating query, given a set of clauses. - By default creates a boolean query composed of clauses passed in. - - Can be overridden by extending classes, to modify query being - returned. - - - Vector that contains {@link BooleanClause} instances - to join. - - true if coord scoring should be disabled. - - - Resulting {@link Query} object. - - throw in overridden method to disallow - - - - - - Factory method for generating a query (similar to - {@link #getWildcardQuery}). Called when parser parses - an input term token that has the fuzzy suffix (~) appended. - - - Name of the field query will use. - - Term token to use for building term for the query - - - Resulting {@link Query} built for the term - - throw in overridden method to disallow - - - - Returns a String where the escape char has been - removed, or kept only once if there was a double escape. - - - - Returns a String where those characters that QueryParser - expects to be escaped are escaped by a preceding \. - - - - - The default operator for parsing queries. - Use {@link QueryParser#setDefaultOperator} to change it. - - - - Creates a MultiFieldQueryParser. - -

It will, when parse(String query) - is called, construct a query like this (assuming the query consists of - two terms and you specify the two fields title and body):

- - - (title:term1 body:term1) (title:term2 body:term2) - - -

When setDefaultOperator(AND_OPERATOR) is set, the result will be:

- - - +(title:term1 body:term1) +(title:term2 body:term2) - - -

In other words, all the query's terms must appear, but it doesn't matter in - what fields they appear.

- - - - - - - This exception is thrown when parse errors are encountered. - You can explicitly create objects of this exception type by - calling the method generateParseException in the generated - parser. - - You can modify this class to customize your error reporting - mechanisms so long as you retain the public fields. - - - - - The following constructors are for use by you for whatever - purpose you can think of. Constructing the exception in this - manner makes the exception behave in the normal way - i.e., as - documented in the class "Throwable". The fields "errorToken", - "expectedTokenSequences", and "tokenImage" do not contain - relevant information. The JavaCC generated code does not use - these constructors. - - - - This variable determines which constructor was used to create - this object and thereby affects the semantics of the - "getMessage" method (see below). - - - - This is the last token that has been consumed successfully. If - this object has been created due to a parse error, the token - followng this token will (therefore) be the first error token. - - - - Each entry in this array is an array of integers. Each array - of integers represents a sequence of tokens (by their ordinal - values) that is expected at this point of the parse. - - - - This is a reference to the "tokenImage" array of the generated - parser within which the parse error occurred. This array is - defined in the generated ...Constants interface. - - - - The end of line string for this machine. - - - Used to convert raw characters to their escaped version - when these raw version cannot be used as part of an ASCII - string literal. - - - - This method has the standard behavior when this object has been - created using the standard constructors. Otherwise, it uses - "currentToken" and "expectedTokenSequences" to generate a parse - error message and returns it. If this object has been created - due to a parse error, and you do not catch it (it gets thrown - from the parser), then this method is called during the printing - of the final stack trace, and hence the correct error message - gets displayed. - - - - Describes the input token stream. - - - An integer that describes the kind of this token. This numbering - system is determined by JavaCCParser, and a table of these numbers is - stored in the file ...Constants.java. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - beginLine and beginColumn describe the position of the first character - of this token; endLine and endColumn describe the position of the - last character of this token. - - - - The string image of the token. - - - A reference to the next regular (non-special) token from the input - stream. If this is the last token from the input stream, or if the - token manager has not read tokens beyond this one, this field is - set to null. This is true only if this token is also a regular - token. Otherwise, see below for a description of the contents of - this field. - - - - This field is used to access special tokens that occur prior to this - token, but after the immediately preceding regular (non-special) token. - If there are no such special tokens, this field is set to null. - When there are more than one such special token, this field refers - to the last of these special tokens, which in turn refers to the next - previous special token through its specialToken field, and so on - until the first special token (whose specialToken field is null). - The next fields of special tokens refer to other special tokens that - immediately follow it (without an intervening regular token). If there - is no such token, this field is null. - - - - Returns the image. - - - Returns a new Token object, by default. However, if you want, you - can create and return subclass objects based on the value of ofKind. - Simply add the cases to the switch for all those special cases. - For example, if you have a subclass of Token called IDToken that - you want to create if ofKind is ID, simlpy add something like : - - case MyParserConstants.ID : return new IDToken(); - - to the following switch statement. Then you can cast matchedToken - variable to the appropriate type and use it in your lexical actions. - - - - Lexical error occured. - - - An attempt wass made to create a second instance of a static token manager. - - - Tried to change to an invalid lexical state. - - - Detected (and bailed out of) an infinite loop in the token manager. - - - Indicates the reason why the exception is thrown. It will have - one of the above 4 values. - - - - Replaces unprintable characters by their espaced (or unicode escaped) - equivalents in the given string - - - - Returns a detailed message for the Error when it is thrown by the - token manager to indicate a lexical error. - Parameters : - EOFSeen : indicates if EOF caused the lexicl error - curLexState : lexical state in which this error occured - errorLine : line number when the error occured - errorColumn : column number when the error occured - errorAfter : prefix that was seen before this error occured - curchar : the offending character - Note: You can customize the lexical error message by modifying this method. - - - - You can also modify the body of this method to customize your error messages. - For example, cases like LOOP_DETECTED and INVALID_LEXICAL_STATE are not - of end-users concern, so you can return something like : - - "Internal Error : Please file a bug report .... " - - from this method for such cases in the release version of your parser. - - - - Expert: an enumeration of span matches. Used to implement span searching. - Each span represents a range of term positions within a document. Matches - are enumerated in order, by increasing document number, within that by - increasing start position and finally by increasing end position. - - - - Move to the next match, returning true iff any such exists. - - - - Returns the document number of the current match. Initially invalid. - - - Returns the start position of the current match. Initially invalid. - - - Returns the end position of the current match. Initially invalid. - - - Wraps a Spans, and can be used to form a linked list. - - - Matches spans near the beginning of a field. - - - Base class for span-based queries. - - - - Sets the boost for this query clause to b. Documents - matching this clause will (in addition to the normal weightings) have - their score multiplied by b. - - - - Gets the boost for this clause. Documents matching - this clause will (in addition to the normal weightings) have their score - multiplied by b. The boost is 1.0 by default. - - - - - Prints a query to a string. - - - - Expert: Constructs and initializes a Weight for a top-level query. - - - Expert: called to re-write queries into primitive queries. For example, - a PrefixQuery will be rewritten into a BooleanQuery that consists - of TermQuerys. - - - - Expert: called when re-writing queries under MultiSearcher. - - Create a single query suitable for use by all subsearchers (in 1-1 - correspondence with queries). This is an optimization of the OR of - all queries. We handle the common optimization cases of equal - queries and overlapping clauses of boolean OR queries (as generated - by MultiTermQuery.rewrite() and RangeQuery.rewrite()). - Be careful overriding this method as queries[0] determines which - method will be called and is not necessarily of the same type as - the other queries. - - - - Expert: adds all terms occuring in this query to the terms set. Only - works if this query is in its {@link #rewrite rewritten} form. - - - UnsupportedOperationException if this query is not yet rewritten - - - - Expert: Returns the Similarity implementation to be used for this query. - Subclasses may override this method to specify their own Similarity - implementation, perhaps one that delegates through that of the Searcher. - By default the Searcher's Similarity implementation is returned. - - - - Returns a clone of this query. - - - Expert: Returns the matches for this query in an index. Used internally - to search for spans. - - - - Returns the name of the field matched by this query. - - - Returns a collection of all terms matched by this query. - use extractTerms instead - - - - - - Construct a SpanFirstQuery matching spans in match whose end - position is less than or equal to end. - - - - Return the SpanQuery whose matches are filtered. - - - Return the maximum end position permitted in a match. - - - Returns a collection of all terms matched by this query. - use ExtractTerms instead - - - - - - Matches spans which are near one another. One can specify slop, the - maximum number of intervening unmatched positions, as well as whether - matches are required to be in-order. - - - - Construct a SpanNearQuery. Matches spans matching a span from each - clause, with up to slop total unmatched positions between - them. * When inOrder is true, the spans from each clause - must be * ordered as in clauses. - - - - Return the clauses whose spans are matched. - - - Return the maximum number of intervening unmatched positions permitted. - - - Return true if matches are required to be in-order. - - - Returns a collection of all terms matched by this query. - use extractTerms instead - - - - - - Returns true iff o is equal to this. - - - Removes matches which overlap with another SpanQuery. - - - Construct a SpanNotQuery matching spans from include which - have no overlap with spans from exclude. - - - - Return the SpanQuery whose matches are filtered. - - - Return the SpanQuery whose matches must not overlap those returned. - - - Returns a collection of all terms matched by this query. - use extractTerms instead - - - - - - Returns true iff o is equal to this. - - - Matches the union of its clauses. - - - Construct a SpanOrQuery merging the provided clauses. - - - Return the clauses whose spans are matched. - - - Returns a collection of all terms matched by this query. - use ExtractTerms instead - - - - - - - Constructs a Scorer. - The Similarity implementation used by this scorer. - - - - Returns the Similarity implementation used by this scorer. - - - - Expert: Collects matching documents in a range. Hook for optimization. - Note that {@link #Next()} must be called once before this method is called - for the first time. - - The collector to which all matching documents are passed through - {@link HitCollector#Collect(int, float)}. - - Do not score documents past this. - - true if more matching documents may remain. - - - - - Returns the current document number matching the query. - Initially invalid, until {@link #Next()} is called the first time. - - - - Returns the score of the current document matching the query. - Initially invalid, until {@link #Next()} or {@link #SkipTo(int)} - is called the first time. - - - - - - Matches spans containing a term. - - - Construct a SpanTermQuery matching the named term's spans. - - - Return the term whose spans are matched. - - - Returns a collection of all terms matched by this query. - use extractTerms instead - - - - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - - The query that this concerns. - - - The weight for this query. - - - The sum of squared weights of contained query clauses. - - - Assigns the query normalization factor to this. - - - Constructs a scorer for this. - - - An explanation of the score computation for the named document. - - - A clause in a BooleanQuery. - - - The query whose matching documents are combined by the boolean query. - - - Constructs a BooleanClause. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - Specifies how terms may occur in matching documents. - - - Use this operator for terms that must appear in the matching documents. - - - Use this operator for terms that should appear in the - matching documents. For a BooleanQuery with two SHOULD - subqueries, at least one of the queries must appear in the matching documents. - - - - Use this operator for terms that must not appear in the matching documents. - Note that it is not possible to search for queries that only consist - of a MUST_NOT query. - - - - A Query that matches documents matching boolean combinations of other - queries, e.g. {@link TermQuery}s, {@link PhraseQuery}s or other - BooleanQuerys. - - - - Return the maximum number of clauses permitted, 1024 by default. - Attempts to add more than the permitted number of clauses cause {@link - TooManyClauses} to be thrown. - - - - - - - Constructs an empty boolean query. - - - Constructs an empty boolean query. - - {@link Similarity#Coord(int,int)} may be disabled in scoring, as - appropriate. For example, this score factor does not make sense for most - automatically generated queries, like {@link WildcardQuery} and {@link - FuzzyQuery}. - - - disables {@link Similarity#Coord(int,int)} in scoring. - - - - Returns true iff {@link Similarity#Coord(int,int)} is disabled in - scoring for this query instance. - - - - - - Specifies a minimum number of the optional BooleanClauses - which must be satisifed. - -

- By default no optional clauses are neccessary for a match - (unless there are no required clauses). If this method is used, - then the specified numebr of clauses is required. -

-

- Use of this method is totally independant of specifying that - any specific clauses are required (or prohibited). This number will - only be compared against the number of matching optional clauses. -

-

- EXPERT NOTE: Using this method will force the use of BooleanWeight2, - regardless of wether setUseScorer14(true) has been called. -

- - - the number of optional clauses that must match - - - - - - Gets the minimum number of the optional BooleanClauses - which must be satisifed. - - - - Adds a clause to a boolean query. - - - TooManyClauses if the new number of clauses exceeds the maximum clause number - - - - - Adds a clause to a boolean query. - TooManyClauses if the new number of clauses exceeds the maximum clause number - - - - - Returns the set of clauses in this query. - - - Indicates whether to use good old 1.4 BooleanScorer. - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - Expert: Delegating scoring implementation. Useful in {@link - Query#GetSimilarity(Searcher)} implementations, to override only certain - methods of a Searcher's Similiarty implementation.. - - - - - The Similarity implementation used by default. - - - Set the default Similarity implementation used by indexing and search - code. - - - - - - - - - - Cache of decoded bytes. - - - Decodes a normalization factor stored in an index. - - - - - Returns a table for decoding normalization bytes. - - - - - - - - - - - - - - - Construct a {@link Similarity} that delegates all methods to another. - - - the Similarity implementation to delegate to - - - - Thrown when an attempt is made to add more than {@link - #GetMaxClauseCount()} clauses. This typically happens if - a PrefixQuery, FuzzyQuery, WildcardQuery, or RangeQuery - is expanded to many terms during search. - - - - A good old 1.4 Scorer - - - - An alternative Scorer that uses and provides skipTo(), - and scores documents in document number order. - - - - A simple hash table of document scores within a range. - - - - - - The scorer to which all scoring will be delegated, - except for computing and using the coordination factor. - - - - The number of optionalScorers that need to match (if there are any) - - - Create a BooleanScorer2. - The similarity to be used. - - The minimum number of optional added scorers - that should match during the search. - In case no required scorers are added, - at least one of the optional scorers will have to - match during the search. - - - - Create a BooleanScorer2. - In no required scorers are added, - at least one of the optional scorers will have to match during the search. - - The similarity to be used. - - - - - Returns the scorer to be used for match counting and score summing. - Uses requiredScorers, optionalScorers and prohibitedScorers. - - - - Returns the scorer to be used for match counting and score summing. - Uses the given required scorer and the prohibitedScorers. - - A required scorer already built. - - - - - - - Throws an UnsupportedOperationException. - TODO: Implement an explanation of the coordination factor. - - The document number for the explanation. - - UnsupportedOperationException - - - A Scorer for OR like queries, counterpart of Lucene's ConjunctionScorer. - This Scorer implements {@link Scorer#SkipTo(int)} and uses skipTo() on the given Scorers. - - - - The number of subscorers. - - - The subscorers. - - - The minimum number of scorers that should match. - - - - The document number of the current match. - - - The number of subscorers that provide the current match. - - - - Construct a DisjunctionScorer, using one as the minimum number - of matching subscorers. - - - - Called the first time next() or skipTo() is called to - initialize scorerQueue. - - - - - Returns the score of the current document matching the query. - Initially invalid, until {@link #Next()} is called the first time. - - - - Returns the number of subscorers matching the current document. - Initially invalid, until {@link #Next()} is called the first time. - - - - - Gives and explanation for the score of a given document. - Show the resulting score. See BooleanScorer.explain() on how to do this. - - - A PriorityQueue that orders by {@link Scorer#Doc()}. - - - Scorer for conjunctions, sets of queries, all of which are required. - - - Count a scorer as a single match. - - - Wraps another filter's result and caches it. The caching - behavior is like {@link QueryFilter}. The purpose is to allow - filters to simply filter, and then wrap with this class to add - caching, keeping the two concerns decoupled yet composable. - - - - Abstract base class providing a mechanism to restrict searches to a subset - of an index. - - - - Returns a BitSet with true for documents which should be permitted in - search results, and false for those that should not. - - - - What about serialization in RemoteSearchable? Caching won't work. - Should transient be removed? - - - - Filter to cache results of - - - - A query that wraps a filter and simply returns a constant score equal to the - query boost for every document in the filter. - - - yonik - - $Id$ - - - - Prints a user-readable version of this query. - - - Returns true if o is equal to this. - - - Returns a hash code value for this object. - - - - Returns the field name for this query - - - Returns the value of the lower endpoint of this range query, null if open ended - - - Returns the value of the upper endpoint of this range query, null if open ended - - - Returns true if the lower endpoint is inclusive - - - Returns true if the upper endpoint is inclusive - - - Prints a user-readable version of this query. - - - Returns true if o is equal to this. - - - Returns a hash code value for this object. - - - Expert: Default scoring implementation. - - - Implemented as 1/sqrt(numTerms). - - - Implemented as 1/sqrt(sumOfSquaredWeights). - - - Implemented as sqrt(freq). - - - Implemented as 1 / (distance + 1). - - - Implemented as log(numDocs/(docFreq+1)) + 1. - - - Implemented as overlap / maxOverlap. - - - A query that generates the union of the documents produced by its subqueries, and that scores each document as the maximum - score for that document produced by any subquery plus a tie breaking increment for any additional matching subqueries. - This is useful to search for a word in multiple fields with different boost factors (so that the fields cannot be - combined equivalently into a single search field). We want the primary score to be the one associated with the highest boost, - not the sum of the field scores (as BooleanQuery would give). - If the query is "albino elephant" this ensures that "albino" matching one field and "elephant" matching - another gets a higher score than "albino" matching both fields. - To get this result, use both BooleanQuery and DisjunctionMaxQuery: for each term a DisjunctionMaxQuery searches for it in - each field, while the set of these DisjunctionMaxQuery's is combined into a BooleanQuery. - The tie breaker capability allows results that include the same term in multiple fields to be judged better than results that - include this term in only the best of those multiple fields, without confusing this with the better case of two different terms - in the multiple fields. - - Chuck Williams - - - - Creates a new empty DisjunctionMaxQuery. Use add() to add the subqueries. - this score of each non-maximum disjunct for a document is multiplied by this weight - and added into the final score. If non-zero, the value should be small, on the order of 0.1, which says that - 10 occurrences of word in a lower-scored field that is also in a higher scored field is just as good as a unique - word in the lower scored field (i.e., one that is not in any higher scored field. - - - - - Add a subquery to this disjunction - the disjunct added - - - - - - Optimize our representation and our subqueries representations - the IndexReader we query - - an optimized copy of us (which may not be a copy if there is nothing to optimize) - - - - Create a shallow copy of us -- used in rewriting if necessary - a copy of us (but reuse, don't copy, our subqueries) - - - - Prettyprint us. - the field to which we are applied - - a string that shows what we do, of the form "(disjunct1 | disjunct2 | ... | disjunctn)^boost" - - - - Return true iff we represent the same query as o - another object - - true iff o is a DisjunctionMaxQuery with the same boost and the same subqueries, in the same order, as us - - - - Compute a hash code for hashing us - the hash code - - - - The Scorer for DisjunctionMaxQuery's. The union of all documents generated by the the subquery scorers - is generated in document number order. The score for each document is the maximum of the scores computed - by the subquery scorers that generate that document, plus tieBreakerMultiplier times the sum of the scores - for the other subqueries that generate the document. - - Chuck Williams - - - - Creates a new instance of DisjunctionMaxScorer - Multiplier applied to non-maximum-scoring subqueries for a document as they are summed into the result. - - -- not used since our definition involves neither coord nor terms directly - - - - Add the scorer for a subquery - the scorer of a subquery of our associated DisjunctionMaxQuery - - - - Generate the next document matching our associated DisjunctionMaxQuery. - true iff there is a next document - - - - Determine the current document number. Initially invalid, until {@link #Next()} is called the first time. - the document number of the currently generated document - - - - Determine the current document score. Initially invalid, until {@link #Next()} is called the first time. - the score of the current generated document - - - - Advance to the first document beyond the current whose number is greater than or equal to target. - the minimum number of the next desired document - - true iff there is a document to be generated whose number is at least target - - - - Explain a score that we computed. UNSUPPORTED -- see explanation capability in DisjunctionMaxQuery. - the number of a document we scored - - the Explanation for our score - - - - Expert: Describes the score computation for document and query. - - - The value assigned to this explanation node. - - - Sets the value assigned to this explanation node. - - - A description of this explanation node. - - - Sets the description of this explanation node. - - - The sub-nodes of this explanation node. - - - Adds a sub-node to this explanation node. - - - Render an explanation as text. - - - Render an explanation as HTML. - - - - All the term values, in natural order. - - - For each document, an index into the lookup array. - - - Creates one of these objects - - - Indicator for StringIndex values in the cache. - - - Expert: The cache used internally by sorting and range query classes. - - - Checks the internal cache for an appropriate entry, and if none is - found, reads the terms in field as integers and returns an array - of size reader.maxDoc() of the value each document - has in the given field. - - Used to get field values. - - Which field contains the integers. - - The values in the given field for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if none is found, - reads the terms in field as integers and returns an array of - size reader.maxDoc() of the value each document has in the - given field. - - Used to get field values. - - Which field contains the integers. - - Computes integer for string values. - - The values in the given field for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if - none is found, reads the terms in field as floats and returns an array - of size reader.maxDoc() of the value each document - has in the given field. - - Used to get field values. - - Which field contains the floats. - - The values in the given field for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if - none is found, reads the terms in field as floats and returns an array - of size reader.maxDoc() of the value each document - has in the given field. - - Used to get field values. - - Which field contains the floats. - - Computes float for string values. - - The values in the given field for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if none - is found, reads the term values in field and returns an array - of size reader.maxDoc() containing the value each document - has in the given field. - - Used to get field values. - - Which field contains the strings. - - The values in the given field for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if none - is found reads the term values in field and returns - an array of them in natural order, along with an array telling - which element in the term array each document uses. - - Used to get field values. - - Which field contains the strings. - - Array of terms and index into the array for each document. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if - none is found reads field to see if it contains integers, floats - or strings, and then calls one of the other methods in this class to get the - values. For string values, a StringIndex is returned. After - calling this method, there is an entry in the cache for both - type AUTO and the actual found type. - - Used to get field values. - - Which field contains the values. - - int[], float[] or StringIndex. - - IOException If any error occurs. - - - Checks the internal cache for an appropriate entry, and if none - is found reads the terms out of field and calls the given SortComparator - to get the sort values. A hit in the cache will happen if reader, - field, and comparator are the same (using equals()) - as a previous call to this method. - - Used to get field values. - - Which field contains the values. - - Used to convert terms into something to sort by. - - Array of sort objects, one for each document. - - IOException If any error occurs. - - - Interface to parse ints from document fields. - - - - - Return an integer representation of this field's value. - - - Interface to parse floats from document fields. - - - - - Return an float representation of this field's value. - - - - The internal cache. Maps Entry to array of interpreted term values. * - - - See if an object is in the cache. - - - See if a custom object is in the cache. - - - Put an object into the cache. - - - Put a custom object into the cache. - - - The pattern used to detect float values in a field - removed for java 1.3 compatibility - protected static final Object pFloats = Pattern.compile ("[0-9+\\-\\.eEfFdD]+"); - - - - Expert: Every key in the internal cache is of this type. - - - Creates one of these objects. - - - Creates one of these objects for a custom comparator. - - - Two of these are equal iff they reference the same field and type. - - - Composes a hashcode based on the field and type. - - - - Expert: Returned by low-level search implementations. - - - - - Expert: The score of this document for the query. - - - Expert: A hit document's number. - - - - - Expert: Constructs a ScoreDoc. - - - Expert: The values which are used to sort the referenced document. - The order of these will match the original sort criteria given by a - Sort object. Each Object will be either an Integer, Float or String, - depending on the type of values in the terms of the original field. - - - - - - - - Expert: Creates one of these objects with empty sort information. - - - Expert: Creates one of these objects with the given sort information. - - - - Creates a hit queue sorted by the given list of fields. - Field names, in priority order (highest priority first). - - The number of hits to retain. Must be greater than zero. - - - - Allows redefinition of sort fields if they are null. - This is to handle the case using ParallelMultiSearcher where the - original list contains AUTO and we don't know the actual sort - type until the values come back. The fields can only be set once. - This method is thread safe. - - - - - - Returns the fields being used to sort. - - - Returns an array of collators, possibly null. The collators - correspond to any SortFields which were given a specific locale. - - Array of sort fields. - - Array, possibly null. - - - - Returns whether a is less relevant than b. - ScoreDoc - - ScoreDoc - - true if document a should be sorted after document b. - - - - - Creates a hit queue sorted by the given list of fields. - Index to use. - - Field names, in priority order (highest priority first). Cannot be null or empty. - - The number of hits to retain. Must be greater than zero. + IOException - - Stores a comparator corresponding to each field being sorted by - - - Stores the sort criteria being used. - - - Stores the maximum score value encountered, needed for normalizing. - - - returns the maximum score encountered by elements inserted via insert() - - - Returns whether a is less relevant than b. - ScoreDoc - - ScoreDoc - - true if document a should be sorted after document b. - - - - Given a FieldDoc object, stores the values used - to sort the given document. These values are not the raw - values out of the index, but the internal representation - of them. This is so the given search hit can be collated - by a MultiSearcher with other search hits. + + Do a bulk copy of numDocs documents from reader to our + streams. This is used to expedite merging, if the + field numbers are congruent. - The FieldDoc to store sort values into. - - The same FieldDoc passed in. + + + Close all streams. + + + $Id: TermVectorsReader.java 687046 2008-08-19 13:01:11Z mikemccand $ + + + + Retrieve the length (in bytes) of the tvd and tvf + entries for the next numDocs starting with + startDocID. This is used for bulk copying when + merging segments, if the field numbers are + congruent. Once this returns, the tvf & tvd streams + are seeked to the startDocID. + + + + + The number of documents in the reader - + + + Retrieve the term vector for the given document and field + The document number to retrieve the vector for + + The field within the document to retrieve + + The TermFreqVector for the document and field or null if there is no termVector for this field. + + IOException if there is an error reading the term vector files + + + Return all term vectors stored for this document or null if the could not be read in. + + + The document number to retrieve the vector for + + All term frequency vectors + + IOException if there is an error reading the term vector files + + + + The field to read in + + The pointer within the tvf file where we should start reading + + The mapper used to map the TermVector + + IOException + + + Models the existing parallel array structure + + + The TermVectorMapper can be used to map Term Vectors into your own + structure instead of the parallel array structure used by + {@link Lucene.Net.Index.IndexReader#GetTermFreqVector(int,String)}. +

+ It is up to the implementation to make sure it is thread-safe. + + + +

+ + + + true if this mapper should tell Lucene to ignore positions even if they are stored + + similar to ignoringPositions + + + + Tell the mapper what to expect in regards to field, number of terms, offset and position storage. + This method will be called once before retrieving the vector for a field. + + This method will be called before {@link #Map(String,int,TermVectorOffsetInfo[],int[])}. + + The field the vector is for + + The number of terms that need to be mapped + + true if the mapper should expect offset information + + true if the mapper should expect positions info + + + + Map the Term Vector information into your own structure + The term to add to the vector + + The frequency of the term in the document + + null if the offset is not specified, otherwise the offset into the field of the term + + null if the position is not specified, otherwise the position in the field of the term + + + + Indicate to Lucene that even if there are positions stored, this mapper is not interested in them and they + can be skipped over. Derived classes should set this to true if they want to ignore positions. The default + is false, meaning positions will be loaded if they are stored. + + false + + + + + Same principal as {@link #IsIgnoringPositions()}, but applied to offsets. false by default. + + false + + + + Passes down the index of the document whose term vector is currently being mapped, + once for each top level call to a term vector reader. +

+ Default implementation IGNORES the document number. Override if your implementation needs the document number. +

+ NOTE: Document numbers are internal to Lucene and subject to change depending on indexing operations. + +

+ index of document currently being mapped + + + + Construct the vector + The {@link TermFreqVector} based on the mappings. + + + + TermDocs provides an interface for enumerating <document, frequency> + pairs for a term.

The document portion names each document containing + the term. Documents are indicated by number. The frequency portion gives + the number of times the term occurred in each document.

The pairs are + ordered by document number. +

+ - - Returns the SortFields being used by this hit queue. - - - Internal cache of comparators. Similar to FieldCache, only - caches comparators instead of term values. + + Sets this to the data for a term. + The enumeration is reset to the start of the data for this term. - - Returns a comparator if it is in the cache. - - - Stores a comparator into the cache. - - - Returns a comparator for sorting hits according to a field containing integers. - Index to use. - - Field containg integer values. - - Comparator for sorting hits. - - IOException If an error occurs reading the index. - - - Returns a comparator for sorting hits according to a field containing floats. - Index to use. - - Field containg float values. - - Comparator for sorting hits. - - IOException If an error occurs reading the index. - - - Returns a comparator for sorting hits according to a field containing strings. - Index to use. - - Field containg string values. - - Comparator for sorting hits. - - IOException If an error occurs reading the index. - - - Returns a comparator for sorting hits according to a field containing strings. - Index to use. - - Field containg string values. - - Comparator for sorting hits. - - IOException If an error occurs reading the index. - - - Returns a comparator for sorting hits according to values in the given field. - The terms in the field are looked at to determine whether they contain integers, - floats or strings. Once the type is determined, one of the other static methods - in this class is called to get the comparator. + + Sets this to the data for the current term in a {@link TermEnum}. + This may be optimized in some implementations. - Index to use. - - Field containg values. - - Comparator for sorting hits. - - IOException If an error occurs reading the index. - - - Returns the value used to sort the given document. The - object returned must implement the java.io.Serializable - interface. This is used by multisearchers to determine how to collate results from their searchers. + + Returns the current document number.

This is invalid until {@link + #Next()} is called for the first time.

- - - Document - - Serializable object - - - Returns the type of sort. Should return SortField.SCORE, SortField.DOC, SortField.STRING, SortField.INTEGER, - SortField.FLOAT or SortField.CUSTOM. It is not valid to return SortField.AUTO. - This is used by multisearchers to determine how to collate results from their searchers. + + Returns the frequency of the term within the current document.

This + is invalid until {@link #Next()} is called for the first time.

- One of the constants in SortField. - - + + + Moves to the next pair in the enumeration.

Returns true iff there is + such a next pair in the enumeration. +

+ + + Attempts to read multiple entries from the enumeration, up to length of + docs. Document numbers are stored in docs, and term + frequencies are stored in freqs. The freqs array must be as + long as the docs array. + +

Returns the number of entries read. Zero is only returned when the + stream has been exhausted. +

+ + + Skips entries to the first beyond the current whose document number is + greater than or equal to target.

Returns true iff there is such + an entry.

Behaves as if written: 

+            boolean skipTo(int target) {
+            do {
+            if (!next())
+            return false;
+            } while (target > doc());
+            return true;
+            }
+
+ Some implementations are considerably more efficient than that. + + + + Frees associated resources. + + + This exception is thrown when an {@link IndexReader} + tries to make changes to the index (via {@link + IndexReader#deleteDocument}, {@link + IndexReader#undeleteAll} or {@link IndexReader#setNorm}) + but changes have already been committed to the index + since this reader was instantiated. When this happens + you must open a new reader on the current index to make + the changes. + + + + This is a {@link LogMergePolicy} that measures size of a + segment as the number of documents (not taking deletions + into account). + + + +

This class implements a {@link MergePolicy} that tries + to merge segments into levels of exponentially + increasing size, where each level has fewer segments than + the value of the merge factor. Whenever extra segments + (beyond the merge factor upper bound) are encountered, + all segments within the level are merged. You can get or + set the merge factor using {@link #GetMergeFactor()} and + {@link #SetMergeFactor(int)} respectively.

+ +

This class is abstract and requires a subclass to + define the {@link #size} method which specifies how a + segment's size is determined. {@link LogDocMergePolicy} + is one subclass that measures size by document count in + the segment. {@link LogByteSizeMergePolicy} is another + subclass that measures size as the total byte size of the + file(s) for the segment.

+

+ + +

Expert: a MergePolicy determines the sequence of + primitive merge operations to be used for overall merge + and optimize operations.

+ +

Whenever the segments in an index have been altered by + {@link IndexWriter}, either the addition of a newly + flushed segment, addition of many segments from + addIndexes* calls, or a previous merge that may now need + to cascade, {@link IndexWriter} invokes {@link + #findMerges} to give the MergePolicy a chance to pick + merges that are now required. This method returns a + {@link MergeSpecification} instance describing the set of + merges that should be done, or null if no merges are + necessary. When IndexWriter.optimize is called, it calls + {@link #findMergesForOptimize} and the MergePolicy should + then return the necessary merges.

+ +

Note that the policy can return more than one merge at + a time. In this case, if the writer is using {@link + SerialMergeScheduler}, the merges will be run + sequentially but if it is using {@link + ConcurrentMergeScheduler} they will be run concurrently.

+ +

The default MergePolicy is {@link + LogByteSizeMergePolicy}.

+ +

NOTE: This API is new and still experimental + (subject to change suddenly in the next release)

+ +

NOTE: This class typically requires access to + package-private APIs (e.g. SegmentInfos) to do its job; + if you implement your own MergePolicy, you'll need to put + it in package Lucene.Net.Index in order to use + these APIs. +

+ + + Determine what set of merge operations are now necessary on the index. + {@link IndexWriter} calls this whenever there is a change to the segments. + This call is always synchronized on the {@link IndexWriter} instance so + only one thread at a time will call this method. + + + the total set of segments in the index + + + + Determine what set of merge operations is necessary in order to optimize + the index. {@link IndexWriter} calls this when its + {@link IndexWriter#Optimize()} method is called. This call is always + synchronized on the {@link IndexWriter} instance so only one thread at a + time will call this method. + + + the total set of segments in the index + + requested maximum number of segments in the index (currently this + is always 1) + + contains the specific SegmentInfo instances that must be merged + away. This may be a subset of all SegmentInfos. + + + + Determine what set of merge operations is necessary in order to expunge all + deletes from the index. + + + the total set of segments in the index + + + + Release all resources for the policy. + + + Returns true if a newly flushed (not from merge) + segment should use the compound file format. + + + + Returns true if the doc store files should use the + compound file format. + + + + OneMerge provides the information necessary to perform + an individual primitive merge operation, resulting in + a single new segment. The merge spec includes the + subset of segments to be merged as well as whether the + new segment should use the compound file format. + + + + Record that an exception occurred while executing + this merge + + + + Retrieve previous exception set by {@link + #setException}. + + + + Mark this merge as aborted. If this is called + before the merge is committed then the merge will + not be committed. + + + + Returns true if this merge was aborted. + + + A MergeSpecification instance provides the information + necessary to perform multiple merges. It simply + contains a list of {@link OneMerge} instances. + + + + The subset of segments to be included in the primitive merge. + + + Exception thrown if there are any problems while + executing a merge. + + + + + Use {@link #MergePolicy.MergeException(String,Directory)} instead + + + + + Use {@link #MergePolicy.MergeException(Throwable,Directory)} instead + + + + Returns the {@link Directory} of the index that hit + the exception. + + + + Defines the allowed range of log(size) for each + level. A level is computed by taking the max segment + log size, minus LEVEL_LOG_SPAN, and finding all + segments falling within that range. + + + + Default merge factor, which is how many segments are + merged at a time + + + + Default maximum segment size. A segment of this size + - - - Constructs a new query which applies a filter to the results of the original query. - Filter.bits() will be called every time this query is used in a search. + +

Returns the number of segments that are merged at + once and also controls the total number of segments + allowed to accumulate in the index.

 - Query to be filtered, cannot be null. + + + Determines how often segment indices are merged by + addDocument(). With smaller values, less RAM is used + while indexing, and searches on unoptimized indices are + faster, but indexing speed is slower. With larger + values, more RAM is used during indexing, and while + searches on unoptimized indices are slower, indexing is + faster. Thus larger values (> 10) are best for batch + index creation, and smaller values (< 10) for indices + that are interactively maintained. + + + + Sets whether compound file format should be used for + newly flushed and newly merged segments. + + + + Returns true if newly flushed and newly merge segments + + + + + Sets whether compound file format should be used for + newly flushed and newly merged doc store + segment files (term vectors and stored fields). + + + + Returns true if newly flushed and newly merge doc + store segment files (term vectors and stored fields) + + + + + + Sets whether the segment size should be calibrated by + the number of deletes when choosing segments for merge. + + + + Returns true if the segment size should be calibrated + by the number of deletes when choosing segments for merge. + + + + Returns true if this single info is optimized (has no + pending norms or deletes, is in the same dir as the + writer, and matches the current compound file setting + + + + Returns the merges necessary to optimize the index. + This merge policy defines "optimized" to mean only one + segment in the index, where that segment has no + deletions pending nor separate norms, and it is in + compound file format if the current useCompoundFile + setting is true. This method returns multiple merges + (mergeFactor at a time) so the {@link MergeScheduler} + in use may make use of concurrency. + + + + Finds merges necessary to expunge all deletes from the + index. We simply merge adjacent segments that have + deletes, up to mergeFactor at a time. + + + + Checks if any merges are now necessary and returns a + {@link MergePolicy.MergeSpecification} if so. A merge + is necessary when there are more than {@link + #setMergeFactor} segments at a given level. When + multiple levels have too many segments, this method + will return multiple merges, allowing the {@link + MergeScheduler} to use concurrency. + + + +

Determines the largest segment (measured by + document count) that may be merged with other segments. + Small values (e.g., less than 10,000) are best for + interactive indexing, as this limits the length of + pauses while indexing to a few seconds. Larger values + are best for batched indexing and speedier + searches.

+ +

The default value is {@link Integer#MAX_VALUE}.

+ +

The default merge policy ({@link + LogByteSizeMergePolicy}) also allows you to set this + limit by net size (in MB) of the segment, using {@link + LogByteSizeMergePolicy#setMaxMergeMB}.

+

+ + + Returns the largest segment (measured by document + count) that may be merged with other segments. + + + + + + + + + + Sets the minimum size for the lowest level segments. + Any segments below this size are considered to be on + the same level (even if they vary drastically in size) + and will be merged whenever there are mergeFactor of + them. This effectively truncates the "long tail" of + small segments that would otherwise be created into a + single level. If you set this too large, it could + greatly increase the merging cost during indexing (if + you flush many small segments). + + + + Get the minimum size for a segment to remain + un-merged. + + + + + + Please subclass IndexCommit class instead + + + + Get the segments file (segments_N) associated + with this commit point. + + + + Returns all index files referenced by this commit point. + + + Delete this commit point. +

+ Upon calling this, the writer is notified that this commit + point should be deleted. +

+ Decision that a commit-point should be deleted is taken by the {@link IndexDeletionPolicy} in effect + and therefore this should only be called by its {@link IndexDeletionPolicy#onInit onInit()} or + {@link IndexDeletionPolicy#onCommit onCommit()} methods. +

+ + + NOTE: this API is experimental and will likely change + + + Adds a new term in this field; term ends with U+FFFF + char + + + + Called when we are done adding terms to this field + + + Called when DocumentsWriter decides to create a new + segment + + + + Called when DocumentsWriter decides to close the doc + stores + + + + Called when an aborting exception is hit + + + Add a new thread + + + Called when DocumentsWriter is using too much RAM. + The consumer should free RAM, if possible, returning + true if any RAM was in fact freed. + + + + Class to write byte streams into slices of shared + byte[]. This is used by DocumentsWriter to hold the + posting list for many terms in RAM. + + + + Set up the writer to write at address. + + + Write byte into byte slice stream + + + Abstract base class for input from a file in a {@link Directory}. A + random-access input stream. Used for all Lucene index input operations. + + + + + + Reads and returns a single byte. + + + + + Reads a specified number of bytes into an array at the specified offset. + the array to read bytes into - Filter to apply to query results, cannot be null. + the offset in the array to start storing bytes + + the number of bytes to read + + + + + + Reads a specified number of bytes into an array at the + specified offset with control over whether the read + should be buffered (callers who have their own buffer + should pass in "false" for useBuffer). Currently only + {@link BufferedIndexInput} respects this parameter. + + the array to read bytes into + + the offset in the array to start storing bytes + + the number of bytes to read + + set to false if the caller will handle + buffering. + + + + + + Reads four bytes and returns an int. + + + + + Reads an int stored in variable-length format. Reads between one and + five bytes. Smaller values take fewer bytes. Negative numbers are not + supported. + + + + + + Reads eight bytes and returns a long. + + + + + Reads a long stored in variable-length format. Reads between one and + nine bytes. Smaller values take fewer bytes. Negative numbers are not + supported. + + + + Call this if readString should read characters stored + in the old modified UTF8 format (length in java chars + and java's modified UTF8 encoding). This is used for + indices written pre-2.4 See LUCENE-510 for details. + + + + Reads a string. + + + + + Reads Lucene's old "modified UTF-8" encoded + characters into an array. + + the array to read characters into + + the offset in the array to start storing characters + + the number of characters to read + + + + -- please use readString or readBytes + instead, and construct the string + from those utf8 bytes + + + + Expert + + Similar to {@link #ReadChars(char[], int, int)} but does not do any conversion operations on the bytes it is reading in. It still + has to invoke {@link #ReadByte()} just as {@link #ReadChars(char[], int, int)} does, but it does not need a buffer to store anything + and it does not have to do any of the bitwise operations, since we don't actually care what is in the byte except to determine + how many more bytes to read + + The number of chars to read + + this method operates on old "modified utf8" encoded + strings + + + + Closes the stream to futher operations. + + + Returns the current position in this file, where the next read will + occur. + + + + + + Sets current position in this file, where the next read will occur. + + + + + The number of bytes in the file. + + + Returns a clone of this stream. + +

Clones of a stream access the same data, and are positioned at the same + point as the stream they were cloned from. + +

Expert: Subclasses must ensure that clones may be positioned at + different points in the input from each other and from the stream they + were cloned from. +

+ + + A {@link FieldSelector} based on a Map of field names to {@link FieldSelectorResult}s + + + + + Similar to a {@link java.io.FileFilter}, the FieldSelector allows one to make decisions about + what Fields get loaded on a {@link Document} by {@link Lucene.Net.Index.IndexReader#Document(int,Lucene.Net.Documents.FieldSelector)} + + + + + + + the field to accept or reject + + an instance of {@link FieldSelectorResult} + if the {@link Field} named fieldName should be loaded. + + + + Create a a MapFieldSelector + maps from field names (String) to {@link FieldSelectorResult}s - - Returns a Weight that applies the filter to the enclosed query's Weight. - This is accomplished by overriding the Scorer returned by the Weight. + + Create a a MapFieldSelector + fields to LOAD. List of Strings. All other fields are NO_LOAD. + + + + Create a a MapFieldSelector + fields to LOAD. All other fields are NO_LOAD. + + + + Load field according to its associated value in fieldSelections + a field name + + the fieldSelections value that field maps to or NO_LOAD if none. + + + + Provides information about what should be done with this Field + + - - Rewrites the wrapped query. - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - - Equality compare on the term - - - Equality measure on the term - - - Indicates the end of the enumeration has been reached - - - Returns the docFreq of the current Term in the enumeration. - Returns -1 if no Term matches or all terms have been enumerated. + + Load this {@link Field} every time the {@link Document} is loaded, reading in the data as it is encountered. + {@link Document#GetField(String)} and {@link Document#GetFieldable(String)} should not return null. +

+ {@link Document#Add(Fieldable)} should be called by the Reader.

- - Increments the enumeration to the next element. True if one exists. - - - Returns the current Term in the enumeration. - Returns null if no Term matches or all terms have been enumerated. + + Lazily load this {@link Field}. This means the {@link Field} is valid, but it may not actually contain its data until + invoked. {@link Document#GetField(String)} SHOULD NOT BE USED. {@link Document#GetFieldable(String)} is safe to use and should + return a valid instance of a {@link Fieldable}. +

+ {@link Document#Add(Fieldable)} should be called by the Reader.

- - Closes the enumeration to further activity, freeing resources. + + Do not load the {@link Field}. {@link Document#GetField(String)} and {@link Document#GetFieldable(String)} should return null. + {@link Document#Add(Fieldable)} is not called. +

+ {@link Document#Add(Fieldable)} should not be called by the Reader. +

+ + + Load this field as in the {@link #LOAD} case, but immediately return from {@link Field} loading for the {@link Document}. Thus, the + Document may not have its complete set of Fields. {@link Document#GetField(String)} and {@link Document#GetFieldable(String)} should + both be valid for this {@link Field} +

+ {@link Document#Add(Fieldable)} should be called by the Reader. +

+ + + Behaves much like {@link #LOAD} but does not uncompress any compressed data. This is used for internal purposes. + {@link Document#GetField(String)} and {@link Document#GetFieldable(String)} should not return null. +

+ {@link Document#Add(Fieldable)} should be called by + the Reader. +

+ This is an internal option only, and is + no longer needed now that {@link CompressionTools} + is used for field compression. + + + + Expert: Load the size of this {@link Field} rather than its value. + Size is measured as number of bytes required to store the field == bytes for a binary or any compressed value, and 2*chars for a String value. + The size is stored as a binary value, represented as an int in a byte[], with the higher order byte first in [0] + + + + Expert: Like {@link #SIZE} but immediately break from the field loading loop, i.e., stop loading further fields, after the size is loaded + + + A Tokenizer is a TokenStream whose input is a Reader. +

+ This is an abstract class; subclasses must override {@link #IncrementToken()} +

+ NOTE: Subclasses overriding {@link #next(Token)} must call + {@link AttributeSource#ClearAttributes()} before setting attributes. + Subclasses overriding {@link #IncrementToken()} must call + {@link Token#Clear()} before setting Token attributes. +

+ + + A TokenStream enumerates the sequence of tokens, either from + {@link Field}s of a {@link Document} or from query text. +

+ This is an abstract class. Concrete subclasses are: +

    +
  • {@link Tokenizer}, a TokenStream whose input is a Reader; and
    • +
  • {@link TokenFilter}, a TokenStream whose input is another + TokenStream.
    • +
+ A new TokenStream API has been introduced with Lucene 2.9. This API + has moved from being {@link Token} based to {@link Attribute} based. While + {@link Token} still exists in 2.9 as a convenience class, the preferred way + to store the information of a {@link Token} is to use {@link AttributeImpl}s. +

+ TokenStream now extends {@link AttributeSource}, which provides + access to all of the token {@link Attribute}s for the TokenStream. + Note that only one instance per {@link AttributeImpl} is created and reused + for every token. This approach reduces object creation and allows local + caching of references to the {@link AttributeImpl}s. See + {@link #IncrementToken()} for further details. +

+ The workflow of the new TokenStream API is as follows: +

    +
  1. Instantiation of TokenStream/{@link TokenFilter}s which add/get + attributes to/from the {@link AttributeSource}.
    2. +
  2. The consumer calls {@link TokenStream#Reset()}.
    3. +
  3. The consumer retrieves attributes from the stream and stores local + references to all attributes it wants to access
    4. +
  4. The consumer calls {@link #IncrementToken()} until it returns false and + consumes the attributes after each call.
    5. +
  5. The consumer calls {@link #End()} so that any end-of-stream operations + can be performed.
    6. +
  6. The consumer calls {@link #Close()} to release any resource when finished + using the TokenStream
    7. +
+ To make sure that filters and consumers know which attributes are available, + the attributes must be added during instantiation. Filters and consumers are + not required to check for availability of attributes in + {@link #IncrementToken()}. +

+ You can find some example code for the new API in the analysis package level + Javadoc. +

+ Sometimes it is desirable to capture a current state of a TokenStream + , e. g. for buffering purposes (see {@link CachingTokenFilter}, + {@link TeeSinkTokenFilter}). For this usecase + {@link AttributeSource#CaptureState} and {@link AttributeSource#RestoreState} + can be used. +

+ + + An AttributeSource contains a list of different {@link AttributeImpl}s, + and methods to add and get them. There can only be a single instance + of an attribute in the same AttributeSource instance. This is ensured + by passing in the actual type of the Attribute (Class<Attribute>) to + the {@link #AddAttribute(Class)}, which then checks if an instance of + that type is already present. If yes, it returns the instance, otherwise + it creates a new instance and returns it. + + + + An AttributeSource using the default attribute factory {@link AttributeSource.AttributeFactory#DEFAULT_ATTRIBUTE_FACTORY}. + + + An AttributeSource that uses the same attributes as the supplied one. + + + An AttributeSource using the supplied {@link AttributeFactory} for creating new {@link Attribute} instances. + + + returns the used AttributeFactory. + + + Returns a new iterator that iterates the attribute classes + in the same order they were added in. + Signature for Java 1.5: public Iterator<Class<? extends Attribute>> getAttributeClassesIterator() + + Note that this return value is different from Java in that it enumerates over the values + and not the keys + + + + Returns a new iterator that iterates all unique Attribute implementations. + This iterator may contain less entries that {@link #getAttributeClassesIterator}, + if one instance implements more than one Attribute interface. + Signature for Java 1.5: public Iterator<AttributeImpl> getAttributeImplsIterator() + + + + a cache that stores all interfaces for known implementation classes for performance (slow reflection) + + + Adds a custom AttributeImpl instance with one or more Attribute interfaces. + + + The caller must pass in a Class<? extends Attribute> value. + This method first checks if an instance of that class is + already in this AttributeSource and returns it. Otherwise a + new instance is created, added to this AttributeSource and returned. + Signature for Java 1.5: public <T extends Attribute> T addAttribute(Class<T>) + + + + Returns true, iff this AttributeSource has any attributes + + + The caller must pass in a Class<? extends Attribute> value. + Returns true, iff this AttributeSource contains the passed-in Attribute. + Signature for Java 1.5: public boolean hasAttribute(Class<? extends Attribute>) + + + + The caller must pass in a Class<? extends Attribute> value. + Returns the instance of the passed in Attribute contained in this AttributeSource + Signature for Java 1.5: public <T extends Attribute> T getAttribute(Class<T>) + + + IllegalArgumentException if this AttributeSource does not contain the + Attribute. It is recommended to always use {@link #addAttribute} even in consumers + of TokenStreams, because you cannot know if a specific TokenStream really uses + a specific Attribute. {@link #addAttribute} will automatically make the attribute + available. If you want to only use the attribute, if it is available (to optimize + consuming), use {@link #hasAttribute}. + + + + Resets all Attributes in this AttributeSource by calling + {@link AttributeImpl#Clear()} on each Attribute implementation. + + + + Captures the state of all Attributes. The return value can be passed to + {@link #restoreState} to restore the state of this or another AttributeSource. + + + + Restores this state by copying the values of all attribute implementations + that this state contains into the attributes implementations of the targetStream. + The targetStream must contain a corresponding instance for each argument + contained in this state (e.g. it is not possible to restore the state of + an AttributeSource containing a TermAttribute into a AttributeSource using + a Token instance as implementation). + + Note that this method does not affect attributes of the targetStream + that are not contained in this state. In other words, if for example + the targetStream contains an OffsetAttribute, but this state doesn't, then + the value of the OffsetAttribute remains unchanged. It might be desirable to + reset its value to the default, in which case the caller should first + call {@link TokenStream#ClearAttributes()} on the targetStream. + + + + Performs a clone of all {@link AttributeImpl} instances returned in a new + AttributeSource instance. This method can be used to e.g. create another TokenStream + with exactly the same attributes (using {@link #AttributeSource(AttributeSource)}) + + + + An AttributeFactory creates instances of {@link AttributeImpl}s. + + + returns an {@link AttributeImpl} for the supplied {@link Attribute} interface class. +

Signature for Java 1.5: public AttributeImpl createAttributeInstance(Class%lt;? extends Attribute> attClass) +

+ + + This is the default factory that creates {@link AttributeImpl}s using the + class name of the supplied {@link Attribute} interface class by appending Impl to it. + + + + This class holds the state of an AttributeSource. + + + + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + A TokenStream using the default attribute factory. + + + A TokenStream that uses the same attributes as the supplied one. + + + A TokenStream using the supplied AttributeFactory for creating new {@link Attribute} instances. + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + For extra performance you can globally enable the new + {@link #IncrementToken} API using {@link Attribute}s. There will be a + small, but in most cases negligible performance increase by enabling this, + but it only works if all TokenStreams use the new API and + implement {@link #IncrementToken}. This setting can only be enabled + globally. +

+ This setting only affects TokenStreams instantiated after this + call. All TokenStreams already created use the other setting. +

+ All core {@link Analyzer}s are compatible with this setting, if you have + your own TokenStreams that are also compatible, you should enable + this. +

+ When enabled, tokenization may throw {@link UnsupportedOperationException} + s, if the whole tokenizer chain is not compatible eg one of the + TokenStreams does not implement the new TokenStream API. +

+ The default is false, so there is the fallback to the old API + available. + +

+ This setting will no longer be needed in Lucene 3.0 as the old + API will be removed. + + + + Returns if only the new API is used. + + + + + This setting will no longer be needed in Lucene 3.0 as + the old API will be removed. + + + + Consumers (i.e., {@link IndexWriter}) use this method to advance the stream to + the next token. Implementing classes must implement this method and update + the appropriate {@link AttributeImpl}s with the attributes of the next + token. + + The producer must make no assumptions about the attributes after the + method has been returned: the caller may arbitrarily change it. If the + producer needs to preserve the state for subsequent calls, it can use + {@link #captureState} to create a copy of the current attribute state. + + This method is called for every token of a document, so an efficient + implementation is crucial for good performance. To avoid calls to + {@link #AddAttribute(Class)} and {@link #GetAttribute(Class)} or downcasts, + references to all {@link AttributeImpl}s that this stream uses should be + retrieved during instantiation. + + To ensure that filters and consumers know which attributes are available, + the attributes must be added during instantiation. Filters and consumers + are not required to check for availability of attributes in + {@link #IncrementToken()}. + + + false for end of stream; true otherwise + + Note that this method will be defined abstract in Lucene + 3.0. + + + + This method is called by the consumer after the last token has been + consumed, after {@link #IncrementToken()} returned false + (using the new TokenStream API). Streams implementing the old API + should upgrade to use this feature. +

+ This method can be used to perform any end-of-stream operations, such as + setting the final offset of a stream. The final offset of a stream might + differ from the offset of the last token eg in case one or more whitespaces + followed after the last token, but a {@link WhitespaceTokenizer} was used. + +

+ IOException + + + Returns the next token in the stream, or null at EOS. When possible, the + input Token should be used as the returned Token (this gives fastest + tokenization performance), but this is not required and a new Token may be + returned. Callers may re-use a single Token instance for successive calls + to this method. + + This implicitly defines a "contract" between consumers (callers of this + method) and producers (implementations of this method that are the source + for tokens): +
    +
  • A consumer must fully consume the previously returned {@link Token} + before calling this method again.
    • +
  • A producer must call {@link Token#Clear()} before setting the fields in + it and returning it
    • +
+ Also, the producer must make no assumptions about a {@link Token} after it + has been returned: the caller may arbitrarily change it. If the producer + needs to hold onto the {@link Token} for subsequent calls, it must clone() + it before storing it. Note that a {@link TokenFilter} is considered a + consumer. + + + a {@link Token} that may or may not be used to return; + this parameter should never be null (the callee is not required to + check for null before using it, but it is a good idea to assert that + it is not null.) + + next {@link Token} in the stream or null if end-of-stream was hit + + The new {@link #IncrementToken()} and {@link AttributeSource} + APIs should be used instead. + + + + Returns the next {@link Token} in the stream, or null at EOS. + + + The returned Token is a "full private copy" (not re-used across + calls to {@link #Next()}) but will be slower than calling + {@link #Next(Token)} or using the new {@link #IncrementToken()} + method with the new {@link AttributeSource} API. + + + + Resets this stream to the beginning. This is an optional operation, so + subclasses may or may not implement this method. {@link #Reset()} is not needed for + the standard indexing process. However, if the tokens of a + TokenStream are intended to be consumed more than once, it is + necessary to implement {@link #Reset()}. Note that if your TokenStream + caches tokens and feeds them back again after a reset, it is imperative + that you clone the tokens when you store them away (on the first pass) as + well as when you return them (on future passes after {@link #Reset()}). + + + + Releases resources associated with this stream. + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + The text source for this Tokenizer. + + + Construct a tokenizer with null input. + + + Construct a token stream processing the given input. + + + Construct a tokenizer with null input using the given AttributeFactory. + + + Construct a token stream processing the given input using the given AttributeFactory. + + + Construct a token stream processing the given input using the given AttributeSource. + + + Construct a token stream processing the given input using the given AttributeSource. + + + By default, closes the input Reader. + + + Return the corrected offset. If {@link #input} is a {@link CharStream} subclass + this method calls {@link CharStream#CorrectOffset}, else returns currentOff. + + offset as seen in the output + + corrected offset based on the input + + + + + + Expert: Reset the tokenizer to a new reader. Typically, an + analyzer (in its reusableTokenStream method) will use + this to re-use a previously created tokenizer. + + + + The start and end character offset of a Token. + + + Base interface for attributes. + + + Returns this Token's starting offset, the position of the first character + corresponding to this token in the source text. + Note that the difference between endOffset() and startOffset() may not be + equal to termText.length(), as the term text may have been altered by a + stemmer or some other filter. + + + + Set the starting and ending offset. + See StartOffset() and EndOffset() + + + + Returns this Token's ending offset, one greater than the position of the + last character corresponding to this token in the source text. The length + of the token in the source text is (endOffset - startOffset). + + + + Filters {@link LetterTokenizer} with {@link LowerCaseFilter} and + {@link StopFilter}. + + +

+ You must specify the required {@link Version} compatibility when creating + StopAnalyzer: +

    +
  • As of 2.9, position increments are preserved
    • +
+ + + + An Analyzer builds TokenStreams, which analyze text. It thus represents a + policy for extracting index terms from text. +

+ Typical implementations first build a Tokenizer, which breaks the stream of + characters from the Reader into raw Tokens. One or more TokenFilters may + then be applied to the output of the Tokenizer. +

+ + + Creates a TokenStream which tokenizes all the text in the provided + Reader. Must be able to handle null field name for + backward compatibility. + + + + Creates a TokenStream that is allowed to be re-used + from the previous time that the same thread called + this method. Callers that do not need to use more + than one TokenStream at the same time from this + analyzer should use this method for better + performance. + + + + Used by Analyzers that implement reusableTokenStream + to retrieve previously saved TokenStreams for re-use + by the same thread. + + + + Used by Analyzers that implement reusableTokenStream + to save a TokenStream for later re-use by the same + thread. + + + + This is only present to preserve + back-compat of classes that subclass a core analyzer + and override tokenStream but not reusableTokenStream + + + + Invoked before indexing a Fieldable instance if + terms have already been added to that field. This allows custom + analyzers to place an automatic position increment gap between + Fieldable instances using the same field name. The default value + position increment gap is 0. With a 0 position increment gap and + the typical default token position increment of 1, all terms in a field, + including across Fieldable instances, are in successive positions, allowing + exact PhraseQuery matches, for instance, across Fieldable instance boundaries. + + + Fieldable name being indexed. + + position increment gap, added to the next token emitted from {@link #TokenStream(String,Reader)} + + + + Just like {@link #getPositionIncrementGap}, except for + Token offsets instead. By default this returns 1 for + tokenized fields and, as if the fields were joined + with an extra space character, and 0 for un-tokenized + fields. This method is only called if the field + produced at least one token for indexing. + + + the field just indexed + + offset gap, added to the next token emitted from {@link #TokenStream(String,Reader)} + + + + Frees persistent resources used by this Analyzer + + + An array containing some common English words that are not usually useful + for searching. + + Use {@link #ENGLISH_STOP_WORDS_SET} instead + + + + An unmodifiable set containing some common English words that are not usually useful + for searching. + + + + Builds an analyzer which removes words in + ENGLISH_STOP_WORDS. + + Use {@link #StopAnalyzer(Version)} instead + + + + Builds an analyzer which removes words in ENGLISH_STOP_WORDS. + + + Builds an analyzer which removes words in + ENGLISH_STOP_WORDS. + + + See {@link StopFilter#SetEnablePositionIncrements} + + Use {@link #StopAnalyzer(Version)} instead + + + + Builds an analyzer with the stop words from the given set. + Use {@link #StopAnalyzer(Version, Set)} instead + + + + Builds an analyzer with the stop words from the given set. + + + Builds an analyzer with the stop words from the given set. + Set of stop words + + + See {@link StopFilter#SetEnablePositionIncrements} + + Use {@link #StopAnalyzer(Version, Set)} instead + + + + Builds an analyzer which removes words in the provided array. + Use {@link #StopAnalyzer(Set, boolean)} instead + + Use {@link #StopAnalyzer(Version, Set)} instead + + + + Builds an analyzer which removes words in the provided array. + Array of stop words + + + See {@link StopFilter#SetEnablePositionIncrements} + + Use {@link #StopAnalyzer(Version, Set)} instead + + + + Builds an analyzer with the stop words from the given file. + + + Use {@link #StopAnalyzer(Version, File)} instead + + + + Builds an analyzer with the stop words from the given file. + + + File to load stop words from + + + See {@link StopFilter#SetEnablePositionIncrements} + + Use {@link #StopAnalyzer(Version, File)} instead + + + + Builds an analyzer with the stop words from the given file. + + + + + See above + + File to load stop words from + + + + Builds an analyzer with the stop words from the given reader. + + + Use {@link #StopAnalyzer(Version, Reader)} instead + + + + Builds an analyzer with the stop words from the given reader. + + + Reader to load stop words from + + + See {@link StopFilter#SetEnablePositionIncrements} + + Use {@link #StopAnalyzer(Version, Reader)} instead + + + + Builds an analyzer with the stop words from the given reader. + + + See above + + Reader to load stop words from + + + + Filters LowerCaseTokenizer with StopFilter. + + + Filters LowerCaseTokenizer with StopFilter. + + + Normalizes tokens extracted with {@link StandardTokenizer}. + + + A TokenFilter is a TokenStream whose input is another TokenStream. +

+ This is an abstract class; subclasses must override {@link #IncrementToken()}. + +

+ + + + + The source of tokens for this filter. + + + Construct a token stream filtering the given input. + + + Performs end-of-stream operations, if any, and calls then end() on the + input TokenStream.

+ NOTE: Be sure to call super.end() first when overriding this method. +

+ + + Close the input TokenStream. + + + Reset the filter as well as the input TokenStream. + + + Construct filtering in. + + + Returns the next token in the stream, or null at EOS. +

Removes 's from the end of words. +

Removes dots from acronyms. +

+ + + Expert: This class provides a {@link TokenStream} + for indexing numeric values that can be used by {@link + NumericRangeQuery} or {@link NumericRangeFilter}. + +

Note that for simple usage, {@link NumericField} is + recommended. {@link NumericField} disables norms and + term freqs, as they are not usually needed during + searching. If you need to change these settings, you + should use this class. + +

See {@link NumericField} for capabilities of fields + indexed numerically.

+ +

Here's an example usage, for an int field: + + 

+             Field field = new Field(name, new NumericTokenStream(precisionStep).setIntValue(value));
+             field.setOmitNorms(true);
+             field.setOmitTermFreqAndPositions(true);
+             document.add(field);
+
+ +

For optimal performance, re-use the TokenStream and Field instance + for more than one document: + + 

+             NumericTokenStream stream = new NumericTokenStream(precisionStep);
+             Field field = new Field(name, stream);
+             field.setOmitNorms(true);
+             field.setOmitTermFreqAndPositions(true);
+             Document document = new Document();
+             document.add(field);
+            
+             for(all documents) {
+               stream.setIntValue(value)
+               writer.addDocument(document);
+             }
+
+ +

This stream is not intended to be used in analyzers; + it's more for iterating the different precisions during + indexing a specific numeric value.

+ +

NOTE: as token streams are only consumed once + the document is added to the index, if you index more + than one numeric field, use a separate NumericTokenStream + instance for each.

+ +

See {@link NumericRangeQuery} for more details on the + precisionStep + parameter as well as how numeric fields work under the hood.

+ +

NOTE: This API is experimental and + might change in incompatible ways in the next release. + +

+ 2.9 + + + + The full precision token gets this token type assigned. + + + The lower precision tokens gets this token type assigned. + + + Creates a token stream for numeric values using the default precisionStep + {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). The stream is not yet initialized, + before using set a value using the various set???Value() methods. + + + + Creates a token stream for numeric values with the specified + precisionStep. The stream is not yet initialized, + before using set a value using the various set???Value() methods. + + + + Expert: Creates a token stream for numeric values with the specified + precisionStep using the given {@link AttributeSource}. + The stream is not yet initialized, + before using set a value using the various set???Value() methods. + + + + Expert: Creates a token stream for numeric values with the specified + precisionStep using the given + {@link org.apache.lucene.util.AttributeSource.AttributeFactory}. + The stream is not yet initialized, + before using set a value using the various set???Value() methods. + + + + Initializes the token stream with the supplied long value. + the value, for which this TokenStream should enumerate tokens. + + this instance, because of this you can use it the following way: + new Field(name, new NumericTokenStream(precisionStep).SetLongValue(value)) + + + + Initializes the token stream with the supplied int value. + the value, for which this TokenStream should enumerate tokens. + + this instance, because of this you can use it the following way: + new Field(name, new NumericTokenStream(precisionStep).SetIntValue(value)) + + + + Initializes the token stream with the supplied double value. + the value, for which this TokenStream should enumerate tokens. + + this instance, because of this you can use it the following way: + new Field(name, new NumericTokenStream(precisionStep).SetDoubleValue(value)) + + + + Initializes the token stream with the supplied float value. + the value, for which this TokenStream should enumerate tokens. + + this instance, because of this you can use it the following way: + new Field(name, new NumericTokenStream(precisionStep).SetFloatValue(value)) + + + + Holds a map of String input to String output, to be used + with {@link MappingCharFilter}. + + + + Records a replacement to be applied to the inputs + stream. Whenever singleMatch occurs in + the input, it will be replaced with + replacement. + + + input String to be replaced + + output String + + + + An abstract base class for simple, character-oriented tokenizers. + + + Returns true iff a character should be included in a token. This + tokenizer generates as tokens adjacent sequences of characters which + satisfy this predicate. Characters for which this is false are used to + define token boundaries and are not included in tokens. + + + + Called on each token character to normalize it before it is added to the + token. The default implementation does nothing. Subclasses may use this + to, e.g., lowercase tokens. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + An iterator to iterate over set bits in an OpenBitSet. + This is faster than nextSetBit() for iterating over the complete set of bits, + especially when the density of the bits set is high. + + + $Id$ + + + + ** the python code that generated bitlist + def bits2int(val): + arr=0 + for shift in range(8,0,-1): + if val & 0x80: + arr = (arr << 4) | shift + val = val << 1 + return arr + def int_table(): + tbl = [ hex(bits2int(val)).strip('L') for val in range(256) ] + return ','.join(tbl) + **** + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + Expert: allocate a new buffer. + Subclasses can allocate differently. + + size of allocated buffer. + + allocated buffer. + + + + The interface for search implementations. + +

+ Searchable is the abstract network protocol for searching. Implementations + provide search over a single index, over multiple indices, and over indices + on remote servers. + +

+ Queries, filters and sort criteria are designed to be compact so that they + may be efficiently passed to a remote index, with only the top-scoring hits + being returned, rather than every matching hit. + + NOTE: this interface is kept public for convenience. Since it is not + expected to be implemented directly, it may be changed unexpectedly between + releases. +

+ + + Lower-level search API. + +

{@link HitCollector#Collect(int,float)} is called for every non-zero + scoring document. +
HitCollector-based access to remote indexes is discouraged. + +

Applications should only use this if they need all of the + matching documents. The high-level search API ({@link + Searcher#Search(Query)}) is usually more efficient, as it skips + non-high-scoring hits. + +

+ to match documents + + if non-null, used to permit documents to be collected. + + to receive hits + + BooleanQuery.TooManyClauses + use {@link #Search(Weight, Filter, Collector)} instead. + + + + Lower-level search API. + +

+ {@link Collector#Collect(int)} is called for every document.
+ Collector-based access to remote indexes is discouraged. + +

+ Applications should only use this if they need all of the matching + documents. The high-level search API ({@link Searcher#Search(Query)}) is + usually more efficient, as it skips non-high-scoring hits. + +

+ to match documents + + if non-null, used to permit documents to be collected. + + to receive hits + + BooleanQuery.TooManyClauses + + + Frees resources associated with this Searcher. + Be careful not to call this method while you are still using objects + like {@link Hits}. + + + + Expert: Returns the number of documents containing term. + Called by search code to compute term weights. + + + + + + Expert: For each term in the terms array, calculates the number of + documents containing term. Returns an array with these + document frequencies. Used to minimize number of remote calls. + + + + Expert: Returns one greater than the largest possible document number. + Called by search code to compute term weights. + + + + + + Expert: Low-level search implementation. Finds the top n + hits for query, applying filter if non-null. + +

Called by {@link Hits}. + +

Applications should usually call {@link Searcher#Search(Query)} or + {@link Searcher#Search(Query,Filter)} instead. +

+ BooleanQuery.TooManyClauses + + + Expert: Returns the stored fields of document i. + Called by {@link HitCollector} implementations. + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Get the {@link Lucene.Net.Documents.Document} at the nth position. The {@link Lucene.Net.Documents.FieldSelector} + may be used to determine what {@link Lucene.Net.Documents.Field}s to load and how they should be loaded. + + NOTE: If the underlying Reader (more specifically, the underlying FieldsReader) is closed before the lazy {@link Lucene.Net.Documents.Field} is + loaded an exception may be thrown. If you want the value of a lazy {@link Lucene.Net.Documents.Field} to be available after closing you must + explicitly load it or fetch the Document again with a new loader. + + + + Get the document at the nth position + + The {@link Lucene.Net.Documents.FieldSelector} to use to determine what Fields should be loaded on the Document. May be null, in which case all Fields will be loaded. + + The stored fields of the {@link Lucene.Net.Documents.Document} at the nth position + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + + + + + + + + + + + + + Expert: called to re-write queries into primitive queries. + BooleanQuery.TooManyClauses + + + Expert: low-level implementation method + Returns an Explanation that describes how doc scored against + weight. + +

This is intended to be used in developing Similarity implementations, + and, for good performance, should not be displayed with every hit. + Computing an explanation is as expensive as executing the query over the + entire index. +

Applications should call {@link Searcher#Explain(Query, int)}. +

+ BooleanQuery.TooManyClauses + + + Expert: Low-level search implementation with arbitrary sorting. Finds + the top n hits for query, applying + filter if non-null, and sorting the hits by the criteria in + sort. + +

Applications should usually call + {@link Searcher#Search(Query,Filter,int,Sort)} instead. + +

+ BooleanQuery.TooManyClauses + + + A Filter that restricts search results to a range of values in a given + field. + +

This filter matches the documents looking for terms that fall into the + supplied range according to {@link String#compareTo(String)}. It is not intended + for numerical ranges, use {@link NumericRangeFilter} instead. + +

If you construct a large number of range filters with different ranges but on the + same field, {@link FieldCacheRangeFilter} may have significantly better performance. + +

+ Use {@link TermRangeFilter} for term ranges or + {@link NumericRangeFilter} for numeric ranges instead. + This class will be removed in Lucene 3.0. + + + + A wrapper for {@link MultiTermQuery}, that exposes its + functionality as a {@link Filter}. +

+ MultiTermQueryWrapperFilter is not designed to + be used by itself. Normally you subclass it to provide a Filter + counterpart for a {@link MultiTermQuery} subclass. +

+ For example, {@link TermRangeFilter} and {@link PrefixFilter} extend + MultiTermQueryWrapperFilter. + This class also provides the functionality behind + {@link MultiTermQuery#CONSTANT_SCORE_FILTER_REWRITE}; + this is why it is not abstract. +

+ + + Wrap a {@link MultiTermQuery} as a Filter. + + + Expert: Return the number of unique terms visited during execution of the filter. + If there are many of them, you may consider using another filter type + or optimize your total term count in index. +

This method is not thread safe, be sure to only call it when no filter is running! + If you re-use the same filter instance for another + search, be sure to first reset the term counter + with {@link #clearTotalNumberOfTerms}. +

+ + + + + Expert: Resets the counting of unique terms. + Do this before executing the filter. + + + + + + Returns a BitSet with true for documents which should be + permitted in search results, and false for those that should + not. + + Use {@link #GetDocIdSet(IndexReader)} instead. + + + + Returns a DocIdSet with documents that should be + permitted in search results. + + + + The field this range applies to + + The lower bound on this range + + The upper bound on this range + + Does this range include the lower bound? + + Does this range include the upper bound? + + IllegalArgumentException if both terms are null or if + lowerTerm is null and includeLower is true (similar for upperTerm + and includeUpper) + + + + WARNING: Using this constructor and supplying a non-null + value in the collator parameter will cause every single + index Term in the Field referenced by lowerTerm and/or upperTerm to be + examined. Depending on the number of index Terms in this Field, the + operation could be very slow. + + + The lower bound on this range + + The upper bound on this range + + Does this range include the lower bound? + + Does this range include the upper bound? + + The collator to use when determining range inclusion; set + to null to use Unicode code point ordering instead of collation. + + IllegalArgumentException if both terms are null or if + lowerTerm is null and includeLower is true (similar for upperTerm + and includeUpper) + + + + Constructs a filter for field fieldName matching + less than or equal to upperTerm. + + + + Constructs a filter for field fieldName matching + greater than or equal to lowerTerm. + - Implements the fuzzy search query. The similiarity measurement + Implements the fuzzy search query. The similarity measurement is based on the Levenshtein (edit distance) algorithm. + + Warning: this query is not very scalable with its default prefix + length of 0 - in this case, *every* term will be enumerated and + cause an edit score calculation. + - - - Constructs a query for terms matching term. - - - Returns the pattern term. - - - Construct the enumeration to be used, expanding the pattern term. - - - Prints a user-readable version of this query. - Create a new FuzzyQuery that will match terms with a similarity of at least minimumSimilarity to term. @@ -5009,389 +3843,2310 @@ is to match that term. - - - - - - The termCompare method in FuzzyTermEnum uses Levenshtein distance to - calculate the distance between the given term and the comparing term. + + Returns the pattern term. + + + A PriorityQueue maintains a partial ordering of its elements such that the + least element can always be found in constant time. Put()'s and pop()'s + require log(size) time. + +

NOTE: This class pre-allocates a full array of + length maxSize+1, in {@link #initialize}. +

- - Finds and returns the smallest of three integers - - - - Grow the second dimension of the array, so that we can calculate the - Levenshtein difference. + + Determines the ordering of objects in this priority queue. Subclasses + must define this one method. - - The max Distance is the maximum Levenshtein distance for the text - compared to some other value that results in score that is - better than the minimum similarity. + + This method can be overridden by extending classes to return a sentinel + object which will be used by {@link #Initialize(int)} to fill the queue, so + that the code which uses that queue can always assume it's full and only + change the top without attempting to insert any new object.
+ + Those sentinel values should always compare worse than any non-sentinel + value (i.e., {@link #LessThan(Object, Object)} should always favor the + non-sentinel values).
+ + By default, this method returns false, which means the queue will not be + filled with sentinel values. Otherwise, the value returned will be used to + pre-populate the queue. Adds sentinel values to the queue.
+ + If this method is extended to return a non-null value, then the following + usage pattern is recommended: + + 
+            // extends getSentinelObject() to return a non-null value.
+            PriorityQueue pq = new MyQueue(numHits);
+            // save the 'top' element, which is guaranteed to not be null.
+            MyObject pqTop = (MyObject) pq.top();
+            <...>
+            // now in order to add a new element, which is 'better' than top (after 
+            // you've verified it is better), it is as simple as:
+            pqTop.change().
+            pqTop = pq.updateTop();
+
+ + NOTE: if this method returns a non-null value, it will be called by + {@link #Initialize(int)} {@link #Size()} times, relying on a new object to + be returned and will not check if it's null again. Therefore you should + ensure any call to this method creates a new instance and behaves + consistently, e.g., it cannot return null if it previously returned + non-null. + - the length of the "other value" + the sentinel object to use to pre-populate the queue, or null if + sentinel objects are not supported. + + + + Subclass constructors must call this. + + + Adds an Object to a PriorityQueue in log(size) time. If one tries to add + more objects than maxSize from initialize a RuntimeException + (ArrayIndexOutOfBound) is thrown. + + + use {@link #Add(Object)} which returns the new top object, + saving an additional call to {@link #Top()}. + + + + Adds an Object to a PriorityQueue in log(size) time. If one tries to add + more objects than maxSize from initialize an + {@link ArrayIndexOutOfBoundsException} is thrown. + + + the new 'top' element in the queue. + + + + Adds element to the PriorityQueue in log(size) time if either the + PriorityQueue is not full, or not lessThan(element, top()). + + + - the maximum levenshtein distance that we care about + true if element is added, false otherwise. + + use {@link #InsertWithOverflow(Object)} instead, which + encourages objects reuse. + + + + insertWithOverflow() is the same as insert() except its + return value: it returns the object (if any) that was + dropped off the heap because it was full. This can be + the given parameter (in case it is smaller than the + full heap's minimum, and couldn't be added), or another + object that was previously the smallest value in the + heap and now has been replaced by a larger one, or null + if the queue wasn't yet full with maxSize elements. + + + + Returns the least element of the PriorityQueue in constant time. + + + Removes and returns the least element of the PriorityQueue in log(size) + time. + + + + Should be called when the Object at top changes values. Still log(n) worst + case, but it's at least twice as fast to + + 
+            pq.top().change();
+            pq.adjustTop();
+
+ + instead of + + 
+            o = pq.pop();
+            o.change();
+            pq.push(o);
+
+ + + use {@link #UpdateTop()} which returns the new top element and + saves an additional call to {@link #Top()}. + + + + Should be called when the Object at top changes values. Still log(n) worst + case, but it's at least twice as fast to + + 
+            pq.top().change();
+            pq.updateTop();
+
+ + instead of + + 
+            o = pq.pop();
+            o.change();
+            pq.push(o);
+
+ + + the new 'top' element. - - Wrapper used by {@link HitIterator} to provide a lazily loaded hit - from {@link Hits}. + + Returns the number of elements currently stored in the PriorityQueue. + + + Removes all entries from the PriorityQueue. + + + Expert: obtains int field values from the + {@link Lucene.Net.Search.FieldCache FieldCache} + using getInts() and makes those values + available as other numeric types, casting as needed. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case.

- Jeremy Rayner - - - - Constructed from {@link HitIterator} - Hits returned from a search - - Hit index in Hits - - - - Returns document for this hit. + for requirements + on the field. - - +

NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

- -

Returns score for this hit. + + Create a cached int field source with default string-to-int parser. + + + Create a cached int field source with a specific string-to-int parser. + + + Writes norms. Each thread X field accumulates the norms + for the doc/fields it saw, then the flush method below + merges all of these together into a single _X.nrm file. + + + + Produce _X.nrm if any document had a field with norms + not disabled + + + + Remaps docIDs after a merge has completed, where the + merged segments had at least one deletion. This is used + to renumber the buffered deletes in IndexWriter when a + merge of segments with deletions commits. + + + + Filename filter that accept filenames and extensions only created by Lucene. - - - - - Returns id for this hit. - - - - - - - Returns the boost factor for this hit on any field of the underlying document. - - - - - - - Returns the string value of the field with the given name if any exist in - this document, or null. If multiple fields exist with this name, this - method returns the first value added. If only binary fields with this name - exist, returns null. - - - - - - - Prints the parameters to be used to discover the promised result. - - - An iterator over {@link Hits} that provides lazy fetching of each document. - {@link Hits#Iterator()} returns an instance of this class. Calls to {@link #next()} - return a {@link Hit} instance. - - - Jeremy Rayner - - - - Constructed from {@link Hits#Iterator()}. - - - true if current hit is less than the total number of {@link Hits}. - - - - Unsupported operation. - - - UnsupportedOperationException - - - Returns the total number of hits. - - - Returns a {@link Hit} instance representing the next hit in {@link Hits}. - - - Next {@link Hit}. - - - - A ranked list of documents, used to hold search results. - - - Tries to add new documents to hitDocs. - Ensures that the hit numbered min has been retrieved. - - - - Returns the total number of hits available in this set. - - - - Returns the score for the nth document in this set. - - - Returns the id for the nth document in this set. - - - Returns a {@link HitIterator} to navigate the Hits. Each item returned - from {@link Iterator#next()} is a {@link Hit}. -

- Caution: Iterate only over the hits needed. Iterating over all - hits is generally not desirable and may be the source of - performance issues. -

- - - - - - - - Frees resources associated with this Searcher. - Be careful not to call this method while you are still using objects - like {@link Hits}. - - - - Expert: Returns the number of documents containing term. - Called by search code to compute term weights. - - - - - - Expert: For each term in the terms array, calculates the number of - documents containing term. Returns an array with these - document frequencies. Used to minimize number of remote calls. - - - - Expert: Returns one greater than the largest possible document number. - Called by search code to compute term weights. - - - - - - - Expert: Returns the stored fields of document i. - Called by {@link HitCollector} implementations. - - - - - - Expert: called to re-write queries into primitive queries. - BooleanQuery.TooManyClauses - - - - - Returns the documents matching query. - BooleanQuery.TooManyClauses - - - Returns the documents matching query and - filter. - - BooleanQuery.TooManyClauses - - - Returns documents matching query sorted by - sort. - - BooleanQuery.TooManyClauses - - - Returns documents matching query and filter, - sorted by sort. - - BooleanQuery.TooManyClauses - - - - - - - - The Similarity implementation used by this searcher. - - - Expert: Set the Similarity implementation used by this Searcher. - - - - - - - - creates a weight for query - new weight - - - - Creates a searcher searching the index in the named directory. - - - Creates a searcher searching the index in the provided directory. - - - Creates a searcher searching the provided index. - - - Return the {@link IndexReader} this searches. - - - Note that the underlying IndexReader is not closed, if - IndexSearcher was constructed with IndexSearcher(IndexReader r). - If the IndexReader was supplied implicitly by specifying a directory, then - the IndexReader gets closed. - - - - A query that matches all documents. - - - John Wang - - - - MultiPhraseQuery is a generalized version of PhraseQuery, with an added - method {@link #Add(Term[])}. - To use this class, to search for the phrase "Microsoft app*" first use - add(Term) on the term "Microsoft", then find all terms that have "app" as - prefix using IndexReader.terms(Term), and use MultiPhraseQuery.add(Term[] - terms) to add them to the query. - - - Anders Nielsen - - 1.0 + $rcs = ' $Id: Exp $ ' ; - - Sets the phrase slop for this query. - - + + Returns true if this is a file that would be contained + in a CFS file. This function should only be called on + files that pass the above "accept" (ie, are already + known to be a Lucene index file). + - - Sets the phrase slop for this query. - - + + This is a DocFieldConsumer that inverts each field, + separately, from a Document, and accepts a + InvertedTermsConsumer to process those terms. + - - Add a single term at the next position in the phrase. - - + + Processes all occurrences of a single field - - Add multiple terms at the next position in the phrase. Any of the terms - may match. + + Implements the skip list writer for the default posting list format + that stores positions and payloads. - - - - Allows to specify the relative position of terms within the phrase. + + This abstract class writes skip lists with multiple levels. + + Example for skipInterval = 3: + c (skip level 2) + c c c (skip level 1) + x x x x x x x x x x (skip level 0) + d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d (posting list) + 3 6 9 12 15 18 21 24 27 30 (df) + + d - document + x - skip data + c - skip data with child pointer + + Skip level i contains every skipInterval-th entry from skip level i-1. + Therefore the number of entries on level i is: floor(df / ((skipInterval ^ (i + 1))). + + Each skip entry on a level i>0 contains a pointer to the corresponding skip entry in list i-1. + This guarantess a logarithmic amount of skips to find the target document. + + While this class takes care of writing the different skip levels, + subclasses must define the actual format of the skip data. - - - + + + Subclasses must implement the actual skip data encoding in this method. + + + the level skip data shall be writting for - + the skip buffer to write to - - - Returns the relative positions of terms in this phrase. - - - Prints a user-readable version of this query. - - - Returns true if o is equal to this. - - - Returns a hash code value for this object. - - - - Creates a searcher which searches searchables. - - - Return the array of {@link Searchable}s this searches. - - - Returns index of the searcher for document n in the array - used to construct this searcher. - - - - Returns the document number of document n within its - sub-index. - - - - Create weight in multiple index scenario. - - Distributed query processing is done in the following steps: - 1. rewrite query - 2. extract necessary terms - 3. collect dfs for these terms from the Searchables - 4. create query weight using aggregate dfs. - 5. distribute that weight to Searchables - 6. merge results - - Steps 1-4 are done here, 5+6 in the search() methods + + Writes the current skip data to the buffers. The current document frequency determines + the max level is skip data is to be written to. - rewritten queries + the current document frequency + + IOException + + + Writes the buffered skip lists to the given output. + + + the IndexOutput the skip lists shall be written to + + the pointer the skip list starts - - Document Frequency cache acting as a Dummy-Searcher. - This class is no full-fledged Searcher, but only supports - the methods necessary to initialize Weights. + + Sets the values for the current skip data. + + + Implements the skip list reader for the default posting list format + that stores positions and payloads. + - - A scorer that matches no document at all. - - - - Creates a searcher which searches searchables. - - - TODO: parallelize this one too - - - A search implementation which spans a new thread for each - Searchable, waits for each search to complete and merge - the results back together. + + This abstract class reads skip lists with multiple levels. + + See {@link MultiLevelSkipListWriter} for the information about the encoding + of the multi level skip lists. + + Subclasses must implement the abstract method {@link #ReadSkipData(int, IndexInput)} + which defines the actual format of the skip data. - - A search implementation allowing sorting which spans a new thread for each - Searchable, waits for each search to complete and merges - the results back together. + + Returns the id of the doc to which the last call of {@link #SkipTo(int)} + has skipped. - - - A thread subclass for searching a single searchable + + Skips entries to the first beyond the current whose document number is + greater than or equal to target. Returns the current doc count. + + + + Seeks the skip entry on the given level + + + initializes the reader + + + Loads the skip levels + + + Subclasses must implement the actual skip data encoding in this method. + + + the level skip data shall be read from + + the skip stream to read from + + + + Copies the values of the last read skip entry on this level + + + used to buffer the top skip levels + + + Returns the freq pointer of the doc to which the last call of + {@link MultiLevelSkipListReader#SkipTo(int)} has skipped. + + + + Returns the prox pointer of the doc to which the last call of + {@link MultiLevelSkipListReader#SkipTo(int)} has skipped. + + + + Returns the payload length of the payload stored just before + the doc to which the last call of {@link MultiLevelSkipListReader#SkipTo(int)} + has skipped. + + + + This exception is thrown when Lucene detects + an inconsistency in the index. + + + + This class wraps a Token and supplies a single attribute instance + where the delegate token can be replaced. + + Will be removed, when old TokenStream API is removed. + + + + Base class for Attributes that can be added to a + {@link Lucene.Net.Util.AttributeSource}. +

+ Attributes are used to add data in a dynamic, yet type-safe way to a source + of usually streamed objects, e. g. a {@link Lucene.Net.Analysis.TokenStream}. +

+ + + Clears the values in this AttributeImpl and resets it to its + default value. If this implementation implements more than one Attribute interface + it clears all. + + + + The default implementation of this method accesses all declared + fields of this object and prints the values in the following syntax: + + 
+            public String toString() {
+            return "start=" + startOffset + ",end=" + endOffset;
+            }
+
+ + This method may be overridden by subclasses. + + + + Subclasses must implement this method and should compute + a hashCode similar to this: + 
+            public int hashCode() {
+            int code = startOffset;
+            code = code * 31 + endOffset;
+            return code;
+            }
+
+ + see also {@link #equals(Object)} + + + + All values used for computation of {@link #hashCode()} + should be checked here for equality. + + see also {@link Object#equals(Object)} + + + + Copies the values from this Attribute into the passed-in + target attribute. The target implementation must support all the + Attributes this implementation supports. + + + + Shallow clone. Subclasses must override this if they + need to clone any members deeply, + + + + The term text of a Token. + + + Returns the Token's term text. + + This method has a performance penalty + because the text is stored internally in a char[]. If + possible, use {@link #TermBuffer()} and {@link + #TermLength()} directly instead. If you really need a + String, use this method, which is nothing more than + a convenience call to new String(token.termBuffer(), 0, token.termLength()) + + + + Copies the contents of buffer, starting at offset for + length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Copies the contents of buffer into the termBuffer array. + the buffer to copy + + + + Copies the contents of buffer, starting at offset and continuing + for length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Returns the internal termBuffer character array which + you can then directly alter. If the array is too + small for your token, use {@link + #ResizeTermBuffer(int)} to increase it. After + altering the buffer be sure to call {@link + #setTermLength} to record the number of valid + characters that were placed into the termBuffer. + + + + Grows the termBuffer to at least size newSize, preserving the + existing content. Note: If the next operation is to change + the contents of the term buffer use + {@link #SetTermBuffer(char[], int, int)}, + {@link #SetTermBuffer(String)}, or + {@link #SetTermBuffer(String, int, int)} + to optimally combine the resize with the setting of the termBuffer. + + minimum size of the new termBuffer + + newly created termBuffer with length >= newSize + + + + Return number of valid characters (length of the term) + in the termBuffer array. + + + + Set number of valid characters (length of the term) in + the termBuffer array. Use this to truncate the termBuffer + or to synchronize with external manipulation of the termBuffer. + Note: to grow the size of the array, + use {@link #ResizeTermBuffer(int)} first. + + the truncated length + + + + A Token's lexical type. The Default value is "word". + + + Returns this Token's lexical type. Defaults to "word". + + + Set the lexical type. + + + + + The positionIncrement determines the position of this token + relative to the previous Token in a TokenStream, used in phrase + searching. + +

The default value is one. + +

Some common uses for this are:

    + +
  • Set it to zero to put multiple terms in the same position. This is + useful if, e.g., a word has multiple stems. Searches for phrases + including either stem will match. In this case, all but the first stem's + increment should be set to zero: the increment of the first instance + should be one. Repeating a token with an increment of zero can also be + used to boost the scores of matches on that token.
    • + +
  • Set it to values greater than one to inhibit exact phrase matches. + If, for example, one does not want phrases to match across removed stop + words, then one could build a stop word filter that removes stop words and + also sets the increment to the number of stop words removed before each + non-stop word. Then exact phrase queries will only match when the terms + occur with no intervening stop words.
    • + +
+ + + + + + + Set the position increment. The default value is one. + + + the distance from the prior term + + + + Returns the position increment of this Token. + + + + + This attribute can be used to pass different flags down the {@link Tokenizer} chain, + eg from one TokenFilter to another one. + + + + EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long. +

+ + Get the bitset for any bits that have been set. This is completely distinct from {@link TypeAttribute#Type()}, although they do share similar purposes. + The flags can be used to encode information about the token for use by other {@link Lucene.Net.Analysis.TokenFilter}s. + + +

+ The bits + + + + + + + + The payload of a Token. See also {@link Payload}. + + + Returns this Token's payload. + + + Sets this Token's payload. + + + A Token is an occurrence of a term from the text of a field. It consists of + a term's text, the start and end offset of the term in the text of the field, + and a type string. +

+ The start and end offsets permit applications to re-associate a token with + its source text, e.g., to display highlighted query terms in a document + browser, or to show matching text fragments in a KWIC display, etc. +

+ The type is a string, assigned by a lexical analyzer + (a.k.a. tokenizer), naming the lexical or syntactic class that the token + belongs to. For example an end of sentence marker token might be implemented + with type "eos". The default token type is "word". +

+ A Token can optionally have metadata (a.k.a. Payload) in the form of a variable + length byte array. Use {@link TermPositions#GetPayloadLength()} and + {@link TermPositions#GetPayload(byte[], int)} to retrieve the payloads from the index. +

+

+ +

NOTE: As of 2.9, Token implements all {@link Attribute} interfaces + that are part of core Lucene and can be found in the {@code tokenattributes} subpackage. + Even though it is not necessary to use Token anymore, with the new TokenStream API it can + be used as convenience class that implements all {@link Attribute}s, which is especially useful + to easily switch from the old to the new TokenStream API. +

+

+

NOTE: As of 2.3, Token stores the term text + internally as a malleable char[] termBuffer instead of + String termText. The indexing code and core tokenizers + have been changed to re-use a single Token instance, changing + its buffer and other fields in-place as the Token is + processed. This provides substantially better indexing + performance as it saves the GC cost of new'ing a Token and + String for every term. The APIs that accept String + termText are still available but a warning about the + associated performance cost has been added (below). The + {@link #TermText()} method has been deprecated.

+

+

Tokenizers and TokenFilters should try to re-use a Token instance when + possible for best performance, by implementing the + {@link TokenStream#IncrementToken()} API. + Failing that, to create a new Token you should first use + one of the constructors that starts with null text. To load + the token from a char[] use {@link #SetTermBuffer(char[], int, int)}. + To load from a String use {@link #SetTermBuffer(String)} or {@link #SetTermBuffer(String, int, int)}. + Alternatively you can get the Token's termBuffer by calling either {@link #TermBuffer()}, + if you know that your text is shorter than the capacity of the termBuffer + or {@link #ResizeTermBuffer(int)}, if there is any possibility + that you may need to grow the buffer. Fill in the characters of your term into this + buffer, with {@link String#getChars(int, int, char[], int)} if loading from a string, + or with {@link System#arraycopy(Object, int, Object, int, int)}, and finally call {@link #SetTermLength(int)} to + set the length of the term text. See LUCENE-969 + for details.

+

Typical Token reuse patterns: +

    +
  • Copying text from a string (type is reset to {@link #DEFAULT_TYPE} if not + specified):
    + 
    +            return reusableToken.reinit(string, startOffset, endOffset[, type]);
+
    +
    • +
  • Copying some text from a string (type is reset to {@link #DEFAULT_TYPE} + if not specified):
    + 
    +            return reusableToken.reinit(string, 0, string.length(), startOffset, endOffset[, type]);
+
    +
    • +
  • Copying text from char[] buffer (type is reset to {@link #DEFAULT_TYPE} + if not specified):
    + 
    +            return reusableToken.reinit(buffer, 0, buffer.length, startOffset, endOffset[, type]);
+
    +
    • +
  • Copying some text from a char[] buffer (type is reset to + {@link #DEFAULT_TYPE} if not specified):
    + 
    +            return reusableToken.reinit(buffer, start, end - start, startOffset, endOffset[, type]);
+
    +
    • +
  • Copying from one one Token to another (type is reset to + {@link #DEFAULT_TYPE} if not specified):
    + 
    +            return reusableToken.reinit(source.termBuffer(), 0, source.termLength(), source.startOffset(), source.endOffset()[, source.type()]);
+
    +
    • +
+ A few things to note: +
    +
  • clear() initializes all of the fields to default values. This was changed in contrast to Lucene 2.4, but should affect no one.
    • +
  • Because TokenStreams can be chained, one cannot assume that the Token's current type is correct.
    • +
  • The startOffset and endOffset represent the start and offset in the + source text, so be careful in adjusting them.
    • +
  • When caching a reusable token, clone it. When injecting a cached token into a stream that can be reset, clone it again.
    • +
+

+

+ + + + + We will remove this when we remove the + deprecated APIs + + + + Characters for the term text. + This will be made private. Instead, use: + {@link #TermBuffer()}, + {@link #SetTermBuffer(char[], int, int)}, + {@link #SetTermBuffer(String)}, or + {@link #SetTermBuffer(String, int, int)} + + + + Length of term text in the buffer. + This will be made private. Instead, use: + {@link #TermLength()}, or @{link setTermLength(int)}. + + + + Start in source text. + This will be made private. Instead, use: + {@link #StartOffset()}, or @{link setStartOffset(int)}. + + + + End in source text. + This will be made private. Instead, use: + {@link #EndOffset()}, or @{link setEndOffset(int)}. + + + + The lexical type of the token. + This will be made private. Instead, use: + {@link #Type()}, or @{link setType(String)}. + + + + This will be made private. Instead, use: + {@link #GetPayload()}, or @{link setPayload(Payload)}. + + + + This will be made private. Instead, use: + {@link #GetPositionIncrement()}, or @{link setPositionIncrement(String)}. + + + + Constructs a Token will null text. + + + Constructs a Token with null text and start & end + offsets. + + start offset in the source text + + end offset in the source text + + + + Constructs a Token with null text and start & end + offsets plus the Token type. + + start offset in the source text + + end offset in the source text + + the lexical type of this Token + + + + Constructs a Token with null text and start & end + offsets plus flags. NOTE: flags is EXPERIMENTAL. + + start offset in the source text + + end offset in the source text + + The bits to set for this token + + + + Constructs a Token with the given term text, and start + & end offsets. The type defaults to "word." + NOTE: for better indexing speed you should + instead use the char[] termBuffer methods to set the + term text. + + term text + + start offset + + end offset + + + + Constructs a Token with the given text, start and end + offsets, & type. NOTE: for better indexing + speed you should instead use the char[] termBuffer + methods to set the term text. + + term text + + start offset + + end offset + + token type + + + + Constructs a Token with the given text, start and end + offsets, & type. NOTE: for better indexing + speed you should instead use the char[] termBuffer + methods to set the term text. + + + + + + + + token type bits + + + + Constructs a Token with the given term buffer (offset + & length), start and end + offsets + + + + + + + + + + + + + + Set the position increment. This determines the position of this token + relative to the previous Token in a {@link TokenStream}, used in phrase + searching. + +

The default value is one. + +

Some common uses for this are:

    + +
  • Set it to zero to put multiple terms in the same position. This is + useful if, e.g., a word has multiple stems. Searches for phrases + including either stem will match. In this case, all but the first stem's + increment should be set to zero: the increment of the first instance + should be one. Repeating a token with an increment of zero can also be + used to boost the scores of matches on that token.
    • + +
  • Set it to values greater than one to inhibit exact phrase matches. + If, for example, one does not want phrases to match across removed stop + words, then one could build a stop word filter that removes stop words and + also sets the increment to the number of stop words removed before each + non-stop word. Then exact phrase queries will only match when the terms + occur with no intervening stop words.
    • + +
+ + the distance from the prior term + + + + + + Returns the position increment of this Token. + + + + + Sets the Token's term text. NOTE: for better + indexing speed you should instead use the char[] + termBuffer methods to set the term text. + + use {@link #SetTermBuffer(char[], int, int)} or + {@link #SetTermBuffer(String)} or + {@link #SetTermBuffer(String, int, int)}. + + + + Returns the Token's term text. + + + This method now has a performance penalty + because the text is stored internally in a char[]. If + possible, use {@link #TermBuffer()} and {@link + #TermLength()} directly instead. If you really need a + String, use {@link #Term()} + + + + Returns the Token's term text. + + This method has a performance penalty + because the text is stored internally in a char[]. If + possible, use {@link #TermBuffer()} and {@link + #TermLength()} directly instead. If you really need a + String, use this method, which is nothing more than + a convenience call to new String(token.termBuffer(), 0, token.termLength()) + + + + Copies the contents of buffer, starting at offset for + length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Copies the contents of buffer into the termBuffer array. + the buffer to copy + + + + Copies the contents of buffer, starting at offset and continuing + for length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Returns the internal termBuffer character array which + you can then directly alter. If the array is too + small for your token, use {@link + #ResizeTermBuffer(int)} to increase it. After + altering the buffer be sure to call {@link + #setTermLength} to record the number of valid + characters that were placed into the termBuffer. + + + + Grows the termBuffer to at least size newSize, preserving the + existing content. Note: If the next operation is to change + the contents of the term buffer use + {@link #SetTermBuffer(char[], int, int)}, + {@link #SetTermBuffer(String)}, or + {@link #SetTermBuffer(String, int, int)} + to optimally combine the resize with the setting of the termBuffer. + + minimum size of the new termBuffer + + newly created termBuffer with length >= newSize + + + + Allocates a buffer char[] of at least newSize, without preserving the existing content. + its always used in places that set the content + + minimum size of the buffer + + + + Return number of valid characters (length of the term) + in the termBuffer array. + + + + Set number of valid characters (length of the term) in + the termBuffer array. Use this to truncate the termBuffer + or to synchronize with external manipulation of the termBuffer. + Note: to grow the size of the array, + use {@link #ResizeTermBuffer(int)} first. + + the truncated length + + + + Returns this Token's starting offset, the position of the first character + corresponding to this token in the source text. + Note that the difference between endOffset() and startOffset() may not be + equal to termText.length(), as the term text may have been altered by a + stemmer or some other filter. + + + + Set the starting offset. + + + + + Returns this Token's ending offset, one greater than the position of the + last character corresponding to this token in the source text. The length + of the token in the source text is (endOffset - startOffset). + + + + Set the ending offset. + + + + + Set the starting and ending offset. + See StartOffset() and EndOffset() + + + + Returns this Token's lexical type. Defaults to "word". + + + Set the lexical type. + + + + + EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long. +

+ + Get the bitset for any bits that have been set. This is completely distinct from {@link #Type()}, although they do share similar purposes. + The flags can be used to encode information about the token for use by other {@link Lucene.Net.Analysis.TokenFilter}s. + + +

+ The bits + + + + + + + + Returns this Token's payload. + + + Sets this Token's payload. + + + Resets the term text, payload, flags, and positionIncrement, + startOffset, endOffset and token type to default. + + + + Makes a clone, but replaces the term buffer & + start/end offset in the process. This is more + efficient than doing a full clone (and then calling + setTermBuffer) because it saves a wasted copy of the old + termBuffer. + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(char[], int, int)}, + {@link #setStartOffset}, + {@link #setEndOffset}, + {@link #setType} + + this Token instance + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(char[], int, int)}, + {@link #setStartOffset}, + {@link #setEndOffset} + {@link #setType} on Token.DEFAULT_TYPE + + this Token instance + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(String)}, + {@link #setStartOffset}, + {@link #setEndOffset} + {@link #setType} + + this Token instance + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(String, int, int)}, + {@link #setStartOffset}, + {@link #setEndOffset} + {@link #setType} + + this Token instance + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(String)}, + {@link #setStartOffset}, + {@link #setEndOffset} + {@link #setType} on Token.DEFAULT_TYPE + + this Token instance + + + + Shorthand for calling {@link #clear}, + {@link #SetTermBuffer(String, int, int)}, + {@link #setStartOffset}, + {@link #setEndOffset} + {@link #setType} on Token.DEFAULT_TYPE + + this Token instance + + + + Copy the prototype token's fields into this one. Note: Payloads are shared. + + + + + Copy the prototype token's fields into this one, with a different term. Note: Payloads are shared. + + + + + + + Copy the prototype token's fields into this one, with a different term. Note: Payloads are shared. + + + + + + + + + + + Use this {@link LockFactory} to disable locking entirely. + This LockFactory is used when you call {@link FSDirectory#setDisableLocks}. + Only one instance of this lock is created. You should call {@link + #GetNoLockFactory()} to get the instance. + + + + + + + + Base class for Directory implementations that store index + files in the file system. There are currently three core + subclasses: + + + + Unfortunately, because of system peculiarities, there is + no single overall best implementation. Therefore, we've + added the {@link #open} method, to allow Lucene to choose + the best FSDirectory implementation given your + environment, and the known limitations of each + implementation. For users who have no reason to prefer a + specific implementation, it's best to simply use {@link + #open}. For all others, you should instantiate the + desired implementation directly. + +

The locking implementation is by default {@link + NativeFSLockFactory}, but can be changed by + passing in a custom {@link LockFactory} instance. + The deprecated getDirectory methods default to use + {@link SimpleFSLockFactory} for backwards compatibility. + The system properties + org.apache.lucene.store.FSDirectoryLockFactoryClass + and org.apache.lucene.FSDirectory.class + are deprecated and only used by the deprecated + getDirectory methods. The system property + org.apache.lucene.lockDir is ignored completely, + If you really want to store locks + elsewhere, you can create your own {@link + SimpleFSLockFactory} (or {@link NativeFSLockFactory}, + etc.) passing in your preferred lock directory. + +

In 3.0 this class will become abstract. + +

+ + + + + A Directory is a flat list of files. Files may be written once, when they + are created. Once a file is created it may only be opened for read, or + deleted. Random access is permitted both when reading and writing. + +

Java's i/o APIs not used directly, but rather all i/o is + through this API. This permits things such as:

    +
  • implementation of RAM-based indices;
    • +
  • implementation indices stored in a database, via JDBC;
    • +
  • implementation of an index as a single file;
    • +
+ + Directory locking is implemented by an instance of {@link + LockFactory}, and can be changed for each Directory + instance using {@link #setLockFactory}. + + + + + Holds the LockFactory instance (implements locking for + this Directory instance). + + + + For some Directory implementations ({@link + FSDirectory}, and its subclasses), this method + silently filters its results to include only index + files. Please use {@link #listAll} instead, which + does no filtering. + + + + Returns an array of strings, one for each file in the + directory. Unlike {@link #list} this method does no + filtering of the contents in a directory, and it will + never return null (throws IOException instead). + + Currently this method simply fallsback to {@link + #list} for Directory impls outside of Lucene's core & + contrib, but in 3.0 that method will be removed and + this method will become abstract. + + + + Returns true iff a file with the given name exists. + + + Returns the time the named file was last modified. + + + Set the modified time of an existing file to now. + + + Removes an existing file in the directory. + + + Renames an existing file in the directory. + If a file already exists with the new name, then it is replaced. + This replacement is not guaranteed to be atomic. + + + + + + Returns the length of a file in the directory. + + + Creates a new, empty file in the directory with the given name. + Returns a stream writing this file. + + + + Ensure that any writes to this file are moved to + stable storage. Lucene uses this to properly commit + changes to the index, to prevent a machine/OS crash + from corrupting the index. + + + + Returns a stream reading an existing file. + + + Returns a stream reading an existing file, with the + specified read buffer size. The particular Directory + implementation may ignore the buffer size. Currently + the only Directory implementations that respect this + parameter are {@link FSDirectory} and {@link + Lucene.Net.Index.CompoundFileReader}. + + + + Construct a {@link Lock}. + the name of the lock file + + + + Attempt to clear (forcefully unlock and remove) the + specified lock. Only call this at a time when you are + certain this lock is no longer in use. + + name of the lock to be cleared. + + + + Closes the store. + + + Set the LockFactory that this Directory instance should + use for its locking implementation. Each * instance of + LockFactory should only be used for one directory (ie, + do not share a single instance across multiple + Directories). + + + instance of {@link LockFactory}. + + + + Get the LockFactory that this Directory instance is + using for its locking implementation. Note that this + may be null for Directory implementations that provide + their own locking implementation. + + + + Return a string identifier that uniquely differentiates + this Directory instance from other Directory instances. + This ID should be the same if two Directory instances + (even in different JVMs and/or on different machines) + are considered "the same index". This is how locking + "scopes" to the right index. + + + + Copy contents of a directory src to a directory dest. + If a file in src already exists in dest then the + one in dest will be blindly overwritten. + +

NOTE: the source directory cannot change + while this method is running. Otherwise the results + are undefined and you could easily hit a + FileNotFoundException. + +

NOTE: this method only copies files that look + like index files (ie, have extensions matching the + known extensions of index files). + +

+ source directory + + destination directory + + if true, call {@link #Close()} method on source directory + + IOException + + + AlreadyClosedException if this Directory is closed + + + This cache of directories ensures that there is a unique Directory + instance per path, so that synchronization on the Directory can be used to + synchronize access between readers and writers. We use + refcounts to ensure when the last use of an FSDirectory + instance for a given canonical path is closed, we remove the + instance from the cache. See LUCENE-776 + for some relevant discussion. + + Not used by any non-deprecated methods anymore + + + + Set whether Lucene's use of lock files is disabled. By default, + lock files are enabled. They should only be disabled if the index + is on a read-only medium like a CD-ROM. + + Use a {@link #open(File, LockFactory)} or a constructor + that takes a {@link LockFactory} and supply + {@link NoLockFactory#getNoLockFactory}. This setting does not work + with {@link #open(File)} only the deprecated getDirectory + respect this setting. + + + + Returns whether Lucene's use of lock files is disabled. + true if locks are disabled, false if locks are enabled. + + + + Use a constructor that takes a {@link LockFactory} and + supply {@link NoLockFactory#getNoLockFactory}. + + + + The default class which implements filesystem-based directories. + + + A buffer optionally used in renameTo method + + + Returns the directory instance for the named location. + + + Use {@link #Open(File)} + + + the path to the directory. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use {@link #Open(File, LockFactory)} + + + the path to the directory. + + instance of {@link LockFactory} providing the + locking implementation. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use {@link #Open(File)} + + + the path to the directory. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use {@link #Open(File)} + + + the path to the directory. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use {@link #Open(File, LockFactory)} + + + the path to the directory. + + instance of {@link LockFactory} providing the + locking implementation. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use {@link #Open(File, LockFactory)} + + + the path to the directory. + + instance of {@link LockFactory} providing the + locking implementation. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use IndexWriter's create flag, instead, to + create a new index. + + + the path to the directory. + + if true, create, or erase any existing contents. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use IndexWriter's create flag, instead, to + create a new index. + + + the path to the directory. + + if true, create, or erase any existing contents. + + the FSDirectory for the named file. + + + + Returns the directory instance for the named location. + + + Use IndexWriter's create flag, instead, to + create a new index. + + + the path to the directory. + + if true, create, or erase any existing contents. + + the FSDirectory for the named file. + + + + + + + + Initializes the directory to create a new file with the given name. + This method should be used in {@link #createOutput}. + + + + The underlying filesystem directory + + + + + + + + + + + Create a new FSDirectory for the named location (ctor for subclasses). + the path of the directory + + the lock factory to use, or null for the default + ({@link NativeFSLockFactory}); + + IOException + + + Creates an FSDirectory instance, trying to pick the + best implementation given the current environment. + The directory returned uses the {@link NativeFSLockFactory}. + +

Currently this returns {@link SimpleFSDirectory} as + NIOFSDirectory is currently not supported. + +

Currently this returns {@link SimpleFSDirectory} as + NIOFSDirectory is currently not supported. + +

NOTE: this method may suddenly change which + implementation is returned from release to release, in + the event that higher performance defaults become + possible; if the precise implementation is important to + your application, please instantiate it directly, + instead. On 64 bit systems, it may also good to + return {@link MMapDirectory}, but this is disabled + because of officially missing unmap support in Java. + For optimal performance you should consider using + this implementation on 64 bit JVMs. + +

See above +

+ + + Creates an FSDirectory instance, trying to pick the + best implementation given the current environment. + The directory returned uses the {@link NativeFSLockFactory}. + +

Currently this returns {@link SimpleFSDirectory} as + NIOFSDirectory is currently not supported. + +

NOTE: this method may suddenly change which + implementation is returned from release to release, in + the event that higher performance defaults become + possible; if the precise implementation is important to + your application, please instantiate it directly, + instead. On 64 bit systems, it may also good to + return {@link MMapDirectory}, but this is disabled + because of officially missing unmap support in Java. + For optimal performance you should consider using + this implementation on 64 bit JVMs. + +

See above +

+ + + Just like {@link #Open(File)}, but allows you to + also specify a custom {@link LockFactory}. + + + + Lists all files (not subdirectories) in the + directory. This method never returns null (throws + {@link IOException} instead). + + + NoSuchDirectoryException if the directory + does not exist, or does exist but is not a + directory. + + IOException if list() returns null + + + Lists all files (not subdirectories) in the + directory. This method never returns null (throws + {@link IOException} instead). + + + NoSuchDirectoryException if the directory + does not exist, or does exist but is not a + directory. + + IOException if list() returns null + + + Lists all files (not subdirectories) in the + directory. + + + + + + Returns true iff a file with the given name exists. + + + Returns the time the named file was last modified. + + + Returns the time the named file was last modified. + + + Set the modified time of an existing file to now. + + + Returns the length in bytes of a file in the directory. + + + Removes an existing file in the directory. + + + Renames an existing file in the directory. + Warning: This is not atomic. + + + + + + Creates an IndexOutput for the file with the given name. + In 3.0 this method will become abstract. + + + + Creates an IndexInput for the file with the given name. + In 3.0 this method will become abstract. + + + + So we can do some byte-to-hexchar conversion below + + + Closes the store to future operations. + + + For debug output. + + + Default read chunk size. This is a conditional + default: on 32bit JVMs, it defaults to 100 MB. On + 64bit JVMs, it's Integer.MAX_VALUE. + + + + + + Sets the maximum number of bytes read at once from the + underlying file during {@link IndexInput#readBytes}. + The default value is {@link #DEFAULT_READ_CHUNK_SIZE}; + +

This was introduced due to Sun + JVM Bug 6478546, which throws an incorrect + OutOfMemoryError when attempting to read too many bytes + at once. It only happens on 32bit JVMs with a large + maximum heap size.

+ +

Changes to this value will not impact any + already-opened {@link IndexInput}s. You should call + this before attempting to open an index on the + directory.

+ +

NOTE: This value should be as large as + possible to reduce any possible performance impact. If + you still encounter an incorrect OutOfMemoryError, + trying lowering the chunk size.

+

+ + + The maximum number of bytes to read at once from the + underlying file during {@link IndexInput#readBytes}. + + + + + + Use SimpleFSDirectory.SimpleFSIndexInput instead + + + + Base implementation class for buffered {@link IndexInput}. + + + Default buffer size + + + Inits BufferedIndexInput with a specific bufferSize + + + Change the buffer size used by this IndexInput + + + + + + + Expert: implements buffer refill. Reads bytes from the current position + in the input. + + the array to read bytes into + + the offset in the array to start storing bytes + + the number of bytes to read + + + + Expert: implements seek. Sets current position in this file, where the + next {@link #ReadInternal(byte[],int,int)} will occur. + + + + + + A straightforward implementation of {@link FSDirectory} + using java.io.RandomAccessFile. However, this class has + poor concurrent performance (multiple threads will + bottleneck) as it synchronizes when multiple threads + read from the same file. It's usually better to use + {@link NIOFSDirectory} or {@link MMapDirectory} instead. + + + + Create a new SimpleFSDirectory for the named location. + + + the path of the directory + + the lock factory to use, or null for the default. + + IOException + + + Create a new SimpleFSDirectory for the named location. + + + the path of the directory + + the lock factory to use, or null for the default. + + IOException + + + Create a new SimpleFSDirectory for the named location and the default lock factory. + + + the path of the directory + + IOException + + + + + + + Create a new SimpleFSDirectory for the named location and the default lock factory. + + + the path of the directory + + IOException + + + Creates an IndexOutput for the file with the given name. + + + Creates an IndexInput for the file with the given name. + + + Please use ctor taking chunkSize + + + + Please use ctor taking chunkSize + + + + IndexInput methods + + + Method used for testing. Returns true if the underlying + file descriptor is valid. + + + + Base implementation class for buffered {@link IndexOutput}. + + + Abstract base class for output to a file in a Directory. A random-access + output stream. Used for all Lucene index output operations. + + + + + + + + Writes a single byte. + + + + + Writes an array of bytes. + the bytes to write + + the number of bytes to write + + + + + + Writes an array of bytes. + the bytes to write + + the offset in the byte array + + the number of bytes to write + + + + + + Writes an int as four bytes. + + + + + Writes an int in a variable-length format. Writes between one and + five bytes. Smaller values take fewer bytes. Negative numbers are not + supported. + + + + + + Writes a long as eight bytes. + + + + + Writes an long in a variable-length format. Writes between one and five + bytes. Smaller values take fewer bytes. Negative numbers are not + supported. + + + + + + Writes a string. + + + + + Writes a sub sequence of characters from s as the old + format (modified UTF-8 encoded bytes). + + the source of the characters + + the first character in the sequence + + the number of characters in the sequence + + -- please pre-convert to utf8 bytes + instead or use {@link #writeString} + + + + Writes a sub sequence of characters from char[] as + the old format (modified UTF-8 encoded bytes). + + the source of the characters + + the first character in the sequence + + the number of characters in the sequence + + -- please pre-convert to utf8 bytes instead or use {@link #writeString} + + + + Copy numBytes bytes from input to ourself. + + + Forces any buffered output to be written. + + + Closes this stream to further operations. + + + Returns the current position in this file, where the next write will + occur. + + + + + + Sets current position in this file, where the next write will occur. + + + + + The number of bytes in the file. + + + Set the file length. By default, this method does + nothing (it's optional for a Directory to implement + it). But, certain Directory implementations (for + + can use this to inform the + underlying IO system to pre-allocate the file to the + specified size. If the length is longer than the + current file length, the bytes added to the file are + undefined. Otherwise the file is truncated. + + file length + + + + Writes a single byte. + + + + + Writes an array of bytes. + the bytes to write + + the number of bytes to write + + + + + + Forces any buffered output to be written. + + + Expert: implements buffer write. Writes bytes at the current position in + the output. + + the bytes to write + + the number of bytes to write + + + + Expert: implements buffer write. Writes bytes at the current position in + the output. + + the bytes to write + + the offset in the byte array + + the number of bytes to write + + + + Closes this stream to further operations. + + + Returns the current position in this file, where the next write will + occur. + + + + + + Sets current position in this file, where the next write will occur. + + + + + The number of bytes in the file. + + + output methods: + + + Random-access methods + + + + + + + + + + + + + + + + + + + Use SimpleFSDirectory.SimpleFSIndexOutput instead + + + + + + + + This exception is thrown when there is an attempt to + access something that has already been closed. + + + + The {@link TimeLimitingCollector} is used to timeout search requests that + take longer than the maximum allowed search time limit. After this time is + exceeded, the search thread is stopped by throwing a + {@link TimeExceededException}. + + + +

Expert: Collectors are primarily meant to be used to + gather raw results from a search, and implement sorting + or custom result filtering, collation, etc.

+ +

As of 2.9, this class replaces the deprecated + HitCollector, and offers an API for efficient collection + of hits across sequential {@link IndexReader}s. {@link + IndexSearcher} advances the collector through each of the + sub readers, in an arbitrary order. This results in a + higher performance means of collection.

+ +

Lucene's core collectors are derived from Collector. + Likely your application can use one of these classes, or + subclass {@link TopDocsCollector}, instead of + implementing Collector directly: + +

    + +
  • {@link TopDocsCollector} is an abstract base class + that assumes you will retrieve the top N docs, + according to some criteria, after collection is + done.
    • + +
  • {@link TopScoreDocCollector} is a concrete subclass + {@link TopDocsCollector} and sorts according to score + + docID. This is used internally by the {@link + IndexSearcher} search methods that do not take an + explicit {@link Sort}. It is likely the most frequently + used collector.
    • + +
  • {@link TopFieldCollector} subclasses {@link + TopDocsCollector} and sorts according to a specified + {@link Sort} object (sort by field). This is used + internally by the {@link IndexSearcher} search methods + that take an explicit {@link Sort}.
    • + +
  • {@link TimeLimitingCollector}, which wraps any other + Collector and aborts the search if it's taken too much + time, will subclass Collector in 3.0 (presently it + subclasses the deprecated HitCollector).
    • + +
  • {@link PositiveScoresOnlyCollector} wraps any other + Collector and prevents collection of hits whose score + is <= 0.0
    • + +
+ +

Collector decouples the score from the collected doc: + the score computation is skipped entirely if it's not + needed. Collectors that do need the score should + implement the {@link #setScorer} method, to hold onto the + passed {@link Scorer} instance, and call {@link + Scorer#Score()} within the collect method to compute the + current hit's score. If your collector may request the + score for a single hit multiple times, you should use + {@link ScoreCachingWrappingScorer}.

+ +

NOTE: The doc that is passed to the collect + method is relative to the current reader. If your + collector needs to resolve this to the docID space of the + Multi*Reader, you must re-base it by recording the + docBase from the most recent setNextReader call. Here's + a simple example showing how to collect docIDs into a + BitSet:

+ + 

+            Searcher searcher = new IndexSearcher(indexReader);
+            final BitSet bits = new BitSet(indexReader.maxDoc());
+            searcher.search(query, new Collector() {
+            private int docBase;
+            
+            // ignore scorer
+            public void setScorer(Scorer scorer) {
+            }
+            
+            // accept docs out of order (for a BitSet it doesn't matter)
+            public boolean acceptsDocsOutOfOrder() {
+            return true;
+            }
+            
+            public void collect(int doc) {
+            bits.set(doc + docBase);
+            }
+            
+            public void setNextReader(IndexReader reader, int docBase) {
+            this.docBase = docBase;
+            }
+            });
+
+ +

Not all collectors will need to rebase the docID. For + example, a collector that simply counts the total number + of hits would skip it.

+ +

NOTE: Prior to 2.9, Lucene silently filtered + out hits with score <= 0. As of 2.9, the core Collectors + no longer do that. It's very unusual to have such hits + (a negative query boost, or function query returning + negative custom scores, could cause it to happen). If + you need that behavior, use {@link + PositiveScoresOnlyCollector}.

+ +

NOTE: This API is experimental and might change + in incompatible ways in the next release.

+ +

+ 2.9 + + + + Called before successive calls to {@link #Collect(int)}. Implementations + that need the score of the current document (passed-in to + {@link #Collect(int)}), should save the passed-in Scorer and call + scorer.score() when needed. + + + + Called once for every document matching a query, with the unbased document + number. + +

+ Note: This is called in an inner search loop. For good search performance, + implementations of this method should not call {@link Searcher#Doc(int)} or + {@link Lucene.Net.Index.IndexReader#Document(int)} on every hit. + Doing so can slow searches by an order of magnitude or more. +

+ + + Called before collecting from each IndexReader. All doc ids in + {@link #Collect(int)} will correspond to reader. + + Add docBase to the current IndexReaders internal document id to re-base ids + in {@link #Collect(int)}. + + + next IndexReader + + + + + + + * Return true if this collector does not + * require the matching docIDs to be delivered in int sort + * order (smallest to largest) to {@link #collect}. + * + *

Most Lucene Query implementations will visit + * matching docIDs in order. However, some queries + * (currently limited to certain cases of {@link + * BooleanQuery}) can achieve faster searching if the + * Collector allows them to deliver the + * docIDs out of order. + * + *

Many collectors don't mind getting docIDs out of + * order, so it's important to return true + * here. + * +

+ + + + Default timer resolution. + + + + + Default for {@link #IsGreedy()}. + + + + + Create a TimeLimitedCollector wrapper over another {@link Collector} with a specified timeout. + the wrapped {@link Collector} + + max time allowed for collecting hits after which {@link TimeExceededException} is thrown + + + + Return the timer resolution. + + + + + Set the timer resolution. + The default timer resolution is 20 milliseconds. + This means that a search required to take no longer than + 800 milliseconds may be stopped after 780 to 820 milliseconds. +
Note that: +
    +
  • Finer (smaller) resolution is more accurate but less efficient.
    • +
  • Setting resolution to less than 5 milliseconds will be silently modified to 5 milliseconds.
    • +
  • Setting resolution smaller than current resolution might take effect only after current + resolution. (Assume current resolution of 20 milliseconds is modified to 5 milliseconds, + then it can take up to 20 milliseconds for the change to have effect.
    • +
+ + + + Checks if this time limited collector is greedy in collecting the last hit. + A non greedy collector, upon a timeout, would throw a {@link TimeExceededException} + without allowing the wrapped collector to collect current doc. A greedy one would + first allow the wrapped hit collector to collect current doc and only then + throw a {@link TimeExceededException}. + + + + + + Sets whether this time limited collector is greedy. + true to make this time limited greedy + + + + + + Calls {@link Collector#Collect(int)} on the decorated {@link Collector} + unless the allowed time has passed, in which case it throws an exception. + + + TimeExceededException + if the time allowed has exceeded. + @@ -5415,6 +6170,17 @@ Contains conversion support elements such as classes, interfaces and static methods. + + + Copies an array of chars obtained from a String into a specified array of chars + + The String to get the chars from + Position of the String to start getting the chars + Position of the String to end getting the chars + Array to return the chars + Position of the destination array of chars to start storing the chars + An array of chars + Support class used to handle threads @@ -5510,9 +6276,9 @@ - Obtain a String that represents the current Object + Obtain a String that represents the current object - A String that represents the current Object + A String that represents the current object @@ -5557,6 +6323,21 @@ The abstract pathname to list it childs. An array of abstract pathnames childs of the path specified or null if the path is not a directory + + + Returns a list of files in a give directory. + + The full path name to the directory. + + An array containing the files. + + + + Flushes the specified file stream. Ensures that all buffered + data is actually written to the file system. + + The file stream. + A simple class for number conversions. @@ -5572,6 +6353,20 @@ Max radix value. + + + Converts a number to System.String. + + + + + + + Converts a number to System.String. + + + + Converts a number to System.String in the specified radix. @@ -5596,6 +6391,14 @@ Ammount of bits to shift The resulting number from the shift operation + + + Performs an unsigned bitwise right shift with the specified number + + Number to operate on + Ammount of bits to shift + The resulting number from the shift operation + Returns the index of the first bit that is set to true that occurs @@ -5606,6 +6409,13 @@ The index to start checking from (inclusive). The index of the next set bit. + + + Converts a System.String number to long. + + + + Mimics Java's Character class. @@ -5627,18 +6437,11 @@ - + - - - - - - - @@ -5676,11 +6479,54 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -5705,330 +6551,343 @@ - + - Use for .NET 1.1 Framework only. + This class provides supporting methods of java.util.BitSet + that are not present in System.Collections.BitArray. - - - Constructs an empty phrase query. + + + Returns the next set bit at or after index, or -1 if no such bit exists. + + + the index of bit array at which to start checking + the next set bit or -1 - - - Returns the slop. See setSlop(). + + + Returns the next un-set bit at or after index, or -1 if no such bit exists. + + + the index of bit array at which to start checking + the next set bit or -1 - - Adds a term to the end of the query phrase. - The relative position of the term is the one immediately after the last term added. + + + Returns the number of bits set to true in this BitSet. + + The BitArray object. + The number of bits set to true in this BitSet. + + + + Summary description for TestSupportClass. - - Adds a term to the end of the query phrase. - The relative position of the term within the phrase is specified explicitly. - This allows e.g. phrases with more than one term at the same position - or phrases with gaps (e.g. in connection with stopwords). + + + Compares two Term arrays for equality. + + First Term array to compare + Second Term array to compare + true if the Terms are equal in both arrays, false otherwise + + + + A Hashtable which holds weak references to its keys so they + can be collected during GC. + + + + + Serves as a simple "GC Monitor" that indicates whether cleanup is needed. + If collectableObject.IsAlive is false, GC has occurred and we should perform cleanup + + + + + Customize the hashtable lookup process by overriding KeyEquals. KeyEquals + will compare both WeakKey to WeakKey and WeakKey to real keys + + + + + Perform cleanup if GC occurred + + + + + Iterate over all keys and remove keys that were collected + + + + + Wrap each key with a WeakKey and add it to the hashtable + + + + + Create a temporary copy of the real keys and return that + + + + + A weak referene wrapper for the hashtable keys. Whenever a key\value pair + is added to the hashtable, the key is wrapped using a WeakKey. WeakKey saves the + value of the original object hashcode for fast comparison. + + + + + A Dictionary enumerator which wraps the original hashtable enumerator + and performs 2 tasks: Extract the real key from a WeakKey and skip keys + that were already collected. + + + + + Support class used to handle Hashtable addition, which does a check + first to make sure the added item is unique in the hash. + + + + + Converts the specified collection to its string representation. + + The collection to convert to string. + A string representation of the specified collection. + + + + Compares two string arrays for equality. + + First string array list to compare + Second string array list to compare + true if the strings are equal in both arrays, false otherwise + + + + Sorts an IList collections + + The System.Collections.IList instance that will be sorted + The Comparator criteria, null to use natural comparator. + + + + Fills the array with an specific value from an specific index to an specific index. + + The array to be filled. + The first index to be filled. + The last index to be filled. + The value to fill the array with. + + + + Fills the array with an specific value. + + The array to be filled. + The value to fill the array with. + + + + Compares the entire members of one array whith the other one. + + The array to be compared. + The array to be compared with. + Returns true if the two specified arrays of Objects are equal + to one another. The two arrays are considered equal if both arrays + contain the same number of elements, and all corresponding pairs of + elements in the two arrays are equal. Two objects e1 and e2 are + considered equal if (e1==null ? e2==null : e1.equals(e2)). In other + words, the two arrays are equal if they contain the same elements in + the same order. Also, two array references are considered equal if + both are null. + + + A collection of which can be + looked up by instances of . + The type of the items contains in this + collection. + The type of the keys that can be used to look + up the items. + + + Creates a new instance of the + class. + The which will convert + instances of to + when the override of is called. + + + The which will convert + instances of to + when the override of is called. + + + Converts an item that is added to the collection to + a key. + The instance of + to convert into an instance of . + The instance of which is the + key for this item. + + + Determines if a key for an item exists in this + collection. + The instance of + to see if it exists in this collection. + True if the key exists in the collection, false otherwise. + + + Represents a strongly typed list of objects that can be accessed by index. + Provides methods to search, sort, and manipulate lists. Also provides functionality + to compare lists against each other through an implementations of + . + The type of elements in the list. + + + Initializes a new instance of the + class that is empty and has the + default initial capacity. + + + Initializes a new instance of the + class that contains elements copied from the specified collection and has + sufficient capacity to accommodate the number of elements copied. + The collection whose elements are copied to the new list. + + + Initializes a new instance of the + class that is empty and has the specified initial capacity. + The number of elements that the new list can initially store. + + + Adds a range of objects represented by the + implementation. + The + implementation to add to this list. + + + Compares the counts of two + implementations. + This uses a trick in LINQ, sniffing types for implementations + of interfaces that might supply shortcuts when trying to make comparisons. + In this case, that is the and + interfaces, either of which can provide a count + which can be used in determining the equality of sequences (if they don't have + the same count, then they can't be equal). + The from the left hand side of the + comparison to check the count of. + The from the right hand side of the + comparison to check the count of. + Null if the result is indeterminate. This occurs when either + or doesn't implement or . + Otherwise, it will get the count from each and return true if they are equal, false otherwise. + + + Compares the contents of a + implementation to another one to determine equality. + Thinking of the implementation as + a string with any number of characters, the algorithm checks + each item in each list. If any item of the list is not equal (or + one list contains all the elements of another list), then that list + element is compared to the other list element to see which + list is greater. + The implementation + that is considered the left hand side. + The implementation + that is considered the right hand side. + True if the items are equal, false otherwise. + + + Compares this sequence to another + implementation, returning true if they are equal, false otherwise. + The other implementation + to compare against. + True if the sequence in + is the same as this one. + + + Compares this object for equality against other. + The other object to compare this object against. + True if this object and are equal, false + otherwise. + + + Gets the hash code for the list. + The hash code value. + + + Gets the hash code for the list. + The + implementation which will have all the contents hashed. + The hash code value. + + + Clones the . + This is a shallow clone. + A new shallow clone of this + . + + + + A simple wrapper to allow for the use of the GeneralKeyedCollection. The + wrapper is required as there can be several keys for an object depending + on how many interfaces it implements. + + + + + Provides platform infos. + + + + + Whether we run under a Unix platform. + + + + + Whether we run under a supported Windows platform. + + + + TimerThread provides a pseudo-clock service to all searching + threads, so that they can count elapsed time with less overhead + than repeatedly calling System.currentTimeMillis. A single + thread should be created to be used for all searches. + + + + Get the timer value in milliseconds. + + + Thrown when elapsed search time exceeds allowed search time. + + + Returns allowed time (milliseconds). + + + Returns elapsed time (milliseconds). + + + Returns last doc that was collected when the search time exceeded. + + + Stores information about how to sort documents by terms in an individual + field. Fields must be indexed in order to sort by them. + +

Created: Feb 11, 2004 1:25:29 PM

- - - - - - - Returns the set of terms in this phrase. - - - Returns the relative positions of terms in this phrase. - - - - - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - A Query that matches documents containing terms with a specified prefix. A PrefixQuery - is built by QueryParser for input like app*. - - - - Constructs a query for terms starting with prefix. - - - Returns the prefix of this query. - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - - Constructs a filter which only matches documents matching - query. - - - - - - - - - - - The original list of terms from the query, can contain duplicates - - - - A Filter that restricts search results to a range of values in a given - field. - -

- This code borrows heavily from {@link RangeQuery}, but is implemented as a Filter - -

- - - - The field this range applies to - - The lower bound on this range - - The upper bound on this range - - Does this range include the lower bound? - - Does this range include the upper bound? - - IllegalArgumentException if both terms are null or if - lowerTerm is null and includeLower is true (similar for upperTerm - and includeUpper) - - - - Constructs a filter for field fieldName matching - less than or equal to upperTerm. - - - - Constructs a filter for field fieldName matching - greater than or equal to lowerTerm. - - - - Returns a BitSet with true for documents which should be - permitted in search results, and false for those that should - not. - - - - Returns true if o is equal to this. - - - Returns a hash code value for this object. - - - A Query that matches documents within an exclusive range. A RangeQuery - is built by QueryParser for input like [010 TO 120]. - - - $Id: RangeQuery.java 329381 2005-10-29 09:26:21Z ehatcher $ + lucene 1.4 + + $Id: SortField.java 801344 2009-08-05 18:05:06Z yonik $ - - - Constructs a query selecting all terms greater than - lowerTerm but less than upperTerm. - There must be at least one term and either term may be null, - in which case there is no bound on that side, but if there are - two terms, both terms must be for the same field. - - - - Returns the field name for this query - - - Returns the lower term of this range query - - - Returns the upper term of this range query - - - Returns true if the range query is inclusive - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - A remote searchable implementation. - - - $Id: RemoteSearchable.java 351472 2005-12-01 21:15:53Z bmesser $ - - - - Constructs and exports a remote searcher. - - - Exports a searcher for the index in args[0] named - "//localhost/Searchable". - - - - - Construct a ReqExclScorer. - The scorer that must match, except where - - indicates exclusion. - - - - - Returns the score of the current document matching the query. - Initially invalid, until {@link #Next()} is called the first time. - - The score of the required scorer. - - - - - - The scorers passed from the constructor. - These are set to null as soon as their next() or skipTo() returns false. - - - - Construct a ReqOptScorer. - The required scorer. This must match. - - The optional scorer. This is used for scoring only. - - - - Returns the score of the current document matching the query. - Initially invalid, until {@link #Next()} is called the first time. - - The score of the required scorer, eventually increased by the score - of the optional scorer when it also matches the current document. - - - - Explain the score of a document. - Also show the total score. - See BooleanScorer.explain() on how to do this. - - - - - Special comparator for sorting hits according to computed relevance (document score). - - - Special comparator for sorting hits according to index order (document number). - - - - Represents sorting by computed relevance. Using this sort criteria returns - the same results as calling - {@link Searcher#Search(Query) Searcher#search()}without a sort criteria, - only with slightly more overhead. - - - - Represents sorting by index order. - - - Sorts by computed relevance. This is the same sort criteria as calling - {@link Searcher#Search(Query) Searcher#search()}without a sort criteria, - only with slightly more overhead. - - - - Sorts by the terms in field then by index order (document - number). The type of value in field is determined - automatically. - - - + - - Sorts possibly in reverse by the terms in field then by - index order (document number). The type of value in field is - determined automatically. - - - - - - - Sorts in succession by the terms in each field. The type of value in - field is determined automatically. - - - - - - - Sorts by the criteria in the given SortField. - - - Sorts in succession by the criteria in each SortField. - - - Sets the sort to the terms in field then by index order - (document number). - - - - Sets the sort to the terms in field possibly in reverse, - then by index order (document number). - - - - Sets the sort to the terms in each field in succession. - - - Sets the sort to the given criteria. - - - Sets the sort to the given criteria in succession. - - - Representation of the sort criteria. - Array of SortField objects used in this sort criteria - - - - - - Creates a comparator for the field in the given index. - Index to create comparator for. - - Field to create comparator for. - - Comparator of ScoreDoc objects. - - IOException If an error occurs reading the index. - - - Sort by document score (relevancy). Sort values are Float and higher values are at the front. @@ -6043,8 +6902,12 @@ Guess type of sort based on field contents. A regular expression is used to look at the first term indexed for the field and determine if it represents an integer number, a floating point number, or just arbitrary - string characters. + string characters. + Please specify the exact type, instead. + Especially, guessing does not work with the new + {@link NumericField} type. + Sort using term values as Strings. Sort values are String and lower @@ -6061,11 +6924,38 @@ lower values are at the front. + + Sort using term values as encoded Longs. Sort values are Long and + lower values are at the front. + + + + Sort using term values as encoded Doubles. Sort values are Double and + lower values are at the front. + + + + Sort using term values as encoded Shorts. Sort values are Short and + lower values are at the front. + + Sort using a custom Comparator. Sort values are any Comparable and sorting is done according to natural order. + + Sort using term values as encoded Bytes. Sort values are Byte and + lower values are at the front. + + + + Sort using term values as Strings, but comparing by + value (using String.compareTo) for all comparisons. + This is typically slower than {@link #STRING}, which + uses ordinals to do the sorting. + + Represents sorting by document score (relevancy). @@ -6076,8 +6966,11 @@ Creates a sort by terms in the given field where the type of term value is determined dynamically ({@link #AUTO AUTO}). - Name of field to sort by, cannot be null. + Name of field to sort by, cannot be + null. + Please specify the exact type instead. + Creates a sort, possibly in reverse, by terms in the given field where @@ -6087,6 +6980,8 @@ True if natural order should be reversed. + Please specify the exact type instead. + Creates a sort by terms in the given field with the type of term @@ -6110,6 +7005,38 @@ True if natural order should be reversed. + + Creates a sort by terms in the given field, parsed + to numeric values using a custom {@link FieldCache.Parser}. + + Name of field to sort by. Must not be null. + + Instance of a {@link FieldCache.Parser}, + which must subclass one of the existing numeric + parsers from {@link FieldCache}. Sort type is inferred + by testing which numeric parser the parser subclasses. + + IllegalArgumentException if the parser fails to + subclass an existing numeric parser, or field is null + + + + Creates a sort, possibly in reverse, by terms in the given field, parsed + to numeric values using a custom {@link FieldCache.Parser}. + + Name of field to sort by. Must not be null. + + Instance of a {@link FieldCache.Parser}, + which must subclass one of the existing numeric + parsers from {@link FieldCache}. Sort type is inferred + by testing which numeric parser the parser subclasses. + + True if natural order should be reversed. + + IllegalArgumentException if the parser fails to + subclass an existing numeric parser, or field is null + + Creates a sort by terms in the given field sorted according to the given locale. @@ -6134,6 +7061,15 @@ Returns a comparator for sorting hits. + use SortField (String field, FieldComparatorSource comparator) + + + + Creates a sort with a custom comparison function. + Name of field to sort by; cannot be null. + + Returns a comparator for sorting hits. + Creates a sort, possibly in reverse, with a custom comparison function. @@ -6143,6 +7079,17 @@ True if natural order should be reversed. + use SortField (String field, FieldComparatorSource comparator, boolean reverse) + + + + Creates a sort, possibly in reverse, with a custom comparison function. + Name of field to sort by; cannot be null. + + Returns a comparator for sorting hits. + + True if natural order should be reversed. + Returns the name of the field. Could return null @@ -6163,459 +7110,4087 @@ Locale, or null. + + Returns the instance of a {@link FieldCache} parser that fits to the given sort type. + May return null if no parser was specified. Sorting is using the default parser then. + + An instance of a {@link FieldCache} parser, or null. + + Returns whether the sort should be reversed. True if natural order should be reversed. - - A Query that matches documents containing a term. - This may be combined with other terms with a {@link BooleanQuery}. - + + use {@link #GetComparatorSource()} + - - Constructs a query for the term t. - - - Returns the term of this query. - - - Prints a user-readable version of this query. - - - Returns true iff o is equal to this. - - - Returns a hash code value for this object. - - - Expert: A Scorer for documents matching a Term. - - - - Returns the current document number matching the query. - Initially invalid, until {@link #Next()} is called the first time. - - - - - - - Returns a string representation of this TermScorer. - - - - Construct to collect a given number of hits. - the maximum number of hits to collect - - - - The total number of documents that matched this query. - - - The top-scoring hits. - - - Expert: Returned by low-level search implementations. - - - - - Expert: The total number of hits for the query. - - - - - Expert: The top hits for the query. - - - Expert: Stores the maximum score value encountered, needed for normalizing. - - - Expert: Returns the maximum score value encountered. - - - Expert: Sets the maximum score value encountered. - - - Expert: Constructs a TopDocs. - - - - Construct to collect a given number of hits. - the index to be searched - - the sort criteria - - the maximum number of hits to collect - - - - - The fields which were used to sort results by. - - - Creates one of these objects. - Total number of hits for the query. - - The top hits for the query. - - The sort criteria used to find the top hits. - - The maximum score encountered. - - - - Implements the wildcard search query. Supported wildcards are *, which - matches any character sequence (including the empty one), and ?, - which matches any single character. Note this query can be slow, as it - needs to iterate over many terms. In order to prevent extremely slow WildcardQueries, - a Wildcard term should not start with one of the wildcards * or - ?. + + Use legacy IndexSearch implementation: search with a DirectoryReader rather + than passing a single hit collector to multiple SegmentReaders. - - + true for legacy behavior + + will be removed in Lucene 3.0. + - - - ***************************************** - String equality with support for wildcards - ****************************************** + + if true, IndexSearch will use legacy sorting search implementation. + eg. multiple Priority Queues. + + will be removed in Lucene 3.0. + + + + Returns true if o is equal to this. If a + {@link SortComparatorSource} (deprecated) or {@link + FieldCache.Parser} was provided, it must properly + implement equals (unless a singleton is always used). - - - Determines if a word matches a wildcard pattern. - Work released by Granta Design Ltd after originally being done on - company time. + + Returns true if o is equal to this. If a + {@link SortComparatorSource} (deprecated) or {@link + FieldCache.Parser} was provided, it must properly + implement hashCode (unless a singleton is always + used). - - Base implementation class for buffered {@link IndexOutput}. - - - Abstract base class for output to a file in a Directory. A random-access - output stream. Used for all Lucene index output operations. + + + Lucene.Net specific. Needed for Serialization - - - - + + - - Writes a single byte. - - - - - Writes an array of bytes. - the bytes to write - - the number of bytes to write - - - - - - Writes an int as four bytes. - - - - - Writes an int in a variable-length format. Writes between one and - five bytes. Smaller values take fewer bytes. Negative numbers are not - supported. + + + Lucene.Net specific. Needed for deserialization - - + + - - Writes a long as eight bytes. - - - - - Writes an long in a variable-length format. Writes between one and five - bytes. Smaller values take fewer bytes. Negative numbers are not - supported. - - - - - - Writes a string. - - - - - Writes a sequence of UTF-8 encoded characters from a string. - the source of the characters - - the first character in the sequence - - the number of characters in the sequence - - - - - - Forces any buffered output to be written. - - - Closes this stream to further operations. - - - Returns the current position in this file, where the next write will - occur. - - - - - - Sets current position in this file, where the next write will occur. - - - - - The number of bytes in the file. - - - Writes a single byte. - - - - - Writes an array of bytes. - the bytes to write - - the number of bytes to write - - - - - - Forces any buffered output to be written. - - - Expert: implements buffer write. Writes bytes at the current position in - the output. - - the bytes to write - - the number of bytes to write - - - - Closes this stream to further operations. - - - Returns the current position in this file, where the next write will - occur. - - - - - - Sets current position in this file, where the next write will occur. - - - - - The number of bytes in the file. - - - Straightforward implementation of {@link Directory} as a directory of files. + + Returns the {@link FieldComparator} to use for + sorting. + + NOTE: This API is experimental and might change in + incompatible ways in the next release. - - - Doug Cutting - - - - This cache of directories ensures that there is a unique Directory - instance per path, so that synchronization on the Directory can be used to - synchronize access between readers and writers. - - This should be a WeakHashMap, so that entries can be GC'd, but that would - require Java 1.2. Instead we use refcounts... - - - - Set whether Lucene's use of lock files is disabled. By default, - lock files are enabled. They should only be disabled if the index - is on a read-only medium like a CD-ROM. - - - - Returns whether Lucene's use of lock files is disabled. - true if locks are disabled, false if locks are enabled. + number of top hits the queue will store + + position of this SortField within {@link + Sort}. The comparator is primary if sortPos==0, + secondary if sortPos==1, etc. Some comparators can + optimize themselves when they are the primary sort. + + {@link FieldComparator} to use when sorting - - Directory specified by Lucene.Net.lockDir - or java.io.tmpdir system property + + Attempts to detect the given field type for an IndexReader. + + + + + The BoostingTermQuery is very similar to the {@link Lucene.Net.Search.Spans.SpanTermQuery} except + that it factors in the value of the payload located at each of the positions where the + {@link Lucene.Net.Index.Term} occurs. +

+ In order to take advantage of this, you must override {@link Lucene.Net.Search.Similarity#ScorePayload(String, byte[],int,int)} + which returns 1 by default. +

+ Payload scores are averaged across term occurrences in the document. + +

+ + + + See {@link Lucene.Net.Search.Payloads.PayloadTermQuery} + + + + This class is very similar to + {@link Lucene.Net.Search.Spans.SpanTermQuery} except that it factors + in the value of the payload located at each of the positions where the + {@link Lucene.Net.Index.Term} occurs. +

+ In order to take advantage of this, you must override + {@link Lucene.Net.Search.Similarity#ScorePayload(String, byte[],int,int)} + which returns 1 by default. +

+ Payload scores are aggregated using a pluggable {@link PayloadFunction}. +

- - The default class which implements filesystem-based directories. + + Matches spans containing a term. - - A buffer optionally used in renameTo method + + Construct a SpanTermQuery matching the named term's spans. - - - + + Return the term whose spans are matched. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + + Expert-only. Public for use by other weight implementations + + + Public for extension only. + + + not needed anymore + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + + {@link #GetSpanScore()} * {@link #GetPayloadScore()} + + IOException + + + Returns the SpanScorer score only. +

+ Should not be overriden without good cause! + +

+ the score for just the Span part w/o the payload + + IOException + + + + + + + The score for the payload + + + The score, as calculated by + {@link PayloadFunction#DocScore(int, String, int, float)} + + + + Wraps another SpanFilter's result and caches it. The purpose is to allow + filters to simply filter, and then wrap with this class to add caching. + + + + A transient Filter cache. + + + Filter to cache results of + + + + Use {@link #GetDocIdSet(IndexReader)} instead. + + + + An IndexReader which reads multiple indexes, appending their content. + + + $Id: MultiReader.java 782406 2009-06-07 16:31:18Z mikemccand $ + + + + IndexReader is an abstract class, providing an interface for accessing an + index. Search of an index is done entirely through this abstract interface, + so that any subclass which implements it is searchable. +

Concrete subclasses of IndexReader are usually constructed with a call to + one of the static open() methods, e.g. {@link + #Open(String, boolean)}. +

For efficiency, in this API documents are often referred to via + document numbers, non-negative integers which each name a unique + document in the index. These document numbers are ephemeral--they may change + as documents are added to and deleted from an index. Clients should thus not + rely on a given document having the same number between sessions. +

An IndexReader can be opened on a directory for which an IndexWriter is + opened already, but it cannot be used to delete documents from the index then. +

+ NOTE: for backwards API compatibility, several methods are not listed + as abstract, but have no useful implementations in this base class and + instead always throw UnsupportedOperationException. Subclasses are + strongly encouraged to override these methods, but in many cases may not + need to. +

+

+ NOTE: as of 2.4, it's possible to open a read-only + IndexReader using one of the static open methods that + accepts the boolean readOnly parameter. Such a reader has + better concurrency as it's not necessary to synchronize on + the isDeleted method. Currently the default for readOnly + is false, meaning if not specified you will get a + read/write IndexReader. But in 3.0 this default will + change to true, meaning you must explicitly specify false + if you want to make changes with the resulting IndexReader. +

+

NOTE: {@link + IndexReader} instances are completely thread + safe, meaning multiple threads can call any of its methods, + concurrently. If your application requires external + synchronization, you should not synchronize on the + IndexReader instance; use your own + (non-Lucene) objects instead. +

+ $Id: IndexReader.java 826049 2009-10-16 19:28:55Z mikemccand $ + + + + Expert: returns the current refCount for this reader + + + Expert: increments the refCount of this IndexReader + instance. RefCounts are used to determine when a + reader can be closed safely, i.e. as soon as there are + no more references. Be sure to always call a + corresponding {@link #decRef}, in a finally clause; + otherwise the reader may never be closed. Note that + {@link #close} simply calls decRef(), which means that + the IndexReader will not really be closed until {@link + #decRef} has been called for all outstanding + references. + + + + + + + Expert: decreases the refCount of this IndexReader + instance. If the refCount drops to 0, then pending + changes (if any) are committed to the index and this + reader is closed. + + + IOException in case an IOException occurs in commit() or doClose() + + + + + + + will be deleted when IndexReader(Directory) is deleted + + + + + + Legacy Constructor for backwards compatibility. + +

+ This Constructor should not be used, it exists for backwards + compatibility only to support legacy subclasses that did not "own" + a specific directory, but needed to specify something to be returned + by the directory() method. Future subclasses should delegate to the + no arg constructor and implement the directory() method as appropriate. + +

+ Directory to be returned by the directory() method + + + + - use IndexReader() + + + + AlreadyClosedException if this IndexReader is closed + + + Returns a read/write IndexReader reading the index in an FSDirectory in the named + path. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #Open(Directory, boolean)} instead. + This method will be removed in the 3.0 release. + + + the path to the index directory + + + + Returns an IndexReader reading the index in an + FSDirectory in the named path. You should pass + readOnly=true, since it gives much better concurrent + performance, unless you intend to do write operations + (delete documents or change norms) with the reader. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + the path to the index directory + + true if this should be a readOnly + reader + + Use {@link #Open(Directory, boolean)} instead. + This method will be removed in the 3.0 release. + + + + + Returns a read/write IndexReader reading the index in an FSDirectory in the named + path. + + the path to the index directory + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #Open(Directory, boolean)} instead. + This method will be removed in the 3.0 release. + + + + + Returns an IndexReader reading the index in an + FSDirectory in the named path. You should pass + readOnly=true, since it gives much better concurrent + performance, unless you intend to do write operations + (delete documents or change norms) with the reader. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + the path to the index directory + + true if this should be a readOnly + reader + + Use {@link #Open(Directory, boolean)} instead. + This method will be removed in the 3.0 release. + + + + + Returns a read/write IndexReader reading the index in + the given Directory. + + the index directory + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #Open(Directory, boolean)} instead + This method will be removed in the 3.0 release. + + + + + Returns an IndexReader reading the index in the given + Directory. You should pass readOnly=true, since it + gives much better concurrent performance, unless you + intend to do write operations (delete documents or + change norms) with the reader. + + the index directory + + true if no changes (deletions, norms) will be made with this IndexReader + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns a read/write IndexReader reading the index in the given + {@link IndexCommit}. + + the commit point to open + + CorruptIndexException if the index is corrupt + Use {@link #Open(IndexCommit, boolean)} instead. + This method will be removed in the 3.0 release. + + + IOException if there is a low-level IO error + + + Expert: returns an IndexReader reading the index in the given + {@link IndexCommit}. You should pass readOnly=true, since it + gives much better concurrent performance, unless you + intend to do write operations (delete documents or + change norms) with the reader. + + the commit point to open + + true if no changes (deletions, norms) will be made with this IndexReader + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns a read/write IndexReader reading the index in the given + Directory, with a custom {@link IndexDeletionPolicy}. + + the index directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + Use {@link #Open(Directory, IndexDeletionPolicy, boolean)} instead. + This method will be removed in the 3.0 release. + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns an IndexReader reading the index in + the given Directory, with a custom {@link + IndexDeletionPolicy}. You should pass readOnly=true, + since it gives much better concurrent performance, + unless you intend to do write operations (delete + documents or change norms) with the reader. + + the index directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + true if no changes (deletions, norms) will be made with this IndexReader + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns an IndexReader reading the index in + the given Directory, with a custom {@link + IndexDeletionPolicy}. You should pass readOnly=true, + since it gives much better concurrent performance, + unless you intend to do write operations (delete + documents or change norms) with the reader. + + the index directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + true if no changes (deletions, norms) will be made with this IndexReader + + Subsamples which indexed + terms are loaded into RAM. This has the same effect as {@link + IndexWriter#setTermIndexInterval} except that setting + must be done at indexing time while this setting can be + set per reader. When set to N, then one in every + N*termIndexInterval terms in the index is loaded into + memory. By setting this to a value > 1 you can reduce + memory usage, at the expense of higher latency when + loading a TermInfo. The default value is 1. Set this + to -1 to skip loading the terms index entirely. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns a read/write IndexReader reading the index in the given + Directory, using a specific commit and with a custom + {@link IndexDeletionPolicy}. + + the specific {@link IndexCommit} to open; + see {@link IndexReader#listCommits} to list all commits + in a directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + Use {@link #Open(IndexCommit, IndexDeletionPolicy, boolean)} instead. + This method will be removed in the 3.0 release. + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns an IndexReader reading the index in + the given Directory, using a specific commit and with + a custom {@link IndexDeletionPolicy}. You should pass + readOnly=true, since it gives much better concurrent + performance, unless you intend to do write operations + (delete documents or change norms) with the reader. + + the specific {@link IndexCommit} to open; + see {@link IndexReader#listCommits} to list all commits + in a directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + true if no changes (deletions, norms) will be made with this IndexReader + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Expert: returns an IndexReader reading the index in + the given Directory, using a specific commit and with + a custom {@link IndexDeletionPolicy}. You should pass + readOnly=true, since it gives much better concurrent + performance, unless you intend to do write operations + (delete documents or change norms) with the reader. + + the specific {@link IndexCommit} to open; + see {@link IndexReader#listCommits} to list all commits + in a directory + + a custom deletion policy (only used + if you use this reader to perform deletes or to set + norms); see {@link IndexWriter} for details. + + true if no changes (deletions, norms) will be made with this IndexReader + + Subsambles which indexed + terms are loaded into RAM. This has the same effect as {@link + IndexWriter#setTermIndexInterval} except that setting + must be done at indexing time while this setting can be + set per reader. When set to N, then one in every + N*termIndexInterval terms in the index is loaded into + memory. By setting this to a value > 1 you can reduce + memory usage, at the expense of higher latency when + loading a TermInfo. The default value is 1. Set this + to -1 to skip loading the terms index entirely. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Refreshes an IndexReader if the index has changed since this instance + was (re)opened. +

+ Opening an IndexReader is an expensive operation. This method can be used + to refresh an existing IndexReader to reduce these costs. This method + tries to only load segments that have changed or were created after the + IndexReader was (re)opened. +

+ If the index has not changed since this instance was (re)opened, then this + call is a NOOP and returns this instance. Otherwise, a new instance is + returned. The old instance is not closed and remains usable.
+

+ If the reader is reopened, even though they share + resources internally, it's safe to make changes + (deletions, norms) with the new reader. All shared + mutable state obeys "copy on write" semantics to ensure + the changes are not seen by other readers. +

+ You can determine whether a reader was actually reopened by comparing the + old instance with the instance returned by this method: + 

+            IndexReader reader = ... 
+            ...
+            IndexReader newReader = r.reopen();
+            if (newReader != reader) {
+            ...     // reader was reopened
+            reader.close(); 
+            }
+            reader = newReader;
+            ...
+
+ + Be sure to synchronize that code so that other threads, + if present, can never use reader after it has been + closed and before it's switched to newReader. + +

NOTE: If this reader is a near real-time + reader (obtained from {@link IndexWriter#GetReader()}, + reopen() will simply call writer.getReader() again for + you, though this may change in the future. + +

+ CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Just like {@link #Reopen()}, except you can change the + readOnly of the original reader. If the index is + unchanged but readOnly is different then a new reader + will be returned. + + + + Expert: reopen this reader on a specific commit point. + This always returns a readOnly reader. If the + specified commit point matches what this reader is + already on, and this reader is already readOnly, then + this same instance is returned; if it is not already + readOnly, a readOnly clone is returned. + + + + Efficiently clones the IndexReader (sharing most + internal state). +

+ On cloning a reader with pending changes (deletions, + norms), the original reader transfers its write lock to + the cloned reader. This means only the cloned reader + may make further changes to the index, and commit the + changes to the index on close, but the old reader still + reflects all changes made up until it was cloned. +

+ Like {@link #Reopen()}, it's safe to make changes to + either the original or the cloned reader: all shared + mutable state obeys "copy on write" semantics to ensure + the changes are not seen by other readers. +

+

+ CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Clones the IndexReader and optionally changes readOnly. A readOnly + reader cannot open a writeable reader. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Returns the directory associated with this index. The Default + implementation returns the directory specified by subclasses when + delegating to the IndexReader(Directory) constructor, or throws an + UnsupportedOperationException if one was not specified. + + UnsupportedOperationException if no directory + + + Returns the time the index in the named directory was last modified. + Do not use this to check whether the reader is still up-to-date, use + {@link #IsCurrent()} instead. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #LastModified(Directory)} instead. + This method will be removed in the 3.0 release. + + + + Returns the time the index in the named directory was last modified. + Do not use this to check whether the reader is still up-to-date, use + {@link #IsCurrent()} instead. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #LastModified(Directory)} instead. + This method will be removed in the 3.0 release. + + + + + Returns the time the index in the named directory was last modified. + Do not use this to check whether the reader is still up-to-date, use + {@link #IsCurrent()} instead. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Reads version number from segments files. The version number is + initialized with a timestamp and then increased by one for each change of + the index. + + + where the index resides. + + version number. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #GetCurrentVersion(Directory)} instead. + This method will be removed in the 3.0 release. + + + + Reads version number from segments files. The version number is + initialized with a timestamp and then increased by one for each change of + the index. + + + where the index resides. + + version number. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #GetCurrentVersion(Directory)} instead. + This method will be removed in the 3.0 release. + + + + Reads version number from segments files. The version number is + initialized with a timestamp and then increased by one for each change of + the index. + + + where the index resides. + + version number. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Reads commitUserData, previously passed to {@link + IndexWriter#Commit(Map)}, from current index + segments file. This will return null if {@link + IndexWriter#Commit(Map)} has never been called for + this index. + + + where the index resides. + + commit userData. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + + + + + Version number when this IndexReader was opened. Not implemented in the + IndexReader base class. + +

+ If this reader is based on a Directory (ie, was created by calling + {@link #Open}, or {@link #Reopen} on a reader based on a Directory), then + this method returns the version recorded in the commit that the reader + opened. This version is advanced every time {@link IndexWriter#Commit} is + called. +

+ +

+ If instead this reader is a near real-time reader (ie, obtained by a call + to {@link IndexWriter#GetReader}, or by calling {@link #Reopen} on a near + real-time reader), then this method returns the version of the last + commit done by the writer. Note that even as further changes are made + with the writer, the version will not changed until a commit is + completed. Thus, you should not rely on this method to determine when a + near real-time reader should be opened. Use {@link #IsCurrent} instead. +

+ +

+ UnsupportedOperationException + unless overridden in subclass + + + + Retrieve the String userData optionally passed to + IndexWriter#commit. This will return null if {@link + IndexWriter#Commit(Map)} has never been called for + this index. + + + + + + +

For IndexReader implementations that use + TermInfosReader to read terms, this sets the + indexDivisor to subsample the number of indexed terms + loaded into memory. This has the same effect as {@link + IndexWriter#setTermIndexInterval} except that setting + must be done at indexing time while this setting can be + set per reader. When set to N, then one in every + N*termIndexInterval terms in the index is loaded into + memory. By setting this to a value > 1 you can reduce + memory usage, at the expense of higher latency when + loading a TermInfo. The default value is 1.

+ + NOTE: you must call this before the term + index is loaded. If the index is already loaded, + an IllegalStateException is thrown. +

+ IllegalStateException if the term index has already been loaded into memory + Please use {@link IndexReader#Open(Directory, IndexDeletionPolicy, boolean, int)} to specify the required TermInfos index divisor instead. + + + +

For IndexReader implementations that use + TermInfosReader to read terms, this returns the + current indexDivisor as specified when the reader was + opened. +

+ + + Check whether any new changes have occurred to the index since this + reader was opened. + +

+ If this reader is based on a Directory (ie, was created by calling + {@link #open}, or {@link #reopen} on a reader based on a Directory), then + this method checks if any further commits (see {@link IndexWriter#commit} + have occurred in that directory). +

+ +

+ If instead this reader is a near real-time reader (ie, obtained by a call + to {@link IndexWriter#getReader}, or by calling {@link #reopen} on a near + real-time reader), then this method checks if either a new commmit has + occurred, or any new uncommitted changes have taken place via the writer. + Note that even if the writer has only performed merging, this method will + still return false. +

+ +

+ In any event, if this returns false, you should call {@link #reopen} to + get a new reader that sees the changes. +

+ +

+ CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + UnsupportedOperationException unless overridden in subclass + + + Checks is the index is optimized (if it has a single segment and + no deletions). Not implemented in the IndexReader base class. + + true if the index is optimized; false otherwise + + UnsupportedOperationException unless overridden in subclass + + + Return an array of term frequency vectors for the specified document. + The array contains a vector for each vectorized field in the document. + Each vector contains terms and frequencies for all terms in a given vectorized field. + If no such fields existed, the method returns null. The term vectors that are + returned may either be of type {@link TermFreqVector} + or of type {@link TermPositionVector} if + positions or offsets have been stored. + + + document for which term frequency vectors are returned + + array of term frequency vectors. May be null if no term vectors have been + stored for the specified document. + + IOException if index cannot be accessed + + + + + Return a term frequency vector for the specified document and field. The + returned vector contains terms and frequencies for the terms in + the specified field of this document, if the field had the storeTermVector + flag set. If termvectors had been stored with positions or offsets, a + {@link TermPositionVector} is returned. + + + document for which the term frequency vector is returned + + field for which the term frequency vector is returned. + + term frequency vector May be null if field does not exist in the specified + document or term vector was not stored. + + IOException if index cannot be accessed + + + + + Load the Term Vector into a user-defined data structure instead of relying on the parallel arrays of + the {@link TermFreqVector}. + + The number of the document to load the vector for + + The name of the field to load + + The {@link TermVectorMapper} to process the vector. Must not be null + + IOException if term vectors cannot be accessed or if they do not exist on the field and doc. specified. + + + + + Map all the term vectors for all fields in a Document + The number of the document to load the vector for + + The {@link TermVectorMapper} to process the vector. Must not be null + + IOException if term vectors cannot be accessed or if they do not exist on the field and doc. specified. + + + Returns true if an index exists at the specified directory. + If the directory does not exist or if there is no index in it. + false is returned. + + the directory to check for an index + + true if an index exists; false otherwise + + Use {@link #IndexExists(Directory)} instead + This method will be removed in the 3.0 release. + + + + + Returns true if an index exists at the specified directory. + If the directory does not exist or if there is no index in it. + + the directory to check for an index + + true if an index exists; false otherwise + + Use {@link #IndexExists(Directory)} instead. + This method will be removed in the 3.0 release. + + + + + Returns true if an index exists at the specified directory. + If the directory does not exist or if there is no index in it. + + the directory to check for an index + + true if an index exists; false otherwise + + IOException if there is a problem with accessing the index + + + Returns the number of documents in this index. + + + Returns one greater than the largest possible document number. + This may be used to, e.g., determine how big to allocate an array which + will have an element for every document number in an index. + + + + Returns the number of deleted documents. + + + Returns the stored fields of the nth + Document in this index. +

+ NOTE: for performance reasons, this method does not check if the + requested document is deleted, and therefore asking for a deleted document + may yield unspecified results. Usually this is not required, however you + can call {@link #IsDeleted(int)} with the requested document ID to verify + the document is not deleted. + +

+ CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Get the {@link Lucene.Net.Documents.Document} at the n + th position. The {@link FieldSelector} may be used to determine + what {@link Lucene.Net.Documents.Field}s to load and how they should + be loaded. NOTE: If this Reader (more specifically, the underlying + FieldsReader) is closed before the lazy + {@link Lucene.Net.Documents.Field} is loaded an exception may be + thrown. If you want the value of a lazy + {@link Lucene.Net.Documents.Field} to be available after closing you + must explicitly load it or fetch the Document again with a new loader. +

+ NOTE: for performance reasons, this method does not check if the + requested document is deleted, and therefore asking for a deleted document + may yield unspecified results. Usually this is not required, however you + can call {@link #IsDeleted(int)} with the requested document ID to verify + the document is not deleted. + +

+ Get the document at the nth position + + The {@link FieldSelector} to use to determine what + Fields should be loaded on the Document. May be null, in which case + all Fields will be loaded. + + The stored fields of the + {@link Lucene.Net.Documents.Document} at the nth position + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + + + + + + + + + Returns true if document n has been deleted + + + Returns true if any documents have been deleted + + + Returns true if there are norms stored for this field. + + + Returns the byte-encoded normalization factor for the named field of + every document. This is used by the search code to score documents. + + + + + + + Reads the byte-encoded normalization factor for the named field of every + document. This is used by the search code to score documents. + + + + + + + Expert: Resets the normalization factor for the named field of the named + document. The norm represents the product of the field's {@link + Lucene.Net.Documents.Fieldable#SetBoost(float) boost} and its {@link Similarity#LengthNorm(String, + int) length normalization}. Thus, to preserve the length normalization + values when resetting this, one should base the new value upon the old. + + NOTE: If this field does not store norms, then + this method call will silently do nothing. + + + + + + + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Implements setNorm in subclass. + + + Expert: Resets the normalization factor for the named field of the named + document. + + + + + + + + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Returns an enumeration of all the terms in the index. The + enumeration is ordered by Term.compareTo(). Each term is greater + than all that precede it in the enumeration. Note that after + calling terms(), {@link TermEnum#Next()} must be called + on the resulting enumeration before calling other methods such as + {@link TermEnum#Term()}. + + IOException if there is a low-level IO error + + + Returns an enumeration of all terms starting at a given term. If + the given term does not exist, the enumeration is positioned at the + first term greater than the supplied term. The enumeration is + ordered by Term.compareTo(). Each term is greater than all that + precede it in the enumeration. + + IOException if there is a low-level IO error + + + Returns the number of documents containing the term t. + IOException if there is a low-level IO error + + + Returns an enumeration of all the documents which contain + term. For each document, the document number, the frequency of + the term in that document is also provided, for use in + search scoring. If term is null, then all non-deleted + docs are returned with freq=1. + Thus, this method implements the mapping: +

    + Term    =>    <docNum, freq>* +
+

The enumeration is ordered by document number. Each document number + is greater than all that precede it in the enumeration. +

+ IOException if there is a low-level IO error + + + Returns an unpositioned {@link TermDocs} enumerator. + IOException if there is a low-level IO error + + + Returns an enumeration of all the documents which contain + term. For each document, in addition to the document number + and frequency of the term in that document, a list of all of the ordinal + positions of the term in the document is available. Thus, this method + implements the mapping: + +

    + Term    =>    <docNum, freq, + <pos1, pos2, ... + posfreq-1> + >* +
+

This positional information facilitates phrase and proximity searching. +

The enumeration is ordered by document number. Each document number is + greater than all that precede it in the enumeration. +

+ IOException if there is a low-level IO error + + + Returns an unpositioned {@link TermPositions} enumerator. + IOException if there is a low-level IO error + + + Deletes the document numbered docNum. Once a document is + deleted it will not appear in TermDocs or TermPostitions enumerations. + Attempts to read its field with the {@link #document} + method will result in an error. The presence of this document may still be + reflected in the {@link #docFreq} statistic, though + this will be corrected eventually as the index is further modified. + + + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Implements deletion of the document numbered docNum. + Applications should call {@link #DeleteDocument(int)} or {@link #DeleteDocuments(Term)}. + + + + Deletes all documents that have a given term indexed. + This is useful if one uses a document field to hold a unique ID string for + the document. Then to delete such a document, one merely constructs a + term with the appropriate field and the unique ID string as its text and + passes it to this method. + See {@link #DeleteDocument(int)} for information about when this deletion will + become effective. + + + the number of documents deleted + + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Undeletes all documents currently marked as deleted in this index. + + + StaleReaderException if the index has changed + since this reader was opened + + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Implements actual undeleteAll() in subclass. + + + Does nothing by default. Subclasses that require a write lock for + index modifications must implement this method. + + + + + IOException + + + Opaque Map (String -> String) + that's recorded into the segments file in the index, + and retrievable by {@link + IndexReader#getCommitUserData}. + + IOException + + + Commit changes resulting from delete, undeleteAll, or + setNorm operations + + If an exception is hit, then either no changes or all + changes will have been committed to the index + (transactional semantics). + + IOException if there is a low-level IO error + + + Commit changes resulting from delete, undeleteAll, or + setNorm operations + + If an exception is hit, then either no changes or all + changes will have been committed to the index + (transactional semantics). + + IOException if there is a low-level IO error + + + Implements commit. + Please implement {@link #DoCommit(Map) + instead}. + + + + Implements commit. NOTE: subclasses should override + this. In 3.0 this will become an abstract method. + + + + Closes files associated with this index. + Also saves any new deletions to disk. + No other methods should be called after this has been called. + + IOException if there is a low-level IO error + + + Implements close. + + + Get a list of unique field names that exist in this index and have the specified + field option information. + + specifies which field option should be available for the returned fields + + Collection of Strings indicating the names of the fields. + + + + + + Returns true iff the index in the named directory is + currently locked. + + the directory to check for a lock + + IOException if there is a low-level IO error + Please use {@link IndexWriter#IsLocked(Directory)} instead. + This method will be removed in the 3.0 release. + + + + + Returns true iff the index in the named directory is + currently locked. + + the directory to check for a lock + + IOException if there is a low-level IO error + Use {@link #IsLocked(Directory)} instead. + This method will be removed in the 3.0 release. + + + + + Forcibly unlocks the index in the named directory. +

+ Caution: this should only be used by failure recovery code, + when it is known that no other process nor thread is in fact + currently accessing this index. +

+ Please use {@link IndexWriter#Unlock(Directory)} instead. + This method will be removed in the 3.0 release. + + + + + Expert: return the IndexCommit that this reader has + opened. This method is only implemented by those + readers that correspond to a Directory with its own + segments_N file. + +

WARNING: this API is new and experimental and + may suddenly change.

+

+ + + Prints the filename and size of each file within a given compound file. + Add the -extract flag to extract files to the current working directory. + In order to make the extracted version of the index work, you have to copy + the segments file from the compound index into the directory where the extracted files are stored. + + Usage: Lucene.Net.Index.IndexReader [-extract] <cfsfile> + + + + Returns all commit points that exist in the Directory. + Normally, because the default is {@link + KeepOnlyLastCommitDeletionPolicy}, there would be only + one commit point. But if you're using a custom {@link + IndexDeletionPolicy} then there could be many commits. + Once you have a given commit, you can open a reader on + it by calling {@link IndexReader#Open(IndexCommit)} + There must be at least one commit in + the Directory, else this method throws {@link + java.io.IOException}. Note that if a commit is in + progress while this method is running, that commit + may or may not be returned array. + + + + Expert: returns the sequential sub readers that this + reader is logically composed of. For example, + IndexSearcher uses this API to drive searching by one + sub reader at a time. If this reader is not composed + of sequential child readers, it should return null. + If this method returns an empty array, that means this + reader is a null reader (for example a MultiReader + that has no sub readers). +

+ NOTE: You should not try using sub-readers returned by + this method to make any changes (setNorm, deleteDocument, + etc.). While this might succeed for one composite reader + (like MultiReader), it will most likely lead to index + corruption for other readers (like DirectoryReader obtained + through {@link #open}. Use the parent reader directly. +

+ + + Expert + + + + + Returns the number of unique terms (across all fields) + in this reader. + + This method returns long, even though internally + Lucene cannot handle more than 2^31 unique terms, for + a possible future when this limitation is removed. + + + UnsupportedOperationException if this count + cannot be easily determined (eg Multi*Readers). + Instead, you should call {@link + #getSequentialSubReaders} and ask each sub reader for + its unique term count. + + + + Expert: Return the state of the flag that disables fakes norms in favor of representing the absence of field norms with null. + true if fake norms are disabled + + This currently defaults to false (to remain + back-compatible), but in 3.0 it will be hardwired to + true, meaning the norms() methods will return null for + fields that had disabled norms. + + + + Expert: Set the state of the flag that disables fakes norms in favor of representing the absence of field norms with null. + true to disable fake norms, false to preserve the legacy behavior + + This currently defaults to false (to remain + back-compatible), but in 3.0 it will be hardwired to + true, meaning the norms() methods will return null for + fields that had disabled norms. + + + + Utility class for executing code that needs to do + something with the current segments file. This is + necessary with lock-less commits because from the time + you locate the current segments file name, until you + actually open it, read its contents, or check modified + time, etc., it could have been deleted due to a writer + commit finishing. + + + + A collection of segmentInfo objects with methods for operating on + those segments in relation to the file system. + +

NOTE: This API is new and still experimental + (subject to change suddenly in the next release)

+

+ + + The file format version, a negative number. + + + This format adds details used for lockless commits. It differs + slightly from the previous format in that file names + are never re-used (write once). Instead, each file is + written to the next generation. For example, + segments_1, segments_2, etc. This allows us to not use + a commit lock. See file + formats for details. + + + + This format adds a "hasSingleNormFile" flag into each segment info. + See LUCENE-756 + for details. + + + + This format allows multiple segments to share a single + vectors and stored fields file. + + + + This format adds a checksum at the end of the file to + ensure all bytes were successfully written. + + + + This format adds the deletion count for each segment. + This way IndexWriter can efficiently report numDocs(). + + + + This format adds the boolean hasProx to record if any + fields in the segment store prox information (ie, have + omitTermFreqAndPositions==false) + + + + This format adds optional commit userData (String) storage. + + + This format adds optional per-segment String + dianostics storage, and switches userData to Map + + + + counts how often the index has been changed by adding or deleting docs. + starting with the current time in milliseconds forces to create unique version numbers. + + + + If non-null, information about loading segments_N files + + + + + Get the generation (N) of the current segments_N file + from a list of files. + + + -- array of file names to check + + + + Get the generation (N) of the current segments_N file + in the directory. + + + -- directory to search for the latest segments_N file + + + + Get the filename of the current segments_N file + from a list of files. + + + -- array of file names to check + + + + Get the filename of the current segments_N file + in the directory. + + + -- directory to search for the latest segments_N file + + + + Get the segments_N filename in use by this segment infos. + + + Parse the generation off the segments file name and + return it. + + + + Get the next segments_N filename that will be written. + + + Read a particular segmentFileName. Note that this may + throw an IOException if a commit is in process. + + + -- directory containing the segments file + + -- segment file to load + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + This version of read uses the retry logic (for lock-less + commits) to find the right segments file to load. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Returns a copy of this instance, also copying each + SegmentInfo. + + + + version number when this SegmentInfos was generated. + + + Current version number from segments file. + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Returns userData from latest segments file + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + If non-null, information about retries when loading + the segments file will be printed to this. + + + + Advanced: set how many times to try loading the + segments.gen file contents to determine current segment + generation. This file is only referenced when the + primary method (listing the directory) fails. + + + + + + + + Advanced: set how many milliseconds to pause in between + attempts to load the segments.gen file. + + + + + + + + Advanced: set how many times to try incrementing the + gen when loading the segments file. This only runs if + the primary (listing directory) and secondary (opening + segments.gen file) methods fail to find the segments + file. + + + + + + + + + + + + Returns a new SegmentInfos containg the SegmentInfo + instances in the specified range first (inclusive) to + last (exclusive), so total number of segments returned + is last-first. + + + + Call this to start a commit. This writes the new + segments file, but writes an invalid checksum at the + end, so that it is not visible to readers. Once this + is called you must call {@link #finishCommit} to complete + the commit or {@link #rollbackCommit} to abort it. + + + + Returns all file names referenced by SegmentInfo + instances matching the provided Directory (ie files + associated with any "external" segments are skipped). + The returned collection is recomputed on each + invocation. + + + + Writes & syncs to the Directory dir, taking care to + remove the segments file on exception + + + + Replaces all segments in this instance, but keeps + generation, version, counter so that future commits + remain write once. + + + + + Simple brute force implementation. + If size is equal, compare items one by one. + + SegmentInfos object to check equality for + true if lists are equal, false otherwise + + + + Calculate hash code of SegmentInfos + + hash code as in java version of ArrayList + + + Utility class for executing code that needs to do + something with the current segments file. This is + necessary with lock-less commits because from the time + you locate the current segments file name, until you + actually open it, read its contents, or check modified + time, etc., it could have been deleted due to a writer + commit finishing. + + + + Subclass must implement this. The assumption is an + IOException will be thrown if something goes wrong + during the processing that could have been caused by + a writer committing. + + + + Constants describing field properties, for example used for + {@link IndexReader#GetFieldNames(FieldOption)}. + + + + All fields + + + All indexed fields + + + All fields that store payloads + + + All fields that omit tf + + + Renamed to {@link #OMIT_TERM_FREQ_AND_POSITIONS} + + + + All fields which are not indexed + + + All fields which are indexed with termvectors enabled + + + All fields which are indexed but don't have termvectors enabled + + + All fields with termvectors enabled. Please note that only standard termvector fields are returned + + + All fields with termvectors with position values enabled + + + All fields with termvectors with offset values enabled + + + All fields with termvectors with offset values and position values enabled + + +

Construct a MultiReader aggregating the named set of (sub)readers. + Directory locking for delete, undeleteAll, and setNorm operations is + left to the subreaders.

+

Note that all subreaders are closed if this Multireader is closed.

+

+ set of (sub)readers + + IOException + + +

Construct a MultiReader aggregating the named set of (sub)readers. + Directory locking for delete, undeleteAll, and setNorm operations is + left to the subreaders.

+

+ indicates whether the subreaders should be closed + when this MultiReader is closed + + set of (sub)readers + + IOException + + + Tries to reopen the subreaders. +
+ If one or more subreaders could be re-opened (i. e. subReader.reopen() + returned a new instance != subReader), then a new MultiReader instance + is returned, otherwise this instance is returned. +

+ A re-opened instance might share one or more subreaders with the old + instance. Index modification operations result in undefined behavior + when performed before the old instance is closed. + (see {@link IndexReader#Reopen()}). +

+ If subreaders are shared, then the reference count of those + readers is increased to ensure that the subreaders remain open + until the last referring reader is closed. + +

+ CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Clones the subreaders. + (see {@link IndexReader#clone()}). +
+

+ If subreaders are shared, then the reference count of those + readers is increased to ensure that the subreaders remain open + until the last referring reader is closed. +

+ + + If clone is true then we clone each of the subreaders + + + New IndexReader, or same one (this) if + reopen/clone is not necessary + + CorruptIndexException + IOException + + + + + + + Checks recursively if all subreaders are up to date. + + + Not implemented. + UnsupportedOperationException + + + Change to true to see details of reference counts when + infoStream != null + + + + Initialize the deleter: find all previous commits in + the Directory, incref the files they reference, call + the policy to let it delete commits. This will remove + any files not referenced by any of the commits. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Remove the CommitPoints in the commitsToDelete List by + DecRef'ing all files from each SegmentInfos. + + + + Writer calls this when it has hit an error and had to + roll back, to tell us that there may now be + unreferenced files in the filesystem. So we re-list + the filesystem and delete such files. If segmentName + is non-null, we will only delete files corresponding to + that segment. + + + + For definition of "check point" see IndexWriter comments: + "Clarification: Check Points (and commits)". + + Writer calls this when it has made a "consistent + change" to the index, meaning new files are written to + the index and the in-memory SegmentInfos have been + modified to point to those files. + + This may or may not be a commit (segments_N may or may + not have been written). + + We simply incref the files referenced by the new + SegmentInfos and decref the files we had previously + seen (if any). + + If this is a commit, we also call the policy to give it + a chance to remove other commits. If any commits are + removed, we decref their files as well. + + + + Deletes the specified files, but only if they are new + (have not yet been incref'd). + + + + Tracks the reference count for a single index file: + + + Holds details for each commit point. This class is + also passed to the deletion policy. Note: this class + has a natural ordering that is inconsistent with + equals. + + + +

Expert: represents a single commit into an index as seen by the + {@link IndexDeletionPolicy} or {@link IndexReader}.

+ +

Changes to the content of an index are made visible + only after the writer who made that change commits by + writing a new segments file + (segments_N). This point in time, when the + action of writing of a new segments file to the directory + is completed, is an index commit.

+ +

Each index commit point has a unique segments file + associated with it. The segments file associated with a + later index commit point would have a larger N.

+ +

WARNING: This API is a new and experimental and + may suddenly change.

+

+ + + Get the segments file (segments_N) associated + with this commit point. + + + + Returns all index files referenced by this commit point. + + + Returns the {@link Directory} for the index. + + + Delete this commit point. This only applies when using + the commit point in the context of IndexWriter's + IndexDeletionPolicy. +

+ Upon calling this, the writer is notified that this commit + point should be deleted. +

+ Decision that a commit-point should be deleted is taken by the {@link IndexDeletionPolicy} in effect + and therefore this should only be called by its {@link IndexDeletionPolicy#onInit onInit()} or + {@link IndexDeletionPolicy#onCommit onCommit()} methods. +

+ + + Returns true if this commit is an optimized index. + + + Two IndexCommits are equal if both their Directory and versions are equal. + + + Returns the version for this IndexCommit. This is the + same value that {@link IndexReader#getVersion} would + return if it were opened on this commit. + + + + Returns the generation (the _N in segments_N) for this + IndexCommit + + + + Convenience method that returns the last modified time + of the segments_N file corresponding to this index + commit, equivalent to + getDirectory().fileModified(getSegmentsFileName()). + + + + Returns userData, previously passed to {@link + IndexWriter#Commit(Map)} for this commit. Map is + String -> String. + + + + Called only be the deletion policy, to remove this + commit point from the index. + + + + NOTE: this API is experimental and will likely change + + + Adds a new doc in this term. If this returns null + then we just skip consuming positions/payloads. + + + + Called when we are done adding docs to this term + + + Adds a new doc in this term. If this returns null + then we just skip consuming positions/payloads. + + + + Called when we are done adding docs to this term + + + This is a DocFieldConsumer that inverts each field, + separately, from a Document, and accepts a + InvertedTermsConsumer to process those terms. + + + + Combines multiple files into a single compound file. + The file format:
+
    +
  • VInt fileCount
    • +
  • {Directory} + fileCount entries with the following structure:
    • +
      +
    • long dataOffset
      • +
    • String fileName
      • +
    +
  • {File Data} + fileCount entries with the raw data of the corresponding file
    • +
+ + The fileCount integer indicates how many files are contained in this compound + file. The {directory} that follows has that many entries. Each directory entry + contains a long pointer to the start of this file's data section, and a String + with that file's name. + + + + $Id: CompoundFileWriter.java 690539 2008-08-30 17:33:06Z mikemccand $ + + + + Create the compound stream in the specified file. The file name is the + entire name (no extensions are added). + + NullPointerException if dir or name is null + + + Returns the directory of the compound file. + + + Returns the name of the compound file. + + + Add a source stream. file is the string by which the + sub-stream will be known in the compound stream. + + + IllegalStateException if this writer is closed + NullPointerException if file is null + IllegalArgumentException if a file with the same name + has been added already + + + + Merge files with the extensions added up to now. + All files with these extensions are combined sequentially into the + compound stream. After successful merge, the source files + are deleted. + + IllegalStateException if close() had been called before or + if no file has been added to this object + + + + Copy the contents of the file with specified extension into the + provided output stream. Use the provided buffer for moving data + to reduce memory allocation. + + + + source file + + + temporary holder for the start of directory entry for this file + + + temporary holder for the start of this file's data section + + + Class for accessing a compound stream. + This class implements a directory, but is limited to only read operations. + Directory methods that would normally modify data throw an exception. + + + + $Id: CompoundFileReader.java 673371 2008-07-02 11:57:27Z mikemccand $ + + + Returns an array of strings, one for each file in the directory. - + Returns true iff a file with the given name exists. - - Returns the time the named file was last modified. + + Returns the time the compound file was last modified. - - Returns the time the named file was last modified. + + Set the modified time of the compound file to now. - - Set the modified time of an existing file to now. + + Not implemented + UnsupportedOperationException - - Returns the length in bytes of a file in the directory. + + Not implemented + UnsupportedOperationException - - Removes an existing file in the directory. + + Returns the length of a file in the directory. + IOException if the file does not exist - - Renames an existing file in the directory. + + Not implemented + UnsupportedOperationException - - Creates a new, empty file in the directory with the given name. - Returns a stream writing this file. + + Not implemented + UnsupportedOperationException + + + Implementation of an IndexInput that reads from a portion of the + compound file. The visibility is left as "package" *only* because + this helps with testing since JUnit test cases in a different class + can then access package fields of this class. - - Returns a stream reading an existing file. + + Expert: implements buffer refill. Reads bytes from the current + position in the input. + + the array to read bytes into + + the offset in the array to start storing bytes + + the number of bytes to read + - - So we can do some byte-to-hexchar conversion below + + Expert: implements seek. Sets current position in this file, where + the next {@link #ReadInternal(byte[],int,int)} will occur. + + + - - Constructs a {@link Lock} with the specified name. Locks are implemented - with {@link File#createNewFile()}. + + Closes the stream to further operations. + + + Synonymous with {@link Field}. + +

WARNING: This interface may change within minor versions, despite Lucene's backward compatibility requirements. + This means new methods may be added from version to version. This change only affects the Fieldable API; other backwards + compatibility promises remain intact. For example, Lucene can still + read and write indices created within the same major version. +

+

- the name of the lock file - - an instance of Lock holding the lock + + + Sets the boost factor hits on this field. This value will be + multiplied into the score of all hits on this this field of this + document. + +

The boost is multiplied by {@link Lucene.Net.Documents.Document#GetBoost()} of the document + containing this field. If a document has multiple fields with the same + name, all such values are multiplied together. This product is then + used to compute the norm factor for the field. By + default, in the {@link + Lucene.Net.Search.Similarity#ComputeNorm(String, + FieldInvertState)} method, the boost value is multiplied + by the {@link + Lucene.Net.Search.Similarity#LengthNorm(String, + int)} and then rounded by {@link Lucene.Net.Search.Similarity#EncodeNorm(float)} before it is stored in the + index. One should attempt to ensure that this product does not overflow + the range of that encoding. + +

+ + + + + + + + + Returns the boost factor for hits for this field. + +

The default value is 1.0. + +

Note: this value is not stored directly with the document in the index. + Documents returned from {@link Lucene.Net.Index.IndexReader#Document(int)} and + {@link Lucene.Net.Search.Hits#Doc(int)} may thus not have the same value present as when + this field was indexed. + +

+ + + + + Returns the name of the field as an interned string. + For example "date", "title", "body", ... + + + + The value of the field as a String, or null. +

+ For indexing, if isStored()==true, the stringValue() will be used as the stored field value + unless isBinary()==true, in which case binaryValue() will be used. + + If isIndexed()==true and isTokenized()==false, this String value will be indexed as a single token. + If isIndexed()==true and isTokenized()==true, then tokenStreamValue() will be used to generate indexed tokens if not null, + else readerValue() will be used to generate indexed tokens if not null, else stringValue() will be used to generate tokens. +

+ + + The value of the field as a Reader, which can be used at index time to generate indexed tokens. + + + + + The value of the field in Binary, or null. + + + + + The TokenStream for this field to be used when indexing, or null. + + + + + True if the value of the field is to be stored in the index for return + with search hits. + + + + True if the value of the field is to be indexed, so that it may be + searched on. + + + + True if the value of the field should be tokenized as text prior to + indexing. Un-tokenized fields are indexed as a single word and may not be + Reader-valued. + + + + True if the value of the field is stored and compressed within the index + + + True if the term or terms used to index this field are stored as a term + vector, available from {@link Lucene.Net.Index.IndexReader#GetTermFreqVector(int,String)}. + These methods do not provide access to the original content of the field, + only to terms used to index it. If the original content must be + preserved, use the stored attribute instead. + + + + + + + True if terms are stored as term vector together with their offsets + (start and end positon in source text). + + + + True if terms are stored as term vector together with their token positions. + + + True if the value of the field is stored as binary + + + True if norms are omitted for this indexed field + + + Expert: + + If set, omit normalization factors associated with this indexed field. + This effectively disables indexing boosts and length normalization for this field. + + + + Renamed to {@link AbstractField#setOmitTermFreqAndPositions} + + + + Renamed to {@link AbstractField#getOmitTermFreqAndPositions} + + + + Indicates whether a Field is Lazy or not. The semantics of Lazy loading are such that if a Field is lazily loaded, retrieving + it's values via {@link #StringValue()} or {@link #BinaryValue()} is only valid as long as the {@link Lucene.Net.Index.IndexReader} that + retrieved the {@link Document} is still open. + + + true if this field can be loaded lazily - - Closes the store to future operations. + + Returns offset into byte[] segment that is used as value, if Field is not binary + returned value is undefined + + index of the first character in byte[] segment that represents this Field value + - - For debug output. + + Returns length of byte[] segment that is used as value, if Field is not binary + returned value is undefined + + length of byte[] segment that represents this Field value + - - IndexInput methods + + Return the raw byte[] for the binary field. Note that + you must also call {@link #getBinaryLength} and {@link + #getBinaryOffset} to know which range of bytes in this + returned array belong to the field. + + reference to the Field value as byte[]. + - - Method used for testing. Returns true if the underlying - file descriptor is valid. + + Return the raw byte[] for the binary field. Note that + you must also call {@link #getBinaryLength} and {@link + #getBinaryOffset} to know which range of bytes in this + returned array belong to the field.

+ About reuse: if you pass in the result byte[] and it is + used, likely the underlying implementation will hold + onto this byte[] and return it in future calls to + {@link #BinaryValue()} or {@link #GetBinaryValue()}. + So if you subsequently re-use the same byte[] elsewhere + it will alter this Fieldable's value. +

+ User defined buffer that will be used if + possible. If this is null or not large enough, a new + buffer is allocated + + reference to the Field value as byte[]. + + + + Transforms the token stream as per the Porter stemming algorithm. + Note: the input to the stemming filter must already be in lower case, + so you will need to use LowerCaseFilter or LowerCaseTokenizer farther + down the Tokenizer chain in order for this to work properly! +

+ To use this filter with other analyzers, you'll want to write an + Analyzer class that sets up the TokenStream chain as you want it. + To use this with LowerCaseTokenizer, for example, you'd write an + analyzer like this: +

+ 

+            class MyAnalyzer extends Analyzer {
+            public final TokenStream tokenStream(String fieldName, Reader reader) {
+            return new PorterStemFilter(new LowerCaseTokenizer(reader));
+            }
+            }
+
- - output methods: + + Simplistic {@link CharFilter} that applies the mappings + contained in a {@link NormalizeCharMap} to the character + stream, and correcting the resulting changes to the + offsets. + - - Random-access methods + + Base utility class for implementing a {@link CharFilter}. + You subclass this, and then record mappings by calling + {@link #addOffCorrectMap}, and then invoke the correct + method to correct an offset. + +

NOTE: This class is not particularly efficient. + For example, a new class instance is created for every + call to {@link #addOffCorrectMap}, which is then appended + to a private list. +

- - - A memory-resident {@link Directory} implementation. + + Subclasses of CharFilter can be chained to filter CharStream. + They can be used as {@link java.io.Reader} with additional offset + correction. {@link Tokenizer}s will automatically use {@link #CorrectOffset} + if a CharFilter/CharStream subclass is used. - $Id: RAMDirectory.java 351779 2005-12-02 17:37:50Z bmesser $ + $Id$ + - - Constructs an empty {@link Directory}. + + CharStream adds {@link #CorrectOffset} + functionality over {@link Reader}. All Tokenizers accept a + CharStream instead of {@link Reader} as input, which enables + arbitrary character based filtering before tokenization. + The {@link #CorrectOffset} method fixed offsets to account for + removal or insertion of characters, so that the offsets + reported in the tokens match the character offsets of the + original Reader. + - - - Creates a new RAMDirectory instance from the {@link FSDirectory}. + + Called by CharFilter(s) and Tokenizer to correct token offset. - a File specifying the index directory + offset as seen in the output + corrected offset based on the input + - - Creates a new RAMDirectory instance from the {@link FSDirectory}. + + Subclass may want to override to correct the current offset. - a String specifying the full index directory path + current offset + corrected offset + - - Returns an array of strings, one for each file in the directory. - - - Returns true iff the named file exists in this directory. - - - Returns the time the named file was last modified. - - - Set the modified time of an existing file to now. - - - Returns the length in bytes of a file in the directory. - - - Removes an existing file in the directory. - - - Removes an existing file in the directory. - - - Creates a new, empty file in the directory with the given name. - Returns a stream writing this file. + + Chains the corrected offset through the input + CharFilter. - - Returns a stream reading an existing file. + + Retrieve the corrected offset. Note that this method + is slow, if you correct positions far before the most + recently added position, as it's a simple linear + search backwards through all offset corrections added + by {@link #addOffCorrectMap}. + - - Construct a {@link Lock}. - the name of the lock file - + + Default constructor that takes a {@link CharStream}. - - Closes the store to future operations. + + Easy-use constructor that takes a {@link Reader}. - - A memory-resident {@link IndexInput} implementation. + + This class can be used if the token attributes of a TokenStream + are intended to be consumed more than once. It caches + all token attribute states locally in a List. + +

CachingTokenFilter implements the optional method + {@link TokenStream#Reset()}, which repositions the + stream to the first Token. +

+ + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Java's builtin ThreadLocal has a serious flaw: + it can take an arbitrarily long amount of time to + dereference the things you had stored in it, even once the + ThreadLocal instance itself is no longer referenced. + This is because there is single, master map stored for + each thread, which all ThreadLocals share, and that + master map only periodically purges "stale" entries. + + While not technically a memory leak, because eventually + the memory will be reclaimed, it can take a long time + and you can easily hit OutOfMemoryError because from the + GC's standpoint the stale entries are not reclaimaible. + + This class works around that, by only enrolling + WeakReference values into the ThreadLocal, and + separately holding a hard reference to each stored + value. When you call {@link #close}, these hard + references are cleared and then GC is freely able to + reclaim space by objects stored in it. + + + + A variety of high efficiencly bit twiddling routines. - $Id: RAMInputStream.java 150537 2004-09-28 20:45:26Z cutting $ + $Id$ - - A memory-resident {@link IndexOutput} implementation. + + Returns the number of bits set in the long + + + Returns the number of set bits in an array of longs. + + + Returns the popcount or cardinality of the two sets after an intersection. + Neither array is modified. + + + + Returns the popcount or cardinality of the union of two sets. + Neither array is modified. + + + + Returns the popcount or cardinality of A & ~B + Neither array is modified. + + + + table of number of trailing zeros in a byte + + + Returns number of trailing zeros in a 64 bit long value. + + + Returns number of trailing zeros in a 32 bit int value. + + + returns 0 based index of first set bit + (only works for x!=0) +
This is an alternate implementation of ntz() + + + + returns 0 based index of first set bit +
This is an alternate implementation of ntz() + + + + returns true if v is a power of two or zero + + + returns true if v is a power of two or zero + + + returns the next highest power of two, or the current value if it's already a power of two or zero + + + returns the next highest power of two, or the current value if it's already a power of two or zero + + + Simple standalone server that must be running when you + use {@link VerifyingLockFactory}. This server simply + verifies at most one process holds the lock at a time. + Run without any args to see usage. - $Id: RAMOutputStream.java 150537 2004-09-28 20:45:26Z cutting $ + + + + + + + Base class for file system based locking implementation. + + + Directory for the lock files. + + + Set the lock directory. This method can be only called + once to initialize the lock directory. It is used by {@link FSDirectory} + to set the lock directory to itsself. + Subclasses can also use this method to set the directory + in the constructor. + + + + Retrieve the lock directory. + + + Writes bytes through to a primary IndexOutput, computing + checksum. Note that you cannot use seek(). + + + + Starts but does not complete the commit of this file (= + writing of the final checksum at the end). After this + is called must call {@link #finishCommit} and the + {@link #close} to complete the commit. + + + + See {@link #prepareCommit} + + + Expert: returns a comparator for sorting ScoreDocs. + +

+ Created: Apr 21, 2004 3:49:28 PM + + This class will be used as part of a key to a FieldCache value. You must + implement hashCode and equals to avoid an explosion in RAM usage if you use + instances that are not the same instance. If you are searching using the + Remote contrib, the same instance of this class on the client will be a new + instance on every call to the server, so hashCode/equals is very important in + that situation. + +

+ $Id: SortComparatorSource.java 747019 2009-02-23 13:59:50Z + mikemccand $ + + 1.4 + + Please use {@link FieldComparatorSource} instead. + + + + Creates a comparator for the field in the given index. + Index to create comparator for. + + Name of the field to create comparator for. + + Comparator of ScoreDoc objects. + + IOException If an error occurs reading the index. + + + A Query that matches documents containing a particular sequence of terms. + A PhraseQuery is built by QueryParser for input like "new york". + +

This query may be combined with other terms or queries with a {@link BooleanQuery}. +

+ + + Constructs an empty phrase query. + + + Sets the number of other words permitted between words in query phrase. + If zero, then this is an exact phrase search. For larger values this works + like a WITHIN or NEAR operator. +

The slop is in fact an edit-distance, where the units correspond to + moves of terms in the query phrase out of position. For example, to switch + the order of two words requires two moves (the first move places the words + atop one another), so to permit re-orderings of phrases, the slop must be + at least two. +

More exact matches are scored higher than sloppier matches, thus search + results are sorted by exactness. +

The slop is zero by default, requiring exact matches. +

+ + + Returns the slop. See setSlop(). + + + Adds a term to the end of the query phrase. + The relative position of the term is the one immediately after the last term added. + + + + Adds a term to the end of the query phrase. + The relative position of the term within the phrase is specified explicitly. + This allows e.g. phrases with more than one term at the same position + or phrases with gaps (e.g. in connection with stopwords). + + + + + + + + + Returns the set of terms in this phrase. + + + Returns the relative positions of terms in this phrase. + + + + + + + Prints a user-readable version of this query. + + + Returns true iff o is equal to this. + + + Returns a hash code value for this object. + + + Implements search over a single IndexReader. + +

Applications usually need only call the inherited {@link #Search(Query)} + or {@link #Search(Query,Filter)} methods. For performance reasons it is + recommended to open only one IndexSearcher and use it for all of your searches. + +

Note that you can only access Hits from an IndexSearcher as long as it is + not yet closed, otherwise an IOException will be thrown. + +

NOTE: {@link + IndexSearcher} instances are completely + thread safe, meaning multiple threads can call any of its + methods, concurrently. If your application requires + external synchronization, you should not + synchronize on the IndexSearcher instance; + use your own (non-Lucene) objects instead.

+

+ + + An abstract base class for search implementations. Implements the main search + methods. + +

+ Note that you can only access hits from a Searcher as long as it is not yet + closed, otherwise an IOException will be thrown. +

+ + + Returns the documents matching query. + BooleanQuery.TooManyClauses + Hits will be removed in Lucene 3.0. Use + {@link #Search(Query, Filter, int)} instead. + + + + Returns the documents matching query and + filter. + + BooleanQuery.TooManyClauses + Hits will be removed in Lucene 3.0. Use + {@link #Search(Query, Filter, int)} instead. + + + + Returns documents matching query sorted by + sort. + + BooleanQuery.TooManyClauses + Hits will be removed in Lucene 3.0. Use + {@link #Search(Query, Filter, int, Sort)} instead. + + + + Returns documents matching query and filter, + sorted by sort. + + BooleanQuery.TooManyClauses + Hits will be removed in Lucene 3.0. Use + {@link #Search(Query, Filter, int, Sort)} instead. + + + + Search implementation with arbitrary sorting. Finds + the top n hits for query, applying + filter if non-null, and sorting the hits by the criteria in + sort. + +

NOTE: this does not compute scores by default; use + {@link IndexSearcher#setDefaultFieldSortScoring} to enable scoring. + +

+ BooleanQuery.TooManyClauses + + + Lower-level search API. + +

{@link HitCollector#Collect(int,float)} is called for every matching + document. + +

Applications should only use this if they need all of the + matching documents. The high-level search API ({@link + Searcher#Search(Query)}) is usually more efficient, as it skips + non-high-scoring hits. +

Note: The score passed to this method is a raw score. + In other words, the score will not necessarily be a float whose value is + between 0 and 1. +

+ BooleanQuery.TooManyClauses + use {@link #Search(Query, Collector)} instead. + + + + Lower-level search API. + +

{@link Collector#Collect(int)} is called for every matching document. + +

Applications should only use this if they need all of the matching + documents. The high-level search API ({@link Searcher#Search(Query, int)} + ) is usually more efficient, as it skips non-high-scoring hits. +

Note: The score passed to this method is a raw score. + In other words, the score will not necessarily be a float whose value is + between 0 and 1. +

+ BooleanQuery.TooManyClauses + + + Lower-level search API. + +

{@link HitCollector#Collect(int,float)} is called for every matching + document. +
HitCollector-based access to remote indexes is discouraged. + +

Applications should only use this if they need all of the + matching documents. The high-level search API ({@link + Searcher#Search(Query, Filter, int)}) is usually more efficient, as it skips + non-high-scoring hits. + +

+ to match documents + + if non-null, used to permit documents to be collected. + + to receive hits + + BooleanQuery.TooManyClauses + use {@link #Search(Query, Filter, Collector)} instead. + + + + Lower-level search API. + +

{@link Collector#Collect(int)} is called for every matching + document. +
Collector-based access to remote indexes is discouraged. + +

Applications should only use this if they need all of the + matching documents. The high-level search API ({@link + Searcher#Search(Query, Filter, int)}) is usually more efficient, as it skips + non-high-scoring hits. + +

+ to match documents + + if non-null, used to permit documents to be collected. + + to receive hits + + BooleanQuery.TooManyClauses + + + Finds the top n + hits for query, applying filter if non-null. + + + BooleanQuery.TooManyClauses + + + Finds the top n + hits for query. + + + BooleanQuery.TooManyClauses + + + Returns an Explanation that describes how doc scored against + query. + +

This is intended to be used in developing Similarity implementations, + and, for good performance, should not be displayed with every hit. + Computing an explanation is as expensive as executing the query over the + entire index. +

+ + + The Similarity implementation used by this searcher. + + + Expert: Set the Similarity implementation used by this Searcher. + + + + + + + Expert: Return the Similarity implementation used by this Searcher. + +

This defaults to the current value of {@link Similarity#GetDefault()}. +

+ + + creates a weight for query + new weight + + + + use {@link #Search(Weight, Filter, Collector)} instead. + + + + Creates a searcher searching the index in the named directory. + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #IndexSearcher(Directory, boolean)} instead + + + + Creates a searcher searching the index in the named + directory. You should pass readOnly=true, since it + gives much better concurrent performance, unless you + intend to do write operations (delete documents or + change norms) with the underlying IndexReader. + + directory where IndexReader will be opened + + if true, the underlying IndexReader + will be opened readOnly + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #IndexSearcher(Directory, boolean)} instead + + + + Creates a searcher searching the index in the provided directory. + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + Use {@link #IndexSearcher(Directory, boolean)} instead + + + + Creates a searcher searching the index in the named + directory. You should pass readOnly=true, since it + gives much better concurrent performance, unless you + intend to do write operations (delete documents or + change norms) with the underlying IndexReader. + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + directory where IndexReader will be opened + + if true, the underlying IndexReader + will be opened readOnly + + + + Creates a searcher searching the provided index. + + + Return the {@link IndexReader} this searches. + + + Note that the underlying IndexReader is not closed, if + IndexSearcher was constructed with IndexSearcher(IndexReader r). + If the IndexReader was supplied implicitly by specifying a directory, then + the IndexReader gets closed. + + + + Just like {@link #Search(Weight, Filter, int, Sort)}, but you choose + whether or not the fields in the returned {@link FieldDoc} instances + should be set by specifying fillFields.
+ +

+ NOTE: this does not compute scores by default. If you need scores, create + a {@link TopFieldCollector} instance by calling + {@link TopFieldCollector#create} and then pass that to + {@link #Search(Weight, Filter, Collector)}. +

+

+ + + By default, no scores are computed when sorting by field (using + {@link #Search(Query,Filter,int,Sort)}). You can change that, per + IndexSearcher instance, by calling this method. Note that this will incur + a CPU cost. + + + If true, then scores are returned for every matching document + in {@link TopFieldDocs}. + + + If true, then the max score for all matching docs is computed. + + + + Expert: obtains the ordinal of the field value from the default Lucene + {@link Lucene.Net.Search.FieldCache Fieldcache} using getStringIndex(). +

+ The native lucene index order is used to assign an ordinal value for each field value. +

+ Field values (terms) are lexicographically ordered by unicode value, and numbered starting at 1. +

+ Example: +
If there were only three field values: "apple","banana","pear" +
then ord("apple")=1, ord("banana")=2, ord("pear")=3 +

+ WARNING: + ord() depends on the position in an index and can thus change + when other documents are inserted or deleted, + or if a MultiSearcher is used. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

+

+ + + Constructor for a certain field. + field whose values order is used. + + + + A range query that returns a constant score equal to its boost for + all documents in the exclusive range of terms. + +

It does not have an upper bound on the number of clauses covered in the range. + +

This query matches the documents looking for terms that fall into the + supplied range according to {@link String#compareTo(String)}. It is not intended + for numerical ranges, use {@link NumericRangeQuery} instead. + +

This query is hardwired to {@link MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT}. + If you want to change this, use {@link TermRangeQuery} instead. + +

+ Use {@link TermRangeQuery} for term ranges or + {@link NumericRangeQuery} for numeric ranges instead. + This class will be removed in Lucene 3.0. + + $Id: ConstantScoreRangeQuery.java 797694 2009-07-25 00:03:33Z mikemccand $ - - Construct an empty output buffer. + + A Query that matches documents within an exclusive range of terms. + +

This query matches the documents looking for terms that fall into the + supplied range according to {@link String#compareTo(String)}. It is not intended + for numerical ranges, use {@link NumericRangeQuery} instead. + +

This query uses the {@link + MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} + rewrite method. +

+ 2.9 + - - Copy the current contents of this buffer to the named output. + + Constructs a query selecting all terms greater/equal than lowerTerm + but less/equal than upperTerm. + +

+ If an endpoint is null, it is said + to be "open". Either or both endpoints may be open. Open endpoints may not + be exclusive (you can't select all but the first or last term without + explicitly specifying the term to exclude.) + +

+ The field that holds both lower and upper terms. + + The term text at the lower end of the range + + The term text at the upper end of the range + + If true, the lowerTerm is + included in the range. + + If true, the upperTerm is + included in the range. + - - Resets this to an empty buffer. + + Constructs a query selecting all terms greater/equal than + lowerTerm but less/equal than upperTerm. +

+ If an endpoint is null, it is said + to be "open". Either or both endpoints may be open. Open endpoints may not + be exclusive (you can't select all but the first or last term without + explicitly specifying the term to exclude.) +

+ If collator is not null, it will be used to decide whether + index terms are within the given range, rather than using the Unicode code + point order in which index terms are stored. +

+ WARNING: Using this constructor and supplying a non-null + value in the collator parameter will cause every single + index Term in the Field referenced by lowerTerm and/or upperTerm to be + examined. Depending on the number of index Terms in this Field, the + operation could be very slow. + +

+ The Term text at the lower end of the range + + The Term text at the upper end of the range + + If true, the lowerTerm is + included in the range. + + If true, the upperTerm is + included in the range. + + The collator to use to collate index Terms, to determine + their membership in the range bounded by lowerTerm and + upperTerm. + + + + Returns the field name for this query + + + Returns the lower value of this range query + + + Returns the upper value of this range query + + + Returns true if the lower endpoint is inclusive + + + Returns true if the upper endpoint is inclusive + + + Returns the collator used to determine range inclusion, if any. + + + Prints a user-readable version of this query. + + + Changes of mode are not supported by this class (fixed to constant score rewrite mode) + + + A clause in a BooleanQuery. + + + The query whose matching documents are combined by the boolean query. + + + Constructs a BooleanClause. + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + + + Specifies how clauses are to occur in matching documents. + + + A serializable Enum class. + + + Resolves the deserialized instance to the local reference for accurate + equals() and == comparisons. + + + a reference to Parameter as resolved in the local VM + + ObjectStreamException + + + Use this operator for clauses that must appear in the matching documents. + + + Use this operator for clauses that should appear in the + matching documents. For a BooleanQuery with no MUST + clauses one or more SHOULD clauses must match a document + for the BooleanQuery to match. + + + + + + Use this operator for clauses that must not appear in the matching documents. + Note that it is not possible to search for queries that only consist + of a MUST_NOT clause. + + + + This exception is thrown when parse errors are encountered. + You can explicitly create objects of this exception type by + calling the method generateParseException in the generated + parser. + + You can modify this class to customize your error reporting + mechanisms so long as you retain the public fields. + + + + This constructor is used by the method "generateParseException" + in the generated parser. Calling this constructor generates + a new object of this type with the fields "currentToken", + "expectedTokenSequences", and "tokenImage" set. The boolean + flag "specialConstructor" is also set to true to indicate that + this constructor was used to create this object. + This constructor calls its super class with the empty string + to force the "toString" method of parent class "Throwable" to + print the error message in the form: + ParseException: <result of getMessage> + + + + The following constructors are for use by you for whatever + purpose you can think of. Constructing the exception in this + manner makes the exception behave in the normal way - i.e., as + documented in the class "Throwable". The fields "errorToken", + "expectedTokenSequences", and "tokenImage" do not contain + relevant information. The JavaCC generated code does not use + these constructors. + + + + Constructor with message. + + + Constructor with message. + + + This variable determines which constructor was used to create + this object and thereby affects the semantics of the + "getMessage" method (see below). + + + + This is the last token that has been consumed successfully. If + this object has been created due to a parse error, the token + followng this token will (therefore) be the first error token. + + + + Each entry in this array is an array of integers. Each array + of integers represents a sequence of tokens (by their ordinal + values) that is expected at this point of the parse. + + + + This is a reference to the "tokenImage" array of the generated + parser within which the parse error occurred. This array is + defined in the generated ...Constants interface. + + + + The end of line string for this machine. + + + Used to convert raw characters to their escaped version + when these raw version cannot be used as part of an ASCII + string literal. + + + + This method has the standard behavior when this object has been + created using the standard constructors. Otherwise, it uses + "currentToken" and "expectedTokenSequences" to generate a parse + error message and returns it. If this object has been created + due to a parse error, and you do not catch it (it gets thrown + from the parser), then this method is called during the printing + of the final stack trace, and hence the correct error message + gets displayed. + + + + Call this if the IndexInput passed to {@link #read} + stores terms in the "modified UTF8" (pre LUCENE-510) + format. + + + + Allows you to iterate over the {@link TermPositions} for multiple {@link Term}s as + a single {@link TermPositions}. + + + + + TermPositions provides an interface for enumerating the <document, + frequency, <position>* > tuples for a term.

The document and + frequency are the same as for a TermDocs. The positions portion lists the ordinal + positions of each occurrence of a term in a document. + +

+ + + + + Returns next position in the current document. It is an error to call + this more than {@link #Freq()} times + without calling {@link #Next()}

This is + invalid until {@link #Next()} is called for + the first time. +

+ + + Returns the length of the payload at the current term position. + This is invalid until {@link #NextPosition()} is called for + the first time.
+ + length of the current payload in number of bytes + + + + Returns the payload data at the current term position. + This is invalid until {@link #NextPosition()} is called for + the first time. + This method must not be called more than once after each call + of {@link #NextPosition()}. However, payloads are loaded lazily, + so if the payload data for the current position is not needed, + this method may not be called at all for performance reasons.
+ + + the array into which the data of this payload is to be + stored, if it is big enough; otherwise, a new byte[] array + is allocated for this purpose. + + the offset in the array into which the data of this payload + is to be stored. + + a byte[] array containing the data of this payload + + IOException + + + Checks if a payload can be loaded at this position. +

+ Payloads can only be loaded once per call to + {@link #NextPosition()}. + +

+ true if there is a payload available at this position that can be loaded + + + + Creates a new MultipleTermPositions instance. + + + + + + + Not implemented. + UnsupportedOperationException + + + Not implemented. + UnsupportedOperationException + + + Not implemented. + UnsupportedOperationException + + + Not implemented. + UnsupportedOperationException + + + Not implemented. + UnsupportedOperationException + + + + false + + + + Add a new thread + + + Abort (called after hitting AbortException) + + + Flush a new segment + + + Close doc stores + + + Attempt to free RAM, returning true if any RAM was + freed + + + + Used by DocumentsWriter to maintain per-thread state. + We keep a separate Posting hash and other state for each + thread and then merge postings hashes from all threads + when writing the segment. + + + + This class converts alphabetic, numeric, and symbolic Unicode characters + which are not in the first 127 ASCII characters (the "Basic Latin" Unicode + block) into their ASCII equivalents, if one exists. + + Characters from the following Unicode blocks are converted; however, only + those characters with reasonable ASCII alternatives are converted: + + + + See: http://en.wikipedia.org/wiki/Latin_characters_in_Unicode + + The set of character conversions supported by this class is a superset of + those supported by Lucene's {@link ISOLatin1AccentFilter} which strips + accents from Latin1 characters. For example, 'À' will be replaced by + 'a'. + + + + Converts characters above ASCII to their ASCII equivalents. For example, + accents are removed from accented characters. + + The string to fold + + The number of characters in the input string + + + + Borrowed from Cglib. Allows custom swap so that two arrays can be sorted + at the same time. + + + + Simple lockless and memory barrier free String intern cache that is guaranteed + to return the same String instance as String.intern() does. + + + + Subclasses of StringInterner are required to + return the same single String object for all equal strings. + Depending on the implementation, this may not be + the same object returned as String.intern(). + + This StringInterner base class simply delegates to String.intern(). + + + + Returns a single object instance for each equal string. + + + Returns a single object instance for each equal string. + + + Size of the hash table, should be a power of two. + + Maximum length of each bucket, after which the oldest item inserted is dropped. + + + + Encapsulates sort criteria for returned hits. + +

The fields used to determine sort order must be carefully chosen. + Documents must contain a single term in such a field, + and the value of the term should indicate the document's relative position in + a given sort order. The field must be indexed, but should not be tokenized, + and does not need to be stored (unless you happen to want it back with the + rest of your document data). In other words: + +

document.add (new Field ("byNumber", Integer.toString(x), Field.Store.NO, Field.Index.NOT_ANALYZED));

+ + +

Valid Types of Values

+ +

There are four possible kinds of term values which may be put into + sorting fields: Integers, Longs, Floats, or Strings. Unless + {@link SortField SortField} objects are specified, the type of value + in the field is determined by parsing the first term in the field. + +

Integer term values should contain only digits and an optional + preceding negative sign. Values must be base 10 and in the range + Integer.MIN_VALUE and Integer.MAX_VALUE inclusive. + Documents which should appear first in the sort + should have low value integers, later documents high values + (i.e. the documents should be numbered 1..n where + 1 is the first and n the last). + +

Long term values should contain only digits and an optional + preceding negative sign. Values must be base 10 and in the range + Long.MIN_VALUE and Long.MAX_VALUE inclusive. + Documents which should appear first in the sort + should have low value integers, later documents high values. + +

Float term values should conform to values accepted by + {@link Float Float.valueOf(String)} (except that NaN + and Infinity are not supported). + Documents which should appear first in the sort + should have low values, later documents high values. + +

String term values can contain any valid String, but should + not be tokenized. The values are sorted according to their + {@link Comparable natural order}. Note that using this type + of term value has higher memory requirements than the other + two types. + +

Object Reuse

+ +

One of these objects can be + used multiple times and the sort order changed between usages. + +

This class is thread safe. + +

Memory Usage

+ +

Sorting uses of caches of term values maintained by the + internal HitQueue(s). The cache is static and contains an integer + or float array of length IndexReader.maxDoc() for each field + name for which a sort is performed. In other words, the size of the + cache in bytes is: + +

4 * IndexReader.maxDoc() * (# of different fields actually used to sort) + +

For String fields, the cache is larger: in addition to the + above array, the value of every term in the field is kept in memory. + If there are many unique terms in the field, this could + be quite large. + +

Note that the size of the cache is not affected by how many + fields are in the index and might be used to sort - only by + the ones actually used to sort a result set. + +

Created: Feb 12, 2004 10:53:57 AM + +

+ lucene 1.4 + + $Id: Sort.java 795179 2009-07-17 18:23:30Z mikemccand $ + + + + Represents sorting by computed relevance. Using this sort criteria returns + the same results as calling + {@link Searcher#Search(Query) Searcher#search()}without a sort criteria, + only with slightly more overhead. + + + + Represents sorting by index order. + + + Sorts by computed relevance. This is the same sort criteria as calling + {@link Searcher#Search(Query) Searcher#search()}without a sort criteria, + only with slightly more overhead. + + + + Sorts by the terms in field then by index order (document + number). The type of value in field is determined + automatically. + + + + + Please specify the type explicitly by + first creating a {@link SortField} and then use {@link + #Sort(SortField)} + + + + Sorts possibly in reverse by the terms in field then by + index order (document number). The type of value in field is + determined automatically. + + + + + Please specify the type explicitly by + first creating a {@link SortField} and then use {@link + #Sort(SortField)} + + + + Sorts in succession by the terms in each field. The type of value in + field is determined automatically. + + + + + Please specify the type explicitly by + first creating {@link SortField}s and then use {@link + #Sort(SortField[])} + + + + Sorts by the criteria in the given SortField. + + + Sorts in succession by the criteria in each SortField. + + + Sets the sort to the terms in field then by index order + (document number). + + Please specify the type explicitly by + first creating a {@link SortField} and then use {@link + #SetSort(SortField)} + + + + Sets the sort to the terms in field possibly in reverse, + then by index order (document number). + + Please specify the type explicitly by + first creating a {@link SortField} and then use {@link + #SetSort(SortField)} + + + + Sets the sort to the terms in each field in succession. + Please specify the type explicitly by + first creating {@link SortField}s and then use {@link + #SetSort(SortField[])} + + + + Sets the sort to the given criteria. + + + Sets the sort to the given criteria in succession. + + + Representation of the sort criteria. + Array of SortField objects used in this sort criteria + + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + + + Calculate the final score as the average score of all payloads seen. +

+ Is thread safe and completely reusable. + + +

+ + + Expert: obtains single byte field values from the + {@link Lucene.Net.Search.FieldCache FieldCache} + using getBytes() and makes those values + available as other numeric types, casting as needed. + +

+ WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

+ for requirements" + on the field. + +

NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

+ + + +

Create a cached byte field source with default string-to-byte parser. + + + Create a cached byte field source with a specific string-to-byte parser. + + + Filter caching singleton. It can be used + to save filters locally for reuse. + This class makes it possble to cache Filters even when using RMI, as it + keeps the cache on the seaercher side of the RMI connection. + + Also could be used as a persistent storage for any filter as long as the + filter provides a proper hashCode(), as that is used as the key in the cache. + + The cache is periodically cleaned up from a separate thread to ensure the + cache doesn't exceed the maximum size. + + + + The default maximum number of Filters in the cache + + + The default frequency of cache clenup + + + The cache itself + + + Maximum allowed cache size + + + Cache cleaning frequency + + + Cache cleaner that runs in a separate thread + + + Sets up the FilterManager singleton. + + + Sets the max size that cache should reach before it is cleaned up + maximum allowed cache size + + + + Sets the cache cleaning frequency in milliseconds. + cleaning frequency in millioseconds + + + + Returns the cached version of the filter. Allows the caller to pass up + a small filter but this will keep a persistent version around and allow + the caching filter to do its job. + + + The input filter + + The cached version of the filter + + + + Holds the filter and the last time the filter was used, to make LRU-based + cache cleaning possible. + TODO: Clean this up when we switch to Java 1.5 + + + + Keeps the cache from getting too big. + If we were using Java 1.5, we could use LinkedHashMap and we would not need this thread + to clean out the cache. + + The SortedSet sortedFilterItems is used only to sort the items from the cache, + so when it's time to clean up we have the TreeSet sort the FilterItems by + timestamp. + + Removes 1.5 * the numbers of items to make the cache smaller. + For example: + If cache clean size is 10, and the cache is at 15, we would remove (15 - 10) * 1.5 = 7.5 round up to 8. + This way we clean the cache a bit more, and avoid having the cache cleaner having to do it frequently. + + + + Describes the input token stream. + + + An integer that describes the kind of this token. This numbering + system is determined by JavaCCParser, and a table of these numbers is + stored in the file ...Constants.java. + + + + The line number of the first character of this Token. + + + The column number of the first character of this Token. + + + The line number of the last character of this Token. + + + The column number of the last character of this Token. + + + The string image of the token. + + + A reference to the next regular (non-special) token from the input + stream. If this is the last token from the input stream, or if the + token manager has not read tokens beyond this one, this field is + set to null. This is true only if this token is also a regular + token. Otherwise, see below for a description of the contents of + this field. + + + + This field is used to access special tokens that occur prior to this + token, but after the immediately preceding regular (non-special) token. + If there are no such special tokens, this field is set to null. + When there are more than one such special token, this field refers + to the last of these special tokens, which in turn refers to the next + previous special token through its specialToken field, and so on + until the first special token (whose specialToken field is null). + The next fields of special tokens refer to other special tokens that + immediately follow it (without an intervening regular token). If there + is no such token, this field is null. + + + + An optional attribute value of the Token. + Tokens which are not used as syntactic sugar will often contain + meaningful values that will be used later on by the compiler or + interpreter. This attribute value is often different from the image. + Any subclass of Token that actually wants to return a non-null value can + override this method as appropriate. + + + + No-argument constructor + + + Constructs a new token for the specified Image. + + + Constructs a new token for the specified Image and Kind. + + + Returns the image. + + + Returns a new Token object, by default. However, if you want, you + can create and return subclass objects based on the value of ofKind. + Simply add the cases to the switch for all those special cases. + For example, if you have a subclass of Token called IDToken that + you want to create if ofKind is ID, simply add something like : + + case MyParserConstants.ID : return new IDToken(ofKind, image); + + to the following switch statement. Then you can cast matchedToken + variable to the appropriate type and use sit in your lexical actions. + + + + Token Manager. + + + Token literal values and constants. + Generated by org.javacc.parser.OtherFilesGen#start() + + + + End of File. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + RegularExpression Id. + + + Lexical state. + + + Lexical state. + + + Lexical state. + + + Lexical state. + + + Literal token values. + + + Debug output. + + + Set debug output. + + + Token literal values. + + + Lexer state names. + + + Lex State array. + + + Constructor. + + + Constructor. + + + Reinitialise parser. + + + Reinitialise parser. + + + Switch to specified lex state. + + + Get the next Token. + + + MessageBundles classes extend this class, to implement a bundle. + + For Native Language Support (NLS), system of software internationalization. + + This interface is similar to the NLS class in eclipse.osgi.util.NLS class - + initializeMessages() method resets the values of all static strings, should + only be called by classes that extend from NLS (see TestMessages.java for + reference) - performs validation of all message in a bundle, at class load + time - performs per message validation at runtime - see NLSTest.java for + usage reference + + MessageBundle classes may subclass this type. + + + + Initialize a given class with the message bundle Keys Should be called from + a class that extends NLS in a static block at class load time. + + + Property file with that contains the message bundle + + where constants will reside + + + + + + + + + + + + + + - Message Key + + + + + Performs the priviliged action. + + A value that may represent the result of the action. + + + A Term represents a word from text. This is the unit of search. It is + composed of two elements, the text of the word, as a string, and the name of + the field that the text occured in, an interned string. + Note that terms may represent more than words from text fields, but also + things like dates, email addresses, urls, etc. + + + + Constructs a Term with the given field and text. +

Note that a null field or null text value results in undefined + behavior for most Lucene APIs that accept a Term parameter. +

+ + + Constructs a Term with the given field and empty text. + This serves two purposes: 1) reuse of a Term with the same field. + 2) pattern for a query. + + + + + + + Returns the field of this term, an interned string. The field indicates + the part of a document which this term came from. + + + + Returns the text of this term. In the case of words, this is simply the + text of the word. In the case of dates and other types, this is an + encoding of the object as a string. + + + + Optimized construction of new Terms by reusing same field as this Term + - avoids field.intern() overhead + + The text of the new term (field is implicitly same as this Term instance) + + A new Term + + + + Compares two terms, returning a negative integer if this + term belongs before the argument, zero if this term is equal to the + argument, and a positive integer if this term belongs after the argument. + The ordering of terms is first by field, then by text. + + + + Resets the field and text of a Term. + + + Optimized implementation. + + + Overridden by SegmentTermPositions to skip in prox stream. + + + Optimized implementation. + + + Called by super.skipTo(). + + + This is a DocConsumer that gathers all fields under the + same name, and calls per-field consumers to process field + by field. This class doesn't doesn't do any "real" work + of its own: it just forwards the fields to a + DocFieldConsumer. + + + + Load the First field and break. +

+ See {@link FieldSelectorResult#LOAD_AND_BREAK} +

+ + + Replacement for Java 1.5 Character.valueOf() + Move to Character.valueOf() in 3.0 + + + + Returns a Character instance representing the given char value + + + a char value + + a Character representation of the given char value. + Optimized implementation of a vector of bits. This is more-or-less like @@ -6624,11 +11199,10 @@
  • a count() method, which efficiently computes the number of one bits;
  • optimized read from and write to disk;
  • inlinable get() method;
    • +
  • store and load, as bit set or d-gaps, depending on sparseness;
    •  - Doug Cutting - - $Id: BitVector.java 150536 2004-09-28 18:15:52Z cutting $ + $Id: BitVector.java 765649 2009-04-16 14:29:26Z mikemccand $     @@ -6637,6 +11211,11 @@ Sets the value of bit to one. + + Sets the value of bit to true, and + returns true if bit was already set + + Sets the value of bit to zero. @@ -6662,22 +11241,3025 @@ #BitVector(Directory, String)}.     + + Write as a bit set + + + Write as a d-gaps list + + + Indicates if the bit vector is sparse and should be saved as a d-gaps list, or dense, and should be saved as a bit set. + Constructs a bit vector from the file name in Directory d, as written by the {@link #write} method. + + Read as a bit set + + + read as a d-gaps list + + + Retrieve a subset of this BitVector. + + + starting index, inclusive + + ending index, exclusive + + subset + + + + + Represents hits returned by {@link Searcher#search(Query,Filter,int,Sort)}. + + + + The fields which were used to sort results by. + + + Creates one of these objects. + Total number of hits for the query. + + The top hits for the query. + + The sort criteria used to find the top hits. + + The maximum score encountered. + + + + A {@link Collector} that sorts by {@link SortField} using + {@link FieldComparator}s. +

    + See the {@link #create(Lucene.Net.Search.Sort, int, boolean, boolean, boolean, boolean)} method + for instantiating a TopFieldCollector. + +

    NOTE: This API is experimental and might change in + incompatible ways in the next release.

    +

    +     + + A base class for all collectors that return a {@link TopDocs} output. This + collector allows easy extension by providing a single constructor which + accepts a {@link PriorityQueue} as well as protected members for that + priority queue and a counter of the number of total hits.
    + Extending classes can override {@link #TopDocs(int, int)} and + {@link #GetTotalHits()} in order to provide their own implementation. +     +     + + The priority queue which holds the top documents. Note that different + implementations of PriorityQueue give different meaning to 'top documents'. + HitQueue for example aggregates the top scoring documents, while other PQ + implementations may hold documents sorted by other criteria. + + + + The total number of documents that the collector encountered. + + + Populates the results array with the ScoreDoc instaces. This can be + overridden in case a different ScoreDoc type should be returned. + + + + Returns a {@link TopDocs} instance containing the given results. If + results is null it means there are no results to return, + either because there were 0 calls to collect() or because the arguments to + topDocs were invalid. + + + + The total number of documents that matched this query. + + + Returns the top docs that were collected by this collector. + + + Returns the documents in the rage [start .. pq.size()) that were collected + by this collector. Note that if start >= pq.size(), an empty TopDocs is + returned.
    + This method is convenient to call if the application allways asks for the + last results, starting from the last 'page'.
    + NOTE: you cannot call this method more than once for each search + execution. If you need to call it more than once, passing each time a + different start, you should call {@link #TopDocs()} and work + with the returned {@link TopDocs} object, which will contain all the + results this search execution collected. +     +     + + Returns the documents in the rage [start .. start+howMany) that were + collected by this collector. Note that if start >= pq.size(), an empty + TopDocs is returned, and if pq.size() - start < howMany, then only the + available documents in [start .. pq.size()) are returned.
    + This method is useful to call in case pagination of search results is + allowed by the search application, as well as it attempts to optimize the + memory used by allocating only as much as requested by howMany.
    + NOTE: you cannot call this method more than once for each search + execution. If you need to call it more than once, passing each time a + different range, you should call {@link #TopDocs()} and work with the + returned {@link TopDocs} object, which will contain all the results this + search execution collected. +     +     + + Creates a new {@link TopFieldCollector} from the given + arguments. + +

    NOTE: The instances returned by this method + pre-allocate a full array of length + numHits. + +

    + the sort criteria (SortFields). + + the number of results to collect. + + specifies whether the actual field values should be returned on + the results (FieldDoc). + + specifies whether document scores should be tracked and set on the + results. Note that if set to false, then the results' scores will + be set to Float.NaN. Setting this to true affects performance, as + it incurs the score computation on each competitive result. + Therefore if document scores are not required by the application, + it is recommended to set it to false. + + specifies whether the query's maxScore should be tracked and set + on the resulting {@link TopDocs}. Note that if set to false, + {@link TopDocs#GetMaxScore()} returns Float.NaN. Setting this to + true affects performance as it incurs the score computation on + each result. Also, setting this true automatically sets + trackDocScores to true as well. + + specifies whether documents are scored in doc Id order or not by + the given {@link Scorer} in {@link #SetScorer(Scorer)}. + + a {@link TopFieldCollector} instance which will sort the results by + the sort criteria. + + IOException +     + + Abstract base class for sorting hits returned by a Query. + +

    + This class should only be used if the other SortField types (SCORE, DOC, + STRING, INT, FLOAT) do not provide an adequate sorting. It maintains an + internal cache of values which could be quite large. The cache is an array of + Comparable, one for each document in the index. There is a distinct + Comparable for each unique term in the field - if some documents have the + same term in the field, the cache array will have entries which reference the + same Comparable. + + This class will be used as part of a key to a FieldCache value. You must + implement hashCode and equals to avoid an explosion in RAM usage if you use + instances that are not the same instance. If you are searching using the + Remote contrib, the same instance of this class on the client will be a new + instance on every call to the server, so hashCode/equals is very important in + that situation. + +

    + Created: Apr 21, 2004 5:08:38 PM + + +

    + $Id: SortComparator.java 800119 2009-08-02 17:59:21Z markrmiller $ + + 1.4 + + Please use {@link FieldComparatorSource} instead. + +     + + Returns an object which, when sorted according to natural order, + will order the Term values in the correct order. +

    For example, if the Terms contained integer values, this method + would return new Integer(termtext). Note that this + might not always be the most efficient implementation - for this + particular example, a better implementation might be to make a + ScoreDocLookupComparator that uses an internal lookup table of int. +

    + The textual value of the term. + + An object representing termtext that sorts according to the natural order of termtext. + + + + + +     + + Compares two ScoreDoc objects and returns a result indicating their + sort order. + + First ScoreDoc + + Second ScoreDoc + + a negative integer if i should come before j
    + a positive integer if i should come after j
    + 0 if they are equal +     + + +     + + Returns the value used to sort the given document. The + object returned must implement the java.io.Serializable + interface. This is used by multisearchers to determine how + to collate results from their searchers. + + + + Document + + Serializable object + + + + Returns the type of sort. Should return SortField.SCORE, + SortField.DOC, SortField.STRING, + SortField.INTEGER, SortField.FLOAT or + SortField.CUSTOM. It is not valid to return + SortField.AUTO. + This is used by multisearchers to determine how to collate results + from their searchers. + + One of the constants in SortField. + + + + + + A {@link Collector} implementation which wraps another + {@link Collector} and makes sure only documents with + scores > 0 are collected. + + + + A query that matches all documents. + + + + + Field used for normalization factor (document boost). Null if nothing. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + A ranked list of documents, used to hold search results. +

    + Caution: Iterate only over the hits needed. Iterating over all hits is + generally not desirable and may be the source of performance issues. If you + need to iterate over many or all hits, consider using the search method that + takes a {@link HitCollector}. +

    +

    + Note: Deleting matching documents concurrently with traversing the + hits, might, when deleting hits that were not yet retrieved, decrease + {@link #Length()}. In such case, + {@link java.util.ConcurrentModificationException + ConcurrentModificationException} is thrown when accessing hit n + > current_{@link #Length()} (but n < {@link #Length()} + _at_start). + +

    + see {@link Searcher#Search(Query, int)}, + {@link Searcher#Search(Query, Filter, int)} and + {@link Searcher#Search(Query, Filter, int, Sort)}:
    + + 
    +            TopDocs topDocs = searcher.Search(query, numHits);
+            ScoreDoc[] hits = topDocs.scoreDocs;
+            for (int i = 0; i < hits.Length; i++) {
+            int docId = hits[i].doc;
+            Document d = searcher.Doc(docId);
+            // do something with current hit
+            ...
+
    +     +     + + Tries to add new documents to hitDocs. + Ensures that the hit numbered min has been retrieved. + + + + Returns the total number of hits available in this set. + + + Returns the stored fields of the nth document in this set. +

    Documents are cached, so that repeated requests for the same element may + return the same Document object. +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Returns the score for the nth document in this set. + + + Returns the id for the nth document in this set. + Note that ids may change when the index changes, so you cannot + rely on the id to be stable. + + + + Returns a {@link HitIterator} to navigate the Hits. Each item returned + from {@link Iterator#next()} is a {@link Hit}. +

    + Caution: Iterate only over the hits needed. Iterating over all + hits is generally not desirable and may be the source of + performance issues. If you need to iterate over many or all hits, consider + using a search method that takes a {@link HitCollector}. +

    +

    +     + + An iterator over {@link Hits} that provides lazy fetching of each document. + {@link Hits#Iterator()} returns an instance of this class. Calls to {@link #next()} + return a {@link Hit} instance. + + + Use {@link TopScoreDocCollector} and {@link TopDocs} instead. Hits will be removed in Lucene 3.0. + + + + Constructed from {@link Hits#Iterator()}. + + + true if current hit is less than the total number of {@link Hits}. + + + + Unsupported operation. + + + UnsupportedOperationException + + + Returns the total number of hits. + + + Returns a {@link Hit} instance representing the next hit in {@link Hits}. + + + Next {@link Hit}. + + + + Wrapper for ({@link HitCollector}) implementations, which simply re-bases the + incoming docID before calling {@link HitCollector#collect}. + + + Please migrate custom HitCollectors to the new {@link Collector} + class. This class will be removed when {@link HitCollector} is + removed. + + + + Wrapper used by {@link HitIterator} to provide a lazily loaded hit + from {@link Hits}. + + + Use {@link TopScoreDocCollector} and {@link TopDocs} instead. Hits will be removed in Lucene 3.0. + + + + Constructed from {@link HitIterator} + Hits returned from a search + + Hit index in Hits + + + + Returns document for this hit. + + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Returns score for this hit. + + + + + + + Returns id for this hit. + + + + + + + Returns the boost factor for this hit on any field of the underlying document. + + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Returns the string value of the field with the given name if any exist in + this document, or null. If multiple fields exist with this name, this + method returns the first value added. If only binary fields with this name + exist, returns null. + + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Prints the parameters to be used to discover the promised result. + + + Expert: A hit queue for sorting by hits by terms in more than one field. + Uses FieldCache.DEFAULT for maintaining internal term lookup tables. + +

    Created: Dec 8, 2003 12:56:03 PM + +

    + lucene 1.4 + + $Id: FieldSortedHitQueue.java 803676 2009-08-12 19:31:38Z hossman $ + + + + + + see {@link FieldValueHitQueue} + +     + + Creates a hit queue sorted by the given list of fields. + Index to use. + + Fieldable names, in priority order (highest priority first). Cannot be null or empty. + + The number of hits to retain. Must be greater than zero. + + IOException + + + Stores a comparator corresponding to each field being sorted by + + + Stores the sort criteria being used. + + + Stores the maximum score value encountered, needed for normalizing. + + + returns the maximum score encountered by elements inserted via insert() + + + Returns whether a is less relevant than b. + ScoreDoc + + ScoreDoc + + true if document a should be sorted after document b. + + + + Given a FieldDoc object, stores the values used + to sort the given document. These values are not the raw + values out of the index, but the internal representation + of them. This is so the given search hit can be collated + by a MultiSearcher with other search hits. + + The FieldDoc to store sort values into. + + The same FieldDoc passed in. + + + + + + Returns the SortFields being used by this hit queue. + + + Internal cache of comparators. Similar to FieldCache, only + caches comparators instead of term values. + + + + Returns a comparator for sorting hits according to a field containing bytes. + Index to use. + + Fieldable containing integer values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing shorts. + Index to use. + + Fieldable containing integer values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing integers. + Index to use. + + Fieldable containing integer values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing integers. + Index to use. + + Fieldable containing integer values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing floats. + Index to use. + + Fieldable containing float values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing doubles. + Index to use. + + Fieldable containing float values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing strings. + Index to use. + + Fieldable containing string values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to a field containing strings. + Index to use. + + Fieldable containing string values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Returns a comparator for sorting hits according to values in the given field. + The terms in the field are looked at to determine whether they contain integers, + floats or strings. Once the type is determined, one of the other static methods + in this class is called to get the comparator. + + Index to use. + + Fieldable containing values. + + Comparator for sorting hits. + + IOException If an error occurs reading the index. + + + Expert: Internal cache. + + + Expert: The default cache implementation, storing all values in memory. + A WeakHashMap is used for storage. + +

    Created: May 19, 2004 4:40:36 PM + +

    + lucene 1.4 + + $Id: FieldCacheImpl.java 807572 2009-08-25 11:44:45Z mikemccand $ + +     + + Checks the internal cache for an appropriate entry, and if none is + found, reads the terms in field as a single byte and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + Used to get field values. + + Which field contains the single byte values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is found, + reads the terms in field as bytes and returns an array of + size reader.maxDoc() of the value each document has in the + given field. + + Used to get field values. + + Which field contains the bytes. + + Computes byte for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is + found, reads the terms in field as shorts and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + Used to get field values. + + Which field contains the shorts. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is found, + reads the terms in field as shorts and returns an array of + size reader.maxDoc() of the value each document has in the + given field. + + Used to get field values. + + Which field contains the shorts. + + Computes short for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is + found, reads the terms in field as integers and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + Used to get field values. + + Which field contains the integers. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is found, + reads the terms in field as integers and returns an array of + size reader.maxDoc() of the value each document has in the + given field. + + Used to get field values. + + Which field contains the integers. + + Computes integer for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if + none is found, reads the terms in field as floats and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + Used to get field values. + + Which field contains the floats. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if + none is found, reads the terms in field as floats and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + Used to get field values. + + Which field contains the floats. + + Computes float for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is + found, reads the terms in field as longs and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + + Used to get field values. + + Which field contains the longs. + + The values in the given field for each document. + + java.io.IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is found, + reads the terms in field as longs and returns an array of + size reader.maxDoc() of the value each document has in the + given field. + + + Used to get field values. + + Which field contains the longs. + + Computes integer for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is + found, reads the terms in field as integers and returns an array + of size reader.maxDoc() of the value each document + has in the given field. + + + Used to get field values. + + Which field contains the doubles. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none is found, + reads the terms in field as doubles and returns an array of + size reader.maxDoc() of the value each document has in the + given field. + + + Used to get field values. + + Which field contains the doubles. + + Computes integer for string values. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none + is found, reads the term values in field and returns an array + of size reader.maxDoc() containing the value each document + has in the given field. + + Used to get field values. + + Which field contains the strings. + + The values in the given field for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if none + is found reads the term values in field and returns + an array of them in natural order, along with an array telling + which element in the term array each document uses. + + Used to get field values. + + Which field contains the strings. + + Array of terms and index into the array for each document. + + IOException If any error occurs. + + + Checks the internal cache for an appropriate entry, and if + none is found reads field to see if it contains integers, longs, floats + or strings, and then calls one of the other methods in this class to get the + values. For string values, a StringIndex is returned. After + calling this method, there is an entry in the cache for both + type AUTO and the actual found type. + + Used to get field values. + + Which field contains the values. + + int[], long[], float[] or StringIndex. + + IOException If any error occurs. + Please specify the exact type, instead. + Especially, guessing does not work with the new + {@link NumericField} type. + + + + Checks the internal cache for an appropriate entry, and if none + is found reads the terms out of field and calls the given SortComparator + to get the sort values. A hit in the cache will happen if reader, + field, and comparator are the same (using equals()) + as a previous call to this method. + + Used to get field values. + + Which field contains the values. + + Used to convert terms into something to sort by. + + Array of sort objects, one for each document. + + IOException If any error occurs. + Please implement {@link + FieldComparatorSource} directly, instead. + + + + EXPERT: Generates an array of CacheEntry objects representing all items + currently in the FieldCache. +

    + NOTE: These CacheEntry objects maintain a strong refrence to the + Cached Values. Maintaining refrences to a CacheEntry the IndexReader + associated with it has garbage collected will prevent the Value itself + from being garbage collected when the Cache drops the WeakRefrence. +

    +

    + EXPERIMENTAL API: This API is considered extremely advanced + and experimental. It may be removed or altered w/o warning in future + releases + of Lucene. +

    +

    +     + +

    + EXPERT: Instructs the FieldCache to forcibly expunge all entries + from the underlying caches. This is intended only to be used for + test methods as a way to ensure a known base state of the Cache + (with out needing to rely on GC to free WeakReferences). + It should not be relied on for "Cache maintenance" in general + application code. +

    +

    + EXPERIMENTAL API: This API is considered extremely advanced + and experimental. It may be removed or altered w/o warning in future + releases + of Lucene. +

    +

    +     + + If non-null, FieldCacheImpl will warn whenever + entries are created that are not sane according to + {@link Lucene.Net.Util.FieldCacheSanityChecker}. + + + + counterpart of {@link #SetInfoStream(PrintStream)} + + + Will be removed in 3.0, this is for binary compatibility only + + + + Will be removed in 3.0, this is for binary compatibility only + + + + Will be removed in 3.0, this is for binary compatibility only + + + + Will be removed in 3.0, this is for binary compatibility only + + + + The pattern used to detect float values in a field + removed for java 1.3 compatibility + protected static final Object pFloats = Pattern.compile ("[0-9+\\-\\.eEfFdD]+"); + + + + + + + + EXPERT: A unique Identifier/Description for each item in the FieldCache. + Can be useful for logging/debugging. +

    + EXPERIMENTAL API: This API is considered extremely advanced + and experimental. It may be removed or altered w/o warning in future + releases + of Lucene. +

    +

    +     + + + + + + Computes (and stores) the estimated size of the cache Value + + + + + The most recently estimated size of the value, null unless + estimateSize has been called. + + + + Only needed because of Entry (ab)use by + FieldSortedHitQueue, remove when FieldSortedHitQueue + is removed + + + + Only needed because of Entry (ab)use by + FieldSortedHitQueue, remove when FieldSortedHitQueue + is removed + + + + Adds warning to super.toString if Local or sortFieldType were specified + Only needed because of Entry (ab)use by + FieldSortedHitQueue, remove when FieldSortedHitQueue + is removed + + + + Hack: When thrown from a Parser (NUMERIC_UTILS_* ones), this stops + processing terms and returns the current FieldCache + array. + + + + Expert: Internal cache. + + + Expert: Every composite-key in the internal cache is of this type. + + + Only (ab)used by FieldSortedHitQueue, + remove when FieldSortedHitQueue is removed + + + + Only (ab)used by FieldSortedHitQueue, + remove when FieldSortedHitQueue is removed + + + + Only (ab)used by FieldSortedHitQueue, + remove when FieldSortedHitQueue is removed + + + + Creates one of these objects for a custom comparator/parser. + + + Only (ab)used by FieldSortedHitQueue, + remove when FieldSortedHitQueue is removed + + + + Two of these are equal iff they reference the same field and type. + + + Composes a hashcode based on the field and type. + + + Please specify the exact type, instead. + Especially, guessing does not work with the new + {@link NumericField} type. + + + + + + + + Expert: a FieldComparator compares hits so as to determine their + sort order when collecting the top results with {@link + TopFieldCollector}. The concrete public FieldComparator + classes here correspond to the SortField types. + +

    This API is designed to achieve high performance + sorting, by exposing a tight interaction with {@link + FieldValueHitQueue} as it visits hits. Whenever a hit is + competitive, it's enrolled into a virtual slot, which is + an int ranging from 0 to numHits-1. The {@link + FieldComparator} is made aware of segment transitions + during searching in case any internal state it's tracking + needs to be recomputed during these transitions.

    + +

    A comparator must define these functions:

    + +

      + +
    • {@link #compare} Compare a hit at 'slot a' + with hit 'slot b'.
      • + +
    • {@link #setBottom} This method is called by + {@link FieldValueHitQueue} to notify the + FieldComparator of the current weakest ("bottom") + slot. Note that this slot may not hold the weakest + value according to your comparator, in cases where + your comparator is not the primary one (ie, is only + used to break ties from the comparators before it).
      • + +
    • {@link #compareBottom} Compare a new hit (docID) + against the "weakest" (bottom) entry in the queue.
      • + +
    • {@link #copy} Installs a new hit into the + priority queue. The {@link FieldValueHitQueue} + calls this method when a new hit is competitive.
      • + +
    • {@link #setNextReader} Invoked + when the search is switching to the next segment. + You may need to update internal state of the + comparator, for example retrieving new values from + the {@link FieldCache}.
      • + +
    • {@link #value} Return the sort value stored in + the specified slot. This is only called at the end + of the search, in order to populate {@link + FieldDoc#fields} when returning the top results.
      • +
    + + NOTE: This API is experimental and might change in + incompatible ways in the next release. +     +     + + Compare hit at slot1 with hit at slot2. + + + first slot to compare + + second slot to compare + + any N < 0 if slot2's value is sorted after + slot1, any N > 0 if the slot2's value is sorted before + slot1 and 0 if they are equal + + + + Set the bottom slot, ie the "weakest" (sorted last) + entry in the queue. When {@link #compareBottom} is + called, you should compare against this slot. This + will always be called before {@link #compareBottom}. + + + the currently weakest (sorted last) slot in the queue + + + + Compare the bottom of the queue with doc. This will + only invoked after setBottom has been called. This + should return the same result as {@link + #Compare(int,int)}} as if bottom were slot1 and the new + document were slot 2. + +

    For a search that hits many results, this method + will be the hotspot (invoked by far the most + frequently).

    + +

    + that was hit + + any N < 0 if the doc's value is sorted after + the bottom entry (not competitive), any N > 0 if the + doc's value is sorted before the bottom entry and 0 if + they are equal. + +     + + This method is called when a new hit is competitive. + You should copy any state associated with this document + that will be required for future comparisons, into the + specified slot. + + + which slot to copy the hit to + + docID relative to current reader + + + + Set a new Reader. All doc correspond to the current Reader. + + + current reader + + docBase of this reader + + IOException + IOException + + + Sets the Scorer to use in case a document's score is + needed. + + + Scorer instance that you should use to + obtain the current hit's score, if necessary. + + + + Return the actual value in the slot. + + + the value + + value in this slot upgraded to Comparable + + + + Parses field's values as byte (using {@link + FieldCache#getBytes} and sorts by ascending value + + + + Sorts by ascending docID + + + Parses field's values as double (using {@link + FieldCache#getDoubles} and sorts by ascending value + + + + Parses field's values as float (using {@link + FieldCache#getFloats} and sorts by ascending value + + + + Parses field's values as int (using {@link + FieldCache#getInts} and sorts by ascending value + + + + Parses field's values as long (using {@link + FieldCache#getLongs} and sorts by ascending value + + + + Sorts by descending relevance. NOTE: if you are + sorting only by descending relevance and then + secondarily by ascending docID, peformance is faster + using {@link TopScoreDocCollector} directly (which {@link + IndexSearcher#search} uses when no {@link Sort} is + specified). + + + + Parses field's values as short (using {@link + FieldCache#getShorts} and sorts by ascending value + + + + Sorts by a field's value using the Collator for a + given Locale. + + + + Sorts by field's natural String sort order, using + ordinals. This is functionally equivalent to {@link + StringValComparator}, but it first resolves the string + to their relative ordinal positions (using the index + returned by {@link FieldCache#getStringIndex}), and + does most comparisons using the ordinals. For medium + to large results, this comparator will be much faster + than {@link StringValComparator}. For very small + result sets it may be slower. + + + + Sorts by field's natural String sort order. All + comparisons are done using String.compareTo, which is + slow for medium to large result sets but possibly + very fast for very small results sets. + + + + A range filter built on top of a cached single term field (in {@link FieldCache}). + +

    FieldCacheRangeFilter builds a single cache for the field the first time it is used. + Each subsequent FieldCacheRangeFilter on the same field then reuses this cache, + even if the range itself changes. + +

    This means that FieldCacheRangeFilter is much faster (sometimes more than 100x as fast) + as building a {@link TermRangeFilter} (or {@link ConstantScoreRangeQuery} on a {@link TermRangeFilter}) + for each query, if using a {@link #newStringRange}. However, if the range never changes it + is slower (around 2x as slow) than building a CachingWrapperFilter on top of a single TermRangeFilter. + + For numeric data types, this filter may be significantly faster than {@link NumericRangeFilter}. + Furthermore, it does not need the numeric values encoded by {@link NumericField}. But + it has the problem that it only works with exact one value/document (see below). + +

    As with all {@link FieldCache} based functionality, FieldCacheRangeFilter is only valid for + fields which exact one term for each document (except for {@link #newStringRange} + where 0 terms are also allowed). Due to a restriction of {@link FieldCache}, for numeric ranges + all terms that do not have a numeric value, 0 is assumed. + +

    Thus it works on dates, prices and other single value fields but will not work on + regular text fields. It is preferable to use a NOT_ANALYZED field to ensure that + there is only a single term. + +

    This class does not have an constructor, use one of the static factory methods available, + that create a correct instance for different data types supported by {@link FieldCache}. +

    +     + + This method is implemented for each data type + + + Creates a string range query using {@link FieldCache#getStringIndex}. This works with all + fields containing zero or one term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetBytes(IndexReader,String)}. This works with all + byte fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetBytes(IndexReader,String,FieldCache.ByteParser)}. This works with all + byte fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetShorts(IndexReader,String)}. This works with all + short fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetShorts(IndexReader,String,FieldCache.ShortParser)}. This works with all + short fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetInts(IndexReader,String)}. This works with all + int fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetInts(IndexReader,String,FieldCache.IntParser)}. This works with all + int fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetLongs(IndexReader,String)}. This works with all + long fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetLongs(IndexReader,String,FieldCache.LongParser)}. This works with all + long fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetFloats(IndexReader,String)}. This works with all + float fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetFloats(IndexReader,String,FieldCache.FloatParser)}. This works with all + float fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetDoubles(IndexReader,String)}. This works with all + double fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + Creates a numeric range query using {@link FieldCache#GetDoubles(IndexReader,String,FieldCache.DoubleParser)}. This works with all + double fields containing exactly one numeric term in the field. The range can be half-open by setting one + of the values to null. + + + + this method checks, if a doc is a hit, should throw AIOBE, when position invalid + + + this DocIdSet is cacheable, if it works solely with FieldCache and no TermDocs + + + @deprecated use {@link #NextDoc()} instead. + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + Expert: Describes the score computation for document and query. + + + Indicates whether or not this Explanation models a good match. + +

    + By default, an Explanation represents a "match" if the value is positive. +

    +

    + + +     + + The value assigned to this explanation node. + + + Sets the value assigned to this explanation node. + + + A description of this explanation node. + + + Sets the description of this explanation node. + + + A short one line summary which should contain all high level + information about this Explanation, without the "Details" + + + + The sub-nodes of this explanation node. + + + Adds a sub-node to this explanation node. + + + Render an explanation as text. + + + Render an explanation as HTML. + + + Small Util class used to pass both an idf factor as well as an + explanation for that factor. + + This class will likely be held on a {@link Weight}, so be aware + before storing any large or un-serializable fields. + + + + + the idf factor + + + + This should be calculated lazily if possible. + + + the explanation for the idf factor. + + + + An alternative to BooleanScorer that also allows a minimum number + of optional scorers that should match. +
    Implements skipTo(), and has no limitations on the numbers of added scorers. +
    Uses ConjunctionScorer, DisjunctionScorer, ReqOptScorer and ReqExclScorer. +     +     + + The scorer to which all scoring will be delegated, + except for computing and using the coordination factor. + + + + The number of optionalScorers that need to match (if there are any) + + + Creates a {@link Scorer} with the given similarity and lists of required, + prohibited and optional scorers. In no required scorers are added, at least + one of the optional scorers will have to match during the search. + + + The similarity to be used. + + The minimum number of optional added scorers that should match + during the search. In case no required scorers are added, at least + one of the optional scorers will have to match during the search. + + the list of required scorers. + + the list of prohibited scorers. + + the list of optional scorers. + + + + Returns the scorer to be used for match counting and score summing. + Uses requiredScorers, optionalScorers and prohibitedScorers. + + + + Returns the scorer to be used for match counting and score summing. + Uses the given required scorer and the prohibitedScorers. + + A required scorer already built. + + + + Scores and collects all matching documents. + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. +
    When this method is used the {@link #Explain(int)} method should not be used. + + use {@link #Score(Collector)} instead. + +     + + Scores and collects all matching documents. + The collector to which all matching documents are passed through. +
    When this method is used the {@link #Explain(int)} method should not be used. + +     + + Expert: Collects matching documents in a range. +
    Note that {@link #Next()} must be called once before this method is + called for the first time. +     + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. + + Do not score documents past this. + + true if more matching documents may remain. + + use {@link #Score(Collector, int, int)} instead. + +     + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + Throws an UnsupportedOperationException. + TODO: Implement an explanation of the coordination factor. + + The document number for the explanation. + + UnsupportedOperationException + + + A Scorer for OR like queries, counterpart of ConjunctionScorer. + This Scorer implements {@link Scorer#SkipTo(int)} and uses skipTo() on the given Scorers. + TODO: Implement score(HitCollector, int). + + + + The number of subscorers. + + + The subscorers. + + + The minimum number of scorers that should match. + + + The scorerDocQueue contains all subscorers ordered by their current doc(), + with the minimum at the top. +
    The scorerDocQueue is initialized the first time next() or skipTo() is called. +
    An exhausted scorer is immediately removed from the scorerDocQueue. +
    If less than the minimumNrMatchers scorers + remain in the scorerDocQueue next() and skipTo() return false. +

    + After each to call to next() or skipTo() + currentSumScore is the total score of the current matching doc, + nrMatchers is the number of matching scorers, + and all scorers are after the matching doc, or are exhausted. +

    +     + + The document number of the current match. + + + The number of subscorers that provide the current match. + + + Construct a DisjunctionScorer. + A collection of at least two subscorers. + + The positive minimum number of subscorers that should + match to match this query. +
    When minimumNrMatchers is bigger than + the number of subScorers, + no matches will be produced. +
    When minimumNrMatchers equals the number of subScorers, + it more efficient to use ConjunctionScorer. + +     + + Construct a DisjunctionScorer, using one as the minimum number + of matching subscorers. + + + + Called the first time next() or skipTo() is called to + initialize scorerDocQueue. + + + + Scores and collects all matching documents. + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. +
    When this method is used the {@link #Explain(int)} method should not be used. + + use {@link #Score(Collector)} instead. + +     + + Scores and collects all matching documents. + The collector to which all matching documents are passed through. +
    When this method is used the {@link #Explain(int)} method should not be used. + +     + + Expert: Collects matching documents in a range. Hook for optimization. + Note that {@link #Next()} must be called once before this method is called + for the first time. + + The collector to which all matching documents are passed through + {@link HitCollector#Collect(int, float)}. + + Do not score documents past this. + + true if more matching documents may remain. + + use {@link #Score(Collector, int, int)} instead. + + + + Expert: Collects matching documents in a range. Hook for optimization. + Note that {@link #Next()} must be called once before this method is called + for the first time. + + The collector to which all matching documents are passed through. + + Do not score documents past this. + + true if more matching documents may remain. + + + + use {@link #NextDoc()} instead. + + + + Advance all subscorers after the current document determined by the + top of the scorerDocQueue. + Repeat until at least the minimum number of subscorers match on the same + document and all subscorers are after that document or are exhausted. +
    On entry the scorerDocQueue has at least minimumNrMatchers + available. At least the scorer with the minimum document number will be advanced. +     + true iff there is a match. +
    In case there is a match, currentDoc, currentSumScore, + and nrMatchers describe the match. + + TODO: Investigate whether it is possible to use skipTo() when + the minimum number of matchers is bigger than one, ie. try and use the + character of ConjunctionScorer for the minimum number of matchers. + Also delay calling score() on the sub scorers until the minimum number of + matchers is reached. +
    For this, a Scorer array with minimumNrMatchers elements might + hold Scorers at currentDoc that are temporarily popped from scorerQueue. +     +     + + Returns the score of the current document matching the query. + Initially invalid, until {@link #Next()} is called the first time. + + + + use {@link #DocID()} instead. + + + + Returns the number of subscorers matching the current document. + Initially invalid, until {@link #Next()} is called the first time. + + + + Skips to the first match beyond the current whose document number is + greater than or equal to a given target.
    + When this method is used the {@link #Explain(int)} method should not be + used.
    + The implementation uses the skipTo() method on the subscorers. + +     + The target document number. + + true iff there is such a match. + + use {@link #Advance(int)} instead. + +     + + Advances to the first match beyond the current whose document number is + greater than or equal to a given target.
    + When this method is used the {@link #Explain(int)} method should not be + used.
    + The implementation uses the skipTo() method on the subscorers. + +     + The target document number. + + the document whose number is greater than or equal to the given + target, or -1 if none exist. + +     + + An explanation for the score of a given document. + + + + Scorer for conjunctions, sets of queries, all of which are required. + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + Count a scorer as a single match. + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + A QueryParser which constructs queries to search multiple fields. + + + $Revision: 829134 $ + + + + This class is generated by JavaCC. The most important method is + {@link #Parse(String)}. + + The syntax for query strings is as follows: + A Query is a series of clauses. + A clause may be prefixed by: +
      +
    • a plus (+) or a minus (-) sign, indicating + that the clause is required or prohibited respectively; or
      • +
    • a term followed by a colon, indicating the field to be searched. + This enables one to construct queries which search multiple fields.
      • +
    + + A clause may be either: +
      +
    • a term, indicating all the documents that contain this term; or
      • +
    • a nested query, enclosed in parentheses. Note that this may be used + with a +/- prefix to require any of a set of + terms.
      • +
    + + Thus, in BNF, the query grammar is: + 
    +            Query  ::= ( Clause )*
+            Clause ::= ["+", "-"] [<TERM> ":"] ( <TERM> | "(" Query ")" )
+
    + +

    + Examples of appropriately formatted queries can be found in the query syntax + documentation. +

    + +

    + In {@link TermRangeQuery}s, QueryParser tries to detect date values, e.g. + date:[6/1/2005 TO 6/4/2005] produces a range query that searches + for "date" fields between 2005-06-01 and 2005-06-04. Note that the format + of the accepted input depends on {@link #SetLocale(Locale) the locale}. + By default a date is converted into a search term using the deprecated + {@link DateField} for compatibility reasons. + To use the new {@link DateTools} to convert dates, a + {@link Lucene.Net.Documents.DateTools.Resolution} has to be set. +

    +

    + The date resolution that shall be used for RangeQueries can be set + using {@link #SetDateResolution(DateTools.Resolution)} + or {@link #SetDateResolution(String, DateTools.Resolution)}. The former + sets the default date resolution for all fields, whereas the latter can + be used to set field specific date resolutions. Field specific date + resolutions take, if set, precedence over the default date resolution. +

    +

    + If you use neither {@link DateField} nor {@link DateTools} in your + index, you can create your own + query parser that inherits QueryParser and overwrites + {@link #GetRangeQuery(String, String, String, boolean)} to + use a different method for date conversion. +

    + +

    Note that QueryParser is not thread-safe.

    + +

    NOTE: there is a new QueryParser in contrib, which matches + the same syntax as this class, but is more modular, + enabling substantial customization to how a query is created. + +

    NOTE: there is a new QueryParser in contrib, which matches + the same syntax as this class, but is more modular, + enabling substantial customization to how a query is created. + NOTE: You must specify the required {@link Version} compatibility when + creating QueryParser: +

      +
    • As of 2.9, {@link #SetEnablePositionIncrements} is true by default.
      • +
    +     +     + + Alternative form of QueryParser.Operator.AND + + + Alternative form of QueryParser.Operator.OR + + + The actual operator that parser uses to combine query terms + + + Constructs a query parser. + the default field for query terms. + + used to find terms in the query text. + + Use {@link #QueryParser(Version, String, Analyzer)} instead + + + + Constructs a query parser. + + + Lucene version to match. See above) + + the default field for query terms. + + used to find terms in the query text. + + + + Parses a query string, returning a {@link Lucene.Net.Search.Query}. + the query string to be parsed. + + ParseException if the parsing fails + + + Returns the analyzer. + + + + Returns the field. + + + + Get the minimal similarity for fuzzy queries. + + + Set the minimum similarity for fuzzy queries. + Default is 0.5f. + + + + Get the prefix length for fuzzy queries. + Returns the fuzzyPrefixLength. + + + + Set the prefix length for fuzzy queries. Default is 0. + The fuzzyPrefixLength to set. + + + + Sets the default slop for phrases. If zero, then exact phrase matches + are required. Default value is zero. + + + + Gets the default slop for phrases. + + + Set to true to allow leading wildcard characters. +

    + When set, * or ? are allowed as + the first character of a PrefixQuery and WildcardQuery. + Note that this can produce very slow + queries on big indexes. +

    + Default: false. +

    +     + + + + + + Set to true to enable position increments in result query. +

    + When set, result phrase and multi-phrase queries will + be aware of position increments. + Useful when e.g. a StopFilter increases the position increment of + the token that follows an omitted token. +

    + Default: false. +

    +     + + + + + + Sets the boolean operator of the QueryParser. + In default mode (OR_OPERATOR) terms without any modifiers + are considered optional: for example capital of Hungary is equal to + capital OR of OR Hungary.
    + In AND_OPERATOR mode terms are considered to be in conjunction: the + above mentioned query is parsed as capital AND of AND Hungary +     +     + + Gets implicit operator setting, which will be either AND_OPERATOR + or OR_OPERATOR. + + + + Whether terms of wildcard, prefix, fuzzy and range queries are to be automatically + lower-cased or not. Default is true. + + + + + + + + Please use {@link #setMultiTermRewriteMethod} instead. + + + + Please use {@link #getMultiTermRewriteMethod} instead. + + + + By default QueryParser uses {@link MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} + when creating a PrefixQuery, WildcardQuery or RangeQuery. This implementation is generally preferable because it + a) Runs faster b) Does not have the scarcity of terms unduly influence score + c) avoids any "TooManyBooleanClauses" exception. + However, if your application really needs to use the + old-fashioned BooleanQuery expansion rewriting and the above + points are not relevant then use this to change + the rewrite method. + + + + + + + + Set locale used by date range parsing. + + + Returns current locale, allowing access by subclasses. + + + Sets the default date resolution used by RangeQueries for fields for which no + specific date resolutions has been set. Field specific resolutions can be set + with {@link #SetDateResolution(String, DateTools.Resolution)}. + + + the default date resolution to set + + + + Sets the date resolution used by RangeQueries for a specific field. + + + field for which the date resolution is to be set + + date resolution to set + + + + Returns the date resolution that is used by RangeQueries for the given field. + Returns null, if no default or field specific date resolution has been set + for the given field. + + + + + Sets the collator used to determine index term inclusion in ranges + for RangeQuerys. +

    + WARNING: Setting the rangeCollator to a non-null + collator using this method will cause every single index Term in the + Field referenced by lowerTerm and/or upperTerm to be examined. + Depending on the number of index Terms in this Field, the operation could + be very slow. + +

    + the collator to use when constructing RangeQuerys + +     + + the collator used to determine index term inclusion in ranges + for RangeQuerys. + + + + use {@link #AddClause(List, int, int, Query)} instead. + + + + throw in overridden method to disallow + + + + Base implementation delegates to {@link #GetFieldQuery(String,String)}. + This method may be overridden, for example, to return + a SpanNearQuery instead of a PhraseQuery. + + + throw in overridden method to disallow + + + + throw in overridden method to disallow + + + + Builds a new BooleanQuery instance + disable coord + + new BooleanQuery instance + + + + Builds a new BooleanClause instance + sub query + + how this clause should occur when matching documents + + new BooleanClause instance + + + + Builds a new TermQuery instance + term + + new TermQuery instance + + + + Builds a new PhraseQuery instance + new PhraseQuery instance + + + + Builds a new MultiPhraseQuery instance + new MultiPhraseQuery instance + + + + Builds a new PrefixQuery instance + Prefix term + + new PrefixQuery instance + + + + Builds a new FuzzyQuery instance + Term + + minimum similarity + + prefix length + + new FuzzyQuery Instance + + + + Builds a new TermRangeQuery instance + Field + + min + + max + + true if range is inclusive + + new TermRangeQuery instance + + + + Builds a new MatchAllDocsQuery instance + new MatchAllDocsQuery instance + + + + Builds a new WildcardQuery instance + wildcard term + + new WildcardQuery instance + + + + Factory method for generating query, given a set of clauses. + By default creates a boolean query composed of clauses passed in. + + Can be overridden by extending classes, to modify query being + returned. + + + List that contains {@link BooleanClause} instances + to join. + + + Resulting {@link Query} object. + + throw in overridden method to disallow + + use {@link #GetBooleanQuery(List)} instead + + + + Factory method for generating query, given a set of clauses. + By default creates a boolean query composed of clauses passed in. + + Can be overridden by extending classes, to modify query being + returned. + + + List that contains {@link BooleanClause} instances + to join. + + + Resulting {@link Query} object. + + throw in overridden method to disallow + + + + Factory method for generating query, given a set of clauses. + By default creates a boolean query composed of clauses passed in. + + Can be overridden by extending classes, to modify query being + returned. + + + List that contains {@link BooleanClause} instances + to join. + + true if coord scoring should be disabled. + + + Resulting {@link Query} object. + + throw in overridden method to disallow + + use {@link #GetBooleanQuery(List, boolean)} instead + + + + Factory method for generating query, given a set of clauses. + By default creates a boolean query composed of clauses passed in. + + Can be overridden by extending classes, to modify query being + returned. + + + List that contains {@link BooleanClause} instances + to join. + + true if coord scoring should be disabled. + + + Resulting {@link Query} object. + + throw in overridden method to disallow + + + + Factory method for generating a query. Called when parser + parses an input term token that contains one or more wildcard + characters (? and *), but is not a prefix term token (one + that has just a single * character at the end) +

    + Depending on settings, prefix term may be lower-cased + automatically. It will not go through the default Analyzer, + however, since normal Analyzers are unlikely to work properly + with wildcard templates. +

    + Can be overridden by extending classes, to provide custom handling for + wildcard queries, which may be necessary due to missing analyzer calls. + +

    + Name of the field query will use. + + Term token that contains one or more wild card + characters (? or *), but is not simple prefix term + + + Resulting {@link Query} built for the term + + throw in overridden method to disallow + +     + + Factory method for generating a query (similar to + {@link #getWildcardQuery}). Called when parser parses an input term + token that uses prefix notation; that is, contains a single '*' wildcard + character as its last character. Since this is a special case + of generic wildcard term, and such a query can be optimized easily, + this usually results in a different query object. +

    + Depending on settings, a prefix term may be lower-cased + automatically. It will not go through the default Analyzer, + however, since normal Analyzers are unlikely to work properly + with wildcard templates. +

    + Can be overridden by extending classes, to provide custom handling for + wild card queries, which may be necessary due to missing analyzer calls. + +

    + Name of the field query will use. + + Term token to use for building term for the query + (without trailing '*' character!) + + + Resulting {@link Query} built for the term + + throw in overridden method to disallow + +     + + Factory method for generating a query (similar to + {@link #getWildcardQuery}). Called when parser parses + an input term token that has the fuzzy suffix (~) appended. + + + Name of the field query will use. + + Term token to use for building term for the query + + + Resulting {@link Query} built for the term + + throw in overridden method to disallow + + + + Returns a String where the escape char has been + removed, or kept only once if there was a double escape. + + Supports escaped unicode characters, e. g. translates + \\u0041 to A. + + + + + Returns the numeric value of the hexadecimal character + + + Returns a String where those characters that QueryParser + expects to be escaped are escaped by a preceding \. + + + + Command line tool to test QueryParser, using {@link Lucene.Net.Analysis.SimpleAnalyzer}. + Usage:
    + java Lucene.Net.QueryParsers.QueryParser <input> +     +     + + Generated Token Manager. + + + Current token. + + + Next token. + + + Constructor with user supplied CharStream. + + + Reinitialise. + + + Constructor with generated Token Manager. + + + Reinitialise. + + + Get the next Token. + + + Get the specific Token. + + + Generate ParseException. + + + Enable tracing. + + + Disable tracing. + + + The default operator for parsing queries. + Use {@link QueryParser#setDefaultOperator} to change it. + + + + Creates a MultiFieldQueryParser. Allows passing of a map with term to + Boost, and the boost to apply to each term. + +

    + It will, when parse(String query) is called, construct a query like this + (assuming the query consists of two terms and you specify the two fields + title and body): +

    + + + (title:term1 body:term1) (title:term2 body:term2) + + +

    + When setDefaultOperator(AND_OPERATOR) is set, the result will be: +

    + + + +(title:term1 body:term1) +(title:term2 body:term2) + + +

    + When you pass a boost (title=>5 body=>10) you can get +

    + + + +(title:term1^5.0 body:term1^10.0) +(title:term2^5.0 body:term2^10.0) + + +

    + In other words, all the query's terms must appear, but it doesn't matter + in what fields they appear. +

    + +

    + Please use + {@link #MultiFieldQueryParser(Version, String[], Analyzer, Map)} + instead + +     + + Creates a MultiFieldQueryParser. Allows passing of a map with term to + Boost, and the boost to apply to each term. + +

    + It will, when parse(String query) is called, construct a query like this + (assuming the query consists of two terms and you specify the two fields + title and body): +

    + + + (title:term1 body:term1) (title:term2 body:term2) + + +

    + When setDefaultOperator(AND_OPERATOR) is set, the result will be: +

    + + + +(title:term1 body:term1) +(title:term2 body:term2) + + +

    + When you pass a boost (title=>5 body=>10) you can get +

    + + + +(title:term1^5.0 body:term1^10.0) +(title:term2^5.0 body:term2^10.0) + + +

    + In other words, all the query's terms must appear, but it doesn't matter + in what fields they appear. +

    +

    +     + + Creates a MultiFieldQueryParser. + +

    + It will, when parse(String query) is called, construct a query like this + (assuming the query consists of two terms and you specify the two fields + title and body): +

    + + + (title:term1 body:term1) (title:term2 body:term2) + + +

    + When setDefaultOperator(AND_OPERATOR) is set, the result will be: +

    + + + +(title:term1 body:term1) +(title:term2 body:term2) + + +

    + In other words, all the query's terms must appear, but it doesn't matter + in what fields they appear. +

    + +

    + Please use + {@link #MultiFieldQueryParser(Version, String[], Analyzer)} + instead + +     + + Creates a MultiFieldQueryParser. + +

    + It will, when parse(String query) is called, construct a query like this + (assuming the query consists of two terms and you specify the two fields + title and body): +

    + + + (title:term1 body:term1) (title:term2 body:term2) + + +

    + When setDefaultOperator(AND_OPERATOR) is set, the result will be: +

    + + + +(title:term1 body:term1) +(title:term2 body:term2) + + +

    + In other words, all the query's terms must appear, but it doesn't matter + in what fields they appear. +

    +

    +     + + Parses a query which searches on the fields specified. +

    + If x fields are specified, this effectively constructs: + + 

    +            <code>
+            (field1:query1) (field2:query2) (field3:query3)...(fieldx:queryx)
+            </code>
+
    + +     + Queries strings to parse + + Fields to search on + + Analyzer to use + + ParseException + if query parsing fails + + IllegalArgumentException + if the length of the queries array differs from the length of + the fields array + + Use {@link #Parse(Version,String[],String[],Analyzer)} + instead + +     + + Parses a query which searches on the fields specified. +

    + If x fields are specified, this effectively constructs: + + 

    +            <code>
+            (field1:query1) (field2:query2) (field3:query3)...(fieldx:queryx)
+            </code>
+
    + +     + Lucene version to match; this is passed through to + QueryParser. + + Queries strings to parse + + Fields to search on + + Analyzer to use + + ParseException + if query parsing fails + + IllegalArgumentException + if the length of the queries array differs from the length of + the fields array + +     + + Parses a query, searching on the fields specified. + Use this if you need to specify certain fields as required, + and others as prohibited. + 

    +            Usage:
+            
+            String[] fields = {"filename", "contents", "description"};
+            BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+            BooleanClause.Occur.MUST,
+            BooleanClause.Occur.MUST_NOT};
+            MultiFieldQueryParser.parse("query", fields, flags, analyzer);
+            
+
    +

    + The code above would construct a query: + 

    +            
+            (filename:query) +(contents:query) -(description:query)
+            
+
    + +     + Query string to parse + + Fields to search on + + Flags describing the fields + + Analyzer to use + + ParseException if query parsing fails + IllegalArgumentException if the length of the fields array differs + from the length of the flags array + + Use + {@link #Parse(Version, String, String[], BooleanClause.Occur[], Analyzer)} + instead + +     + + Parses a query, searching on the fields specified. Use this if you need + to specify certain fields as required, and others as prohibited. +

    + + 

    +            Usage:
+            <code>
+            String[] fields = {"filename", "contents", "description"};
+            BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+            BooleanClause.Occur.MUST,
+            BooleanClause.Occur.MUST_NOT};
+            MultiFieldQueryParser.parse("query", fields, flags, analyzer);
+            </code>
+
    +

    + The code above would construct a query: + + 

    +            <code>
+            (filename:query) +(contents:query) -(description:query)
+            </code>
+
    + +     + Lucene version to match; this is passed through to + QueryParser. + + Query string to parse + + Fields to search on + + Flags describing the fields + + Analyzer to use + + ParseException + if query parsing fails + + IllegalArgumentException + if the length of the fields array differs from the length of + the flags array + +     + + Parses a query, searching on the fields specified. + Use this if you need to specify certain fields as required, + and others as prohibited. + 

    +            Usage:
+            
+            String[] query = {"query1", "query2", "query3"};
+            String[] fields = {"filename", "contents", "description"};
+            BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+            BooleanClause.Occur.MUST,
+            BooleanClause.Occur.MUST_NOT};
+            MultiFieldQueryParser.parse(query, fields, flags, analyzer);
+            
+
    +

    + The code above would construct a query: + 

    +            
+            (filename:query1) +(contents:query2) -(description:query3)
+            
+
    + +     + Queries string to parse + + Fields to search on + + Flags describing the fields + + Analyzer to use + + ParseException if query parsing fails + IllegalArgumentException if the length of the queries, fields, + and flags array differ + + Used + {@link #Parse(Version, String[], String[], BooleanClause.Occur[], Analyzer)} + instead + +     + + Parses a query, searching on the fields specified. Use this if you need + to specify certain fields as required, and others as prohibited. +

    + + 

    +            Usage:
+            <code>
+            String[] query = {"query1", "query2", "query3"};
+            String[] fields = {"filename", "contents", "description"};
+            BooleanClause.Occur[] flags = {BooleanClause.Occur.SHOULD,
+            BooleanClause.Occur.MUST,
+            BooleanClause.Occur.MUST_NOT};
+            MultiFieldQueryParser.parse(query, fields, flags, analyzer);
+            </code>
+
    +

    + The code above would construct a query: + + 

    +            <code>
+            (filename:query1) +(contents:query2) -(description:query3)
+            </code>
+
    + +     + Lucene version to match; this is passed through to + QueryParser. + + Queries string to parse + + Fields to search on + + Flags describing the fields + + Analyzer to use + + ParseException + if query parsing fails + + IllegalArgumentException + if the length of the queries, fields, and flags array differ + +     + +

    Expert: policy for deletion of stale {@link IndexCommit index commits}. + +

    Implement this interface, and pass it to one + of the {@link IndexWriter} or {@link IndexReader} + constructors, to customize when older + {@link IndexCommit point-in-time commits} + are deleted from the index directory. The default deletion policy + is {@link KeepOnlyLastCommitDeletionPolicy}, which always + removes old commits as soon as a new commit is done (this + matches the behavior before 2.2).

    + +

    One expected use case for this (and the reason why it + was first created) is to work around problems with an + index directory accessed via filesystems like NFS because + NFS does not provide the "delete on last close" semantics + that Lucene's "point in time" search normally relies on. + By implementing a custom deletion policy, such as "a + commit is only removed once it has been stale for more + than X minutes", you can give your readers time to + refresh to the new commit before {@link IndexWriter} + removes the old commits. Note that doing so will + increase the storage requirements of the index. See LUCENE-710 + for details.

    +

    +     + +

    This is called once when a writer is first + instantiated to give the policy a chance to remove old + commit points.

    + +

    The writer locates all index commits present in the + index directory and calls this method. The policy may + choose to delete some of the commit points, doing so by + calling method {@link IndexCommit#delete delete()} + of {@link IndexCommit}.

    + +

    Note: the last CommitPoint is the most recent one, + i.e. the "front index state". Be careful not to delete it, + unless you know for sure what you are doing, and unless + you can afford to lose the index content while doing that. + +

    + List of current + {@link IndexCommit point-in-time commits}, + sorted by age (the 0th one is the oldest commit). + +     + +

    This is called each time the writer completed a commit. + This gives the policy a chance to remove old commit points + with each commit.

    + +

    The policy may now choose to delete old commit points + by calling method {@link IndexCommit#delete delete()} + of {@link IndexCommit}.

    + +

    If writer has autoCommit = true then + this method will in general be called many times during + one instance of {@link IndexWriter}. If + autoCommit = false then this method is + only called once when {@link IndexWriter#close} is + called, or not at all if the {@link IndexWriter#abort} + is called. + +

    Note: the last CommitPoint is the most recent one, + i.e. the "front index state". Be careful not to delete it, + unless you know for sure what you are doing, and unless + you can afford to lose the index content while doing that. + +

    + List of {@link IndexCommit}, + sorted by age (the 0th one is the oldest commit). + +     + + Gathers all Fieldables for a document under the same + name, updates FieldInfos, and calls per-field consumers + to process field by field. + + Currently, only a single thread visits the fields, + sequentially, for processing. + + + + Process the document. If there is + something for this document to be done in docID order, + you should encapsulate that as a + DocumentsWriter.DocWriter and return it. + DocumentsWriter then calls finish() on this object + when it's its turn. + + + + If there are fields we've seen but did not see again + in the last run, then free them up. + + + + Consumer returns this on each doc. This holds any + state that must be flushed synchronized "in docID + order". We gather these and flush them in order. + + + + This class accepts multiple added documents and directly + writes a single segment file. It does this more + efficiently than creating a single segment per document + (with DocumentWriter) and doing standard merges on those + segments. + + Each added document is passed to the {@link DocConsumer}, + which in turn processes the document and interacts with + other consumers in the indexing chain. Certain + consumers, like {@link StoredFieldsWriter} and {@link + TermVectorsTermsWriter}, digest a document and + immediately write bytes to the "doc store" files (ie, + they do not consume RAM per document, except while they + are processing the document). + + Other consumers, eg {@link FreqProxTermsWriter} and + {@link NormsWriter}, buffer bytes in RAM and flush only + when a new segment is produced. + Once we have used our allowed RAM buffer, or the number + of added docs is large enough (in the case we are + flushing by doc count instead of RAM usage), we create a + real segment and flush it to the Directory. + + Threads: + + Multiple threads are allowed into addDocument at once. + There is an initial synchronized call to getThreadState + which allocates a ThreadState for this thread. The same + thread will get the same ThreadState over time (thread + affinity) so that if there are consistent patterns (for + example each thread is indexing a different content + source) then we make better use of RAM. Then + processDocument is called on that ThreadState without + synchronization (most of the "heavy lifting" is in this + call). Finally the synchronized "finishDocument" is + called to flush changes to the directory. + + When flush is called by IndexWriter, or, we flush + internally when autoCommit=false, we forcefully idle all + threads and flush only once they are all idle. This + means you can call flush with a given thread even while + other threads are actively adding/deleting documents. + + + Exceptions: + + Because this class directly updates in-memory posting + lists, and flushes stored fields and term vectors + directly to files in the directory, there are certain + limited times when an exception can corrupt this state. + For example, a disk full while flushing stored fields + leaves this file in a corrupt state. Or, an OOM + exception while appending to the in-memory posting lists + can corrupt that posting list. We call such exceptions + "aborting exceptions". In these cases we must call + abort() to discard all docs added since the last flush. + + All other exceptions ("non-aborting exceptions") can + still partially update the index structures. These + updates are consistent, but, they represent only a part + of the document seen up until the exception was hit. + When this happens, we immediately mark the document as + deleted so that the document is always atomically ("all + or none") added to the index. + + + + Returns true if any of the fields in the current + buffered docs have omitTermFreqAndPositions==false + + + + If non-null, various details of indexing are printed + here. + + + + Set how much RAM we can use before flushing. + + + Set max buffered docs, which means we will flush by + doc count instead of by RAM usage. + + + + Get current segment name we are writing. + + + Returns how many docs are currently buffered in RAM. + + + Returns the current doc store segment we are writing + to. This will be the same as segment when autoCommit + * is true. + + + + Returns the doc offset into the shared doc store for + the current buffered docs. + + + + Closes the current open doc stores an returns the doc + store segment name. This returns null if there are * + no buffered documents. + + + + Called if we hit an exception at a bad time (when + updating the index files) and must discard all + currently buffered docs. This resets our state, + discarding any docs added since last flush. + + + + Reset after a flush + + + Flush all pending docs to a new segment + + + Build compound file for the segment we just flushed + + + Set flushPending if it is not already set and returns + whether it was set. This is used by IndexWriter to + trigger a single flush even when multiple threads are + trying to do so. + + + + Returns a free (idle) ThreadState that may be used for + indexing this one document. This call also pauses if a + flush is pending. If delTerm is non-null then we + buffer this deleted term after the thread state has + been acquired. + + + + Returns true if the caller (IndexWriter) should now + flush. + + + + Called whenever a merge has completed and the merged segments had deletions + + + Does the synchronized work to finish/flush the + inverted document. + + + + The IndexingChain must define the {@link #GetChain(DocumentsWriter)} method + which returns the DocConsumer that the DocumentsWriter calls to process the + documents. + + + + Consumer returns this on each doc. This holds any + state that must be flushed synchronized "in docID + order". We gather these and flush them in order. + + + + + Base class for enumerating all but deleted docs. + +

    NOTE: this class is meant only to be used internally + by Lucene; it's only public so it can be shared across + packages. This means the API is freely subject to + change, and, the class could be removed entirely, in any + Lucene release. Use directly at your own risk! */ +

    +     + + A filter that replaces accented characters in the ISO Latin 1 character set + (ISO-8859-1) by their unaccented equivalent. The case will not be altered. +

    + For instance, 'À' will be replaced by 'a'. +

    + +

    + in favor of {@link ASCIIFoldingFilter} which covers a superset + of Latin 1. This class will be removed in Lucene 3.0. + +     + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + To replace accented characters in a String by unaccented equivalents. + Some useful constants. + - Doug Cutting - - $Id: Constants.java 189792 2005-06-09 18:58:30Z bmesser $ + $Id: Constants.java 828327 2009-10-22 06:47:40Z uschindler $ - + + The value of System.getProperty("java.version"). * + True iff this is Java version 1.1. @@ -6687,7 +14269,9 @@ True iff this is Java version 1.3. - + + The value of System.getProperty("os.name"). * + True iff running on Linux. @@ -6697,33 +14281,10531 @@ True iff running on SunOS. + + File-based {@link Directory} implementation that uses + mmap for reading, and {@link + SimpleFSDirectory.SimpleFSIndexOutput} for writing. + +

    NOTE: memory mapping uses up a portion of the + virtual memory address space in your process equal to the + size of the file being mapped. Before using this class, + be sure your have plenty of virtual address space, e.g. by + using a 64 bit JRE, or a 32 bit JRE with indexes that are + guaranteed to fit within the address space. + On 32 bit platforms also consult {@link #setMaxChunkSize} + if you have problems with mmap failing because of fragmented + address space. If you get an OutOfMemoryException, it is recommened + to reduce the chunk size, until it works. + +

    Due to + this bug in Sun's JRE, MMapDirectory's {@link IndexInput#close} + is unable to close the underlying OS file handle. Only when GC + finally collects the underlying objects, which could be quite + some time later, will the file handle be closed. + +

    This will consume additional transient disk usage: on Windows, + attempts to delete or overwrite the files will result in an + exception; on other platforms, which typically have a "delete on + last close" semantics, while such operations will succeed, the bytes + are still consuming space on disk. For many applications this + limitation is not a problem (e.g. if you have plenty of disk space, + and you don't rely on overwriting files on Windows) but it's still + an important limitation to be aware of. + +

    This class supplies the workaround mentioned in the bug report + (disabled by default, see {@link #setUseUnmap}), which may fail on + non-Sun JVMs. It forcefully unmaps the buffer on close by using + an undocumented internal cleanup functionality. + {@link #UNMAP_SUPPORTED} is true, if the workaround + can be enabled (with no guarantees). +

    +     + + Create a new MMapDirectory for the named location. + + + the path of the directory + + the lock factory to use, or null for the default. + + IOException + + + Create a new MMapDirectory for the named location. + + + the path of the directory + + the lock factory to use, or null for the default. + + IOException + + + Create a new MMapDirectory for the named location and the default lock factory. + + + the path of the directory + + IOException + + + Create a new MMapDirectory for the named location and the default lock factory. + + + the path of the directory + + IOException + + + + + + + true, if this platform supports unmapping mmaped files. + + + This method enables the workaround for unmapping the buffers + from address space after closing {@link IndexInput}, that is + mentioned in the bug report. This hack may fail on non-Sun JVMs. + It forcefully unmaps the buffer on close by using + an undocumented internal cleanup functionality. +

    NOTE: Enabling this is completely unsupported + by Java and may lead to JVM crashs if IndexInput + is closed while another thread is still accessing it (SIGSEGV). +

    + IllegalArgumentException if {@link #UNMAP_SUPPORTED} + is false and the workaround cannot be enabled. + +     + + Returns true, if the unmap workaround is enabled. + + + + + Try to unmap the buffer, this method silently fails if no support + for that in the JVM. On Windows, this leads to the fact, + that mmapped files cannot be modified or deleted. + + + + Sets the maximum chunk size (default is {@link Integer#MAX_VALUE} for + 64 bit JVMs and 256 MiBytes for 32 bit JVMs) used for memory mapping. + Especially on 32 bit platform, the address space can be very fragmented, + so large index files cannot be mapped. + Using a lower chunk size makes the directory implementation a little + bit slower (as the correct chunk must be resolved on each seek) + but the chance is higher that mmap does not fail. On 64 bit + Java platforms, this parameter should always be {@link Integer#MAX_VALUE}, + as the adress space is big enough. + + + + Returns the current mmap chunk size. + + + + + Creates an IndexInput for the file with the given name. + + + Creates an IndexOutput for the file with the given name. + + +

    + The TimeLimitedCollector is used to timeout search requests that take longer + than the maximum allowed search time limit. After this time is exceeded, the + search thread is stopped by throwing a TimeExceeded Exception. +

    + +

    + Use {@link TimeLimitingCollector} instead, which extends the new + {@link Collector}. This class will be removed in 3.0. + +     + + Lower-level search API.
    + HitCollectors are primarily meant to be used to implement queries, sorting + and filtering. See {@link Collector} for a lower level and higher performance + (on a multi-segment index) API. + +     + + + $Id: HitCollector.java 764551 2009-04-13 18:33:56Z mikemccand $ + + Please use {@link Collector} instead. + +     + + Called once for every document matching a query, with the document + number and its raw score. + +

    If, for example, an application wished to collect all of the hits for a + query in a BitSet, then it might:

    +            Searcher searcher = new IndexSearcher(indexReader);
+            final BitSet bits = new BitSet(indexReader.maxDoc());
+            searcher.search(query, new HitCollector() {
+            public void collect(int doc, float score) {
+            bits.set(doc);
+            }
+            });
+
    + +

    Note: This is called in an inner search loop. For good search + performance, implementations of this method should not call + {@link Searcher#Doc(int)} or + {@link Lucene.Net.Index.IndexReader#Document(int)} on every + document number encountered. Doing so can slow searches by an order + of magnitude or more. +

    Note: The score passed to this method is a raw score. + In other words, the score will not necessarily be a float whose value is + between 0 and 1. +

    +     + + Default timer resolution. + + + + + Default for {@link #IsGreedy()}. + + + + + Create a TimeLimitedCollector wrapper over another HitCollector with a specified timeout. + the wrapped HitCollector + + max time allowed for collecting hits after which {@link TimeExceededException} is thrown + + + + Calls collect() on the decorated HitCollector. + + + TimeExceededException if the time allowed has been exceeded. + + + Return the timer resolution. + + + + + Set the timer resolution. + The default timer resolution is 20 milliseconds. + This means that a search required to take no longer than + 800 milliseconds may be stopped after 780 to 820 milliseconds. +
    Note that: +
      +
    • Finer (smaller) resolution is more accurate but less efficient.
      • +
    • Setting resolution to less than 5 milliseconds will be silently modified to 5 milliseconds.
      • +
    • Setting resolution smaller than current resolution might take effect only after current + resolution. (Assume current resolution of 20 milliseconds is modified to 5 milliseconds, + then it can take up to 20 milliseconds for the change to have effect.
      • +
    +     +     + + Checks if this time limited collector is greedy in collecting the last hit. + A non greedy collector, upon a timeout, would throw a {@link TimeExceededException} + without allowing the wrapped collector to collect current doc. A greedy one would + first allow the wrapped hit collector to collect current doc and only then + throw a {@link TimeExceededException}. + + + + + + Sets whether this time limited collector is greedy. + true to make this time limited greedy + + + + + + TimerThread provides a pseudo-clock service to all searching + threads, so that they can count elapsed time with less overhead + than repeatedly calling System.currentTimeMillis. A single + thread should be created to be used for all searches. + + + + Get the timer value in milliseconds. + + + Thrown when elapsed search time exceeds allowed search time. + + + Returns allowed time (milliseconds). + + + Returns elapsed time (milliseconds). + + + Returns last doc that was collected when the search time exceeded. + + +

    Wrapper to allow {@link SpanQuery} objects participate in composite + single-field SpanQueries by 'lying' about their search field. That is, + the masked SpanQuery will function as normal, + but {@link SpanQuery#GetField()} simply hands back the value supplied + in this class's constructor.

    + +

    This can be used to support Queries like {@link SpanNearQuery} or + {@link SpanOrQuery} across different fields, which is not ordinarily + permitted.

    + +

    This can be useful for denormalized relational data: for example, when + indexing a document with conceptually many 'children':

    + + 

    +            teacherid: 1
+            studentfirstname: james
+            studentsurname: jones
+            
+            teacherid: 2
+            studenfirstname: james
+            studentsurname: smith
+            studentfirstname: sally
+            studentsurname: jones
+
    + +

    a SpanNearQuery with a slop of 0 can be applied across two + {@link SpanTermQuery} objects as follows: + 

    +            SpanQuery q1  = new SpanTermQuery(new Term("studentfirstname", "james"));
+            SpanQuery q2  = new SpanTermQuery(new Term("studentsurname", "jones"));
+            SpanQuery q2m new FieldMaskingSpanQuery(q2, "studentfirstname");
+            Query q = new SpanNearQuery(new SpanQuery[]{q1, q2m}, -1, false);
+
    + to search for 'studentfirstname:james studentsurname:jones' and find + teacherid 1 without matching teacherid 2 (which has a 'james' in position 0 + and 'jones' in position 1).

    + +

    Note: as {@link #GetField()} returns the masked field, scoring will be + done using the norms of the field name supplied. This may lead to unexpected + scoring behaviour.

    +

    +     + + use {@link #ExtractTerms(Set)} instead. + + + + Creates a new instance with size elements. If + prePopulate is set to true, the queue will pre-populate itself + with sentinel objects and set its {@link #Size()} to size. In + that case, you should not rely on {@link #Size()} to get the number of + actual elements that were added to the queue, but keep track yourself.
    + NOTE: in case prePopulate is true, you should pop + elements from the queue using the following code example: + + 
    +            PriorityQueue pq = new HitQueue(10, true); // pre-populate.
+            ScoreDoc top = pq.top();
+            
+            // Add/Update one element.
+            top.score = 1.0f;
+            top.doc = 0;
+            top = (ScoreDoc) pq.updateTop();
+            int totalHits = 1;
+            
+            // Now pop only the elements that were *truly* inserted.
+            // First, pop all the sentinel elements (there are pq.size() - totalHits).
+            for (int i = pq.size() - totalHits; i > 0; i--) pq.pop();
+            
+            // Now pop the truly added elements.
+            ScoreDoc[] results = new ScoreDoc[totalHits];
+            for (int i = totalHits - 1; i >= 0; i--) {
+            results[i] = (ScoreDoc) pq.pop();
+            }
+
    + +

    NOTE: This class pre-allocate a full array of + length size. + +

    + the requested size of this queue. + + specifies whether to pre-populate the queue with sentinel values. + + + +     + + Interface that exceptions should implement to support lazy loading of messages. + + For Native Language Support (NLS), system of software internationalization. + + This Interface should be implemented by all exceptions that require + translation + + + + + a instance of a class that implements the Message interface + + + + A {@link IndexDeletionPolicy} that wraps around any other + {@link IndexDeletionPolicy} and adds the ability to hold and + later release a single "snapshot" of an index. While + the snapshot is held, the {@link IndexWriter} will not + remove any files associated with it even if the index is + otherwise being actively, arbitrarily changed. Because + we wrap another arbitrary {@link IndexDeletionPolicy}, this + gives you the freedom to continue using whatever {@link + IndexDeletionPolicy} you would normally want to use with your + index. Note that you can re-use a single instance of + SnapshotDeletionPolicy across multiple writers as long + as they are against the same index Directory. Any + snapshot held when a writer is closed will "survive" + when the next writer is opened. + +

    WARNING: This API is a new and experimental and + may suddenly change.

    +

    +     + + Take a snapshot of the most recent commit to the + index. You must call release() to free this snapshot. + Note that while the snapshot is held, the files it + references will not be deleted, which will consume + additional disk space in your index. If you take a + snapshot at a particularly bad time (say just before + you call optimize()) then in the worst case this could + consume an extra 1X of your total index size, until + you release the snapshot. + + + + Release the currently held snapshot. + + + A Payload is metadata that can be stored together with each occurrence + of a term. This metadata is stored inline in the posting list of the + specific term. +

    + To store payloads in the index a {@link TokenStream} has to be used that + produces payload data. +

    + Use {@link TermPositions#GetPayloadLength()} and {@link TermPositions#GetPayload(byte[], int)} + to retrieve the payloads from the index.
    + +

    +     + + the byte array containing the payload data + + + the offset within the byte array + + + the length of the payload data + + + Creates an empty payload and does not allocate a byte array. + + + Creates a new payload with the the given array as data. + A reference to the passed-in array is held, i. e. no + copy is made. + + + the data of this payload + + + + Creates a new payload with the the given array as data. + A reference to the passed-in array is held, i. e. no + copy is made. + + + the data of this payload + + the offset in the data byte array + + the length of the data + + + + Sets this payloads data. + A reference to the passed-in array is held, i. e. no + copy is made. + + + + Sets this payloads data. + A reference to the passed-in array is held, i. e. no + copy is made. + + + + Returns a reference to the underlying byte array + that holds this payloads data. + + + + Returns the offset in the underlying byte array + + + Returns the length of the payload data. + + + Returns the byte at the given index. + + + Allocates a new byte array, copies the payload data into it and returns it. + + + Copies the payload data to a byte array. + + + the target byte array + + the offset in the target byte array + + + + Clones this payload by creating a copy of the underlying + byte array. + + + + Add a new position & payload. If payloadLength > 0 + you must read those bytes from the IndexInput. + + + + Called when we are done adding positions & payloads + + + Add a new position & payload + + + Called when we are done adding positions & payloads + + + This class tracks the number and position / offset parameters of terms + being added to the index. The information collected in this class is + also used to calculate the normalization factor for a field. + +

    WARNING: This API is new and experimental, and may suddenly + change.

    +

    +     + + Re-initialize the state, using this boost value. + boost value to use. + + + + Get the last processed term position. + the position + + + + Get total number of terms in this field. + the length + + + + Get the number of terms with positionIncrement == 0. + the numOverlap + + + + Get end offset of the last processed term. + the offset + + + + Get boost value. This is the cumulative product of + document boost and field boost for all field instances + sharing the same field name. + + the boost + + + + Provides support for converting longs to Strings, and back again. The strings + are structured so that lexicographic sorting order is preserved. + +

    + That is, if l1 is less than l2 for any two longs l1 and l2, then + NumberTools.longToString(l1) is lexicographically less than + NumberTools.longToString(l2). (Similarly for "greater than" and "equals".) + +

    + This class handles all long values (unlike + {@link Lucene.Net.Documents.DateField}). + +

    + For new indexes use {@link NumericUtils} instead, which + provides a sortable binary representation (prefix encoded) of numeric + values. + To index and efficiently query numeric values use {@link NumericField} + and {@link NumericRangeQuery}. + This class is included for use with existing + indices and will be removed in a future release. + +     + + Equivalent to longToString(Long.MIN_VALUE) + + + Equivalent to longToString(Long.MAX_VALUE) + + + The length of (all) strings returned by {@link #longToString} + + + Converts a long to a String suitable for indexing. + + + Converts a String that was returned by {@link #longToString} back to a + long. + + + IllegalArgumentException + if the input is null + + NumberFormatException + if the input does not parse (it was not a String returned by + longToString()). + + + + This attribute can be used to pass different flags down the tokenizer chain, + eg from one TokenFilter to another one. + + + + EXPERIMENTAL: While we think this is here to stay, we may want to change it to be a long. +

    + + Get the bitset for any bits that have been set. This is completely distinct from {@link TypeAttribute#Type()}, although they do share similar purposes. + The flags can be used to encode information about the token for use by other {@link Lucene.Net.Analysis.TokenFilter}s. + + +

    + The bits + +     + + + + + + This TokenFilter provides the ability to set aside attribute states + that have already been analyzed. This is useful in situations where multiple fields share + many common analysis steps and then go their separate ways. +

    + It is also useful for doing things like entity extraction or proper noun analysis as + part of the analysis workflow and saving off those tokens for use in another field. + + 

    +            TeeSinkTokenFilter source1 = new TeeSinkTokenFilter(new WhitespaceTokenizer(reader1));
+            TeeSinkTokenFilter.SinkTokenStream sink1 = source1.newSinkTokenStream();
+            TeeSinkTokenFilter.SinkTokenStream sink2 = source1.newSinkTokenStream();
+            TeeSinkTokenFilter source2 = new TeeSinkTokenFilter(new WhitespaceTokenizer(reader2));
+            source2.addSinkTokenStream(sink1);
+            source2.addSinkTokenStream(sink2);
+            TokenStream final1 = new LowerCaseFilter(source1);
+            TokenStream final2 = source2;
+            TokenStream final3 = new EntityDetect(sink1);
+            TokenStream final4 = new URLDetect(sink2);
+            d.add(new Field("f1", final1));
+            d.add(new Field("f2", final2));
+            d.add(new Field("f3", final3));
+            d.add(new Field("f4", final4));
+
    + In this example, sink1 and sink2 will both get tokens from both + reader1 and reader2 after whitespace tokenizer + and now we can further wrap any of these in extra analysis, and more "sources" can be inserted if desired. + It is important, that tees are consumed before sinks (in the above example, the field names must be + less the sink's field names). If you are not sure, which stream is consumed first, you can simply + add another sink and then pass all tokens to the sinks at once using {@link #consumeAllTokens}. + This TokenFilter is exhausted after this. In the above example, change + the example above to: + 
    +            ...
+            TokenStream final1 = new LowerCaseFilter(source1.newSinkTokenStream());
+            TokenStream final2 = source2.newSinkTokenStream();
+            sink1.consumeAllTokens();
+            sink2.consumeAllTokens();
+            ...
+
    + In this case, the fields can be added in any order, because the sources are not used anymore and all sinks are ready. +

    Note, the EntityDetect and URLDetect TokenStreams are for the example and do not currently exist in Lucene. +

    +     + + Instantiates a new TeeSinkTokenFilter. + + + Returns a new {@link SinkTokenStream} that receives all tokens consumed by this stream. + + + Returns a new {@link SinkTokenStream} that receives all tokens consumed by this stream + that pass the supplied filter. + + + + + + Adds a {@link SinkTokenStream} created by another TeeSinkTokenFilter + to this one. The supplied stream will also receive all consumed tokens. + This method can be used to pass tokens from two different tees to one sink. + + + + TeeSinkTokenFilter passes all tokens to the added sinks + when itself is consumed. To be sure, that all tokens from the input + stream are passed to the sinks, you can call this methods. + This instance is exhausted after this, but all sinks are instant available. + + + + A filter that decides which {@link AttributeSource} states to store in the sink. + + + Returns true, iff the current state of the passed-in {@link AttributeSource} shall be stored + in the sink. + + + + Called by {@link SinkTokenStream#Reset()}. This method does nothing by default + and can optionally be overridden. + + + + A grammar-based tokenizer constructed with JFlex + +

    This should be a good tokenizer for most European-language documents: + +

      +
    • Splits words at punctuation characters, removing punctuation. However, a + dot that's not followed by whitespace is considered part of a token.
      • +
    • Splits words at hyphens, unless there's a number in the token, in which case + the whole token is interpreted as a product number and is not split.
      • +
    • Recognizes email addresses and internet hostnames as one token.
      • +
    + +

    Many applications have specific tokenizer needs. If this tokenizer does + not suit your application, please consider copying this source code + directory to your project and maintaining your own grammar-based tokenizer. + + +

    + You must specify the required {@link Version} compatibility when creating + StandardAnalyzer: +

    +     +     + + this solves a bug where HOSTs that end with '.' are identified + as ACRONYMs. It is deprecated and will be removed in the next + release. + + + + A private instance of the JFlex-constructed scanner + + + String token types that correspond to token type int constants + + + Please use {@link #TOKEN_TYPES} instead + + + + Specifies whether deprecated acronyms should be replaced with HOST type. + This is false by default to support backward compatibility. +

    + See http://issues.apache.org/jira/browse/LUCENE-1068 + +

    + this should be removed in the next release (3.0). + +     + + Set the max allowed token length. Any token longer + than this is skipped. + + + + + + + + Creates a new instance of the {@link StandardTokenizer}. Attaches the + input to a newly created JFlex scanner. + + Use {@link #StandardTokenizer(Version, Reader)} instead + + + + Creates a new instance of the {@link Lucene.Net.Analysis.Standard.StandardTokenizer}. Attaches + the input to the newly created JFlex scanner. + + + The input reader + + Set to true to replace mischaracterized acronyms with HOST. + + See http://issues.apache.org/jira/browse/LUCENE-1068 + + Use {@link #StandardTokenizer(Version, Reader)} instead + + + + Creates a new instance of the + {@link org.apache.lucene.analysis.standard.StandardTokenizer}. Attaches + the input to the newly created JFlex scanner. + + + The input reader + + See http://issues.apache.org/jira/browse/LUCENE-1068 + + + + Creates a new StandardTokenizer with a given {@link AttributeSource}. + Use + {@link #StandardTokenizer(Version, AttributeSource, Reader)} + instead + + + + Creates a new StandardTokenizer with a given {@link AttributeSource}. + + + Creates a new StandardTokenizer with a given {@link Lucene.Net.Util.AttributeSource.AttributeFactory} + Use + {@link #StandardTokenizer(Version, org.apache.lucene.util.AttributeSource.AttributeFactory, Reader)} + instead + + + + Creates a new StandardTokenizer with a given + {@link org.apache.lucene.util.AttributeSource.AttributeFactory} + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Prior to https://issues.apache.org/jira/browse/LUCENE-1068, StandardTokenizer mischaracterized as acronyms tokens like www.abc.com + when they should have been labeled as hosts instead. + + true if StandardTokenizer now returns these tokens as Hosts, otherwise false + + + Remove in 3.X and make true the only valid value + + + + + Set to true to replace mischaracterized acronyms as HOST. + + Remove in 3.X and make true the only valid value + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + + Helper methods to ease implementing {@link Object#toString()}. + + + for printing boost only if not 1.0 + + + Simple cache implementation that uses a HashMap to store (key, value) pairs. + This cache is not synchronized, use {@link Cache#SynchronizedCache(Cache)} + if needed. + + + + Returns a Set containing all keys in this cache. + + + Helper class for keeping Listss of Objects associated with keys. WARNING: THIS CLASS IS NOT THREAD SAFE + + + the backing store for this object + + + + direct access to the map backing this object. + + + + Adds val to the Set associated with key in the Map. If key is not + already in the map, a new Set will first be created. + + the size of the Set associated with key once val is added to it. + + + + Adds multiple vals to the Set associated with key in the Map. + If key is not + already in the map, a new Set will first be created. + + the size of the Set associated with key once val is added to it. + + + + A memory-resident {@link Directory} implementation. Locking + implementation is by default the {@link SingleInstanceLockFactory} + but can be changed with {@link #setLockFactory}. + + + $Id: RAMDirectory.java 781333 2009-06-03 10:38:57Z mikemccand $ + + + + Constructs an empty {@link Directory}. + + + Creates a new RAMDirectory instance from a different + Directory implementation. This can be used to load + a disk-based index into memory. +

    + This should be used only with indices that can fit into memory. +

    + Note that the resulting RAMDirectory instance is fully + independent from the original Directory (it is a + complete copy). Any subsequent changes to the + original Directory will not be visible in the + RAMDirectory instance. + +

    + a Directory value + + if an error occurs + +     + + Creates a new RAMDirectory instance from the {@link FSDirectory}. + + + a File specifying the index directory + + + + + Use {@link #RAMDirectory(Directory)} instead + + + + Creates a new RAMDirectory instance from the {@link FSDirectory}. + + + a String specifying the full index directory path + + + + + Use {@link #RAMDirectory(Directory)} instead + + + + Returns true iff the named file exists in this directory. + + + Returns the time the named file was last modified. + IOException if the file does not exist + + + Set the modified time of an existing file to now. + IOException if the file does not exist + + + Returns the length in bytes of a file in the directory. + IOException if the file does not exist + + + Return total size in bytes of all files in this + directory. This is currently quantized to + RAMOutputStream.BUFFER_SIZE. + + + + Removes an existing file in the directory. + IOException if the file does not exist + + + Renames an existing file in the directory. + FileNotFoundException if from does not exist + + + + + Creates a new, empty file in the directory with the given name. Returns a stream writing this file. + + + Returns a stream reading an existing file. + + + Closes the store to future operations, releasing associated memory. + + +

    Implements {@link LockFactory} using native OS file + locks. Note that because this LockFactory relies on + java.nio.* APIs for locking, any problems with those APIs + will cause locking to fail. Specifically, on certain NFS + environments the java.nio.* locks will fail (the lock can + incorrectly be double acquired) whereas {@link + SimpleFSLockFactory} worked perfectly in those same + environments. For NFS based access to an index, it's + recommended that you try {@link SimpleFSLockFactory} + first and work around the one limitation that a lock file + could be left when the JVM exits abnormally.

    + +

    The primary benefit of {@link NativeFSLockFactory} is + that lock files will be properly removed (by the OS) if + the JVM has an abnormal exit.

    + +

    Note that, unlike {@link SimpleFSLockFactory}, the existence of + leftover lock files in the filesystem on exiting the JVM + is fine because the OS will free the locks held against + these files even though the files still remain.

    + +

    If you suspect that this or any other LockFactory is + not working properly in your environment, you can easily + test it by using {@link VerifyingLockFactory}, {@link + LockVerifyServer} and {@link LockStressTest}.

    + +

    + + +     + + Create a NativeFSLockFactory instance, with null (unset) + lock directory. When you pass this factory to a {@link FSDirectory} + subclass, the lock directory is automatically set to the + directory itsself. Be sure to create one instance for each directory + your create! + + + + Create a NativeFSLockFactory instance, storing lock + files into the specified lockDirName: + + + where lock files are created. + + + + Create a NativeFSLockFactory instance, storing lock + files into the specified lockDir: + + + where lock files are created. + + + + Create a NativeFSLockFactory instance, storing lock + files into the specified lockDir: + + + where lock files are created. + + + + Writes bytes through to a primary IndexOutput, computing + checksum as it goes. Note that you cannot use seek(). + + + + Similar to {@link NearSpansOrdered}, but for the unordered case. + + Expert: + Only public for subclassing. Most implementations should not need this class + + + + Expert: an enumeration of span matches. Used to implement span searching. + Each span represents a range of term positions within a document. Matches + are enumerated in order, by increasing document number, within that by + increasing start position and finally by increasing end position. + + + + Move to the next match, returning true iff any such exists. + + + Skips to the first match beyond the current, whose document number is + greater than or equal to target.

    Returns true iff there is such + a match.

    Behaves as if written: 

    +            boolean skipTo(int target) {
+            do {
+            if (!next())
+            return false;
+            } while (target > doc());
+            return true;
+            }
+
    + Most implementations are considerably more efficient than that. +     +     + + Returns the document number of the current match. Initially invalid. + + + Returns the start position of the current match. Initially invalid. + + + Returns the end position of the current match. Initially invalid. + + + Returns the payload data for the current span. + This is invalid until {@link #Next()} is called for + the first time. + This method must not be called more than once after each call + of {@link #Next()}. However, most payloads are loaded lazily, + so if the payload data for the current position is not needed, + this method may not be called at all for performance reasons. An ordered + SpanQuery does not lazy load, so if you have payloads in your index and + you do not want ordered SpanNearQuerys to collect payloads, you can + disable collection with a constructor option.
    + + Note that the return type is a collection, thus the ordering should not be relied upon. +
    +

    + WARNING: The status of the Payloads feature is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case.

    + +

    + a List of byte arrays containing the data of this payload, otherwise null if isPayloadAvailable is false + + java.io.IOException +     + + Checks if a payload can be loaded at this position. +

    + Payloads can only be loaded once per call to + {@link #Next()}. + +

    + true if there is a payload available at this position that can be loaded + +     + + WARNING: The List is not necessarily in order of the the positions + Collection of byte[] payloads + + IOException + + + Wraps a Spans, and can be used to form a linked list. + + + A {@link Filter} that only accepts numeric values within + a specified range. To use this, you must first index the + numeric values using {@link NumericField} (expert: {@link + NumericTokenStream}). + +

    You create a new NumericRangeFilter with the static + factory methods, eg: + + 

    +            Filter f = NumericRangeFilter.newFloatRange("weight",
+            new Float(0.3f), new Float(0.10f),
+            true, true);
+
    + + accepts all documents whose float valued "weight" field + ranges from 0.3 to 0.10, inclusive. + See {@link NumericRangeQuery} for details on how Lucene + indexes and searches numeric valued fields. + +

    NOTE: This API is experimental and + might change in incompatible ways in the next + release. + +

    + 2.9 + + +     + + Factory that creates a NumericRangeFilter, that filters a long + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that queries a long + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that filters a int + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that queries a int + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that filters a double + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that queries a double + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that filters a float + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeFilter, that queries a float + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Returns the field name for this filter + + + Returns true if the lower endpoint is inclusive + + + Returns true if the upper endpoint is inclusive + + + Returns the lower value of this range filter + + + Returns the upper value of this range filter + + + Abstract decorator class of a DocIdSetIterator + implementation that provides on-demand filter/validation + mechanism on an underlying DocIdSetIterator. See {@link + FilteredDocIdSet}. + + + + Constructor. + Underlying DocIdSetIterator. + + + + Validation method to determine whether a docid should be in the result set. + docid to be tested + + true if input docid should be in the result set, false otherwise. + + + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + Expert: A ScoreDoc which also contains information about + how to sort the referenced document. In addition to the + document number and score, this object contains an array + of values for the document from the field(s) used to sort. + For example, if the sort criteria was to sort by fields + "a", "b" then "c", the fields object array + will have three elements, corresponding respectively to + the term values for the document in fields "a", "b" and "c". + The class of each element in the array will be either + Integer, Float or String depending on the type of values + in the terms of each field. + +

    Created: Feb 11, 2004 1:23:38 PM + +

    + lucene 1.4 + + $Id: FieldDoc.java 773194 2009-05-09 10:36:41Z mikemccand $ + + + + + +     + + Expert: Returned by low-level search implementations. + + + + + Expert: The score of this document for the query. + + + Expert: A hit document's number. + + + + + Expert: Constructs a ScoreDoc. + + + Expert: The values which are used to sort the referenced document. + The order of these will match the original sort criteria given by a + Sort object. Each Object will be either an Integer, Float or String, + depending on the type of values in the terms of the original field. + + + + + + + + Expert: Creates one of these objects with empty sort information. + + + Expert: Creates one of these objects with the given sort information. + + + Message Interface for a lazy loading. + For Native Language Support (NLS), system of software internationalization. + + + + A {@link MergeScheduler} that simply does each merge + sequentially, using the current thread. + + + +

    Expert: {@link IndexWriter} uses an instance + implementing this interface to execute the merges + selected by a {@link MergePolicy}. The default + MergeScheduler is {@link ConcurrentMergeScheduler}.

    + +

    NOTE: This API is new and still experimental + (subject to change suddenly in the next release)

    + +

    NOTE: This class typically requires access to + package-private APIs (eg, SegmentInfos) to do its job; + if you implement your own MergePolicy, you'll need to put + it in package Lucene.Net.Index in order to use + these APIs. +

    +     + + Run the merges provided by {@link IndexWriter#GetNextMerge()}. + + + Close this MergeScheduler. + + + Just do the merges in sequence. We do this + "synchronized" so that even if the application is using + multiple threads, only one merge may run at a time. + + + + Used by DocumentsWriter to implemented a StringReader + that can be reset to a new string; we use this when + tokenizing the string value from a Field. + + + + $Id + +

    NOTE: This API is new and still experimental + (subject to change suddenly in the next release)

    +

    +     + + The class which implements SegmentReader. + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Clones the norm bytes. May be overridden by subclasses. New and experimental. + Byte array to clone + + New BitVector + + + + Clones the deleteDocs BitVector. May be overridden by subclasses. New and experimental. + BitVector to clone + + New BitVector + + + + + + + + + + + + Read norms into a pre-allocated array. + + + Create a clone from the initial TermVectorsReader and store it in the ThreadLocal. + TermVectorsReader + + + + Return a term frequency vector for the specified document and field. The + vector returned contains term numbers and frequencies for all terms in + the specified field of this document, if the field had storeTermVector + flag set. If the flag was not set, the method returns null. + + IOException + + + Return an array of term frequency vectors for the specified document. + The array contains a vector for each vectorized field in the document. + Each vector vector contains term numbers and frequencies for all terms + in a given vectorized field. + If no such fields existed, the method returns null. + + IOException + + + Return the name of the segment this reader is reading. + + + Return the SegmentInfo of the segment this reader is reading. + + + Returns the directory this index resides in. + + + Lotsa tests did hacks like:
    + SegmentReader reader = (SegmentReader) IndexReader.open(dir);
    + They broke. This method serves as a hack to keep hacks working +     +     + + Sets the initial value + + + Byte[] referencing is used because a new norm object needs + to be created for each clone, and the byte array is all + that is needed for sharing between cloned readers. The + current norm referencing is for sharing between readers + whereas the byte[] referencing is for copy on write which + is independent of reader references (i.e. incRef, decRef). + + + + Abstract API that consumes terms, doc, freq, prox and + payloads postings. Concrete implementations of this + actually do "something" with the postings (write it into + the index in a specific format). + + NOTE: this API is experimental and will likely change + + + + Add a new field + + + Called when we are done adding everything. + + + Add a new field + + + Called when we are done adding everything. + + + Bulk write a contiguous series of documents. The + lengths array is the length (in bytes) of each raw + document. The stream IndexInput is the + fieldsStream from which we should bulk-copy all + bytes. + + + + Class responsible for access to stored document fields. +

    + It uses <segment>.fdt and <segment>.fdx; files. + +

    + $Id: FieldsReader.java 801344 2009-08-05 18:05:06Z yonik $ + +     + + Returns a cloned FieldsReader that shares open + IndexInputs with the original one. It is the caller's + job not to close the original FieldsReader until all + clones are called (eg, currently SegmentReader manages + this logic). + + + + AlreadyClosedException if this FieldsReader is closed + + + Closes the underlying {@link Lucene.Net.Store.IndexInput} streams, including any ones associated with a + lazy implementation of a Field. This means that the Fields values will not be accessible. + + + IOException + + + Returns the length in bytes of each raw document in a + contiguous range of length numDocs starting with + startDocID. Returns the IndexInput (the fieldStream), + already seeked to the starting point for startDocID. + + + + Skip the field. We still have to read some of the information about the field, but can skip past the actual content. + This will have the most payoff on large fields. + + + + A Lazy implementation of Fieldable that differs loading of fields until asked for, instead of when the Document is + loaded. + + + + + + + + + + Sets the boost factor hits on this field. This value will be + multiplied into the score of all hits on this this field of this + document. + +

    The boost is multiplied by {@link Lucene.Net.Documents.Document#GetBoost()} of the document + containing this field. If a document has multiple fields with the same + name, all such values are multiplied together. This product is then + used to compute the norm factor for the field. By + default, in the {@link + Lucene.Net.Search.Similarity#ComputeNorm(String, + FieldInvertState)} method, the boost value is multipled + by the {@link + Lucene.Net.Search.Similarity#LengthNorm(String, + int)} and then + rounded by {@link Lucene.Net.Search.Similarity#EncodeNorm(float)} before it is stored in the + index. One should attempt to ensure that this product does not overflow + the range of that encoding. + +

    + + + + + + +     + + Returns the boost factor for hits for this field. + +

    The default value is 1.0. + +

    Note: this value is not stored directly with the document in the index. + Documents returned from {@link Lucene.Net.Index.IndexReader#Document(int)} and + {@link Lucene.Net.Search.Hits#Doc(int)} may thus not have the same value present as when + this field was indexed. + +

    + + +     + + Returns the name of the field as an interned string. + For example "date", "title", "body", ... + + + + True iff the value of the field is to be stored in the index for return + with search hits. It is an error for this to be true if a field is + Reader-valued. + + + + True iff the value of the field is to be indexed, so that it may be + searched on. + + + + True iff the value of the field should be tokenized as text prior to + indexing. Un-tokenized fields are indexed as a single word and may not be + Reader-valued. + + + + True if the value of the field is stored and compressed within the index + + + True iff the term or terms used to index this field are stored as a term + vector, available from {@link Lucene.Net.Index.IndexReader#GetTermFreqVector(int,String)}. + These methods do not provide access to the original content of the field, + only to terms used to index it. If the original content must be + preserved, use the stored attribute instead. + + + + + + + True iff terms are stored as term vector together with their offsets + (start and end position in source text). + + + + True iff terms are stored as term vector together with their token positions. + + + True iff the value of the filed is stored as binary + + + Return the raw byte[] for the binary field. Note that + you must also call {@link #getBinaryLength} and {@link + #getBinaryOffset} to know which range of bytes in this + returned array belong to the field. + + reference to the Field value as byte[]. + + + + Returns length of byte[] segment that is used as value, if Field is not binary + returned value is undefined + + length of byte[] segment that represents this Field value + + + + Returns offset into byte[] segment that is used as value, if Field is not binary + returned value is undefined + + index of the first character in byte[] segment that represents this Field value + + + + True if norms are omitted for this indexed field + + + Renamed to {@link #getOmitTermFreqAndPositions} + + + + + + + + Expert: + + If set, omit normalization factors associated with this indexed field. + This effectively disables indexing boosts and length normalization for this field. + + + + Renamed to {@link #setOmitTermFreqAndPositions} + + + + Expert: + + If set, omit term freq, positions and payloads from + postings for this field. + +

    NOTE: While this option reduces storage space + required in the index, it also means any query + requiring positional information, such as {@link + PhraseQuery} or {@link SpanQuery} subclasses will + silently fail to find results. +

    +     + + Prints a Field for human consumption. + + + The value of the field in Binary, or null. If null, the Reader value, + String value, or TokenStream value is used. Exactly one of stringValue(), + readerValue(), binaryValue(), and tokenStreamValue() must be set. + + + + The value of the field as a Reader, or null. If null, the String value, + binary value, or TokenStream value is used. Exactly one of stringValue(), + readerValue(), binaryValue(), and tokenStreamValue() must be set. + + + + The value of the field as a TokenStream, or null. If null, the Reader value, + String value, or binary value is used. Exactly one of stringValue(), + readerValue(), binaryValue(), and tokenStreamValue() must be set. + + + + The value of the field as a String, or null. If null, the Reader value, + binary value, or TokenStream value is used. Exactly one of stringValue(), + readerValue(), binaryValue(), and tokenStreamValue() must be set. + + + + This is just a "splitter" class: it lets you wrap two + DocFieldConsumer instances as a single consumer. + + + + A Token's lexical type. The Default value is "word". + + + Returns this Token's lexical type. Defaults to "word". + + + Set the lexical type. + + + + + An {@link Analyzer} that filters {@link LetterTokenizer} + with {@link LowerCaseFilter} + + + + The results of a SpanQueryFilter. Wraps the BitSet and the position information from the SpanQuery + +

    + NOTE: This API is still experimental and subject to change. + + +

    +     + + + + + + + The bits for the Filter + + A List of {@link Lucene.Net.Search.SpanFilterResult.PositionInfo} objects + + Use {@link #SpanFilterResult(DocIdSet, List)} instead + + + + + The DocIdSet for the Filter + + A List of {@link Lucene.Net.Search.SpanFilterResult.PositionInfo} objects + + + + The first entry in the array corresponds to the first "on" bit. + Entries are increasing by document order + + A List of PositionInfo objects + + + + Use {@link #GetDocIdSet()} + + + + Returns the docIdSet + + + + A List of {@link Lucene.Net.Search.SpanFilterResult.StartEnd} objects + + + + + The end position of this match + + + + The Start position + The start position of this match + + + + Expert: Compares two ScoreDoc objects for sorting. + +

    Created: Feb 3, 2004 9:00:16 AM + +

    + lucene 1.4 + + $Id: ScoreDocComparator.java 738219 2009-01-27 20:15:21Z mikemccand $ + + use {@link FieldComparator} + +     + + Special comparator for sorting hits according to computed relevance (document score). + + + Special comparator for sorting hits according to index order (document number). + + + Constrains search results to only match those which also match a provided + query. Results are cached, so that searches after the first on the same + index using this filter are much faster. + + + $Id: QueryFilter.java 528298 2007-04-13 00:59:28Z hossman $ + + use a CachingWrapperFilter with QueryWrapperFilter + + + + Wraps another filter's result and caches it. The purpose is to allow + filters to simply filter, and then wrap with this class to add caching. + + + + A transient Filter cache. + + + Filter to cache results of + + + + Use {@link #GetDocIdSet(IndexReader)} instead. + + + + Provide the DocIdSet to be cached, using the DocIdSet provided + by the wrapped Filter. + This implementation returns the given DocIdSet. + + + + Constructs a filter which only matches documents matching + query. + + + + A Query that matches documents containing terms with a specified prefix. A PrefixQuery + is built by QueryParser for input like app*. + +

    This query uses the {@link + MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} + rewrite method. +

    +     + + Constructs a query for terms starting with prefix. + + + Returns the prefix of this query. + + + Prints a user-readable version of this query. + + + Expert: A hit queue for sorting by hits by terms in more than one field. + Uses FieldCache.DEFAULT for maintaining + internal term lookup tables. + + This class will not resolve SortField.AUTO types, and expects the type + of all SortFields used for construction to already have been resolved. + {@link SortField#DetectFieldType(IndexReader, String)} is a utility method which + may be used for field type detection. + + NOTE: This API is experimental and might change in + incompatible ways in the next release. + + + 2.9 + + $Id: + + + + + + + + Creates a hit queue sorted by the given list of fields. + +

    NOTE: The instances returned by this method + pre-allocate a full array of length numHits. + +

    + SortField array we are sorting by in priority order (highest + priority first); cannot be null or empty + + The number of hits to retain. Must be greater than zero. + + IOException +     + + Stores the sort criteria being used. + + + Given a queue Entry, creates a corresponding FieldDoc + that contains the values used to sort the given document. + These values are not the raw values out of the index, but the internal + representation of them. This is so the given search hit can be collated by + a MultiSearcher with other search hits. + + + The Entry used to create a FieldDoc + + The newly created FieldDoc + + + + + + Returns the SortFields being used by this hit queue. + + + An implementation of {@link FieldValueHitQueue} which is optimized in case + there is just one comparator. + + + + Returns whether a is less relevant than b. + ScoreDoc + + ScoreDoc + + true if document a should be sorted after document b. + + + + An implementation of {@link FieldValueHitQueue} which is optimized in case + there is more than one comparator. + + + + The TermVectorOffsetInfo class holds information pertaining to a Term in a {@link Lucene.Net.Index.TermPositionVector}'s + offset information. This offset information is the character offset as set during the Analysis phase (and thus may not be the actual offset in the + original content). + + + + Convenience declaration when creating a {@link Lucene.Net.Index.TermPositionVector} that stores only position information. + + + The accessor for the ending offset for the term + The offset + + + + The accessor for the starting offset of the term. + + + The offset + + + + Two TermVectorOffsetInfos are equals if both the start and end offsets are the same + The comparison Object + + true if both {@link #GetStartOffset()} and {@link #GetEndOffset()} are the same for both objects. + + + + This is a DocFieldConsumer that writes stored fields. + + + Fills in any hole in the docIDs + + + The SegmentMerger class combines two or more Segments, represented by an IndexReader ({@link #add}, + into a single Segment. After adding the appropriate readers, call the merge method to combine the + segments. +

    + If the compoundFile flag is set, then the segments will be merged into a compound file. + + +

    + + + + +     + + Maximum number of contiguous documents to bulk-copy + when merging stored fields + + + + norms header placeholder + + + This ctor used only by test code. + + + The Directory to merge the other segments into + + The name of the new segment + + + + Add an IndexReader to the collection of readers that are to be merged + + + + + + The index of the reader to return + + The ith reader to be merged + + + + Merges the readers specified by the {@link #add} method into the directory passed to the constructor + The number of documents that were merged + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Merges the readers specified by the {@link #add} method + into the directory passed to the constructor. + + if false, we will not merge the + stored fields nor vectors files + + The number of documents that were merged + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + close all IndexReaders that have been added. + Should not be called before merge(). + + IOException + + + + The number of documents in all of the readers + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Merge the TermVectors from each of the segments into the new one. + IOException + + + Process postings from multiple segments all positioned on the + same term. Writes out merged entries into freqOutput and + the proxOutput streams. + + + array of segments + + number of cells in the array actually occupied + + number of documents across all segments where this term was found + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Records the fact that roughly units amount of work + have been done since this method was last called. + When adding time-consuming code into SegmentMerger, + you should test different values for units to ensure + that the time in between calls to merge.checkAborted + is up to ~ 1 second. + + + + Useful constants representing filenames and extensions used by lucene + + + $rcs = ' $Id: Exp $ ' ; + + + + Name of the index segment file + + + Name of the generation reference file name + + + Name of the index deletable file (only used in + pre-lockless indices) + + + + Extension of norms file + + + Extension of freq postings file + + + Extension of prox postings file + + + Extension of terms file + + + Extension of terms index file + + + Extension of stored fields index file + + + Extension of stored fields file + + + Extension of vectors fields file + + + Extension of vectors documents file + + + Extension of vectors index file + + + Extension of compound file + + + Extension of compound file for doc store files + + + Extension of deletes + + + Extension of field infos + + + Extension of plain norms + + + Extension of separate norms + + + Extension of gen file + + + This array contains all filename extensions used by + Lucene's index files, with two exceptions, namely the + extension made up from .f + a number and + from .s + a number. Also note that + Lucene's segments_N files do not have any + filename extension. + + + + File extensions that are added to a compound file + (same as above, minus "del", "gen", "cfs"). + + + + File extensions of old-style index files + + + File extensions for term vector support + + + Computes the full file name from base, extension and + generation. If the generation is -1, the file name is + null. If it's 0, the file name is + If it's > 0, the file name is + + + -- main part of the file name + + -- extension of the filename (including .) + + -- generation + + + + Returns true if the provided filename is one of the doc + store files (ends with an extension in + STORE_INDEX_EXTENSIONS). + + + + This is the base class for an in-memory posting list, + keyed by a Token. {@link TermsHash} maintains a hash + table holding one instance of this per unique Token. + Consumers of TermsHash ({@link TermsHashConsumer}) must + subclass this class with its own concrete class. + FreqProxTermsWriter.PostingList is a private inner class used + for the freq/prox postings, and + TermVectorsTermsWriter.PostingList is a private inner class + used to hold TermVectors postings. + + + + A FilterIndexReader contains another IndexReader, which it + uses as its basic source of data, possibly transforming the data along the + way or providing additional functionality. The class + FilterIndexReader itself simply implements all abstract methods + of IndexReader with versions that pass all requests to the + contained index reader. Subclasses of FilterIndexReader may + further override some of these methods and may also provide additional + methods and fields. + + + +

    Construct a FilterIndexReader based on the specified base reader. + Directory locking for delete, undeleteAll, and setNorm operations is + left to the base reader.

    +

    Note that base reader is closed if this FilterIndexReader is closed.

    +

    + specified base reader. + +     + + + + + + Base class for filtering {@link TermDocs} implementations. + + + Base class for filtering {@link TermPositions} implementations. + + + Base class for filtering {@link TermEnum} implementations. + + + Abstract class for enumerating terms. +

    Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. +

    +     + + Increments the enumeration to the next element. True if one exists. + + + Returns the current Term in the enumeration. + + + Returns the docFreq of the current Term in the enumeration. + + + Closes the enumeration to further activity, freeing resources. + + + Skips terms to the first beyond the current whose value is + greater or equal to target.

    Returns true iff there is such + an entry.

    Behaves as if written: 

    +            public boolean skipTo(Term target) {
+            do {
+            if (!next())
+            return false;
+            } while (target > term());
+            return true;
+            }
+
    + Some implementations *could* be considerably more efficient than a linear scan. + Check the implementation to be sure. +     + This method is not performant and will be removed in Lucene 3.0. + Use {@link IndexReader#Terms(Term)} to create a new TermEnum positioned at a + given term. + +     + + A {@link MergeScheduler} that runs each merge using a + separate thread, up until a maximum number of threads + ({@link #setMaxThreadCount}) at which when a merge is + needed, the thread(s) that are updating the index will + pause until one or more merges completes. This is a + simple way to use concurrency in the indexing process + without having to create and manage application level + threads. + + + + Sets the max # simultaneous threads that may be + running. If a merge is necessary yet we already have + this many threads running, the incoming thread (that + is calling add/updateDocument) will block until + a merge thread has completed. + + + + Get the max # simultaneous threads that may be + + + + + Return the priority that merge threads run at. By + default the priority is 1 plus the priority of (ie, + slightly higher priority than) the first thread that + calls merge. + + + + Return the priority that merge threads run at. + + + Does the actual merge, by calling {@link IndexWriter#merge} + + + Create and return a new MergeThread + + + Called when an exception is hit in a background merge + thread + + + + Used for testing + + + Used for testing + + + Used for testing + + + Used for testing + + + Used for testing + + + Holds buffered deletes, by docID, term or query. We + hold two instances of this class: one for the deletes + prior to the last flush, the other for deletes after + the last flush. This is so if we need to abort + (discard all buffered docs) we can also discard the + buffered deletes yet keep the deletes done during + previously flushed segments. + + + + An Analyzer that uses {@link WhitespaceTokenizer}. + + + The payload of a Token. See also {@link Payload}. + + + Initialize this attribute with no payload. + + + Initialize this attribute with the given payload. + + + Returns this Token's payload. + + + Sets this Token's payload. + + + A SinkTokenizer can be used to cache Tokens for use in an Analyzer +

    + WARNING: {@link TeeTokenFilter} and {@link SinkTokenizer} only work with the old TokenStream API. + If you switch to the new API, you need to use {@link TeeSinkTokenFilter} instead, which offers + the same functionality. +

    + + + Use {@link TeeSinkTokenFilter} instead + + + +     + + Get the tokens in the internal List. +

    + WARNING: Adding tokens to this list requires the {@link #Reset()} method to be called in order for them + to be made available. Also, this Tokenizer does nothing to protect against {@link java.util.ConcurrentModificationException}s + in the case of adds happening while {@link #Next(Lucene.Net.Analysis.Token)} is being called. +

    + WARNING: Since this SinkTokenizer can be reset and the cached tokens made available again, do not modify them. Modify clones instead. + +

    + A List of {@link Lucene.Net.Analysis.Token}s + +     + + Returns the next token out of the list of cached tokens + The next {@link Lucene.Net.Analysis.Token} in the Sink. + + IOException + + + Override this method to cache only certain tokens, or new tokens based + on the old tokens. + + + The {@link Lucene.Net.Analysis.Token} to add to the sink + + + + Reset the internal data structures to the start at the front of the list of tokens. Should be called + if tokens were added to the list after an invocation of {@link #Next(Token)} + + IOException + + + This analyzer is used to facilitate scenarios where different + fields require different analysis techniques. Use {@link #addAnalyzer} + to add a non-default analyzer on a field name basis. + +

    Example usage: + + 

    +            PerFieldAnalyzerWrapper aWrapper =
+            new PerFieldAnalyzerWrapper(new StandardAnalyzer());
+            aWrapper.addAnalyzer("firstname", new KeywordAnalyzer());
+            aWrapper.addAnalyzer("lastname", new KeywordAnalyzer());
+
    + +

    In this example, StandardAnalyzer will be used for all fields except "firstname" + and "lastname", for which KeywordAnalyzer will be used. + +

    A PerFieldAnalyzerWrapper can be used like any other analyzer, for both indexing + and query parsing. +

    +     + + Constructs with default analyzer. + + + Any fields not specifically + defined to use a different analyzer will use the one provided here. + + + + Constructs with default analyzer and a map of analyzers to use for + specific fields. + + + Any fields not specifically + defined to use a different analyzer will use the one provided here. + + a Map (String field name to the Analyzer) to be + used for those fields + + + + Defines an analyzer to use for the specified field. + + + field name requiring a non-default analyzer + + non-default analyzer to use for field + + + + Return the positionIncrementGap from the analyzer assigned to fieldName + + + Emits the entire input as a single token. + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + Will be removed in Lucene 3.0. This method is final, as it should + not be overridden. Delegates to the backwards compatibility layer. + + + + "Tokenizes" the entire stream as a single token. This is useful + for data like zip codes, ids, and some product names. + + + + Common util methods for dealing with {@link IndexReader}s. + + + + + Gathers sub-readers from reader into a List. + + + + + + + + + Returns sub IndexReader that contains the given document id. + + + id of document + + parent reader + + sub reader of parent which contains the specified doc id + + + + Returns sub-reader subIndex from reader. + + + parent reader + + index of desired sub reader + + the subreader at subINdex + + + + Returns index of the searcher/reader for document n in the + array used to construct this searcher/reader. + + + + Expert: Delegating scoring implementation. Useful in {@link + Query#GetSimilarity(Searcher)} implementations, to override only certain + methods of a Searcher's Similiarty implementation.. + + + + Expert: Scoring API. +

    Subclasses implement search scoring. + +

    The score of query q for document d correlates to the + cosine-distance or dot-product between document and query vectors in a + + Vector Space Model (VSM) of Information Retrieval. + A document whose vector is closer to the query vector in that model is scored higher. + + The score is computed as follows: + +

    + + +
    + + + + + + + + + + + +
    + score(q,d)   =   + coord(q,d)  ·  + queryNorm(q)  ·  + + ∑ + + ( + tf(t in d)  ·  + idf(t)2  ·  + t.getBoost() ·  + norm(t,d) + ) +
    t in q
    +
    + +

    where +

      +
    1. + + tf(t in d) + correlates to the term's frequency, + defined as the number of times term t appears in the currently scored document d. + Documents that have more occurrences of a given term receive a higher score. + The default computation for tf(t in d) in + {@link Lucene.Net.Search.DefaultSimilarity#Tf(float) DefaultSimilarity} is: + +
       
      + + + + + +
      + {@link Lucene.Net.Search.DefaultSimilarity#Tf(float) tf(t in d)}   =   + + frequency½ +
      +
       
      +
      2. + +
    2. + + idf(t) stands for Inverse Document Frequency. This value + correlates to the inverse of docFreq + (the number of documents in which the term t appears). + This means rarer terms give higher contribution to the total score. + The default computation for idf(t) in + {@link Lucene.Net.Search.DefaultSimilarity#Idf(int, int) DefaultSimilarity} is: + +
       
      + + + + + + + +
      + {@link Lucene.Net.Search.DefaultSimilarity#Idf(int, int) idf(t)}  =   + + 1 + log ( + + + + + +
      numDocs
      –––––––––
      docFreq+1
      +       		+ ) +
      +
       
      +
      3. + +
    3. + + coord(q,d) + is a score factor based on how many of the query terms are found in the specified document. + Typically, a document that contains more of the query's terms will receive a higher score + than another document with fewer query terms. + This is a search time factor computed in + {@link #Coord(int, int) coord(q,d)} + by the Similarity in effect at search time. +
       
      +
      4. + +
    4. + + queryNorm(q) + + is a normalizing factor used to make scores between queries comparable. + This factor does not affect document ranking (since all ranked documents are multiplied by the same factor), + but rather just attempts to make scores from different queries (or even different indexes) comparable. + This is a search time factor computed by the Similarity in effect at search time. + + The default computation in + {@link Lucene.Net.Search.DefaultSimilarity#QueryNorm(float) DefaultSimilarity} + is: +
       
      + + + + + +
      + queryNorm(q)   =   + {@link Lucene.Net.Search.DefaultSimilarity#QueryNorm(float) queryNorm(sumOfSquaredWeights)} +   =   + + + + + +
      1
      + –––––––––––––– +
      sumOfSquaredWeights½
      +
      +
       
      + + The sum of squared weights (of the query terms) is + computed by the query {@link Lucene.Net.Search.Weight} object. + For example, a {@link Lucene.Net.Search.BooleanQuery boolean query} + computes this value as: + +
       
      + + + + + + + + + + + +
      + {@link Lucene.Net.Search.Weight#SumOfSquaredWeights() sumOfSquaredWeights}   =   + {@link Lucene.Net.Search.Query#GetBoost() q.getBoost()} 2 +  ·  + + ∑ + + ( + idf(t)  ·  + t.getBoost() + ) 2 +
      t in q
      +
       
      + +
      5. + +
    5. + + t.getBoost() + is a search time boost of term t in the query q as + specified in the query text + (see query syntax), + or as set by application calls to + {@link Lucene.Net.Search.Query#SetBoost(float) setBoost()}. + Notice that there is really no direct API for accessing a boost of one term in a multi term query, + but rather multi terms are represented in a query as multi + {@link Lucene.Net.Search.TermQuery TermQuery} objects, + and so the boost of a term in the query is accessible by calling the sub-query + {@link Lucene.Net.Search.Query#GetBoost() getBoost()}. +
       
      +
      6. + +
    6. + + norm(t,d) encapsulates a few (indexing time) boost and length factors: + +
        +
      • Document boost - set by calling + {@link Lucene.Net.Documents.Document#SetBoost(float) doc.setBoost()} + before adding the document to the index. +
        • +
      • Field boost - set by calling + {@link Lucene.Net.Documents.Fieldable#SetBoost(float) field.setBoost()} + before adding the field to a document. +
        • +
      • {@link #LengthNorm(String, int) lengthNorm(field)} - computed + when the document is added to the index in accordance with the number of tokens + of this field in the document, so that shorter fields contribute more to the score. + LengthNorm is computed by the Similarity class in effect at indexing. +
        • +
      + +

      + When a document is added to the index, all the above factors are multiplied. + If the document has multiple fields with the same name, all their boosts are multiplied together: + +
       
      + + + + + + + + + + + +
      + norm(t,d)   =   + {@link Lucene.Net.Documents.Document#GetBoost() doc.getBoost()} +  ·  + {@link #LengthNorm(String, int) lengthNorm(field)} +  ·  + + ∏ + + {@link Lucene.Net.Documents.Fieldable#GetBoost() f.getBoost}() +
      field f in d named as t
      +
       
      + However the resulted norm value is {@link #EncodeNorm(float) encoded} as a single byte + before being stored. + At search time, the norm byte value is read from the index + {@link Lucene.Net.Store.Directory directory} and + {@link #DecodeNorm(byte) decoded} back to a float norm value. + This encoding/decoding, while reducing index size, comes with the price of + precision loss - it is not guaranteed that decode(encode(x)) = x. + For instance, decode(encode(0.89)) = 0.75. + Also notice that search time is too late to modify this norm part of scoring, e.g. by + using a different {@link Similarity} for search. +
       
      +

      7. +
    + +     + + + + + + +     + + Set the default Similarity implementation used by indexing and search + code. + + + + + + + + + Return the default Similarity implementation used by indexing and search + code. + +

    This is initially an instance of {@link DefaultSimilarity}. + +

    + + + + +     + + Cache of decoded bytes. + + + Decodes a normalization factor stored in an index. + + + + + Returns a table for decoding normalization bytes. + + + + + Compute the normalization value for a field, given the accumulated + state of term processing for this field (see {@link FieldInvertState}). + +

    Implementations should calculate a float value based on the field + state and then return that value. + +

    For backward compatibility this method by default calls + {@link #LengthNorm(String, int)} passing + {@link FieldInvertState#GetLength()} as the second argument, and + then multiplies this value by {@link FieldInvertState#GetBoost()}.

    + +

    WARNING: This API is new and experimental and may + suddenly change.

    + +

    + field name + + current processing state for this field + + the calculated float norm + +     + + Computes the normalization value for a field given the total number of + terms contained in a field. These values, together with field boosts, are + stored in an index and multipled into scores for hits on each field by the + search code. + +

    Matches in longer fields are less precise, so implementations of this + method usually return smaller values when numTokens is large, + and larger values when numTokens is small. + +

    Note that the return values are computed under + {@link Lucene.Net.Index.IndexWriter#AddDocument(Lucene.Net.Documents.Document)} + and then stored using + {@link #EncodeNorm(float)}. + Thus they have limited precision, and documents + must be re-indexed if this method is altered. + +

    + the name of the field + + the total number of tokens contained in fields named + fieldName of doc. + + a normalization factor for hits on this field of this document + + + + +     + + Computes the normalization value for a query given the sum of the squared + weights of each of the query terms. This value is then multipled into the + weight of each query term. + +

    This does not affect ranking, but rather just attempts to make scores + from different queries comparable. + +

    + the sum of the squares of query term weights + + a normalization factor for query weights + +     + + Encodes a normalization factor for storage in an index. + +

    The encoding uses a three-bit mantissa, a five-bit exponent, and + the zero-exponent point at 15, thus + representing values from around 7x10^9 to 2x10^-9 with about one + significant decimal digit of accuracy. Zero is also represented. + Negative numbers are rounded up to zero. Values too large to represent + are rounded down to the largest representable value. Positive values too + small to represent are rounded up to the smallest positive representable + value. + +

    + + + + +     + + Computes a score factor based on a term or phrase's frequency in a + document. This value is multiplied by the {@link #Idf(Term, Searcher)} + factor for each term in the query and these products are then summed to + form the initial score for a document. + +

    Terms and phrases repeated in a document indicate the topic of the + document, so implementations of this method usually return larger values + when freq is large, and smaller values when freq + is small. + +

    The default implementation calls {@link #Tf(float)}. + +

    + the frequency of a term within a document + + a score factor based on a term's within-document frequency + +     + + Computes the amount of a sloppy phrase match, based on an edit distance. + This value is summed for each sloppy phrase match in a document to form + the frequency that is passed to {@link #Tf(float)}. + +

    A phrase match with a small edit distance to a document passage more + closely matches the document, so implementations of this method usually + return larger values when the edit distance is small and smaller values + when it is large. + +

    + + + the edit distance of this sloppy phrase match + + the frequency increment for this match + +     + + Computes a score factor based on a term or phrase's frequency in a + document. This value is multiplied by the {@link #Idf(Term, Searcher)} + factor for each term in the query and these products are then summed to + form the initial score for a document. + +

    Terms and phrases repeated in a document indicate the topic of the + document, so implementations of this method usually return larger values + when freq is large, and smaller values when freq + is small. + +

    + the frequency of a term within a document + + a score factor based on a term's within-document frequency + +     + + Computes a score factor for a simple term. + +

    The default implementation is:

    +            return idf(searcher.docFreq(term), searcher.maxDoc());
+
    + + Note that {@link Searcher#MaxDoc()} is used instead of + {@link Lucene.Net.Index.IndexReader#NumDocs()} because it is proportional to + {@link Searcher#DocFreq(Term)} , i.e., when one is inaccurate, + so is the other, and in the same direction. + +     + the term in question + + the document collection being searched + + a score factor for the term + + see {@link #IdfExplain(Term, Searcher)} + +     + + Computes a score factor for a simple term and returns an explanation + for that score factor. + +

    + The default implementation uses: + + 

    +            idf(searcher.docFreq(term), searcher.maxDoc());
+
    + + Note that {@link Searcher#MaxDoc()} is used instead of + {@link Lucene.Net.Index.IndexReader#NumDocs()} because it is + proportional to {@link Searcher#DocFreq(Term)} , i.e., when one is + inaccurate, so is the other, and in the same direction. + +     + the term in question + + the document collection being searched + + an IDFExplain object that includes both an idf score factor + and an explanation for the term. + + IOException +     + + Computes a score factor for a phrase. + +

    The default implementation sums the {@link #Idf(Term,Searcher)} factor + for each term in the phrase. + +

    + the terms in the phrase + + the document collection being searched + + idf score factor + + see {@link #idfExplain(Collection, Searcher)} + +     + + Computes a score factor for a phrase. + +

    + The default implementation sums the idf factor for + each term in the phrase. + +

    + the terms in the phrase + + the document collection being searched + + an IDFExplain object that includes both an idf + score factor for the phrase and an explanation + for each term. + + IOException +     + + Computes a score factor based on a term's document frequency (the number + of documents which contain the term). This value is multiplied by the + {@link #Tf(int)} factor for each term in the query and these products are + then summed to form the initial score for a document. + +

    Terms that occur in fewer documents are better indicators of topic, so + implementations of this method usually return larger values for rare terms, + and smaller values for common terms. + +

    + the number of documents which contain the term + + the total number of documents in the collection + + a score factor based on the term's document frequency + +     + + Computes a score factor based on the fraction of all query terms that a + document contains. This value is multiplied into scores. + +

    The presence of a large portion of the query terms indicates a better + match with the query, so implementations of this method usually return + larger values when the ratio between these parameters is large and smaller + values when the ratio between them is small. + +

    + the number of query terms matched in the document + + the total number of terms in the query + + a score factor based on term overlap with the query + +     + + Calculate a scoring factor based on the data in the payload. Overriding implementations + are responsible for interpreting what is in the payload. Lucene makes no assumptions about + what is in the byte array. +

    + The default implementation returns 1. + +

    + The fieldName of the term this payload belongs to + + The payload byte array to be scored + + The offset into the payload array + + The length in the array + + An implementation dependent float to be used as a scoring factor + + + See {@link #ScorePayload(int, String, int, int, byte[], int, int)} + +     + + Calculate a scoring factor based on the data in the payload. Overriding implementations + are responsible for interpreting what is in the payload. Lucene makes no assumptions about + what is in the byte array. +

    + The default implementation returns 1. + +

    + The docId currently being scored. If this value is {@link #NO_DOC_ID_PROVIDED}, then it should be assumed that the PayloadQuery implementation does not provide document information + + The fieldName of the term this payload belongs to + + The start position of the payload + + The end position of the payload + + The payload byte array to be scored + + The offset into the payload array + + The length in the array + + An implementation dependent float to be used as a scoring factor + + +     + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + The Similarity implementation used by default. + TODO: move back to top when old API is removed! + + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Remove this when old API is removed! + + + + Construct a {@link Similarity} that delegates all methods to another. + + + the Similarity implementation to delegate to + + + + A Scorer for queries with a required subscorer + and an excluding (prohibited) sub DocIdSetIterator. +
    + This Scorer implements {@link Scorer#SkipTo(int)}, + and it uses the skipTo() on the given scorers. +     +     + + Construct a ReqExclScorer. + The scorer that must match, except where + + indicates exclusion. + + + + use {@link #NextDoc()} instead. + + + + Advance to non excluded doc. +
    On entry: +
      +
    • reqScorer != null,
      • +
    • exclScorer != null,
      • +
    • reqScorer was advanced once via next() or skipTo() + and reqScorer.doc() may still be excluded.
      • +
    + Advances reqScorer a non excluded required doc, if any. +     + true iff there is a non excluded required doc. + +     + + use {@link #DocID()} instead. + + + + Returns the score of the current document matching the query. + Initially invalid, until {@link #Next()} is called the first time. + + The score of the required scorer. + + + + use {@link #Advance(int)} instead. + + + + A Filter that restricts search results to values that have a matching prefix in a given + field. + + + + Prints a user-readable version of this query. + + + Position of a term in a document that takes into account the term offset within the phrase. + + + Go to next location of this term current document, and set + position as location - offset, so that a + matching exact phrase is easily identified when all PhrasePositions + have exactly the same position. + + + + Abstract class for enumerating a subset of all terms. +

    Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. +

    +     + + the current term + + + the delegate enum - to set this member use {@link #setEnum} + + + Equality compare on the term + + + Equality measure on the term + + + Indicates the end of the enumeration has been reached + + + use this method to set the actual TermEnum (e.g. in ctor), + it will be automatically positioned on the first matching term. + + + + Returns the docFreq of the current Term in the enumeration. + Returns -1 if no Term matches or all terms have been enumerated. + + + + Increments the enumeration to the next element. True if one exists. + + + Returns the current Term in the enumeration. + Returns null if no Term matches or all terms have been enumerated. + + + + Closes the enumeration to further activity, freeing resources. + + + Expert: Maintains caches of term values. + +

    Created: May 19, 2004 11:13:14 AM + +

    + lucene 1.4 + + $Id: FieldCache.java 807841 2009-08-25 22:27:31Z markrmiller $ + + + +     + + Expert: Stores term text values and document ordering data. + + + All the term values, in natural order. + + + For each document, an index into the lookup array. + + + Creates one of these objects + + + Indicator for StringIndex values in the cache. + + + Expert: The cache used internally by sorting and range query classes. + + + The default parser for byte values, which are encoded by {@link Byte#toString(byte)} + + + The default parser for short values, which are encoded by {@link Short#toString(short)} + + + The default parser for int values, which are encoded by {@link Integer#toString(int)} + + + The default parser for float values, which are encoded by {@link Float#toString(float)} + + + The default parser for long values, which are encoded by {@link Long#toString(long)} + + + The default parser for double values, which are encoded by {@link Double#toString(double)} + + + A parser instance for int values encoded by {@link NumericUtils#IntToPrefixCoded(int)}, e.g. when indexed + via {@link NumericField}/{@link NumericTokenStream}. + + + + A parser instance for float values encoded with {@link NumericUtils}, e.g. when indexed + via {@link NumericField}/{@link NumericTokenStream}. + + + + A parser instance for long values encoded by {@link NumericUtils#LongToPrefixCoded(long)}, e.g. when indexed + via {@link NumericField}/{@link NumericTokenStream}. + + + + A parser instance for double values encoded with {@link NumericUtils}, e.g. when indexed + via {@link NumericField}/{@link NumericTokenStream}. + + + + Interface to parse bytes from document fields. + + + + + Marker interface as super-interface to all parsers. It + is used to specify a custom parser to {@link + SortField#SortField(String, FieldCache.Parser)}. + + + + Return a single Byte representation of this field's value. + + + Interface to parse shorts from document fields. + + + + + Return a short representation of this field's value. + + + Interface to parse ints from document fields. + + + + + Return an integer representation of this field's value. + + + Interface to parse floats from document fields. + + + + + Return an float representation of this field's value. + + + Interface to parse long from document fields. + + + Use {@link FieldCache.LongParser}, this will be removed in Lucene 3.0 + + + + Return an long representation of this field's value. + + + Interface to parse doubles from document fields. + + + Use {@link FieldCache.DoubleParser}, this will be removed in Lucene 3.0 + + + + Return an long representation of this field's value. + + + A query that wraps a filter and simply returns a constant score equal to the + query boost for every document in the filter. + + + + $Id: ConstantScoreQuery.java 807180 2009-08-24 12:26:43Z markrmiller $ + + + + Returns the encapsulated filter + + + Prints a user-readable version of this query. + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + + + use {@link #NextDoc()} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #Advance(int)} instead. + + + + Compares {@link Lucene.Net.Index.TermVectorEntry}s first by frequency and then by + the term (case-sensitive) + + + + + + Holds all per thread, per field state. + + + Declare what fields to load normally and what fields to load lazily + + + + + + Pass in the Set of {@link Field} names to load and the Set of {@link Field} names to load lazily. If both are null, the + Document will not have any {@link Field} on it. + + A Set of {@link String} field names to load. May be empty, but not null + + A Set of {@link String} field names to load lazily. May be empty, but not null + + + + Indicate whether to load the field with the given name or not. If the {@link Field#Name()} is not in either of the + initializing Sets, then {@link Lucene.Net.Documents.FieldSelectorResult#NO_LOAD} is returned. If a Field name + is in both fieldsToLoad and lazyFieldsToLoad, lazy has precedence. + + + The {@link Field} name to check + + The {@link FieldSelectorResult} + + + + A field is a section of a Document. Each field has two parts, a name and a + value. Values may be free text, provided as a String or as a Reader, or they + may be atomic keywords, which are not further processed. Such keywords may + be used to represent dates, urls, etc. Fields are optionally stored in the + index, so that they may be returned with hits on the document. + + + + The value of the field as a String, or null. If null, the Reader value or + binary value is used. Exactly one of stringValue(), + readerValue(), and getBinaryValue() must be set. + + + + The value of the field as a Reader, or null. If null, the String value or + binary value is used. Exactly one of stringValue(), + readerValue(), and getBinaryValue() must be set. + + + + The value of the field in Binary, or null. If null, the Reader value, + or String value is used. Exactly one of stringValue(), + readerValue(), and getBinaryValue() must be set. + + This method must allocate a new byte[] if + the {@link AbstractField#GetBinaryOffset()} is non-zero + or {@link AbstractField#GetBinaryLength()} is not the + full length of the byte[]. Please use {@link + AbstractField#GetBinaryValue()} instead, which simply + returns the byte[]. + + + + The TokesStream for this field to be used when indexing, or null. If null, the Reader value + or String value is analyzed to produce the indexed tokens. + + + +

    Expert: change the value of this field. This can + be used during indexing to re-use a single Field + instance to improve indexing speed by avoiding GC cost + of new'ing and reclaiming Field instances. Typically + a single {@link Document} instance is re-used as + well. This helps most on small documents.

    + +

    Each Field instance should only be used once + within a single {@link Document} instance. See ImproveIndexingSpeed + for details.

    +

    +     + + Expert: change the value of this field. See setValue(String). + + + Expert: change the value of this field. See setValue(String). + + + Expert: change the value of this field. See setValue(String). + + + Expert: change the value of this field. See setValue(String). + use {@link #setTokenStream} + + + + Expert: sets the token stream to be used for indexing and causes isIndexed() and isTokenized() to return true. + May be combined with stored values from stringValue() or binaryValue() + + + + Create a field by specifying its name, value and how it will + be saved in the index. Term vectors will not be stored in the index. + + + The name of the field + + The string to process + + Whether value should be stored in the index + + Whether the field should be indexed, and if so, if it should + be tokenized before indexing + + NullPointerException if name or value is null + IllegalArgumentException if the field is neither stored nor indexed + + + Create a field by specifying its name, value and how it will + be saved in the index. + + + The name of the field + + The string to process + + Whether value should be stored in the index + + Whether the field should be indexed, and if so, if it should + be tokenized before indexing + + Whether term vector should be stored + + NullPointerException if name or value is null + IllegalArgumentException in any of the following situations: +
      +
    • the field is neither stored nor indexed
      • +
    • the field is not indexed but termVector is TermVector.YES
      • +
    +     +     + + Create a field by specifying its name, value and how it will + be saved in the index. + + + The name of the field + + Whether to .intern() name or not + + The string to process + + Whether value should be stored in the index + + Whether the field should be indexed, and if so, if it should + be tokenized before indexing + + Whether term vector should be stored + + NullPointerException if name or value is null + IllegalArgumentException in any of the following situations: +
      +
    • the field is neither stored nor indexed
      • +
    • the field is not indexed but termVector is TermVector.YES
      • +
    +     +     + + Create a tokenized and indexed field that is not stored. Term vectors will + not be stored. The Reader is read only when the Document is added to the index, + i.e. you may not close the Reader until {@link IndexWriter#AddDocument(Document)} + has been called. + + + The name of the field + + The reader with the content + + NullPointerException if name or reader is null + + + Create a tokenized and indexed field that is not stored, optionally with + storing term vectors. The Reader is read only when the Document is added to the index, + i.e. you may not close the Reader until {@link IndexWriter#AddDocument(Document)} + has been called. + + + The name of the field + + The reader with the content + + Whether term vector should be stored + + NullPointerException if name or reader is null + + + Create a tokenized and indexed field that is not stored. Term vectors will + not be stored. This is useful for pre-analyzed fields. + The TokenStream is read only when the Document is added to the index, + i.e. you may not close the TokenStream until {@link IndexWriter#AddDocument(Document)} + has been called. + + + The name of the field + + The TokenStream with the content + + NullPointerException if name or tokenStream is null + + + Create a tokenized and indexed field that is not stored, optionally with + storing term vectors. This is useful for pre-analyzed fields. + The TokenStream is read only when the Document is added to the index, + i.e. you may not close the TokenStream until {@link IndexWriter#AddDocument(Document)} + has been called. + + + The name of the field + + The TokenStream with the content + + Whether term vector should be stored + + NullPointerException if name or tokenStream is null + + + Create a stored field with binary value. Optionally the value may be compressed. + + + The name of the field + + The binary value + + How value should be stored (compressed or not) + + IllegalArgumentException if store is Store.NO + + + Create a stored field with binary value. Optionally the value may be compressed. + + + The name of the field + + The binary value + + Starting offset in value where this Field's bytes are + + Number of bytes to use for this Field, starting at offset + + How value should be stored (compressed or not) + + IllegalArgumentException if store is Store.NO + + + Specifies whether and how a field should be stored. + + + Store the original field value in the index in a compressed form. This is + useful for long documents and for binary valued fields. + + Please use {@link CompressionTools} instead. + For string fields that were previously indexed and stored using compression, + the new way to achieve this is: First add the field indexed-only (no store) + and additionally using the same field name as a binary, stored field + with {@link CompressionTools#compressString}. + + + + Store the original field value in the index. This is useful for short texts + like a document's title which should be displayed with the results. The + value is stored in its original form, i.e. no analyzer is used before it is + stored. + + + + Do not store the field value in the index. + + + Specifies whether and how a field should be indexed. + + + Do not index the field value. This field can thus not be searched, + but one can still access its contents provided it is + {@link Field.Store stored}. + + + + Index the tokens produced by running the field's + value through an Analyzer. This is useful for + common text. + + + + this has been renamed to {@link #ANALYZED} + + + + Index the field's value without using an Analyzer, so it can be searched. + As no analyzer is used the value will be stored as a single term. This is + useful for unique Ids like product numbers. + + + + This has been renamed to {@link #NOT_ANALYZED} + + + + Expert: Index the field's value without an Analyzer, + and also disable the storing of norms. Note that you + can also separately enable/disable norms by calling + {@link Field#setOmitNorms}. No norms means that + index-time field and document boosting and field + length normalization are disabled. The benefit is + less memory usage as norms take up one byte of RAM + per indexed field for every document in the index, + during searching. Note that once you index a given + field with norms enabled, disabling norms will + have no effect. In other words, for this to have the + above described effect on a field, all instances of + that field must be indexed with NOT_ANALYZED_NO_NORMS + from the beginning. + + + + This has been renamed to + {@link #NOT_ANALYZED_NO_NORMS} + + + + Expert: Index the tokens produced by running the + field's value through an Analyzer, and also + separately disable the storing of norms. See + {@link #NOT_ANALYZED_NO_NORMS} for what norms are + and why you may want to disable them. + + + + Specifies whether and how a field should have term vectors. + + + Do not store term vectors. + + + Store the term vectors of each document. A term vector is a list + of the document's terms and their number of occurrences in that document. + + + + Store the term vector + token position information + + + + + + + Store the term vector + Token offset information + + + + + + + Store the term vector + Token position and offset information + + + + + + + + + + + Works in conjunction with the SinkTokenizer to provide the ability to set aside tokens + that have already been analyzed. This is useful in situations where multiple fields share + many common analysis steps and then go their separate ways. +

    + It is also useful for doing things like entity extraction or proper noun analysis as + part of the analysis workflow and saving off those tokens for use in another field. + + 

    +            SinkTokenizer sink1 = new SinkTokenizer();
+            SinkTokenizer sink2 = new SinkTokenizer();
+            TokenStream source1 = new TeeTokenFilter(new TeeTokenFilter(new WhitespaceTokenizer(reader1), sink1), sink2);
+            TokenStream source2 = new TeeTokenFilter(new TeeTokenFilter(new WhitespaceTokenizer(reader2), sink1), sink2);
+            TokenStream final1 = new LowerCaseFilter(source1);
+            TokenStream final2 = source2;
+            TokenStream final3 = new EntityDetect(sink1);
+            TokenStream final4 = new URLDetect(sink2);
+            d.add(new Field("f1", final1));
+            d.add(new Field("f2", final2));
+            d.add(new Field("f3", final3));
+            d.add(new Field("f4", final4));
+
    + In this example, sink1 and sink2 will both get tokens from both + reader1 and reader2 after whitespace tokenizer + and now we can further wrap any of these in extra analysis, and more "sources" can be inserted if desired. + It is important, that tees are consumed before sinks (in the above example, the field names must be + less the sink's field names). + Note, the EntityDetect and URLDetect TokenStreams are for the example and do not currently exist in Lucene +

    + + See LUCENE-1058. +

    + WARNING: {@link TeeTokenFilter} and {@link SinkTokenizer} only work with the old TokenStream API. + If you switch to the new API, you need to use {@link TeeSinkTokenFilter} instead, which offers + the same functionality. +

    + + + Use {@link TeeSinkTokenFilter} instead + + +     + + Removes stop words from a token stream. + + + Construct a token stream filtering the given input. + Use {@link #StopFilter(boolean, TokenStream, String[])} instead + + + + Construct a token stream filtering the given input. + true if token positions should record the removed stop words + + input TokenStream + + array of stop words + + Use {@link #StopFilter(boolean, TokenStream, Set)} instead. + + + + Constructs a filter which removes words from the input + TokenStream that are named in the array of words. + + Use {@link #StopFilter(boolean, TokenStream, String[], boolean)} instead + + + + Constructs a filter which removes words from the input + TokenStream that are named in the array of words. + + true if token positions should record the removed stop words + + input TokenStream + + array of stop words + + true if case is ignored + + Use {@link #StopFilter(boolean, TokenStream, Set, boolean)} instead. + + + + Construct a token stream filtering the given input. + If stopWords is an instance of {@link CharArraySet} (true if + makeStopSet() was used to construct the set) it will be directly used + and ignoreCase will be ignored since CharArraySet + directly controls case sensitivity. +

    + If stopWords is not an instance of {@link CharArraySet}, + a new CharArraySet will be constructed and ignoreCase will be + used to specify the case sensitivity of that set. + +

    + + + The set of Stop Words. + + -Ignore case when stopping. + + Use {@link #StopFilter(boolean, TokenStream, Set, boolean)} instead + +     + + Construct a token stream filtering the given input. + If stopWords is an instance of {@link CharArraySet} (true if + makeStopSet() was used to construct the set) it will be directly used + and ignoreCase will be ignored since CharArraySet + directly controls case sensitivity. +

    + If stopWords is not an instance of {@link CharArraySet}, + a new CharArraySet will be constructed and ignoreCase will be + used to specify the case sensitivity of that set. + +

    + true if token positions should record the removed stop words + + Input TokenStream + + The set of Stop Words. + + -Ignore case when stopping. + +     + + Constructs a filter which removes words from the input + TokenStream that are named in the Set. + + + + + Use {@link #StopFilter(boolean, TokenStream, Set)} instead + + + + Constructs a filter which removes words from the input + TokenStream that are named in the Set. + + + true if token positions should record the removed stop words + + Input stream + + The set of Stop Words. + + + + + + Builds a Set from an array of stop words, + appropriate for passing into the StopFilter constructor. + This permits this stopWords construction to be cached once when + an Analyzer is constructed. + + + passing false to ignoreCase + + + + Builds a Set from an array of stop words, + appropriate for passing into the StopFilter constructor. + This permits this stopWords construction to be cached once when + an Analyzer is constructed. + + + passing false to ignoreCase + + + + + An array of stopwords + + If true, all words are lower cased first. + + a Set containing the words + + + + + A List of Strings representing the stopwords + + if true, all words are lower cased first + + A Set containing the words + + + + Returns the next input Token whose term() is not a stop word. + + + + + Please specify this when you create the StopFilter + + + + Returns version-dependent default for enablePositionIncrements. Analyzers + that embed StopFilter use this method when creating the StopFilter. Prior + to 2.9, this returns {@link #getEnablePositionIncrementsDefault}. On 2.9 + or later, it returns true. + + + + Set the default position increments behavior of every StopFilter created + from now on. +

    + Note: behavior of a single StopFilter instance can be modified with + {@link #SetEnablePositionIncrements(boolean)}. This static method allows + control over behavior of classes using StopFilters internally, for + example {@link Lucene.Net.Analysis.Standard.StandardAnalyzer + StandardAnalyzer} if used with the no-arg ctor. +

    + Default : false. + +

    + + + Please specify this when you create the StopFilter + +     + + + + + + If true, this StopFilter will preserve + positions of the incoming tokens (ie, accumulate and + set position increments of the removed stop tokens). + Generally, true is best as it does not + lose information (positions of the original tokens) + during indexing. + +

    When set, when a token is stopped + (omitted), the position increment of the following + token is incremented. + +

    NOTE: be sure to also + set {@link QueryParser#setEnablePositionIncrements} if + you use QueryParser to create queries. +

    +     + + Normalizes token text to lower case. + + + $Id: LowerCaseFilter.java 797665 2009-07-24 21:45:48Z buschmi $ + + + + CharReader is a Reader wrapper. It reads chars from + Reader and outputs {@link CharStream}, defining an + identify function {@link #CorrectOffset} method that + simply returns the provided offset. + + + + A simple class that stores Strings as char[]'s in a + hash table. Note that this is not a general purpose + class. For example, it cannot remove items from the + set, nor does it resize its hash table to be smaller, + etc. It is designed to be quick to test if a char[] + is in the set without the necessity of converting it + to a String first. + + + + Create set with enough capacity to hold startSize + terms + + + + Create set from a Collection of char[] or String + + + Create set from entries + + + true if the len chars of text starting at off + are in the set + + + + true if the System.String is in the set + + + Returns true if the String is in the set + + + Add this String into the set + + + Add this char[] directly to the set. + If ignoreCase is true for this Set, the text array will be directly modified. + The user should never modify this text array after calling this method. + + + + Returns an unmodifiable {@link CharArraySet}. This allows to provide + unmodifiable views of internal sets for "read-only" use. + + + a set for which the unmodifiable set is returned. + + an new unmodifiable {@link CharArraySet}. + + NullPointerException + if the given set is null. + + + + Adds all of the elements in the specified collection to this collection + + + Removes all elements from the set + + + Removes from this set all of its elements that are contained in the specified collection + + + Retains only the elements in this set that are contained in the specified collection + + + The Iterator<String> for this set. Strings are constructed on the fly, so + use nextCharArray for more efficient access. + + + + do not modify the returned char[] + + + Returns the next String, as a Set<String> would... + use nextCharArray() for better efficiency. + + + + Efficient unmodifiable {@link CharArraySet}. This implementation does not + delegate calls to a give {@link CharArraySet} like + {@link Collections#UnmodifiableSet(java.util.Set)} does. Instead is passes + the internal representation of a {@link CharArraySet} to a super + constructor and overrides all mutators. + + + + Stores and iterate on sorted integers in compressed form in RAM.
    + The code for compressing the differences between ascending integers was + borrowed from {@link Lucene.Net.Store.IndexInput} and + {@link Lucene.Net.Store.IndexOutput}. +

    + NOTE: this class assumes the stored integers are doc Ids (hence why it + extends {@link DocIdSet}). Therefore its {@link #Iterator()} assumes {@link + DocIdSetIterator#NO_MORE_DOCS} can be used as sentinel. If you intent to use + this value, then make sure it's not used during search flow. +

    +     + + When a BitSet has fewer than 1 in BITS2VINTLIST_SIZE bits set, + a SortedVIntList representing the index numbers of the set bits + will be smaller than that BitSet. + + + + Create a SortedVIntList from all elements of an array of integers. + + + A sorted array of non negative integers. + + + + Create a SortedVIntList from an array of integers. + An array of sorted non negative integers. + + The number of integers to be used from the array. + + + + Create a SortedVIntList from a BitSet. + A bit set representing a set of integers. + + + + Create a SortedVIntList from an OpenBitSet. + A bit set representing a set of integers. + + + + Create a SortedVIntList. + An iterator providing document numbers as a set of integers. + This DocIdSetIterator is iterated completely when this constructor + is called and it must provide the integers in non + decreasing order. + + + + The total number of sorted integers. + + + + The size of the byte array storing the compressed sorted integers. + + + + This DocIdSet implementation is cacheable. + + + An iterator over the sorted integers. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + A ScorerDocQueue maintains a partial ordering of its Scorers such that the + least Scorer can always be found in constant time. Put()'s and pop()'s + require log(size) time. The ordering is by Scorer.doc(). + + + + Create a ScorerDocQueue with a maximum size. + + + Adds a Scorer to a ScorerDocQueue in log(size) time. + If one tries to add more Scorers than maxSize + a RuntimeException (ArrayIndexOutOfBound) is thrown. + + + + Adds a Scorer to the ScorerDocQueue in log(size) time if either + the ScorerDocQueue is not full, or not lessThan(scorer, top()). + + + + true if scorer is added, false otherwise. + + + + Returns the least Scorer of the ScorerDocQueue in constant time. + Should not be used when the queue is empty. + + + + Returns document number of the least Scorer of the ScorerDocQueue + in constant time. + Should not be used when the queue is empty. + + + + Removes and returns the least scorer of the ScorerDocQueue in log(size) + time. + Should not be used when the queue is empty. + + + + Removes the least scorer of the ScorerDocQueue in log(size) time. + Should not be used when the queue is empty. + + + + Should be called when the scorer at top changes doc() value. + Still log(n) worst case, but it's at least twice as fast to 
    +            { pq.top().change(); pq.adjustTop(); }
+
    instead of 
    +            { o = pq.pop(); o.change(); pq.push(o); }
+
    +     +     + + Returns the number of scorers currently stored in the ScorerDocQueue. + + + Removes all entries from the ScorerDocQueue. + + + An "open" BitSet implementation that allows direct access to the array of words + storing the bits. +

    + Unlike java.util.bitset, the fact that bits are packed into an array of longs + is part of the interface. This allows efficient implementation of other algorithms + by someone other than the author. It also allows one to efficiently implement + alternate serialization or interchange formats. +

    + OpenBitSet is faster than java.util.BitSet in most operations + and *much* faster at calculating cardinality of sets and results of set operations. + It can also handle sets of larger cardinality (up to 64 * 2**32-1) +

    + The goals of OpenBitSet are the fastest implementation possible, and + maximum code reuse. Extra safety and encapsulation + may always be built on top, but if that's built in, the cost can never be removed (and + hence people re-implement their own version in order to get better performance). + If you want a "safe", totally encapsulated (and slower and limited) BitSet + class, use java.util.BitSet. +

    +

    Performance Results

    + + Test system: Pentium 4, Sun Java 1.5_06 -server -Xbatch -Xmx64M +
    BitSet size = 1,000,000 +
    Results are java.util.BitSet time divided by OpenBitSet time. + + + + + + + + + + +
    cardinality intersect_count union nextSetBit get iterator
    50% full 3.36 3.96 1.44 1.46 1.99 1.58
    1% full 3.31 3.90   1.04   0.99
    +
    + Test system: AMD Opteron, 64 bit linux, Sun Java 1.5_06 -server -Xbatch -Xmx64M +
    BitSet size = 1,000,000 +
    Results are java.util.BitSet time divided by OpenBitSet time. + + + + + + + + + + +
    cardinality intersect_count union nextSetBit get iterator
    50% full 2.50 3.50 1.00 1.03 1.12 1.25
    1% full 2.51 3.49   1.00   1.02
    +     + $Id$ + +     + + Constructs an OpenBitSet large enough to hold numBits. + + + + + + + Constructs an OpenBitSet from an existing long[]. +
    + The first 64 bits are in long[0], + with bit index 0 at the least significant bit, and bit index 63 at the most significant. + Given a bit index, + the word containing it is long[index/64], and it is at bit number index%64 within that word. +

    + numWords are the number of elements in the array that contain + set bits (non-zero longs). + numWords should be <= bits.length, and + any existing words in the array at position >= numWords should be zero. + +

    +     + + This DocIdSet implementation is cacheable. + + + Returns the current capacity in bits (1 greater than the index of the last bit) + + + Returns the current capacity of this set. Included for + compatibility. This is *not* equal to {@link #cardinality} + + + + Returns true if there are no set bits + + + Expert: returns the long[] storing the bits + + + Expert: sets a new long[] to use as the bit storage + + + Expert: gets the number of longs in the array that are in use + + + Expert: sets the number of longs in the array that are in use + + + Returns true or false for the specified bit index. + + + Returns true or false for the specified bit index. + The index should be less than the OpenBitSet size + + + + Returns true or false for the specified bit index + + + Returns true or false for the specified bit index. + The index should be less than the OpenBitSet size. + + + + returns 1 if the bit is set, 0 if not. + The index should be less than the OpenBitSet size + + + + sets a bit, expanding the set size if necessary + + + Sets the bit at the specified index. + The index should be less than the OpenBitSet size. + + + + Sets the bit at the specified index. + The index should be less than the OpenBitSet size. + + + + Sets a range of bits, expanding the set size if necessary + + + lower index + + one-past the last bit to set + + + + clears a bit. + The index should be less than the OpenBitSet size. + + + + clears a bit. + The index should be less than the OpenBitSet size. + + + + clears a bit, allowing access beyond the current set size without changing the size. + + + Clears a range of bits. Clearing past the end does not change the size of the set. + + + lower index + + one-past the last bit to clear + + + + Clears a range of bits. Clearing past the end does not change the size of the set. + + + lower index + + one-past the last bit to clear + + + + Sets a bit and returns the previous value. + The index should be less than the OpenBitSet size. + + + + Sets a bit and returns the previous value. + The index should be less than the OpenBitSet size. + + + + flips a bit. + The index should be less than the OpenBitSet size. + + + + flips a bit. + The index should be less than the OpenBitSet size. + + + + flips a bit, expanding the set size if necessary + + + flips a bit and returns the resulting bit value. + The index should be less than the OpenBitSet size. + + + + flips a bit and returns the resulting bit value. + The index should be less than the OpenBitSet size. + + + + Flips a range of bits, expanding the set size if necessary + + + lower index + + one-past the last bit to flip + + + + the number of set bits + + + + Returns the popcount or cardinality of the intersection of the two sets. + Neither set is modified. + + + + Returns the popcount or cardinality of the union of the two sets. + Neither set is modified. + + + + Returns the popcount or cardinality of "a and not b" + or "intersection(a, not(b))". + Neither set is modified. + + + + Returns the popcount or cardinality of the exclusive-or of the two sets. + Neither set is modified. + + + + Returns the index of the first set bit starting at the index specified. + -1 is returned if there are no more set bits. + + + + Returns the index of the first set bit starting at the index specified. + -1 is returned if there are no more set bits. + + + + this = this AND other + + + this = this OR other + + + Remove all elements set in other. this = this AND_NOT other + + + this = this XOR other + + + returns true if the sets have any elements in common + + + Expand the long[] with the size given as a number of words (64 bit longs). + getNumWords() is unchanged by this call. + + + + Ensure that the long[] is big enough to hold numBits, expanding it if necessary. + getNumWords() is unchanged by this call. + + + + Lowers numWords, the number of words in use, + by checking for trailing zero words. + + + + returns the number of 64 bit words it would take to hold numBits + + + returns true if both sets have the same bits set + + + Construct an OpenBitSetDISI with its bits set + from the doc ids of the given DocIdSetIterator. + Also give a maximum size one larger than the largest doc id for which a + bit may ever be set on this OpenBitSetDISI. + + + + Construct an OpenBitSetDISI with no bits set, and a given maximum size + one larger than the largest doc id for which a bit may ever be set + on this OpenBitSetDISI. + + + + Perform an inplace OR with the doc ids from a given DocIdSetIterator, + setting the bit for each such doc id. + These doc ids should be smaller than the maximum size passed to the + constructor. + + + + Perform an inplace AND with the doc ids from a given DocIdSetIterator, + leaving only the bits set for which the doc ids are in common. + These doc ids should be smaller than the maximum size passed to the + constructor. + + + + Perform an inplace NOT with the doc ids from a given DocIdSetIterator, + clearing all the bits for each such doc id. + These doc ids should be smaller than the maximum size passed to the + constructor. + + + + Perform an inplace XOR with the doc ids from a given DocIdSetIterator, + flipping all the bits for each such doc id. + These doc ids should be smaller than the maximum size passed to the + constructor. + + + + Provides methods for sanity checking that entries in the FieldCache + are not wasteful or inconsistent. +

    +

    + Lucene 2.9 Introduced numerous enhancements into how the FieldCache + is used by the low levels of Lucene searching (for Sorting and + ValueSourceQueries) to improve both the speed for Sorting, as well + as reopening of IndexReaders. But these changes have shifted the + usage of FieldCache from "top level" IndexReaders (frequently a + MultiReader or DirectoryReader) down to the leaf level SegmentReaders. + As a result, existing applications that directly access the FieldCache + may find RAM usage increase significantly when upgrading to 2.9 or + Later. This class provides an API for these applications (or their + Unit tests) to check at run time if the FieldCache contains "insane" + usages of the FieldCache. +

    +

    + EXPERIMENTAL API: This API is considered extremely advanced and + experimental. It may be removed or altered w/o warning in future releases + of Lucene. +

    +

    + + + + + + +     + + If set, will be used to estimate size for all CacheEntry objects + dealt with. + + + + Quick and dirty convenience method + + + + + Quick and dirty convenience method that instantiates an instance with + "good defaults" and uses it to test the CacheEntry[] + + + + + + Tests a CacheEntry[] for indication of "insane" cache usage. +

    + NOTE:FieldCache CreationPlaceholder objects are ignored. + (:TODO: is this a bad idea? are we masking a real problem?) +

    +

    +     + + Internal helper method used by check that iterates over + valMismatchKeys and generates a Collection of Insanity + instances accordingly. The MapOfSets are used to populate + the Insantiy objects. + + + + + + Internal helper method used by check that iterates over + the keys of readerFieldToValIds and generates a Collection + of Insanity instances whenever two (or more) ReaderField instances are + found that have an ancestery relationships. + + + + + + + Checks if the seed is an IndexReader, and if so will walk + the hierarchy of subReaders building up a list of the objects + returned by obj.getFieldCacheKey() + + + + Simple pair object for using "readerKey + fieldName" a Map key + + + Simple container for a collection of related CacheEntry objects that + in conjunction with eachother represent some "insane" usage of the + FieldCache. + + + + Type of insane behavior this object represents + + + Description of hte insane behavior + + + CacheEntry objects which suggest a problem + + + Multi-Line representation of this Insanity object, starting with + the Type and Msg, followed by each CacheEntry.toString() on it's + own line prefaced by a tab character + + + + An Enumaration of the differnet types of "insane" behavior that + may be detected in a FieldCache. + + + + + + + + + + + Indicates an overlap in cache usage on a given field + in sub/super readers. + + + +

    + Indicates entries have the same reader+fieldname but + different cached values. This can happen if different datatypes, + or parsers are used -- and while it's not necessarily a bug + it's typically an indication of a possible problem. +

    +

    + PNOTE: Only the reader, fieldname, and cached value are actually + tested -- if two cache entries have different parsers or datatypes but + the cached values are the same Object (== not just equal()) this method + does not consider that a red flag. This allows for subtle variations + in the way a Parser is specified (null vs DEFAULT_LONG_PARSER, etc...) +

    +

    +     + + Indicates an expected bit of "insanity". This may be useful for + clients that wish to preserve/log information about insane usage + but indicate that it was expected. + + + + Subclass of FilteredTermEnum for enumerating all terms that match the + specified range parameters. +

    + Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. +

    + 2.9 + +     + + Enumerates all terms greater/equal than lowerTerm + but less/equal than upperTerm. + + If an endpoint is null, it is said to be "open". Either or both + endpoints may be open. Open endpoints may not be exclusive + (you can't select all but the first or last term without + explicitly specifying the term to exclude.) + + + + + An interned field that holds both lower and upper terms. + + The term text at the lower end of the range + + The term text at the upper end of the range + + If true, the lowerTerm is included in the range. + + If true, the upperTerm is included in the range. + + The collator to use to collate index Terms, to determine their + membership in the range bounded by lowerTerm and + upperTerm. + + + IOException + + + Matches the union of its clauses. + + + Construct a SpanOrQuery merging the provided clauses. + + + Return the clauses whose spans are matched. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + +

    A {@link Query} that matches numeric values within a + specified range. To use this, you must first index the + numeric values using {@link NumericField} (expert: {@link + NumericTokenStream}). If your terms are instead textual, + you should use {@link TermRangeQuery}. {@link + NumericRangeFilter} is the filter equivalent of this + query.

    + +

    You create a new NumericRangeQuery with the static + factory methods, eg: + + 

    +            Query q = NumericRangeQuery.newFloatRange("weight",
+            new Float(0.3f), new Float(0.10f),
+            true, true);
+
    + + matches all documents whose float valued "weight" field + ranges from 0.3 to 0.10, inclusive. + +

    The performance of NumericRangeQuery is much better + than the corresponding {@link TermRangeQuery} because the + number of terms that must be searched is usually far + fewer, thanks to trie indexing, described below.

    + +

    You can optionally specify a precisionStep + when creating this query. This is necessary if you've + changed this configuration from its default (4) during + indexing. Lower values consume more disk space but speed + up searching. Suitable values are between 1 and + 8. A good starting point to test is 4, + which is the default value for all Numeric* + classes. See below for + details. + +

    This query defaults to {@linkplain + MultiTermQuery#CONSTANT_SCORE_AUTO_REWRITE_DEFAULT} for + 32 bit (int/float) ranges with precisionStep <8 and 64 + bit (long/double) ranges with precisionStep <6. + Otherwise it uses {@linkplain + MultiTermQuery#CONSTANT_SCORE_FILTER_REWRITE} as the + number of terms is likely to be high. With precision + steps of <4, this query can be run with one of the + BooleanQuery rewrite methods without changing + BooleanQuery's default max clause count. + +

    NOTE: This API is experimental and + might change in incompatible ways in the next release. + +

    How it works

    + +

    See the publication about panFMP, + where this algorithm was described (referred to as TrieRangeQuery): + +

    Schindler, U, Diepenbroek, M, 2008. + Generic XML-based Framework for Metadata Portals. + Computers & Geosciences 34 (12), 1947-1955. + doi:10.1016/j.cageo.2008.02.023
    + +

    A quote from this paper: Because Apache Lucene is a full-text + search engine and not a conventional database, it cannot handle numerical ranges + (e.g., field value is inside user defined bounds, even dates are numerical values). + We have developed an extension to Apache Lucene that stores + the numerical values in a special string-encoded format with variable precision + (all numerical values like doubles, longs, floats, and ints are converted to + lexicographic sortable string representations and stored with different precisions + (for a more detailed description of how the values are stored, + see {@link NumericUtils}). A range is then divided recursively into multiple intervals for searching: + The center of the range is searched only with the lowest possible precision in the trie, + while the boundaries are matched more exactly. This reduces the number of terms dramatically.

    + +

    For the variant that stores long values in 8 different precisions (each reduced by 8 bits) that + uses a lowest precision of 1 byte, the index contains only a maximum of 256 distinct values in the + lowest precision. Overall, a range could consist of a theoretical maximum of + 7*255*2 + 255 = 3825 distinct terms (when there is a term for every distinct value of an + 8-byte-number in the index and the range covers almost all of them; a maximum of 255 distinct values is used + because it would always be possible to reduce the full 256 values to one term with degraded precision). + In practice, we have seen up to 300 terms in most cases (index with 500,000 metadata records + and a uniform value distribution).

    + +

    Precision Step

    +

    You can choose any precisionStep when encoding values. + Lower step values mean more precisions and so more terms in index (and index gets larger). + On the other hand, the maximum number of terms to match reduces, which optimized query speed. + The formula to calculate the maximum term count is: + 

    +            n = [ (bitsPerValue/precisionStep - 1) * (2^precisionStep - 1 ) * 2 ] + (2^precisionStep - 1 )
+
    +

    (this formula is only correct, when bitsPerValue/precisionStep is an integer; + in other cases, the value must be rounded up and the last summand must contain the modulo of the division as + precision step). + For longs stored using a precision step of 4, n = 15*15*2 + 15 = 465, and for a precision + step of 2, n = 31*3*2 + 3 = 189. But the faster search speed is reduced by more seeking + in the term enum of the index. Because of this, the ideal precisionStep value can only + be found out by testing. Important: You can index with a lower precision step value and test search speed + using a multiple of the original step value.

    + +

    Good values for precisionStep are depending on usage and data type: +

      +
    • The default for all data types is 4, which is used, when no precisionStep is given.
      • +
    • Ideal value in most cases for 64 bit data types (long, double) is 6 or 8.
      • +
    • Ideal value in most cases for 32 bit data types (int, float) is 4.
      • +
    • Steps >64 for long/double and >32 for int/float produces one token + per value in the index and querying is as slow as a conventional {@link TermRangeQuery}. But it can be used + to produce fields, that are solely used for sorting (in this case simply use {@link Integer#MAX_VALUE} as + precisionStep). Using {@link NumericField NumericFields} for sorting + is ideal, because building the field cache is much faster than with text-only numbers. + Sorting is also possible with range query optimized fields using one of the above precisionSteps.
      • +
    + +

    Comparisons of the different types of RangeQueries on an index with about 500,000 docs showed + that {@link TermRangeQuery} in boolean rewrite mode (with raised {@link BooleanQuery} clause count) + took about 30-40 secs to complete, {@link TermRangeQuery} in constant score filter rewrite mode took 5 secs + and executing this class took <100ms to complete (on an Opteron64 machine, Java 1.5, 8 bit + precision step). This query type was developed for a geographic portal, where the performance for + e.g. bounding boxes or exact date/time stamps is important.

    + +

    + 2.9 + + +     + + Factory that creates a NumericRangeQuery, that queries a long + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a long + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a int + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a int + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a double + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a double + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a float + range using the given precisionStep. + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Factory that creates a NumericRangeQuery, that queries a float + range using the default precisionStep {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). + You can have half-open ranges (which are in fact </≤ or >/≥ queries) + by setting the min or max value to null. By setting inclusive to false, it will + match all documents excluding the bounds, with inclusive on, the boundaries are hits, too. + + + + Returns the field name for this query + + + Returns true if the lower endpoint is inclusive + + + Returns true if the upper endpoint is inclusive + + + Returns the lower value of this range query + + + Returns the upper value of this range query + + + + Lucene.Net specific. Needed for Serialization + + + + + + + Lucene.Net specific. Needed for deserialization + + + + + + Subclass of FilteredTermEnum for enumerating all terms that match the + sub-ranges for trie range queries. +

    + WARNING: This term enumeration is not guaranteed to be always ordered by + {@link Term#compareTo}. + The ordering depends on how {@link NumericUtils#splitLongRange} and + {@link NumericUtils#splitIntRange} generates the sub-ranges. For + {@link MultiTermQuery} ordering is not relevant. +

    +     + + this is a dummy, it is not used by this class. + + + Compares if current upper bound is reached, + this also updates the term count for statistics. + In contrast to {@link FilteredTermEnum}, a return value + of false ends iterating the current enum + and forwards to the next sub-range. + + + + Increments the enumeration to the next element. True if one exists. + + + Closes the enumeration to further activity, freeing resources. + + + Expert: Callback for {@link #splitLongRange}. + You need to overwrite only one of the methods. +

    NOTE: This is a very low-level interface, + the method signatures may change in later versions. +

    +     + + This is a helper class to generate prefix-encoded representations for numerical values + and supplies converters to represent float/double values as sortable integers/longs. + +

    To quickly execute range queries in Apache Lucene, a range is divided recursively + into multiple intervals for searching: The center of the range is searched only with + the lowest possible precision in the trie, while the boundaries are matched + more exactly. This reduces the number of terms dramatically. + +

    This class generates terms to achive this: First the numerical integer values need to + be converted to strings. For that integer values (32 bit or 64 bit) are made unsigned + and the bits are converted to ASCII chars with each 7 bit. The resulting string is + sortable like the original integer value. Each value is also prefixed + (in the first char) by the shift value (number of bits removed) used + during encoding. + +

    To also index floating point numbers, this class supplies two methods to convert them + to integer values by changing their bit layout: {@link #doubleToSortableLong}, + {@link #floatToSortableInt}. You will have no precision loss by + converting floating point numbers to integers and back (only that the integer form + is not usable). Other data types like dates can easily converted to longs or ints (e.g. + date to long: {@link java.util.Date#getTime}). + +

    For easy usage, the trie algorithm is implemented for indexing inside + {@link NumericTokenStream} that can index int, long, + float, and double. For querying, + {@link NumericRangeQuery} and {@link NumericRangeFilter} implement the query part + for the same data types. + +

    This class can also be used, to generate lexicographically sortable (according + {@link String#compareTo(String)}) representations of numeric data types for other + usages (e.g. sorting). + +

    NOTE: This API is experimental and + might change in incompatible ways in the next release. + +

    + 2.9 + +     + + The default precision step used by {@link NumericField}, {@link NumericTokenStream}, + {@link NumericRangeQuery}, and {@link NumericRangeFilter} as default + + + + Expert: The maximum term length (used for char[] buffer size) + for encoding long values. + + + + + + Expert: The maximum term length (used for char[] buffer size) + for encoding int values. + + + + + + Expert: Longs are stored at lower precision by shifting off lower bits. The shift count is + stored as SHIFT_START_LONG+shift in the first character + + + + Expert: Integers are stored at lower precision by shifting off lower bits. The shift count is + stored as SHIFT_START_INT+shift in the first character + + + + Expert: Returns prefix coded bits after reducing the precision by shift bits. + This is method is used by {@link NumericTokenStream}. + + the numeric value + + how many bits to strip from the right + + that will contain the encoded chars, must be at least of {@link #BUF_SIZE_LONG} + length + + number of chars written to buffer + + + + Expert: Returns prefix coded bits after reducing the precision by shift bits. + This is method is used by {@link LongRangeBuilder}. + + the numeric value + + how many bits to strip from the right + + + + This is a convenience method, that returns prefix coded bits of a long without + reducing the precision. It can be used to store the full precision value as a + stored field in index. +

    To decode, use {@link #prefixCodedToLong}. +

    +     + + Expert: Returns prefix coded bits after reducing the precision by shift bits. + This is method is used by {@link NumericTokenStream}. + + the numeric value + + how many bits to strip from the right + + that will contain the encoded chars, must be at least of {@link #BUF_SIZE_INT} + length + + number of chars written to buffer + + + + Expert: Returns prefix coded bits after reducing the precision by shift bits. + This is method is used by {@link IntRangeBuilder}. + + the numeric value + + how many bits to strip from the right + + + + This is a convenience method, that returns prefix coded bits of an int without + reducing the precision. It can be used to store the full precision value as a + stored field in index. +

    To decode, use {@link #prefixCodedToInt}. +

    +     + + Returns a long from prefixCoded characters. + Rightmost bits will be zero for lower precision codes. + This method can be used to decode e.g. a stored field. + + NumberFormatException if the supplied string is + not correctly prefix encoded. + + + + + + Returns an int from prefixCoded characters. + Rightmost bits will be zero for lower precision codes. + This method can be used to decode e.g. a stored field. + + NumberFormatException if the supplied string is + not correctly prefix encoded. + + + + + + Converts a double value to a sortable signed long. + The value is converted by getting their IEEE 754 floating-point "double format" + bit layout and then some bits are swapped, to be able to compare the result as long. + By this the precision is not reduced, but the value can easily used as a long. + + + + + + Convenience method: this just returns: + longToPrefixCoded(doubleToSortableLong(val)) + + + + Converts a sortable long back to a double. + + + + + Convenience method: this just returns: + sortableLongToDouble(prefixCodedToLong(val)) + + + + Converts a float value to a sortable signed int. + The value is converted by getting their IEEE 754 floating-point "float format" + bit layout and then some bits are swapped, to be able to compare the result as int. + By this the precision is not reduced, but the value can easily used as an int. + + + + + + Convenience method: this just returns: + intToPrefixCoded(floatToSortableInt(val)) + + + + Converts a sortable int back to a float. + + + + + Convenience method: this just returns: + sortableIntToFloat(prefixCodedToInt(val)) + + + + Expert: Splits a long range recursively. + You may implement a builder that adds clauses to a + {@link Lucene.Net.Search.BooleanQuery} for each call to its + {@link LongRangeBuilder#AddRange(String,String)} + method. +

    This method is used by {@link NumericRangeQuery}. +

    +     + + Expert: Splits an int range recursively. + You may implement a builder that adds clauses to a + {@link Lucene.Net.Search.BooleanQuery} for each call to its + {@link IntRangeBuilder#AddRange(String,String)} + method. +

    This method is used by {@link NumericRangeQuery}. +

    +     + + This helper does the splitting for both 32 and 64 bit. + + + Helper that delegates to correct range builder + + + Expert: Callback for {@link #splitLongRange}. + You need to overwrite only one of the methods. +

    NOTE: This is a very low-level interface, + the method signatures may change in later versions. +

    +     + + Overwrite this method, if you like to receive the already prefix encoded range bounds. + You can directly build classical (inclusive) range queries from them. + + + + Overwrite this method, if you like to receive the raw long range bounds. + You can use this for e.g. debugging purposes (print out range bounds). + + + + Expert: Callback for {@link #splitIntRange}. + You need to overwrite only one of the methods. +

    NOTE: This is a very low-level interface, + the method signatures may change in later versions. +

    +     + + Overwrite this method, if you like to receive the already prefix encoded range bounds. + You can directly build classical range (inclusive) queries from them. + + + + Overwrite this method, if you like to receive the raw int range bounds. + You can use this for e.g. debugging purposes (print out range bounds). + + + + Subclass of FilteredTermEnum for enumerating all terms that are similiar + to the specified filter term. + +

    Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. +

    +     + + Creates a FuzzyTermEnum with an empty prefix and a minSimilarity of 0.5f. +

    + After calling the constructor the enumeration is already pointing to the first + valid term if such a term exists. + +

    + + + + + IOException + + +     + + Creates a FuzzyTermEnum with an empty prefix. +

    + After calling the constructor the enumeration is already pointing to the first + valid term if such a term exists. + +

    + + + + + + + IOException + + +     + + Constructor for enumeration of all terms from specified reader which share a prefix of + length prefixLength with term and which have a fuzzy similarity > + minSimilarity. +

    + After calling the constructor the enumeration is already pointing to the first + valid term if such a term exists. + +

    + Delivers terms. + + Pattern term. + + Minimum required similarity for terms from the reader. Default value is 0.5f. + + Length of required common prefix. Default value is 0. + + IOException +     + + The termCompare method in FuzzyTermEnum uses Levenshtein distance to + calculate the distance between the given term and the comparing term. + + + + Finds and returns the smallest of three integers + + +

    Similarity returns a number that is 1.0f or less (including negative numbers) + based on how similar the Term is compared to a target term. It returns + exactly 0.0f when + 

    +            editDistance < maximumEditDistance
    + Otherwise it returns: + 
    +            1 - (editDistance / length)
    + where length is the length of the shortest term (text or target) including a + prefix that are identical and editDistance is the Levenshtein distance for + the two words.

    + +

    Embedded within this algorithm is a fail-fast Levenshtein distance + algorithm. The fail-fast algorithm differs from the standard Levenshtein + distance algorithm in that it is aborted if it is discovered that the + mimimum distance between the words is greater than some threshold. + +

    To calculate the maximum distance threshold we use the following formula: + 

    +            (1 - minimumSimilarity) * length
    + where length is the shortest term including any prefix that is not part of the + similarity comparision. This formula was derived by solving for what maximum value + of distance returns false for the following statements: + 
    +            similarity = 1 - ((float)distance / (float) (prefixLength + Math.min(textlen, targetlen)));
+            return (similarity > minimumSimilarity);
    + where distance is the Levenshtein distance for the two words. +

    +

    Levenshtein distance (also known as edit distance) is a measure of similiarity + between two strings where the distance is measured as the number of character + deletions, insertions or substitutions required to transform one string to + the other string. +

    + the target word or phrase + + the similarity, 0.0 or less indicates that it matches less than the required + threshold and 1.0 indicates that the text and target are identical + +     + + Grow the second dimension of the array, so that we can calculate the + Levenshtein difference. + + + + The max Distance is the maximum Levenshtein distance for the text + compared to some other value that results in score that is + better than the minimum similarity. + + the length of the "other value" + + the maximum levenshtein distance that we care about + + + + Abstract decorator class for a DocIdSet implementation + that provides on-demand filtering/validation + mechanism on a given DocIdSet. + +

    + + Technically, this same functionality could be achieved + with ChainedFilter (under contrib/misc), however the + benefit of this class is it never materializes the full + bitset for the filter. Instead, the {@link #match} + method is invoked on-demand, per docID visited during + searching. If you know few docIDs will be visited, and + the logic behind {@link #match} is relatively costly, + this may be a better way to filter than ChainedFilter. + +

    + + +     + + Constructor. + Underlying DocIdSet + + + + This DocIdSet implementation is cacheable if the inner set is cacheable. + + + Validation method to determine whether a docid should be in the result set. + docid to be tested + + true if input docid should be in the result set, false otherwise. + + + + Implementation of the contract to build a DocIdSetIterator. + + + + + + + This interface is obsolete, use {@link FieldCache} instead. + + + Use {@link FieldCache}, this will be removed in Lucene 3.0 + + + + + Use {@link FieldCache#DEFAULT}; this will be removed in Lucene 3.0 + + + + Use {@link FieldCache.LongParser}, this will be removed in Lucene 3.0 + + + + Use {@link FieldCache.DoubleParser}, this will be removed in Lucene 3.0 + + + + Provides access to stored term vector of + a document field. The vector consists of the name of the field, an array of the terms tha occur in the field of the + {@link Lucene.Net.Documents.Document} and a parallel array of frequencies. Thus, getTermFrequencies()[5] corresponds with the + frequency of getTerms()[5], assuming there are at least 5 terms in the Document. + + + + The {@link Lucene.Net.Documents.Fieldable} name. + The name of the field this vector is associated with. + + + + + The number of terms in the term vector. + + + + An Array of term texts in ascending order. + + + + Array of term frequencies. Locations of the array correspond one to one + to the terms in the array obtained from getTerms + method. Each location in the array contains the number of times this + term occurs in the document or the document field. + + + + Return an index in the term numbers array returned from + getTerms at which the term with the specified + term appears. If this term does not appear in the array, + return -1. + + + + Just like indexOf(int) but searches for a number of terms + at the same time. Returns an array that has the same size as the number + of terms searched for, each slot containing the result of searching for + that term number. + + + array containing terms to look for + + index in the array where the list of terms starts + + the number of terms in the list + + + + + The number of the field this vector is associated with + + + + Extends TermFreqVector to provide additional information about + positions in which each of the terms is found. A TermPositionVector not necessarily + contains both positions and offsets, but at least one of these arrays exists. + + + + Returns an array of positions in which the term is found. + Terms are identified by the index at which its number appears in the + term String array obtained from the indexOf method. + May return null if positions have not been stored. + + + + Returns an array of TermVectorOffsetInfo in which the term is found. + May return null if offsets have not been stored. + + + + + + The position in the array to get the offsets from + + An array of TermVectorOffsetInfo objects or the empty list + + + + Returns an array of TermVectorOffsetInfo in which the term is found. + + + The position in the array to get the offsets from + + An array of TermVectorOffsetInfo objects or the empty list + + + + + + Returns an array of positions in which the term is found. + Terms are identified by the index at which its number appears in the + term String array obtained from the indexOf method. + + + + An IndexReader which reads indexes with multiple segments. + + + Construct reading the named set of readers. + + + This constructor is only used for {@link #Reopen()} + + + Version number when this IndexReader was opened. + + + Checks is the index is optimized (if it has a single segment and no deletions) + true if the index is optimized; false otherwise + + + + Tries to acquire the WriteLock on this directory. this method is only valid if this IndexReader is directory + owner. + + + StaleReaderException if the index has changed since this reader was opened + CorruptIndexException if the index is corrupt + Lucene.Net.Store.LockObtainFailedException + if another writer has this index open (write.lock could not be + obtained) + + IOException if there is a low-level IO error + + + + + + + Commit changes resulting from delete, undeleteAll, or setNorm operations +

    + If an exception is hit, then either no changes or all changes will have been committed to the index (transactional + semantics). + +

    + IOException if there is a low-level IO error +     + + Returns the directory this index resides in. + + + Expert: return the IndexCommit that this reader has opened. +

    +

    WARNING: this API is new and experimental and may suddenly change.

    +

    +     + + + + + + Optimized implementation. + + + An IndexReader which reads multiple, parallel indexes. Each index added + must have the same number of documents, but typically each contains + different fields. Each document contains the union of the fields of all + documents with the same document number. When searching, matches for a + query term are from the first index added that has the field. + +

    This is useful, e.g., with collections that have large fields which + change rarely and small fields that change more frequently. The smaller + fields may be re-indexed in a new index and both indexes may be searched + together. + +

    Warning: It is up to you to make sure all indexes + are created and modified the same way. For example, if you add + documents to one index, you need to add the same documents in the + same order to the other indexes. Failure to do so will result in + undefined behavior. +

    +     + + Construct a ParallelReader. +

    Note that all subreaders are closed if this ParallelReader is closed.

    +

    +     + + Construct a ParallelReader. + indicates whether the subreaders should be closed + when this ParallelReader is closed + + + + Add an IndexReader. + IOException if there is a low-level IO error + + + Add an IndexReader whose stored fields will not be returned. This can + accellerate search when stored fields are only needed from a subset of + the IndexReaders. + + + IllegalArgumentException if not all indexes contain the same number + of documents + + IllegalArgumentException if not all indexes have the same value + of {@link IndexReader#MaxDoc()} + + IOException if there is a low-level IO error + + + Tries to reopen the subreaders. +
    + If one or more subreaders could be re-opened (i. e. subReader.reopen() + returned a new instance != subReader), then a new ParallelReader instance + is returned, otherwise this instance is returned. +

    + A re-opened instance might share one or more subreaders with the old + instance. Index modification operations result in undefined behavior + when performed before the old instance is closed. + (see {@link IndexReader#Reopen()}). +

    + If subreaders are shared, then the reference count of those + readers is increased to ensure that the subreaders remain open + until the last referring reader is closed. + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Checks recursively if all subreaders are up to date. + + + Checks recursively if all subindexes are optimized + + + Not implemented. + UnsupportedOperationException + + + + + + + An IndexWriter creates and maintains an index. +

    The create argument to the {@link + #IndexWriter(Directory, Analyzer, boolean) constructor} determines + whether a new index is created, or whether an existing index is + opened. Note that you can open an index with create=true + even while readers are using the index. The old readers will + continue to search the "point in time" snapshot they had opened, + and won't see the newly created index until they re-open. There are + also {@link #IndexWriter(Directory, Analyzer) constructors} + with no create argument which will create a new index + if there is not already an index at the provided path and otherwise + open the existing index.

    +

    In either case, documents are added with {@link #AddDocument(Document) + addDocument} and removed with {@link #DeleteDocuments(Term)} or {@link + #DeleteDocuments(Query)}. A document can be updated with {@link + #UpdateDocument(Term, Document) updateDocument} (which just deletes + and then adds the entire document). When finished adding, deleting + and updating documents, {@link #Close() close} should be called.

    + +

    These changes are buffered in memory and periodically + flushed to the {@link Directory} (during the above method + calls). A flush is triggered when there are enough + buffered deletes (see {@link #setMaxBufferedDeleteTerms}) + or enough added documents since the last flush, whichever + is sooner. For the added documents, flushing is triggered + either by RAM usage of the documents (see {@link + #setRAMBufferSizeMB}) or the number of added documents. + The default is to flush when RAM usage hits 16 MB. For + best indexing speed you should flush by RAM usage with a + large RAM buffer. Note that flushing just moves the + internal buffered state in IndexWriter into the index, but + these changes are not visible to IndexReader until either + {@link #Commit()} or {@link #close} is called. A flush may + also trigger one or more segment merges which by default + run with a background thread so as not to block the + addDocument calls (see below + for changing the {@link MergeScheduler}).

    + +

    The optional autoCommit argument to the {@link + #IndexWriter(Directory, boolean, Analyzer) constructors} + controls visibility of the changes to {@link IndexReader} + instances reading the same index. When this is + false, changes are not visible until {@link + #Close()} or {@link #Commit()} is called. Note that changes will still be + flushed to the {@link Directory} as new files, but are + not committed (no new segments_N file is written + referencing the new files, nor are the files sync'd to stable storage) + until {@link #Close()} or {@link #Commit()} is called. If something + goes terribly wrong (for example the JVM crashes), then + the index will reflect none of the changes made since the + last commit, or the starting state if commit was not called. + You can also call {@link #Rollback()}, which closes the writer + without committing any changes, and removes any index + files that had been flushed but are now unreferenced. + This mode is useful for preventing readers from refreshing + at a bad time (for example after you've done all your + deletes but before you've done your adds). It can also be + used to implement simple single-writer transactional + semantics ("all or none"). You can do a two-phase commit + by calling {@link #PrepareCommit()} + followed by {@link #Commit()}. This is necessary when + Lucene is working with an external resource (for example, + a database) and both must either commit or rollback the + transaction.

    +

    When autoCommit is true then + the writer will periodically commit on its own. [Deprecated: Note that in 3.0, IndexWriter will + no longer accept autoCommit=true (it will be hardwired to + false). You can always call {@link #Commit()} yourself + when needed]. There is + no guarantee when exactly an auto commit will occur (it + used to be after every flush, but it is now after every + completed merge, as of 2.4). If you want to force a + commit, call {@link #Commit()}, or, close the writer. Once + a commit has finished, newly opened {@link IndexReader} instances will + see the changes to the index as of that commit. When + running in this mode, be careful not to refresh your + readers while optimize or segment merges are taking place + as this can tie up substantial disk space.

    +

    +

    Regardless of autoCommit, an {@link + IndexReader} or {@link Lucene.Net.Search.IndexSearcher} will only see the + index as of the "point in time" that it was opened. Any + changes committed to the index after the reader was opened + are not visible until the reader is re-opened.

    +

    If an index will not have more documents added for a while and optimal search + performance is desired, then either the full {@link #Optimize() optimize} + method or partial {@link #Optimize(int)} method should be + called before the index is closed.

    +

    Opening an IndexWriter creates a lock file for the directory in use. Trying to open + another IndexWriter on the same directory will lead to a + {@link LockObtainFailedException}. The {@link LockObtainFailedException} + is also thrown if an IndexReader on the same directory is used to delete documents + from the index.

    +

    + +

    Expert: IndexWriter allows an optional + {@link IndexDeletionPolicy} implementation to be + specified. You can use this to control when prior commits + are deleted from the index. The default policy is {@link + KeepOnlyLastCommitDeletionPolicy} which removes all prior + commits as soon as a new commit is done (this matches + behavior before 2.2). Creating your own policy can allow + you to explicitly keep previous "point in time" commits + alive in the index for some time, to allow readers to + refresh to the new commit without having the old commit + deleted out from under them. This is necessary on + filesystems like NFS that do not support "delete on last + close" semantics, which Lucene's "point in time" search + normally relies on.

    +

    Expert: + IndexWriter allows you to separately change + the {@link MergePolicy} and the {@link MergeScheduler}. + The {@link MergePolicy} is invoked whenever there are + changes to the segments in the index. Its role is to + select which merges to do, if any, and return a {@link + MergePolicy.MergeSpecification} describing the merges. It + also selects merges to do for optimize(). (The default is + {@link LogByteSizeMergePolicy}. Then, the {@link + MergeScheduler} is invoked with the requested merges and + it decides when and how to run the merges. The default is + {@link ConcurrentMergeScheduler}.

    +

    NOTE: if you hit an + OutOfMemoryError then IndexWriter will quietly record this + fact and block all future segment commits. This is a + defensive measure in case any internal state (buffered + documents and deletions) were corrupted. Any subsequent + calls to {@link #Commit()} will throw an + IllegalStateException. The only course of action is to + call {@link #Close()}, which internally will call {@link + #Rollback()}, to undo any changes to the index since the + last commit. If you opened the writer with autoCommit + false you can also just call {@link #Rollback()} + directly.

    +

    NOTE: {@link + IndexWriter} instances are completely thread + safe, meaning multiple threads can call any of its + methods, concurrently. If your application requires + external synchronization, you should not + synchronize on the IndexWriter instance as + this may cause deadlock; use your own (non-Lucene) objects + instead.

    +

    +     + + Name of the write lock in the index. + + + Value to denote a flush trigger is disabled + + + Default value is 16 MB (which means flush when buffered + docs consume 16 MB RAM). Change using {@link #setRAMBufferSizeMB}. + + + + Default value is 10,000. Change using {@link #SetMaxFieldLength(int)}. + + + Default value is 128. Change using {@link #SetTermIndexInterval(int)}. + + + Default value for the write lock timeout (1,000). + + + + + + + + + + + Disabled by default (because IndexWriter flushes by RAM usage + by default). Change using {@link #SetMaxBufferedDocs(int)}. + + + + Disabled by default (because IndexWriter flushes by RAM usage + by default). Change using {@link #SetMaxBufferedDeleteTerms(int)}. + + + + + + + + + + Absolute hard maximum length for a term. If a term + arrives from the analyzer longer than this length, it + is skipped and a message is printed to infoStream, if + set (see {@link #setInfoStream}). + + + + Default for {@link #getMaxSyncPauseSeconds}. On + Windows this defaults to 10.0 seconds; elsewhere it's + 0. + + + + Expert: returns a readonly reader, covering all committed as well as + un-committed changes to the index. This provides "near real-time" + searching, in that changes made during an IndexWriter session can be + quickly made available for searching without closing the writer nor + calling {@link #commit}. + +

    + Note that this is functionally equivalent to calling {#commit} and then + using {@link IndexReader#open} to open a new reader. But the turarnound + time of this method should be faster since it avoids the potentially + costly {@link #commit}. +

    + + You must close the {@link IndexReader} returned by this method once you are done using it. + +

    + It's near real-time because there is no hard + guarantee on how quickly you can get a new reader after + making changes with IndexWriter. You'll have to + experiment in your situation to determine if it's + faster enough. As this is a new and experimental + feature, please report back on your findings so we can + learn, improve and iterate.

    + +

    The resulting reader suppports {@link + IndexReader#reopen}, but that call will simply forward + back to this method (though this may change in the + future).

    + +

    The very first time this method is called, this + writer instance will make every effort to pool the + readers that it opens for doing merges, applying + deletes, etc. This means additional resources (RAM, + file descriptors, CPU time) will be consumed.

    + +

    For lower latency on reopening a reader, you should call {@link #setMergedSegmentWarmer} + to call {@link #setMergedSegmentWarmer} to + pre-warm a newly merged segment before it's committed + to the index. This is important for minimizing index-to-search + delay after a large merge. + +

    If an addIndexes* call is running in another thread, + then this reader will only search those segments from + the foreign index that have been successfully copied + over, so far

    . + +

    NOTE: Once the writer is closed, any + outstanding readers may continue to be used. However, + if you attempt to reopen any of those readers, you'll + hit an {@link AlreadyClosedException}.

    + +

    NOTE: This API is experimental and might + change in incompatible ways in the next release.

    + +

    + IndexReader that covers entire index plus all + changes made so far by this IndexWriter instance + + + IOException +     + + Expert: like {@link #getReader}, except you can + specify which termInfosIndexDivisor should be used for + any newly opened readers. + + Subsambles which indexed + terms are loaded into RAM. This has the same effect as {@link + IndexWriter#setTermIndexInterval} except that setting + must be done at indexing time while this setting can be + set per reader. When set to N, then one in every + N*termIndexInterval terms in the index is loaded into + memory. By setting this to a value > 1 you can reduce + memory usage, at the expense of higher latency when + loading a TermInfo. The default value is 1. Set this + to -1 to skip loading the terms index entirely. + + + + Obtain the number of deleted docs for a pooled reader. + If the reader isn't being pooled, the segmentInfo's + delCount is returned. + + + + Used internally to throw an {@link + AlreadyClosedException} if this IndexWriter has been + closed. + + AlreadyClosedException if this IndexWriter is + + + Prints a message to the infoStream (if non-null), + prefixed with the identifying information for this + writer and the thread that's calling it. + + + + Casts current mergePolicy to LogMergePolicy, and throws + an exception if the mergePolicy is not a LogMergePolicy. + + + +

    Get the current setting of whether newly flushed + segments will use the compound file format. Note that + this just returns the value previously set with + setUseCompoundFile(boolean), or the default value + (true). You cannot use this to query the status of + previously flushed segments.

    + +

    Note that this method is a convenience method: it + just calls mergePolicy.getUseCompoundFile as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    + +

    + + +     + +

    Setting to turn on usage of a compound file. When on, + multiple files for each segment are merged into a + single file when a new segment is flushed.

    + +

    Note that this method is a convenience method: it + just calls mergePolicy.setUseCompoundFile as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    +

    +     + + Expert: Set the Similarity implementation used by this IndexWriter. + + + + + + + Expert: Return the Similarity implementation used by this IndexWriter. + +

    This defaults to the current value of {@link Similarity#GetDefault()}. +

    +     + + Expert: Set the interval between indexed terms. Large values cause less + memory to be used by IndexReader, but slow random-access to terms. Small + values cause more memory to be used by an IndexReader, and speed + random-access to terms. + + This parameter determines the amount of computation required per query + term, regardless of the number of documents that contain that term. In + particular, it is the maximum number of other terms that must be + scanned before a term is located and its frequency and position information + may be processed. In a large index with user-entered query terms, query + processing time is likely to be dominated not by term lookup but rather + by the processing of frequency and positional data. In a small index + or when many uncommon query terms are generated (e.g., by wildcard + queries) term lookup may become a dominant cost. + + In particular, numUniqueTerms/interval terms are read into + memory by an IndexReader, and, on average, interval/2 terms + must be scanned for each random term access. + + + + + + + Expert: Return the interval between indexed terms. + + + + + + + Constructs an IndexWriter for the index in path. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + path, replacing the index already there, + if any. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the path to the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + Maximum field length in number of tokens/terms: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + Use {@link #IndexWriter(Directory, Analyzer, + boolean, MaxFieldLength)} + +     + + Constructs an IndexWriter for the index in path. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + path, replacing the index already there, if any. + + + the path to the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,boolean,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Constructs an IndexWriter for the index in path. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + path, replacing the index already there, if any. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the path to the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + Maximum field length in number of terms/tokens: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + Use {@link #IndexWriter(Directory, + Analyzer, boolean, MaxFieldLength)} + +     + + Constructs an IndexWriter for the index in path. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + path, replacing the index already there, if any. + + + the path to the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,boolean,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Constructs an IndexWriter for the index in d. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + d, replacing the index already there, if any. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + Maximum field length in number of terms/tokens: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + +     + + Constructs an IndexWriter for the index in d. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + d, replacing the index already there, if any. + + + the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 + release, and call {@link #Commit()} when needed. + Use {@link #IndexWriter(Directory,Analyzer,boolean,MaxFieldLength)} instead. + + + + Constructs an IndexWriter for the index in + path, first creating it if it does not + already exist. Text will be analyzed with + a. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the path to the index directory + + the analyzer to use + + Maximum field length in number of terms/tokens: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + Use {@link #IndexWriter(Directory, Analyzer, MaxFieldLength)} + +     + + Constructs an IndexWriter for the index in + path, first creating it if it does not + already exist. Text will be analyzed with + a. + + + the path to the index directory + + the analyzer to use + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 + release, and call {@link #Commit()} when needed. + Use {@link #IndexWriter(Directory,Analyzer,MaxFieldLength)} instead. + + + + Constructs an IndexWriter for the index in + path, first creating it if it does not + already exist. Text will be analyzed with + a. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the path to the index directory + + the analyzer to use + + Maximum field length in number of terms/tokens: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + Use {@link #IndexWriter(Directory, + Analyzer, MaxFieldLength)} + +     + + Constructs an IndexWriter for the index in + path, first creating it if it does not + already exist. Text will be analyzed with + a. + + + the path to the index directory + + the analyzer to use + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link #IndexWriter(Directory,Analyzer,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Constructs an IndexWriter for the index in + d, first creating it if it does not + already exist. Text will be analyzed with + a. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + Maximum field length in number of terms/tokens: LIMITED, UNLIMITED, or user-specified + via the MaxFieldLength constructor. + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + +     + + Constructs an IndexWriter for the index in + d, first creating it if it does not + already exist. Text will be analyzed with + a. + + + the index directory + + the analyzer to use + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Constructs an IndexWriter for the index in + d, first creating it if it does not + already exist. Text will be analyzed with + a. + + + the index directory + + see above + + the analyzer to use + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Constructs an IndexWriter for the index in d. + Text will be analyzed with a. If create + is true, then a new, empty index will be created in + d, replacing the index already there, if any. + + + the index directory + + see above + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,boolean,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Expert: constructs an IndexWriter with a custom {@link + IndexDeletionPolicy}, for the index in d, + first creating it if it does not already exist. Text + will be analyzed with a. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + see above + + whether or not to limit field lengths + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + +     + + Expert: constructs an IndexWriter with a custom {@link + IndexDeletionPolicy}, for the index in d, + first creating it if it does not already exist. Text + will be analyzed with a. + + + the index directory + + see above + + the analyzer to use + + see above + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be + read/written to or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,IndexDeletionPolicy,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Expert: constructs an IndexWriter with a custom {@link + IndexDeletionPolicy}, for the index in d. + Text will be analyzed with a. If + create is true, then a new, empty index + will be created in d, replacing the index + already there, if any. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + see above + + {@link Lucene.Net.Index.IndexWriter.MaxFieldLength}, whether or not to limit field lengths. Value is in number of terms/tokens + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + +     + + Expert: constructs an IndexWriter with a custom {@link + IndexDeletionPolicy} and {@link IndexingChain}, + for the index in d. + Text will be analyzed with a. If + create is true, then a new, empty index + will be created in d, replacing the index + already there, if any. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + see above + + whether or not to limit field lengths, value is in number of terms/tokens. See {@link Lucene.Net.Index.IndexWriter.MaxFieldLength}. + + the {@link DocConsumer} chain to be used to + process documents + + which commit to open + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + +     + + Expert: constructs an IndexWriter with a custom {@link + IndexDeletionPolicy}, for the index in d. + Text will be analyzed with a. If + create is true, then a new, empty index + will be created in d, replacing the index + already there, if any. + + + the index directory + + see above + + the analyzer to use + + true to create the index or overwrite + the existing one; false to append to the existing + index + + see above + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + + This constructor will be removed in the 3.0 release. + Use {@link + #IndexWriter(Directory,Analyzer,boolean,IndexDeletionPolicy,MaxFieldLength)} + instead, and call {@link #Commit()} when needed. + + + + Expert: constructs an IndexWriter on specific commit + point, with a custom {@link IndexDeletionPolicy}, for + the index in d. Text will be analyzed + with a. + +

    This is only meaningful if you've used a {@link + IndexDeletionPolicy} in that past that keeps more than + just the last commit. + +

    This operation is similar to {@link #Rollback()}, + except that method can only rollback what's been done + with the current instance of IndexWriter since its last + commit, whereas this method can rollback to an + arbitrary commit point from the past, assuming the + {@link IndexDeletionPolicy} has preserved past + commits. + +

    NOTE: autoCommit (see above) is set to false with this + constructor. + +

    + the index directory + + the analyzer to use + + see above + + whether or not to limit field lengths, value is in number of terms/tokens. See {@link Lucene.Net.Index.IndexWriter.MaxFieldLength}. + + which commit to open + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if the directory cannot be read/written to, or + if it does not exist and create is + false or if there is any other low-level + IO error + +     + + Expert: set the merge policy used by this writer. + + + Expert: returns the current MergePolicy in use by this writer. + + + + + Expert: set the merge scheduler used by this writer. + + + Expert: returns the current MergePolicy in use by this + writer. + + + + + +

    Determines the largest segment (measured by + document count) that may be merged with other segments. + Small values (e.g., less than 10,000) are best for + interactive indexing, as this limits the length of + pauses while indexing to a few seconds. Larger values + are best for batched indexing and speedier + searches.

    + +

    The default value is {@link Integer#MAX_VALUE}.

    + +

    Note that this method is a convenience method: it + just calls mergePolicy.setMaxMergeDocs as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    + +

    The default merge policy ({@link + LogByteSizeMergePolicy}) also allows you to set this + limit by net size (in MB) of the segment, using {@link + LogByteSizeMergePolicy#setMaxMergeMB}.

    +

    +     + +

    Returns the largest segment (measured by document + count) that may be merged with other segments.

    + +

    Note that this method is a convenience method: it + just calls mergePolicy.getMaxMergeDocs as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    + +

    + + +     + + The maximum number of terms that will be indexed for a single field in a + document. This limits the amount of memory required for indexing, so that + collections with very large files will not crash the indexing process by + running out of memory. This setting refers to the number of running terms, + not to the number of different terms.

    + Note: this silently truncates large documents, excluding from the + index all terms that occur further in the document. If you know your source + documents are large, be sure to set this value high enough to accomodate + the expected size. If you set it to Integer.MAX_VALUE, then the only limit + is your memory, but you should anticipate an OutOfMemoryError.

    + By default, no more than {@link #DEFAULT_MAX_FIELD_LENGTH} terms + will be indexed for a field. +

    +     + + Returns the maximum number of terms that will be + indexed for a single field in a document. + + + + + + Determines the minimal number of documents required + before the buffered in-memory documents are flushed as + a new Segment. Large values generally gives faster + indexing. + +

    When this is set, the writer will flush every + maxBufferedDocs added documents. Pass in {@link + #DISABLE_AUTO_FLUSH} to prevent triggering a flush due + to number of buffered documents. Note that if flushing + by RAM usage is also enabled, then the flush will be + triggered by whichever comes first.

    + +

    Disabled by default (writer flushes by RAM usage).

    + +

    + IllegalArgumentException if maxBufferedDocs is + enabled but smaller than 2, or it disables maxBufferedDocs + when ramBufferSize is already disabled + + + +     + + If we are flushing by doc count (not by RAM usage), and + using LogDocMergePolicy then push maxBufferedDocs down + as its minMergeDocs, to keep backwards compatibility. + + + + Returns the number of buffered added documents that will + trigger a flush if enabled. + + + + + + Determines the amount of RAM that may be used for + buffering added documents and deletions before they are + flushed to the Directory. Generally for faster + indexing performance it's best to flush by RAM usage + instead of document count and use as large a RAM buffer + as you can. + +

    When this is set, the writer will flush whenever + buffered documents and deletions use this much RAM. + Pass in {@link #DISABLE_AUTO_FLUSH} to prevent + triggering a flush due to RAM usage. Note that if + flushing by document count is also enabled, then the + flush will be triggered by whichever comes first.

    + +

    NOTE: the account of RAM usage for pending + deletions is only approximate. Specifically, if you + delete by Query, Lucene currently has no way to measure + the RAM usage if individual Queries so the accounting + will under-estimate and you should compensate by either + calling commit() periodically yourself, or by using + {@link #setMaxBufferedDeleteTerms} to flush by count + instead of RAM usage (each buffered delete Query counts + as one). + +

    + NOTE: because IndexWriter uses ints when managing its + internal storage, the absolute maximum value for this setting is somewhat + less than 2048 MB. The precise limit depends on various factors, such as + how large your documents are, how many fields have norms, etc., so it's + best to set this value comfortably under 2048. +

    + +

    The default value is {@link #DEFAULT_RAM_BUFFER_SIZE_MB}.

    + +

    + IllegalArgumentException if ramBufferSize is + enabled but non-positive, or it disables ramBufferSize + when maxBufferedDocs is already disabled + +     + + Returns the value set by {@link #setRAMBufferSizeMB} if enabled. + + +

    Determines the minimal number of delete terms required before the buffered + in-memory delete terms are applied and flushed. If there are documents + buffered in memory at the time, they are merged and a new segment is + created.

    +

    Disabled by default (writer flushes by RAM usage).

    + +

    + IllegalArgumentException if maxBufferedDeleteTerms + is enabled but smaller than 1 + + + +     + + Returns the number of buffered deleted terms that will + trigger a flush if enabled. + + + + + + Determines how often segment indices are merged by addDocument(). With + smaller values, less RAM is used while indexing, and searches on + unoptimized indices are faster, but indexing speed is slower. With larger + values, more RAM is used during indexing, and while searches on unoptimized + indices are slower, indexing is faster. Thus larger values (> 10) are best + for batch index creation, and smaller values (< 10) for indices that are + interactively maintained. + +

    Note that this method is a convenience method: it + just calls mergePolicy.setMergeFactor as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    + +

    This must never be less than 2. The default value is 10. +

    +     + +

    Returns the number of segments that are merged at + once and also controls the total number of segments + allowed to accumulate in the index.

    + +

    Note that this method is a convenience method: it + just calls mergePolicy.getMergeFactor as long as + mergePolicy is an instance of {@link LogMergePolicy}. + Otherwise an IllegalArgumentException is thrown.

    + +

    + + +     + + Expert: returns max delay inserted before syncing a + commit point. On Windows, at least, pausing before + syncing can increase net indexing throughput. The + delay is variable based on size of the segment's files, + and is only inserted when using + ConcurrentMergeScheduler for merges. + + This will be removed in 3.0, when + autoCommit=true is removed from IndexWriter. + + + + Expert: sets the max delay before syncing a commit + point. + + + + This will be removed in 3.0, when + autoCommit=true is removed from IndexWriter. + + + + If non-null, this will be the default infoStream used + by a newly instantiated IndexWriter. + + + + + + Returns the current default infoStream for newly + instantiated IndexWriters. + + + + + + If non-null, information about merges, deletes and a + message when maxFieldLength is reached will be printed + to this. + + + + Returns the current infoStream in use by this writer. + + + + + Returns true if verbosing is enabled (i.e., infoStream != null). + + + to change the default value for all instances of IndexWriter. + + + + Returns allowed timeout when acquiring the write lock. + + + + + Sets the default (for any instance of IndexWriter) maximum time to wait for a write lock (in + milliseconds). + + + + Returns default write lock timeout for newly + instantiated IndexWriters. + + + + + + Commits all changes to an index and closes all + associated files. Note that this may be a costly + operation, so, try to re-use a single writer instead of + closing and opening a new one. See {@link #Commit()} for + caveats about write caching done by some IO devices. + +

    If an Exception is hit during close, eg due to disk + full or some other reason, then both the on-disk index + and the internal state of the IndexWriter instance will + be consistent. However, the close will not be complete + even though part of it (flushing buffered documents) + may have succeeded, so the write lock will still be + held.

    + +

    If you can correct the underlying cause (eg free up + some disk space) then you can call close() again. + Failing that, if you want to force the write lock to be + released (dangerous, because you may then lose buffered + docs in the IndexWriter instance) then you can do + something like this:

    + + 

    +            try {
+            writer.close();
+            } finally {
+            if (IndexWriter.isLocked(directory)) {
+            IndexWriter.unlock(directory);
+            }
+            }
+
    + + after which, you must be certain not to use the writer + instance anymore.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer, again. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Closes the index with or without waiting for currently + running merges to finish. This is only meaningful when + using a MergeScheduler that runs merges in background + threads. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer, again. See above for details.

    + +

    NOTE: it is dangerous to always call + close(false), especially when IndexWriter is not open + for very long, because this can result in "merge + starvation" whereby long merges will never have a + chance to finish. This will cause too many segments in + your index over time.

    + +

    + if true, this call will block + until all merges complete; else, it will ask all + running merges to abort, wait until those merges have + finished (which should be at most a few seconds), and + then return. + +     + + Tells the docWriter to close its currently open shared + doc stores (stored fields & vectors files). + Return value specifices whether new doc store files are compound or not. + + + + Returns the Directory used by this index. + + + Returns the analyzer used by this index. + + + Returns the number of documents currently in this + index, not counting deletions. + + Please use {@link #MaxDoc()} (same as this + method) or {@link #NumDocs()} (also takes deletions + into account), instead. + + + + Returns total number of docs in this index, including + docs not yet flushed (still in the RAM buffer), + not counting deletions. + + + + + + Returns total number of docs in this index, including + docs not yet flushed (still in the RAM buffer), and + including deletions. NOTE: buffered deletions + are not counted. If you really need these to be + counted you should call {@link #Commit()} first. + + + + + + The maximum number of terms that will be indexed for a single field in a + document. This limits the amount of memory required for indexing, so that + collections with very large files will not crash the indexing process by + running out of memory.

    + Note that this effectively truncates large documents, excluding from the + index terms that occur further in the document. If you know your source + documents are large, be sure to set this value high enough to accomodate + the expected size. If you set it to Integer.MAX_VALUE, then the only limit + is your memory, but you should anticipate an OutOfMemoryError.

    + By default, no more than 10,000 terms will be indexed for a field. + +

    + + +     + + Adds a document to this index. If the document contains more than + {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are + discarded. + +

    Note that if an Exception is hit (for example disk full) + then the index will be consistent, but this document + may not have been added. Furthermore, it's possible + the index will have one segment in non-compound format + even when using compound files (when a merge has + partially succeeded).

    + +

    This method periodically flushes pending documents + to the Directory (see above), and + also periodically triggers segment merges in the index + according to the {@link MergePolicy} in use.

    + +

    Merges temporarily consume space in the + directory. The amount of space required is up to 1X the + size of all segments being merged, when no + readers/searchers are open against the index, and up to + 2X the size of all segments being merged when + readers/searchers are open against the index (see + {@link #Optimize()} for details). The sequence of + primitive merge operations performed is governed by the + merge policy. + +

    Note that each term in the document can be no longer + than 16383 characters, otherwise an + IllegalArgumentException will be thrown.

    + +

    Note that it's possible to create an invalid Unicode + string in java if a UTF16 surrogate pair is malformed. + In this case, the invalid characters are silently + replaced with the Unicode replacement character + U+FFFD.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Adds a document to this index, using the provided analyzer instead of the + value of {@link #GetAnalyzer()}. If the document contains more than + {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are + discarded. + +

    See {@link #AddDocument(Document)} for details on + index and IndexWriter state after an Exception, and + flushing/merging temporary free space requirements.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Deletes the document(s) containing term. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + the term to identify the documents to be deleted + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Deletes the document(s) containing any of the + terms. All deletes are flushed at the same time. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + array of terms to identify the documents + to be deleted + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Deletes the document(s) matching the provided query. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + the query to identify the documents to be deleted + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Deletes the document(s) matching any of the provided queries. + All deletes are flushed at the same time. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + array of queries to identify the documents + to be deleted + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Updates a document by first deleting the document(s) + containing term and then adding the new + document. The delete and then add are atomic as seen + by a reader on the same index (flush may happen only after + the add). + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + the term to identify the document(s) to be + deleted + + the document to be added + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Updates a document by first deleting the document(s) + containing term and then adding the new + document. The delete and then add are atomic as seen + by a reader on the same index (flush may happen only after + the add). + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + the term to identify the document(s) to be + deleted + + the document to be added + + the analyzer to use when analyzing the document + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + If non-null, information about merges will be printed to this. + + + Requests an "optimize" operation on an index, priming the index + for the fastest available search. Traditionally this has meant + merging all segments into a single segment as is done in the + default merge policy, but individaul merge policies may implement + optimize in different ways. + +

    It is recommended that this method be called upon completion of indexing. In + environments with frequent updates, optimize is best done during low volume times, if at all. + +

    +

    See http://www.gossamer-threads.com/lists/lucene/java-dev/47895 for more discussion.

    + +

    Note that optimize requires 2X the index size free + space in your Directory. For example, if your index + size is 10 MB then you need 20 MB free for optimize to + complete.

    + +

    If some but not all readers re-open while an + optimize is underway, this will cause > 2X temporary + space to be consumed as those new readers will then + hold open the partially optimized segments at that + time. It is best not to re-open readers while optimize + is running.

    + +

    The actual temporary usage could be much less than + these figures (it depends on many factors).

    + +

    In general, once the optimize completes, the total size of the + index will be less than the size of the starting index. + It could be quite a bit smaller (if there were many + pending deletes) or just slightly smaller.

    + +

    If an Exception is hit during optimize(), for example + due to disk full, the index will not be corrupt and no + documents will have been lost. However, it may have + been partially optimized (some segments were merged but + not all), and it's possible that one of the segments in + the index will be in non-compound format even when + using compound file format. This will occur when the + Exception is hit during conversion of the segment into + compound format.

    + +

    This call will optimize those segments present in + the index when the call started. If other threads are + still adding documents and flushing segments, those + newly created segments will not be optimized unless you + call optimize again.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + +     + + Optimize the index down to <= maxNumSegments. If + maxNumSegments==1 then this is the same as {@link + #Optimize()}. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + maximum number of segments left + in the index after optimization finishes + +     + + Just like {@link #Optimize()}, except you can specify + whether the call should block until the optimize + completes. This is only meaningful with a + {@link MergeScheduler} that is able to run merges in + background threads. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Just like {@link #Optimize(int)}, except you can + specify whether the call should block until the + optimize completes. This is only meaningful with a + {@link MergeScheduler} that is able to run merges in + background threads. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Returns true if any merges in pendingMerges or + runningMerges are optimization merges. + + + + Just like {@link #ExpungeDeletes()}, except you can + specify whether the call should block until the + operation completes. This is only meaningful with a + {@link MergeScheduler} that is able to run merges in + background threads. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Expunges all deletes from the index. When an index + has many document deletions (or updates to existing + documents), it's best to either call optimize or + expungeDeletes to remove all unused data in the index + associated with the deleted documents. To see how + many deletions you have pending in your index, call + {@link IndexReader#numDeletedDocs} + This saves disk space and memory usage while + searching. expungeDeletes should be somewhat faster + than optimize since it does not insist on reducing the + index to a single segment (though, this depends on the + {@link MergePolicy}; see {@link + MergePolicy#findMergesToExpungeDeletes}.). Note that + this call does not first commit any buffered + documents, so you must do so yourself if necessary. + See also {@link #ExpungeDeletes(boolean)} + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Expert: asks the mergePolicy whether any merges are + necessary now and if so, runs the requested merges and + then iterate (test again if merges are needed) until no + more merges are returned by the mergePolicy. + + Explicit calls to maybeMerge() are usually not + necessary. The most common case is when merge policy + parameters have changed. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Expert: the {@link MergeScheduler} calls this method + to retrieve the next merge requested by the + MergePolicy + + + + Like getNextMerge() except only returns a merge if it's + external. + + + + Please use {@link #rollback} instead. + + + + Close the IndexWriter without committing + any changes that have occurred since the last commit + (or since it was opened, if commit hasn't been called). + This removes any temporary files that had been created, + after which the state of the index will be the same as + it was when commit() was last called or when this + writer was first opened. This can only be called when + this IndexWriter was opened with + autoCommit=false. This also clears a + previous call to {@link #prepareCommit}. + + IllegalStateException if this is called when + the writer was opened with autoCommit=true. + + IOException if there is a low-level IO error + + + Delete all documents in the index. + +

    This method will drop all buffered documents and will + remove all segments from the index. This change will not be + visible until a {@link #Commit()} has been called. This method + can be rolled back using {@link #Rollback()}.

    + +

    NOTE: this method is much faster than using deleteDocuments( new MatchAllDocsQuery() ).

    + +

    NOTE: this method will forcefully abort all merges + in progress. If other threads are running {@link + #Optimize()} or any of the addIndexes methods, they + will receive {@link MergePolicy.MergeAbortedException}s. +

    +     + + Wait for any currently outstanding merges to finish. + +

    It is guaranteed that any merges started prior to calling this method + will have completed once this method completes.

    +

    +     + + Merges all segments from an array of indexes into this index. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + Use {@link #addIndexesNoOptimize} instead, + then separately call {@link #optimize} afterwards if + you need to. + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Merges all segments from an array of indexes into this + index. + +

    This may be used to parallelize batch indexing. A large document + collection can be broken into sub-collections. Each sub-collection can be + indexed in parallel, on a different thread, process or machine. The + complete index can then be created by merging sub-collection indexes + with this method. + +

    NOTE: the index in each Directory must not be + changed (opened by a writer) while this method is + running. This method does not acquire a write lock in + each input Directory, so it is up to the caller to + enforce this. + +

    NOTE: while this is running, any attempts to + add or delete documents (with another thread) will be + paused until this method completes. + +

    This method is transactional in how Exceptions are + handled: it does not commit a new segments_N file until + all indexes are added. This means if an Exception + occurs (for example disk full), then either no indexes + will have been added or they all will have been.

    + +

    Note that this requires temporary free space in the + Directory up to 2X the sum of all input indexes + (including the starting index). If readers/searchers + are open against the starting index, then temporary + free space required will be higher by the size of the + starting index (see {@link #Optimize()} for details). +

    + +

    Once this completes, the final size of the index + will be less than the sum of all input index sizes + (including the starting index). It could be quite a + bit smaller (if there were many pending deletes) or + just slightly smaller.

    + +

    + This requires this index not be among those to be added. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Merges the provided indexes into this index. +

    After this completes, the index is optimized.

    +

    The provided IndexReaders are not closed.

    + +

    NOTE: while this is running, any attempts to + add or delete documents (with another thread) will be + paused until this method completes. + +

    See {@link #AddIndexesNoOptimize(Directory[])} for + details on transactional semantics, temporary free + space required in the Directory, and non-CFS segments + on an Exception.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Flush all in-memory buffered updates (adds and deletes) + to the Directory. +

    Note: while this will force buffered docs to be + pushed into the index, it will not make these docs + visible to a reader. Use {@link #Commit()} instead + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + please call {@link #Commit()}) instead + + + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error +     + + Expert: prepare for commit. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + + +     + +

    Expert: prepare for commit, specifying + commitUserData Map (String -> String). This does the + first phase of 2-phase commit. You can only call this + when autoCommit is false. This method does all steps + necessary to commit changes since this writer was + opened: flushes pending added and deleted docs, syncs + the index files, writes most of next segments_N file. + After calling this you must call either {@link + #Commit()} to finish the commit, or {@link + #Rollback()} to revert the commit and undo all changes + done since the writer was opened.

    + + You can also just call {@link #Commit(Map)} directly + without prepareCommit first in which case that method + will internally call prepareCommit. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + Opaque Map (String->String) + that's recorded into the segments file in the index, + and retrievable by {@link + IndexReader#getCommitUserData}. Note that when + IndexWriter commits itself, for example if open with + autoCommit=true, or, during {@link #close}, the + commitUserData is unchanged (just carried over from + the prior commit). If this is null then the previous + commitUserData is kept. Also, the commitUserData will + only "stick" if there are actually changes in the + index to commit. Therefore it's best to use this + feature only when autoCommit is false. + +     + +

    Commits all pending changes (added & deleted + documents, optimizations, segment merges, added + indexes, etc.) to the index, and syncs all referenced + index files, such that a reader will see the changes + and the index updates will survive an OS or machine + crash or power loss. Note that this does not wait for + any running background merges to finish. This may be a + costly operation, so you should test the cost in your + application and do it only when really necessary.

    + +

    Note that this operation calls Directory.sync on + the index files. That call should not return until the + file contents & metadata are on stable storage. For + FSDirectory, this calls the OS's fsync. But, beware: + some hardware devices may in fact cache writes even + during fsync, and return before the bits are actually + on stable storage, to give the appearance of faster + performance. If you have such a device, and it does + not have a battery backup (for example) then on power + loss it may still lose data. Lucene cannot guarantee + consistency on such devices.

    + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    + +

    + + + + +     + + Commits all changes to the index, specifying a + commitUserData Map (String -> String). This just + calls {@link #PrepareCommit(Map)} (if you didn't + already call it) and then {@link #finishCommit}. + +

    NOTE: if this method hits an OutOfMemoryError + you should immediately close the writer. See above for details.

    +

    +     + + Flush all in-memory buffered udpates (adds and deletes) + to the Directory. + + if true, we may merge segments (if + deletes or docs were flushed) if necessary + + if false we are allowed to keep + doc stores open to share with the next segment + + whether pending deletes should also + be flushed + + + + Expert: Return the total size of all index files currently cached in memory. + Useful for size management with flushRamDocs() + + + + Expert: Return the number of documents currently + buffered in RAM. + + + + Carefully merges deletes for the segments we just + merged. This is tricky because, although merging will + clear all deletes (compacts the documents), new + deletes may have been flushed to the segments since + the merge was started. This method "carries over" + such new deletes onto the newly merged segment, and + saves the resulting deletes file (incrementing the + delete generation for merge.info). If no deletes were + flushed, no new deletes file is saved. + + + + Merges the indicated segments, replacing them in the stack with a + single segment. + + + + Hook that's called when the specified merge is complete. + + + Checks whether this merge involves any segments + already participating in a merge. If not, this merge + is "registered", meaning we record that its segments + are now participating in a merge, and true is + returned. Else (the merge conflicts) false is + returned. + + + + Does initial setup for a merge, which is fast but holds + the synchronized lock on IndexWriter instance. + + + + This is called after merging a segment and before + building its CFS. Return true if the files should be + sync'd. If you return false, then the source segment + files that were merged cannot be deleted until the CFS + file is built & sync'd. So, returning false consumes + more transient disk space, but saves performance of + not having to sync files which will shortly be deleted + anyway. + + -- this will be removed in 3.0 when + autoCommit is hardwired to false + + + + Does fininishing for a merge, which is fast but holds + the synchronized lock on IndexWriter instance. + + + + Does the actual (time-consuming) work of the merge, + but without holding synchronized lock on IndexWriter + instance + + + + Blocks until all files in syncing are sync'd + + + Pauses before syncing. On Windows, at least, it's + best (performance-wise) to pause in order to let OS + flush writes to disk on its own, before forcing a + sync. + + -- this will be removed in 3.0 when + autoCommit is hardwired to false + + + + Walk through all files referenced by the current + segmentInfos and ask the Directory to sync each file, + if it wasn't already. If that succeeds, then we + prepare a new segments_N file but do not fully commit + it. + + + + Returns true iff the index in the named directory is + currently locked. + + the directory to check for a lock + + IOException if there is a low-level IO error + + + Returns true iff the index in the named directory is + currently locked. + + the directory to check for a lock + + IOException if there is a low-level IO error + Use {@link #IsLocked(Directory)} + + + + Forcibly unlocks the index in the named directory. +

    + Caution: this should only be used by failure recovery code, + when it is known that no other process nor thread is in fact + currently accessing this index. +

    +     + + Set the merged segment warmer. See {@link + IndexReaderWarmer}. + + + + Returns the current merged segment warmer. See {@link + IndexReaderWarmer}. + + + + Deprecated: emulates IndexWriter's buggy behavior when + first token(s) have positionIncrement==0 (ie, prior to + fixing LUCENE-1542) + + + + Holds shared SegmentReader instances. IndexWriter uses + SegmentReaders for 1) applying deletes, 2) doing + merges, 3) handing out a real-time reader. This pool + reuses instances of the SegmentReaders in all these + places if it is in "near real-time mode" (getReader() + has been called on this instance). + + + + Forcefully clear changes for the specifed segments, + and remove from the pool. This is called on succesful merge. + + + + Release the segment reader (i.e. decRef it and close if there + are no more references. + + + + IOException + + + Release the segment reader (i.e. decRef it and close if there + are no more references. + + + + IOException + + + Remove all our references to readers, and commits + any pending changes. + + + + Commit all segment reader in the pool. + IOException + + + Returns a ref to a clone. NOTE: this clone is not + enrolled in the pool, so you should simply close() + it when you're done (ie, do not call release()). + + + + Obtain a SegmentReader from the readerPool. The reader + must be returned by calling {@link #Release(SegmentReader)} + + + + + + + + IOException + + + Obtain a SegmentReader from the readerPool. The reader + must be returned by calling {@link #Release(SegmentReader)} + + + + + + + + + + + + + IOException + + + Specifies maximum field length (in number of tokens/terms) in {@link IndexWriter} constructors. + {@link #SetMaxFieldLength(int)} overrides the value set by + the constructor. + + + + Private type-safe-enum-pattern constructor. + + + instance name + + maximum field length + + + + Public constructor to allow users to specify the maximum field size limit. + + + The maximum field length + + + + Sets the maximum field length to {@link Integer#MAX_VALUE}. + + + Sets the maximum field length to + {@link #DEFAULT_MAX_FIELD_LENGTH} + + + + + If {@link #getReader} has been called (ie, this writer + is in near real-time mode), then after a merge + completes, this class can be invoked to warm the + reader on the newly merged segment, before the merge + commits. This is not required for near real-time + search, but will reduce search latency on opening a + new near real-time reader after a merge completes. + +

    NOTE: This API is experimental and might + change in incompatible ways in the next release.

    + +

    NOTE: warm is called before any deletes have + been carried over to the merged segment. +

    +     + + Basic tool and API to check the health of an index and + write a new segments file that removes reference to + problematic segments. + +

    As this tool checks every byte in the index, on a large + index it can take quite a long time to run. + +

    WARNING: this tool and API is new and + experimental and is subject to suddenly change in the + next release. Please make a complete backup of your + index before using this to fix your index! +

    +     + + Default PrintStream for all CheckIndex instances. + Use {@link #setInfoStream} per instance, + instead. + + + + Create a new CheckIndex on the directory. + + + Set infoStream where messages should go. If null, no + messages are printed + + + + Returns true if index is clean, else false. + Please instantiate a CheckIndex and then use {@link #CheckIndex()} instead + + + + Returns true if index is clean, else false. + Please instantiate a CheckIndex and then use {@link #CheckIndex(List)} instead + + + + Returns a {@link Status} instance detailing + the state of the index. + +

    As this method checks every byte in the index, on a large + index it can take quite a long time to run. + +

    WARNING: make sure + you only call this when the index is not opened by any + writer. +

    +     + + Returns a {@link Status} instance detailing + the state of the index. + + + list of specific segment names to check + +

    As this method checks every byte in the specified + segments, on a large index it can take quite a long + time to run. + +

    WARNING: make sure + you only call this when the index is not opened by any + writer. + + + +

    Test field norms. +     + + Test the term index. + + + Test stored fields for a segment. + + + Test term vectors for a segment. + + + Repairs the index using previously returned result + from {@link #checkIndex}. Note that this does not + remove any of the unreferenced files after it's done; + you must separately open an {@link IndexWriter}, which + deletes unreferenced files when it's created. + +

    WARNING: this writes a + new segments file into the index, effectively removing + all documents in broken segments from the index. + BE CAREFUL. + +

    WARNING: Make sure you only call this when the + index is not opened by any writer. +

    +     + + Command-line interface to check and fix an index. +

    + Run it like this: + 

    +            java -ea:Lucene.Net... Lucene.Net.Index.CheckIndex pathToIndex [-fix] [-segment X] [-segment Y]
+
    +
      +
    • -fix: actually write a new segments_N file, removing any problematic segments
      • +
    • -segment X: only check the specified + segment(s). This can be specified multiple times, + to check more than one segment, eg -segment _2 + -segment _a. You can't use this with the -fix + option.
      • +
    +

    WARNING: -fix should only be used on an emergency basis as it will cause + documents (perhaps many) to be permanently removed from the index. Always make + a backup copy of your index before running this! Do not run this tool on an index + that is actively being written to. You have been warned! +

    Run without -fix, this tool will open the index, report version information + and report any exceptions it hits and what action it would take if -fix were + specified. With -fix, this tool will remove any segments that have issues and + write a new segments_N file. This means all documents contained in the affected + segments will be removed. +

    + This tool exits with exit code 1 if the index cannot be opened or has any + corruption, else 0. +

    +     + + Returned from {@link #CheckIndex()} detailing the health and status of the index. + +

    WARNING: this API is new and experimental and is + subject to suddenly change in the next release. + +

    +     + + True if no problems were found with the index. + + + True if we were unable to locate and load the segments_N file. + + + True if we were unable to open the segments_N file. + + + True if we were unable to read the version number from segments_N file. + + + Name of latest segments_N file in the index. + + + Number of segments in the index. + + + String description of the version of the index. + + + Empty unless you passed specific segments list to check as optional 3rd argument. + + + + + True if the index was created with a newer version of Lucene than the CheckIndex tool. + + + List of {@link SegmentInfoStatus} instances, detailing status of each segment. + + + Directory index is in. + + + SegmentInfos instance containing only segments that + had no problems (this is used with the {@link CheckIndex#fixIndex} + method to repair the index. + + + + How many documents will be lost to bad segments. + + + How many bad segments were found. + + + True if we checked only specific segments ({@link + #CheckIndex(List)}) was called with non-null + argument). + + + + Holds the userData of the last commit in the index + + + Holds the status of each segment in the index. + See {@link #segmentInfos}. + +

    WARNING: this API is new and experimental and is + subject to suddenly change in the next release. +

    +     + + Name of the segment. + + + Document count (does not take deletions into account). + + + True if segment is compound file format. + + + Number of files referenced by this segment. + + + Net size (MB) of the files referenced by this + segment. + + + + Doc store offset, if this segment shares the doc + store files (stored fields and term vectors) with + other segments. This is -1 if it does not share. + + + + String of the shared doc store segment, or null if + this segment does not share the doc store files. + + + + True if the shared doc store files are compound file + format. + + + + True if this segment has pending deletions. + + + Name of the current deletions file name. + + + Number of deleted documents. + + + True if we were able to open a SegmentReader on this + segment. + + + + Number of fields in this segment. + + + True if at least one of the fields in this segment + does not omitTermFreqAndPositions. + + + + + + Map<String, String> that includes certain + debugging details that IndexWriter records into + each segment it creates + + + + Status for testing of field norms (null if field norms could not be tested). + + + Status for testing of indexed terms (null if indexed terms could not be tested). + + + Status for testing of stored fields (null if stored fields could not be tested). + + + Status for testing of term vectors (null if term vectors could not be tested). + + + Status from testing field norms. + + + Number of fields successfully tested + + + Exception thrown during term index test (null on success) + + + Status from testing term index. + + + Total term count + + + Total frequency across all terms. + + + Total number of positions. + + + Exception thrown during term index test (null on success) + + + Status from testing stored fields. + + + Number of documents tested. + + + Total number of stored fields tested. + + + Exception thrown during stored fields test (null on success) + + + Status from testing stored fields. + + + Number of documents tested. + + + Total number of term vectors tested. + + + Exception thrown during term vector test (null on success) + + +

    This class provides a {@link Field} that enables indexing + of numeric values for efficient range filtering and + sorting. Here's an example usage, adding an int value: + 

    +            document.add(new NumericField(name).setIntValue(value));
+
    + + For optimal performance, re-use the + NumericField and {@link Document} instance for more than + one document: + + 
    +            NumericField field = new NumericField(name);
+            Document document = new Document();
+            document.add(field);
+            
+            for(all documents) {
+            ...
+            field.setIntValue(value)
+            writer.addDocument(document);
+            ...
+            }
+
    + +

    The java native types int, long, + float and double are + directly supported. However, any value that can be + converted into these native types can also be indexed. + For example, date/time values represented by a + {@link java.util.Date} can be translated into a long + value using the {@link java.util.Date#getTime} method. If you + don't need millisecond precision, you can quantize the + value, either by dividing the result of + {@link java.util.Date#getTime} or using the separate getters + (for year, month, etc.) to construct an int or + long value.

    + +

    To perform range querying or filtering against a + NumericField, use {@link NumericRangeQuery} or {@link + NumericRangeFilter}. To sort according to a + NumericField, use the normal numeric sort types, eg + {@link SortField#INT} (note that {@link SortField#AUTO} + will not work with these fields). NumericField values + can also be loaded directly from {@link FieldCache}.

    + +

    By default, a NumericField's value is not stored but + is indexed for range filtering and sorting. You can use + the {@link #NumericField(String,Field.Store,boolean)} + constructor if you need to change these defaults.

    + +

    You may add the same field name as a NumericField to + the same document more than once. Range querying and + filtering will be the logical OR of all values; so a range query + will hit all documents that have at least one value in + the range. However sort behavior is not defined. If you need to sort, + you should separately index a single-valued NumericField.

    + +

    A NumericField will consume somewhat more disk space + in the index than an ordinary single-valued field. + However, for a typical index that includes substantial + textual content per document, this increase will likely + be in the noise.

    + +

    Within Lucene, each numeric value is indexed as a + trie structure, where each term is logically + assigned to larger and larger pre-defined brackets (which + are simply lower-precision representations of the value). + The step size between each successive bracket is called the + precisionStep, measured in bits. Smaller + precisionStep values result in larger number + of brackets, which consumes more disk space in the index + but may result in faster range search performance. The + default value, 4, was selected for a reasonable tradeoff + of disk space consumption versus performance. You can + use the expert constructor {@link + #NumericField(String,int,Field.Store,boolean)} if you'd + like to change the value. Note that you must also + specify a congruent value when creating {@link + NumericRangeQuery} or {@link NumericRangeFilter}. + For low cardinality fields larger precision steps are good. + If the cardinality is < 100, it is fair + to use {@link Integer#MAX_VALUE}, which produces one + term per value. + +

    For more information on the internals of numeric trie + indexing, including the precisionStep + configuration, see {@link NumericRangeQuery}. The format of + indexed values is described in {@link NumericUtils}. + +

    If you only need to sort by numeric value, and never + run range querying/filtering, you can index using a + precisionStep of {@link Integer#MAX_VALUE}. + This will minimize disk space consumed.

    + +

    More advanced users can instead use {@link + NumericTokenStream} directly, when indexing numbers. This + class is a wrapper around this token stream type for + easier, more intuitive usage.

    + +

    NOTE: This class is only used during + indexing. When retrieving the stored field value from a + {@link Document} instance after search, you will get a + conventional {@link Fieldable} instance where the numeric + values are returned as {@link String}s (according to + toString(value) of the used data type). + +

    NOTE: This API is + experimental and might change in incompatible ways in the + next release. + +

    + 2.9 + +     + + Creates a field for numeric values using the default precisionStep + {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). The instance is not yet initialized with + a numeric value, before indexing a document containing this field, + set a value using the various set???Value() methods. + This constructor creates an indexed, but not stored field. + + the field name + + + + Creates a field for numeric values using the default precisionStep + {@link NumericUtils#PRECISION_STEP_DEFAULT} (4). The instance is not yet initialized with + a numeric value, before indexing a document containing this field, + set a value using the various set???Value() methods. + + the field name + + if the field should be stored in plain text form + (according to toString(value) of the used data type) + + if the field should be indexed using {@link NumericTokenStream} + + + + Creates a field for numeric values with the specified + precisionStep. The instance is not yet initialized with + a numeric value, before indexing a document containing this field, + set a value using the various set???Value() methods. + This constructor creates an indexed, but not stored field. + + the field name + + the used precision step + + + + Creates a field for numeric values with the specified + precisionStep. The instance is not yet initialized with + a numeric value, before indexing a document containing this field, + set a value using the various set???Value() methods. + + the field name + + the used precision step + + if the field should be stored in plain text form + (according to toString(value) of the used data type) + + if the field should be indexed using {@link NumericTokenStream} + + + + Returns a {@link NumericTokenStream} for indexing the numeric value. + + + Returns always null for numeric fields + + + Returns always null for numeric fields + + + Returns always null for numeric fields + + + Returns the numeric value as a string (how it is stored, when {@link Field.Store#YES} is chosen). + + + Returns the current numeric value as a subclass of {@link Number}, null if not yet initialized. + + + Initializes the field with the supplied long value. + the numeric value + + this instance, because of this you can use it the following way: + document.add(new NumericField(name, precisionStep).SetLongValue(value)) + + + + Initializes the field with the supplied int value. + the numeric value + + this instance, because of this you can use it the following way: + document.add(new NumericField(name, precisionStep).setIntValue(value)) + + + + Initializes the field with the supplied double value. + the numeric value + + this instance, because of this you can use it the following way: + document.add(new NumericField(name, precisionStep).setDoubleValue(value)) + + + + Initializes the field with the supplied float value. + the numeric value + + this instance, because of this you can use it the following way: + document.add(new NumericField(name, precisionStep).setFloatValue(value)) + + + + Methods for manipulating arrays. + + + Parses the string argument as if it was an int value and returns the + result. Throws NumberFormatException if the string does not represent an + int quantity. + + + a string representation of an int quantity. + + int the value represented by the argument + + NumberFormatException if the argument could not be parsed as an int quantity. + + + Parses a char array into an int. + the character array + + The offset into the array + + The length + + the int + + NumberFormatException if it can't parse + + + Parses the string argument as if it was an int value and returns the + result. Throws NumberFormatException if the string does not represent an + int quantity. The second argument specifies the radix to use when parsing + the value. + + + a string representation of an int quantity. + + the base to use for conversion. + + int the value represented by the argument + + NumberFormatException if the argument could not be parsed as an int quantity. + + + Returns hash of chars in range start (inclusive) to + end (inclusive) + + + + Returns hash of chars in range start (inclusive) to + end (inclusive) + + + + A memory-resident {@link IndexOutput} implementation. + + + $Id: RAMOutputStream.java 691694 2008-09-03 17:34:29Z mikemccand $ + + + + Construct an empty output buffer. + + + Copy the current contents of this buffer to the named output. + + + Resets this to an empty buffer. + + + Returns byte usage of all buffers. + + + This exception is thrown when the write.lock + could not be released. + + + + + + A Query that matches documents containing a term. + This may be combined with other terms with a {@link BooleanQuery}. + + + + Constructs a query for the term t. + + + Returns the term of this query. + + + Prints a user-readable version of this query. + + + Returns true iff o is equal to this. + + + Returns a hash code value for this object. + + + Experimental class to get set of payloads for most standard Lucene queries. + Operates like Highlighter - IndexReader should only contain doc of interest, + best to use MemoryIndex. + +

    + + WARNING: The status of the Payloads feature is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

    +     + + that contains doc with payloads to extract + + + + Query should be rewritten for wild/fuzzy support. + + + + + payloads Collection + + IOException + + + Implements search over a set of Searchables. + +

    Applications usually need only call the inherited {@link #Search(Query)} + or {@link #Search(Query,Filter)} methods. +

    +     + + Creates a searcher which searches searchers. + + + Return the array of {@link Searchable}s this searches. + + + Returns index of the searcher for document n in the array + used to construct this searcher. + + + + Returns the document number of document n within its + sub-index. + + + + Create weight in multiple index scenario. + + Distributed query processing is done in the following steps: + 1. rewrite query + 2. extract necessary terms + 3. collect dfs for these terms from the Searchables + 4. create query weight using aggregate dfs. + 5. distribute that weight to Searchables + 6. merge results + + Steps 1-4 are done here, 5+6 in the search() methods + + + rewritten queries + + + + Document Frequency cache acting as a Dummy-Searcher. This class is no + full-fledged Searcher, but only supports the methods necessary to + initialize Weights. + + + + A query that applies a filter to the results of another query. + +

    Note: the bits are retrieved from the filter each time this + query is used in a search - use a CachingWrapperFilter to avoid + regenerating the bits every time. + +

    Created: Apr 20, 2004 8:58:29 AM + +

    + 1.4 + + $Id: FilteredQuery.java 807821 2009-08-25 21:55:49Z mikemccand $ + + + +     + + Constructs a new query which applies a filter to the results of the original query. + Filter.getDocIdSet() will be called every time this query is used in a search. + + Query to be filtered, cannot be null. + + Filter to apply to query results, cannot be null. + + + + Returns a Weight that applies the filter to the enclosed query's Weight. + This is accomplished by overriding the Scorer returned by the Weight. + + + + Rewrites the wrapped query. + + + Prints a user-readable version of this query. + + + Returns true iff o is equal to this. + + + Returns a hash code value for this object. + + + use {@link #NextDoc()} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #Advance(int)} instead. + + + + Token Manager Error. + + + Lexical error occurred. + + + An attempt was made to create a second instance of a static token manager. + + + Tried to change to an invalid lexical state. + + + Detected (and bailed out of) an infinite loop in the token manager. + + + Indicates the reason why the exception is thrown. It will have + one of the above 4 values. + + + + Replaces unprintable characters by their escaped (or unicode escaped) + equivalents in the given string + + + + Returns a detailed message for the Error when it is thrown by the + token manager to indicate a lexical error. + Parameters : + EOFSeen : indicates if EOF caused the lexical error + curLexState : lexical state in which this error occurred + errorLine : line number when the error occurred + errorColumn : column number when the error occurred + errorAfter : prefix that was seen before this error occurred + curchar : the offending character + Note: You can customize the lexical error message by modifying this method. + + + + No arg constructor. + + + Constructor with message and reason. + + + Full Constructor. + + + You can also modify the body of this method to customize your error messages. + For example, cases like LOOP_DETECTED and INVALID_LEXICAL_STATE are not + of end-users concern, so you can return something like : + + "Internal Error : Please file a bug report .... " + + from this method for such cases in the release version of your parser. + + + + Default implementation of Message interface. + For Native Language Support (NLS), system of software internationalization. + + + +

    [Note that as of 2.1, all but one of the + methods in this class are available via {@link + IndexWriter}. The one method that is not available is + {@link #DeleteDocument(int)}.]

    + + A class to modify an index, i.e. to delete and add documents. This + class hides {@link IndexReader} and {@link IndexWriter} so that you + do not need to care about implementation details such as that adding + documents is done via IndexWriter and deletion is done via IndexReader. + +

    Note that you cannot create more than one IndexModifier object + on the same directory at the same time. + +

    Example usage: + + + + + +

    + + + + + + +
    + +     Analyzer analyzer = new StandardAnalyzer();
    +     // create an index in /tmp/index, overwriting an existing one:
    +     IndexModifier indexModifier = new IndexModifier("/tmp/index", analyzer, true);
    +     Document doc = new Document();
    +     doc.add(new Field("id", "1", Field.Store.YES, Field.Index.NOT_ANALYZED));
    +     doc.add(new Field("body", "a simple test", Field.Store.YES, Field.Index.ANALYZED));
    +     indexModifier.addDocument(doc);
    +     int deleted = indexModifier.delete(new Term("id", "1"));
    +     System.out.println("Deleted " + deleted + " document");
    +     indexModifier.flush();
    +     System.out.println(indexModifier.docCount() + " docs in index");
    +     indexModifier.close();     +
    +
    + + + +

    Not all methods of IndexReader and IndexWriter are offered by this + class. If you need access to additional methods, either use those classes + directly or implement your own class that extends IndexModifier. + +

    Although an instance of this class can be used from more than one + thread, you will not get the best performance. You might want to use + IndexReader and IndexWriter directly for that (but you will need to + care about synchronization yourself then). + +

    While you can freely mix calls to add() and delete() using this class, + you should batch you calls for best performance. For example, if you + want to update 20 documents, you should first delete all those documents, + then add all the new documents. + +

    + Please use {@link IndexWriter} instead. + +     + + Open an index with write access. + + + the index directory + + the analyzer to use for adding new documents + + true to create the index or overwrite the existing one; + false to append to the existing index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Open an index with write access. + + + the index directory + + the analyzer to use for adding new documents + + true to create the index or overwrite the existing one; + false to append to the existing index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Open an index with write access. + + + the index directory + + the analyzer to use for adding new documents + + true to create the index or overwrite the existing one; + false to append to the existing index + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Initialize an IndexWriter. + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Throw an IllegalStateException if the index is closed. + IllegalStateException + + + Close the IndexReader and open an IndexWriter. + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Close the IndexWriter and open an IndexReader. + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + Make sure all changes are written to disk. + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Adds a document to this index, using the provided analyzer instead of the + one specific in the constructor. If the document contains more than + {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are + discarded. + + + + IllegalStateException if the index is closed + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Adds a document to this index. If the document contains more than + {@link #SetMaxFieldLength(int)} terms for a given field, the remainder are + discarded. + + + + IllegalStateException if the index is closed + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Deletes all documents containing term. + This is useful if one uses a document field to hold a unique ID string for + the document. Then to delete such a document, one merely constructs a + term with the appropriate field and the unique ID string as its text and + passes it to this method. Returns the number of documents deleted. + + the number of documents deleted + + + + IllegalStateException if the index is closed + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Deletes the document numbered docNum. + + + StaleReaderException if the index has changed + since this reader was opened + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IllegalStateException if the index is closed + + + Returns the number of documents currently in this + index. If the writer is currently open, this returns + {@link IndexWriter#DocCount()}, else {@link + IndexReader#NumDocs()}. But, note that {@link + IndexWriter#DocCount()} does not take deletions into + account, unlike {@link IndexReader#numDocs}. + + IllegalStateException if the index is closed + + + Merges all segments together into a single segment, optimizing an index + for search. + + + + IllegalStateException if the index is closed + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + If non-null, information about merges and a message when + {@link #GetMaxFieldLength()} is reached will be printed to this. +

    Example: index.setInfoStream(System.err); +

    + + + IllegalStateException if the index is closed +     + + + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Setting to turn on usage of a compound file. When on, multiple files + for each segment are merged into a single file once the segment creation + is finished. This is done regardless of what directory is in use. + + + + IllegalStateException if the index is closed + + + + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + The maximum number of terms that will be indexed for a single field in a + document. This limits the amount of memory required for indexing, so that + collections with very large files will not crash the indexing process by + running out of memory.

    + Note that this effectively truncates large documents, excluding from the + index terms that occur further in the document. If you know your source + documents are large, be sure to set this value high enough to accommodate + the expected size. If you set it to Integer.MAX_VALUE, then the only limit + is your memory, but you should anticipate an OutOfMemoryError.

    + By default, no more than 10,000 terms will be indexed for a field. +

    + + + IllegalStateException if the index is closed +     + + + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Determines the minimal number of documents required before the buffered + in-memory documents are merging and a new Segment is created. + Since Documents are merged in a {@link Lucene.Net.Store.RAMDirectory}, + large value gives faster indexing. At the same time, mergeFactor limits + the number of files open in a FSDirectory. + +

    The default value is 10. + +

    + + + IllegalStateException if the index is closed + IllegalArgumentException if maxBufferedDocs is smaller than 2 +     + + + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Determines how often segment indices are merged by addDocument(). With + smaller values, less RAM is used while indexing, and searches on + unoptimized indices are faster, but indexing speed is slower. With larger + values, more RAM is used during indexing, and while searches on unoptimized + indices are slower, indexing is faster. Thus larger values (> 10) are best + for batch index creation, and smaller values (< 10) for indices that are + interactively maintained. +

    This must never be less than 2. The default value is 10. + +

    + + + IllegalStateException if the index is closed +     + + + + CorruptIndexException if the index is corrupt + LockObtainFailedException if another writer + has this index open (write.lock could not + be obtained) + + IOException if there is a low-level IO error + + + Close this index, writing all pending changes to disk. + + + IllegalStateException if the index has been closed before already + CorruptIndexException if the index is corrupt + IOException if there is a low-level IO error + + + This class keeps track of closing the underlying directory. It is used to wrap + DirectoryReaders, that are created using a String/File parameter + in IndexReader.open() with FSDirectory.getDirectory(). + + This helper class is removed with all String/File + IndexReader.open() methods in Lucene 3.0 + + + + This member contains the ref counter, that is passed to each instance after cloning/reopening, + and is global to all DirectoryOwningReader derived from the original one. + This reuses the class {@link SegmentReader.Ref} + + + + Provides support for converting dates to strings and vice-versa. + The strings are structured so that lexicographic sorting orders + them by date, which makes them suitable for use as field values + and search terms. + +

    This class also helps you to limit the resolution of your dates. Do not + save dates with a finer resolution than you really need, as then + RangeQuery and PrefixQuery will require more memory and become slower. + +

    Compared to {@link DateField} the strings generated by the methods + in this class take slightly more space, unless your selected resolution + is set to Resolution.DAY or lower. + +

    + Another approach is {@link NumericUtils}, which provides + a sortable binary representation (prefix encoded) of numeric values, which + date/time are. + For indexing a {@link Date} or {@link Calendar}, just get the unix timestamp as + long using {@link Date#getTime} or {@link Calendar#getTimeInMillis} and + index this as a numeric value with {@link NumericField} + and use {@link NumericRangeQuery} to query it. +

    +     + + Converts a Date to a string suitable for indexing. + + + the date to be converted + + the desired resolution, see + {@link #Round(Date, DateTools.Resolution)} + + a string in format yyyyMMddHHmmssSSS or shorter, + depending on resolution; using GMT as timezone + + + + Converts a millisecond time to a string suitable for indexing. + + + the date expressed as milliseconds since January 1, 1970, 00:00:00 GMT + + the desired resolution, see + {@link #Round(long, DateTools.Resolution)} + + a string in format yyyyMMddHHmmssSSS or shorter, + depending on resolution; using GMT as timezone + + + + Converts a string produced by timeToString or + DateToString back to a time, represented as the + number of milliseconds since January 1, 1970, 00:00:00 GMT. + + + the date string to be converted + + the number of milliseconds since January 1, 1970, 00:00:00 GMT + + ParseException if dateString is not in the + expected format + + + + Converts a string produced by timeToString or + DateToString back to a time, represented as a + Date object. + + + the date string to be converted + + the parsed time as a Date object + + ParseException if dateString is not in the + expected format + + + + Limit a date's resolution. For example, the date 2004-09-21 13:50:11 + will be changed to 2004-09-01 00:00:00 when using + Resolution.MONTH. + + + The desired resolution of the date to be returned + + the date with all values more precise than resolution + set to 0 or 1 + + + + Limit a date's resolution. For example, the date 1095767411000 + (which represents 2004-09-21 13:50:11) will be changed to + 1093989600000 (2004-09-01 00:00:00) when using + Resolution.MONTH. + + + The time in milliseconds (not ticks). + The desired resolution of the date to be returned + + the date with all values more precise than resolution + set to 0 or 1, expressed as milliseconds since January 1, 1970, 00:00:00 GMT + + + + Specifies the time granularity. + + + Loader for text files that represent a list of stopwords. + + + + $Id: WordlistLoader.java 706342 2008-10-20 17:19:29Z gsingers $ + + + + Loads a text file and adds every line as an entry to a HashSet (omitting + leading and trailing whitespace). Every line of the file should contain only + one word. The words need to be in lowercase if you make use of an + Analyzer which uses LowerCaseFilter (like StandardAnalyzer). + + + File containing the wordlist + + A HashSet with the file's words + + + + Loads a text file and adds every non-comment line as an entry to a HashSet (omitting + leading and trailing whitespace). Every line of the file should contain only + one word. The words need to be in lowercase if you make use of an + Analyzer which uses LowerCaseFilter (like StandardAnalyzer). + + + File containing the wordlist + + The comment string to ignore + + A HashSet with the file's words + + + + Reads lines from a Reader and adds every line as an entry to a HashSet (omitting + leading and trailing whitespace). Every line of the Reader should contain only + one word. The words need to be in lowercase if you make use of an + Analyzer which uses LowerCaseFilter (like StandardAnalyzer). + + + Reader containing the wordlist + + A HashSet with the reader's words + + + + Reads lines from a Reader and adds every non-comment line as an entry to a HashSet (omitting + leading and trailing whitespace). Every line of the Reader should contain only + one word. The words need to be in lowercase if you make use of an + Analyzer which uses LowerCaseFilter (like StandardAnalyzer). + + + Reader containing the wordlist + + The string representing a comment. + + A HashSet with the reader's words + + + + Reads a stem dictionary. Each line contains: + 
    word\tstem
    + (i.e. two tab seperated words) + +     + stem dictionary that overrules the stemming algorithm + + IOException +     + + This class is a scanner generated by + JFlex 1.4.1 + on 9/4/08 6:49 PM from the specification file + /tango/mike/src/lucene.standarddigit/src/java/org/apache/lucene/analysis/standard/StandardTokenizerImpl.jflex + + + + This character denotes the end of file + + + initial size of the lookahead buffer + + + lexical states + + + Translates characters to character classes + + + Translates characters to character classes + + + Translates DFA states to action switch labels. + + + Translates a state to a row index in the transition table + + + The transition table of the DFA + + + ZZ_ATTRIBUTE[aState] contains the attributes of state aState + + + the input device + + + the current state of the DFA + + + the current lexical state + + + this buffer contains the current text to be matched and is + the source of the yytext() string + + + + the textposition at the last accepting state + + + the textposition at the last state to be included in yytext + + + the current text position in the buffer + + + startRead marks the beginning of the yytext() string in the buffer + + + endRead marks the last character in the buffer, that has been read + from input + + + + number of newlines encountered up to the start of the matched text + + + the number of characters up to the start of the matched text + + + the number of characters from the last newline up to the start of the + matched text + + + + zzAtBOL == true <=> the scanner is currently at the beginning of a line + + + zzAtEOF == true <=> the scanner is at the EOF + + + this solves a bug where HOSTs that end with '.' are identified + as ACRONYMs. It is deprecated and will be removed in the next + release. + + + + Fills Lucene token with the current token text. + + + Fills TermAttribute with the current token text. + + + Creates a new scanner + There is also a java.io.InputStream version of this constructor. + + + the java.io.Reader to read input from. + + + + Creates a new scanner. + There is also java.io.Reader version of this constructor. + + + the java.io.Inputstream to read input from. + + + + Unpacks the compressed character translation table. + + + the packed character translation table + + the unpacked character translation table + + + + Refills the input buffer. + + + false, iff there was new input. + + + if any I/O-Error occurs + + + + Closes the input stream. + + + Resets the scanner to read from a new input stream. + Does not close the old reader. + + All internal variables are reset, the old input stream + cannot be reused (internal buffer is discarded and lost). + Lexical state is set to ZZ_INITIAL. + + + the new input stream + + + + Returns the current lexical state. + + + Enters a new lexical state + + + the new lexical state + + + + Returns the text matched by the current regular expression. + + + Returns the character at position pos from the + matched text. + + It is equivalent to yytext().charAt(pos), but faster + + + the position of the character to fetch. + A value from 0 to yylength()-1. + + + the character at position pos + + + + Returns the length of the matched text region. + + + Reports an error that occured while scanning. + + In a wellformed scanner (no or only correct usage of + yypushback(int) and a match-all fallback rule) this method + will only be called with things that "Can't Possibly Happen". + If this method is called, something is seriously wrong + (e.g. a JFlex bug producing a faulty scanner etc.). + + Usual syntax/scanner level error handling should be done + in error fallback rules. + + + the code of the errormessage to display + + + + Pushes the specified amount of characters back into the input stream. + + They will be read again by then next call of the scanning method + + + the number of characters to be read again. + This number must not be greater than yylength()! + + + + Resumes scanning until the next regular expression is matched, + the end of input is encountered or an I/O-Error occurs. + + + the next token + + if any I/O-Error occurs + + Floating point numbers smaller than 32 bits. - yonik - $Id$ - + + Converts a 32 bit float to an 8 bit float. +
    Values less than zero are all mapped to zero. +
    Values are truncated (rounded down) to the nearest 8 bit value. +
    Values between zero and the smallest representable value + are rounded up. + +     + the 32 bit float to be converted to an 8 bit float (byte) + + the number of mantissa bits to use in the byte, with the remainder to be used in the exponent + + the zero-point in the range of exponent values + + the 8 bit float representation + +     Converts an 8 bit float to a 32 bit float. - + + floatToByte(b, mantissaBits=3, zeroExponent=15) +
    smallest non-zero value = 5.820766E-10 +
    largest value = 7.5161928E9 +
    epsilon = 0.125 +     +     byteToFloat(b, mantissaBits=3, zeroExponent=15) - + + floatToByte(b, mantissaBits=5, zeroExponent=2) +
    smallest nonzero value = 0.033203125 +
    largest value = 1984.0 +
    epsilon = 0.03125 +     +     byteToFloat(b, mantissaBits=5, zeroExponent=2) + + Estimates the size of a given Object using a given MemoryModel for primitive + size information. + + Resource Usage: + + Internally uses a Map to temporally hold a reference to every + object seen. + + If checkIntered, all Strings checked will be interned, but those + that were not already interned will be released for GC when the + estimate is complete. + + + + Constructs this object with an AverageGuessMemoryModel and + checkInterned = true. + + + + check if Strings are interned and don't add to size + if they are. Defaults to true but if you know the objects you are checking + won't likely contain many interned Strings, it will be faster to turn off + intern checking. + + + + MemoryModel to use for primitive object sizes. + + + + MemoryModel to use for primitive object sizes. + + check if Strings are interned and don't add to size + if they are. Defaults to true but if you know the objects you are checking + won't likely contain many interned Strings, it will be faster to turn off + intern checking. + + + + Return good default units based on byte size. + + + + The maximum number of items to cache. + + + + + The list to efficiently maintain the LRU state. + + + + + The dictionary to hash into any location in the list. + + + + + The node instance to use/re-use when adding an item to the cache. + + + + + Container to hold the key and value to aid in removal from + the dictionary when an item is removed from cache. + + + + An average, best guess, MemoryModel that should work okay on most systems. + + + + + Returns primitive memory sizes for estimating RAM usage. + + + + + size of array beyond contents + + + + Class size overhead + + + + a primitive Class - bool, byte, char, short, long, float, + short, double, int + + the size in bytes of given primitive Class + + + + size of reference + + + + A {@link LockFactory} that wraps another {@link + LockFactory} and verifies that each lock obtain/release + is "correct" (never results in two processes holding the + lock at the same time). It does this by contacting an + external server ({@link LockVerifyServer}) to assert that + at most one process holds the lock at a time. To use + this, you should also run {@link LockVerifyServer} on the + host & port matching what you pass to the constructor. + + + + + + + + + should be a unique id across all clients + + the LockFactory that we are testing + + host or IP where {@link LockVerifyServer} + is running + + the port {@link LockVerifyServer} is + listening on + + + + A memory-resident {@link IndexInput} implementation. + + + $Id: RAMInputStream.java 632120 2008-02-28 21:13:59Z mikemccand $ + + + + Subclass of FilteredTermEnum for enumerating all terms that match the + specified wildcard filter term. +

    + Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. + +

    + $Id: WildcardTermEnum.java 783371 2009-06-10 14:39:56Z mikemccand $ + +     + + ***************************************** + String equality with support for wildcards + ****************************************** + + + + Creates a new WildcardTermEnum. +

    + After calling the constructor the enumeration is already pointing to the first + valid term if such a term exists. +

    +     + + Determines if a word matches a wildcard pattern. + Work released by Granta Design Ltd after originally being done on + company time. + + + + A {@link Collector} implementation that collects the top-scoring hits, + returning them as a {@link TopDocs}. This is used by {@link IndexSearcher} to + implement {@link TopDocs}-based search. Hits are sorted by score descending + and then (when the scores are tied) docID ascending. When you create an + instance of this collector you should know in advance whether documents are + going to be collected in doc Id order or not. + +

    NOTE: The values {@link Float#NaN} and + {Float#NEGATIVE_INFINITY} are not valid scores. This + collector will not properly collect hits with such + scores. +

    +     + + Creates a new {@link TopScoreDocCollector} given the number of hits to + collect and whether documents are scored in order by the input + {@link Scorer} to {@link #SetScorer(Scorer)}. + +

    NOTE: The instances returned by this method + pre-allocate a full array of length + numHits, and fill the array with sentinel + objects. +

    +     + + A Filter that restricts search results to a range of values in a given + field. + +

    This filter matches the documents looking for terms that fall into the + supplied range according to {@link String#compareTo(String)}. It is not intended + for numerical ranges, use {@link NumericRangeFilter} instead. + +

    If you construct a large number of range filters with different ranges but on the + same field, {@link FieldCacheRangeFilter} may have significantly better performance. +

    + 2.9 + +     + + The field this range applies to + + The lower bound on this range + + The upper bound on this range + + Does this range include the lower bound? + + Does this range include the upper bound? + + IllegalArgumentException if both terms are null or if + lowerTerm is null and includeLower is true (similar for upperTerm + and includeUpper) + + + + WARNING: Using this constructor and supplying a non-null + value in the collator parameter will cause every single + index Term in the Field referenced by lowerTerm and/or upperTerm to be + examined. Depending on the number of index Terms in this Field, the + operation could be very slow. + + + The lower bound on this range + + The upper bound on this range + + Does this range include the lower bound? + + Does this range include the upper bound? + + The collator to use when determining range inclusion; set + to null to use Unicode code point ordering instead of collation. + + IllegalArgumentException if both terms are null or if + lowerTerm is null and includeLower is true (similar for upperTerm + and includeUpper) + + + + Constructs a filter for field fieldName matching + less than or equal to upperTerm. + + + + Constructs a filter for field fieldName matching + greater than or equal to lowerTerm. + + + + Returns the field name for this filter + + + Returns the lower value of this range filter + + + Returns the upper value of this range filter + + + Returns true if the lower endpoint is inclusive + + + Returns true if the upper endpoint is inclusive + + + Returns the collator used to determine range inclusion, if any. + + + Removes matches which overlap with another SpanQuery. + + + Construct a SpanNotQuery matching spans from include which + have no overlap with spans from exclude. + + + + Return the SpanQuery whose matches are filtered. + + + Return the SpanQuery whose matches must not overlap those returned. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + + Returns true iff o is equal to this. + + + Matches spans which are near one another. One can specify slop, the + maximum number of intervening unmatched positions, as well as whether + matches are required to be in-order. + + + + Construct a SpanNearQuery. Matches spans matching a span from each + clause, with up to slop total unmatched positions between + them. * When inOrder is true, the spans from each clause + must be * ordered as in clauses. + + + + Return the clauses whose spans are matched. + + + Return the maximum number of intervening unmatched positions permitted. + + + Return true if matches are required to be in-order. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + + Returns true iff o is equal to this. + + + Calculates the minimum payload seen + + + + + + Expert: obtains short field values from the + {@link Lucene.Net.Search.FieldCache FieldCache} + using getShorts() and makes those values + available as other numeric types, casting as needed. + +

    + WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

    + for requirements + on the field. + +

    NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

    + + + +

    Create a cached short field source with default string-to-short parser. +     + + Create a cached short field source with a specific string-to-short parser. + + + Query that sets document score as a programmatic function of several (sub) scores: +
      +
    1. the score of its subQuery (any query)
      2. +
    2. (optional) the score of its ValueSourceQuery (or queries). + For most simple/convenient use cases this query is likely to be a + {@link Lucene.Net.Search.Function.FieldScoreQuery FieldScoreQuery}
      3. +
    + Subclasses can modify the computation by overriding {@link #getCustomScoreProvider}. + +

    + WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. +

    +     + + Create a CustomScoreQuery over input subQuery. + the sub query whose scored is being customed. Must not be null. + + + + Create a CustomScoreQuery over input subQuery and a {@link ValueSourceQuery}. + the sub query whose score is being customed. Must not be null. + + a value source query whose scores are used in the custom score + computation. For most simple/convineient use case this would be a + {@link Lucene.Net.Search.Function.FieldScoreQuery FieldScoreQuery}. + This parameter is optional - it can be null or even an empty array. + + + + Create a CustomScoreQuery over input subQuery and a {@link ValueSourceQuery}. + the sub query whose score is being customized. Must not be null. + + value source queries whose scores are used in the custom score + computation. For most simple/convenient use case these would be + {@link Lucene.Net.Search.Function.FieldScoreQuery FieldScoreQueries}. + This parameter is optional - it can be null or even an empty array. + + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + + + Returns a {@link CustomScoreProvider} that calculates the custom scores + for the given {@link IndexReader}. The default implementation returns a default + implementation as specified in the docs of {@link CustomScoreProvider}. + @since 2.9.2 + + + + Compute a custom score by the subQuery score and a number of + ValueSourceQuery scores. + + The doc is relative to the current reader, which is + unknown to CustomScoreQuery when using per-segment search (since Lucene 2.9). + Please override {@link #getCustomScoreProvider} and return a subclass + of {@link CustomScoreProvider} for the given {@link IndexReader}. + see CustomScoreProvider#customScore(int,float,float[]) + + + + Compute a custom score by the subQuery score and the ValueSourceQuery score. + + The doc is relative to the current reader, which is + unknown to CustomScoreQuery when using per-segment search (since Lucene 2.9). + Please override {@link #getCustomScoreProvider} and return a subclass + of {@link CustomScoreProvider} for the given {@link IndexReader}. + @see CustomScoreProvider#customScore(int,float,float) + + + + Explain the custom score. + + The doc is relative to the current reader, which is + unknown to CustomScoreQuery when using per-segment search (since Lucene 2.9). + Please override {@link #getCustomScoreProvider} and return a subclass + of {@link CustomScoreProvider} for the given {@link IndexReader}. + + + + Explain the custom score. + The doc is relative to the current reader, which is + unknown to CustomScoreQuery when using per-segment search (since Lucene 2.9). + Please override {@link #getCustomScoreProvider} and return a subclass + of {@link CustomScoreProvider} for the given {@link IndexReader}. + + + + Checks if this is strict custom scoring. + In strict custom scoring, the ValueSource part does not participate in weight normalization. + This may be useful when one wants full control over how scores are modified, and does + not care about normalizing by the ValueSource part. + One particular case where this is useful if for testing this query. +

    + Note: only has effect when the ValueSource part is not null. +

    +     + + Set the strict mode of this query. + The strict mode to set. + + + + + + A short name of this query, used in {@link #ToString(String)}. + + + + + Creates a new instance of the provider class for the given IndexReader. + + + + + * Compute a custom score by the subQuery score and a number of + ValueSourceQuery scores. +

    + Subclasses can override this method to modify the custom score. +

    + If your custom scoring is different than the default herein you + should override at least one of the two customScore() methods. + If the number of ValueSourceQueries is always < 2 it is + sufficient to override the other + {@link #customScore(int, float, float) customScore()} + method, which is simpler. +

    + The default computation herein is a multiplication of given scores: + 

    +                ModifiedScore = valSrcScore * valSrcScores[0] * valSrcScores[1] * ...
+
    +     + id of scored doc + score of that doc by the subQuery + scores of that doc by the ValueSourceQuery + custom score +     + + + + Explain the custom score. + Whenever overriding {@link #customScore(int, float, float[])}, + this method should also be overridden to provide the correct explanation + for the part of the custom scoring. + + doc being explained + explanation for the sub-query part + explanation for the value source part + an explanation for the custom score + + + + Explain the custom score. + Whenever overriding {@link #customScore(int, float, float)}, + this method should also be overridden to provide the correct explanation + for the part of the custom scoring. + + + doc being explained + explanation for the sub-query part + explanation for the value source part + an explanation for the custom score + + + A scorer that applies a (callback) function on scores of the subQuery. + + + use {@link #NextDoc()} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #Advance(int)} instead. + + + + A TermInfo is the record of information stored for a term. + + + The number of documents which contain the term. + + + Store a sorted collection of {@link Lucene.Net.Index.TermVectorEntry}s. Collects all term information + into a single, SortedSet. +
    + NOTE: This Mapper ignores all Field information for the Document. This means that if you are using offset/positions you will not + know what Fields they correlate with. +
    + This is not thread-safe +     +     + + Stand-in name for the field in {@link TermVectorEntry}. + + + + A Comparator for sorting {@link TermVectorEntry}s + + + + + The term to map + + The frequency of the term + + Offset information, may be null + + Position information, may be null + + + + The TermVectorEntrySet. A SortedSet of {@link TermVectorEntry} objects. Sort is by the comparator passed into the constructor. +
    + This set will be empty until after the mapping process takes place. + +     + The SortedSet of {@link TermVectorEntry}. + +     + + For each Field, store a sorted collection of {@link TermVectorEntry}s +

    + This is not thread-safe. +

    +     + + + A Comparator for sorting {@link TermVectorEntry}s + + + + Get the mapping between fields and terms, sorted by the comparator + + + A map between field names and {@link java.util.SortedSet}s per field. SortedSet entries are {@link TermVectorEntry} + + + + Access to the Fieldable Info file that describes document fields and whether or + not they are indexed. Each segment has a separate Fieldable Info file. Objects + of this class are thread-safe for multiple readers, but only one thread can + be adding documents at a time, with no other reader or writer threads + accessing this object. + + + + Construct a FieldInfos object using the directory and the name of the file + IndexInput + + The directory to open the IndexInput from + + The name of the file to open the IndexInput from in the Directory + + IOException + + + Returns a deep clone of this FieldInfos instance. + + + Adds field info for a Document. + + + Returns true if any fields do not omitTermFreqAndPositions + + + Add fields that are indexed. Whether they have termvectors has to be specified. + + + The names of the fields + + Whether the fields store term vectors or not + + true if positions should be stored. + + true if offsets should be stored + + + + Assumes the fields are not storing term vectors. + + + The names of the fields + + Whether the fields are indexed or not + + + + + + + Calls 5 parameter add with false for all TermVector parameters. + + + The name of the Fieldable + + true if the field is indexed + + + + + + Calls 5 parameter add with false for term vector positions and offsets. + + + The name of the field + + true if the field is indexed + + true if the term vector should be stored + + + + If the field is not yet known, adds it. If it is known, checks to make + sure that the isIndexed flag is the same as was given previously for this + field. If not - marks it as being indexed. Same goes for the TermVector + parameters. + + + The name of the field + + true if the field is indexed + + true if the term vector should be stored + + true if the term vector with positions should be stored + + true if the term vector with offsets should be stored + + + + If the field is not yet known, adds it. If it is known, checks to make + sure that the isIndexed flag is the same as was given previously for this + field. If not - marks it as being indexed. Same goes for the TermVector + parameters. + + + The name of the field + + true if the field is indexed + + true if the term vector should be stored + + true if the term vector with positions should be stored + + true if the term vector with offsets should be stored + + true if the norms for the indexed field should be omitted + + + + If the field is not yet known, adds it. If it is known, checks to make + sure that the isIndexed flag is the same as was given previously for this + field. If not - marks it as being indexed. Same goes for the TermVector + parameters. + + + The name of the field + + true if the field is indexed + + true if the term vector should be stored + + true if the term vector with positions should be stored + + true if the term vector with offsets should be stored + + true if the norms for the indexed field should be omitted + + true if payloads should be stored for this field + + true if term freqs should be omitted for this field + + + + Return the fieldName identified by its number. + + + + + the fieldName or an empty string when the field + with the given number doesn't exist. + + + + Return the fieldinfo object referenced by the fieldNumber. + + + the FieldInfo object or null when the given fieldNumber + doesn't exist. + + + + + Stemmer, implementing the Porter Stemming Algorithm + + The Stemmer class transforms a word into its root form. The input + word can be provided a character at time (by calling add()), or at once + by calling one of the various stem(something) methods. + + + + reset() resets the stemmer so it can stem another word. If you invoke + the stemmer by calling add(char) and then stem(), you must call reset() + before starting another word. + + + + Add a character to the word being stemmed. When you are finished + adding characters, you can call stem(void) to process the word. + + + + After a word has been stemmed, it can be retrieved by toString(), + or a reference to the internal buffer can be retrieved by getResultBuffer + and getResultLength (which is generally more efficient.) + + + + Returns the length of the word resulting from the stemming process. + + + Returns a reference to a character buffer containing the results of + the stemming process. You also need to consult getResultLength() + to determine the length of the result. + + + + Stem a word provided as a String. Returns the result as a String. + + + Stem a word contained in a char[]. Returns true if the stemming process + resulted in a word different from the input. You can retrieve the + result with getResultLength()/getResultBuffer() or toString(). + + + + Stem a word contained in a portion of a char[] array. Returns + true if the stemming process resulted in a word different from + the input. You can retrieve the result with + getResultLength()/getResultBuffer() or toString(). + + + + Stem a word contained in a leading portion of a char[] array. + Returns true if the stemming process resulted in a word different + from the input. You can retrieve the result with + getResultLength()/getResultBuffer() or toString(). + + + + Stem the word placed into the Stemmer buffer through calls to add(). + Returns true if the stemming process resulted in a word different + from the input. You can retrieve the result with + getResultLength()/getResultBuffer() or toString(). + + + + Test program for demonstrating the Stemmer. It reads a file and + stems each word, writing the result to standard out. + Usage: Stemmer file-name + + Methods for manipulating strings. - $Id: StringHelper.java 150248 2004-03-25 13:39:59Z otis $ + $Id: StringHelper.java 801344 2009-08-05 18:05:06Z yonik $ + + Expert: + The StringInterner implementation used by Lucene. + This shouldn't be changed to an incompatible implementation after other Lucene APIs have been used. + + + + Return the same string object for all equal strings + + + Compares two byte[] arrays, element by element, and returns the + number of elements common to both arrays. + + + The first byte[] to compare + + The second byte[] to compare + + The number of common elements. + + Compares two strings, character by character, and returns the first position where the two strings differ from one another. @@ -6736,8 +24818,2476 @@ The first position where the two strings differ. + +

    Implements {@link LockFactory} using {@link + File#createNewFile()}.

    + +

    NOTE: the javadocs + for File.createNewFile contain a vague + yet spooky warning about not using the API for file + locking. This warning was added due to this + bug, and in fact the only known problem with using + this API for locking is that the Lucene write lock may + not be released when the JVM exits abnormally.

    +

    When this happens, a {@link LockObtainFailedException} + is hit when trying to create a writer, in which case you + need to explicitly clear the lock file first. You can + either manually remove the file, or use the {@link + org.apache.lucene.index.IndexReader#unlock(Directory)} + API. But, first be certain that no writer is in fact + writing to the index otherwise you can easily corrupt + your index.

    + +

    If you suspect that this or any other LockFactory is + not working properly in your environment, you can easily + test it by using {@link VerifyingLockFactory}, {@link + LockVerifyServer} and {@link LockStressTest}.

    + +

    + + +     + + Create a SimpleFSLockFactory instance, with null (unset) + lock directory. When you pass this factory to a {@link FSDirectory} + subclass, the lock directory is automatically set to the + directory itsself. Be sure to create one instance for each directory + your create! + + + + Instantiate using the provided directory (as a File instance). + where lock files should be created. + + + + Instantiate using the provided directory (as a File instance). + where lock files should be created. + + + + Instantiate using the provided directory name (String). + where lock files should be created. + + + + A Spans that is formed from the ordered subspans of a SpanNearQuery + where the subspans do not overlap and have a maximum slop between them. +

    + The formed spans only contains minimum slop matches.
    + The matching slop is computed from the distance(s) between + the non overlapping matching Spans.
    + Successive matches are always formed from the successive Spans + of the SpanNearQuery. +

    + The formed spans may contain overlaps when the slop is at least 1. + For example, when querying using + 

    t1 t2 t3
    + with slop at least 1, the fragment: + 
    t1 t2 t1 t3 t2 t3
    + matches twice: + 
    t1 t2 .. t3
    + 
          t1 .. t2 t3
    + + + Expert: + Only public for subclassing. Most implementations should not need this class +     +     + + The spans in the same order as the SpanNearQuery + + + Indicates that all subSpans have same doc() + + + Advances the subSpans to just after an ordered match with a minimum slop + that is smaller than the slop allowed by the SpanNearQuery. + + true iff there is such a match. + + + + Advance the subSpans to the same document + + + Check whether two Spans in the same document are ordered. + + + + + true iff spans1 starts before spans2 + or the spans start at the same position, + and spans1 ends before spans2. + + + + Like {@link #DocSpansOrdered(Spans,Spans)}, but use the spans + starts and ends as parameters. + + + + Order the subSpans within the same document by advancing all later spans + after the previous one. + + + + The subSpans are ordered in the same doc, so there is a possible match. + Compute the slop while making the match as short as possible by advancing + all subSpans except the last one in reverse order. + + + + + + + + + + + The original list of terms from the query, can contain duplicates + + + + This class is very similar to + {@link Lucene.Net.Search.Spans.SpanNearQuery} except that it factors + in the value of the payloads located at each of the positions where the + {@link Lucene.Net.Search.Spans.TermSpans} occurs. +

    + In order to take advantage of this, you must override + {@link Lucene.Net.Search.Similarity#ScorePayload(String, byte[],int,int)} + which returns 1 by default. +

    + Payload scores are aggregated using a pluggable {@link PayloadFunction}. + +

    + + +     + + By default, uses the {@link PayloadFunction} to score the payloads, but + can be overridden to do other things. + + + The payloads + + The start position of the span being scored + + The end position of the span being scored + + + + + + + This class wraps another ValueSource, but protects + against accidental double RAM usage in FieldCache when + a composite reader is passed to {@link #getValues}. + +

    NOTE: this class adds a CPU penalty to every + lookup, as it must resolve the incoming document to the + right sub-reader using a binary search.

    + +

    + This class is temporary, to ease the + migration to segment-based searching. Please change your + code to not pass composite readers to these APIs. + +     + + A query that generates the union of documents produced by its subqueries, and that scores each document with the maximum + score for that document as produced by any subquery, plus a tie breaking increment for any additional matching subqueries. + This is useful when searching for a word in multiple fields with different boost factors (so that the fields cannot be + combined equivalently into a single search field). We want the primary score to be the one associated with the highest boost, + not the sum of the field scores (as BooleanQuery would give). + If the query is "albino elephant" this ensures that "albino" matching one field and "elephant" matching + another gets a higher score than "albino" matching both fields. + To get this result, use both BooleanQuery and DisjunctionMaxQuery: for each term a DisjunctionMaxQuery searches for it in + each field, while the set of these DisjunctionMaxQuery's is combined into a BooleanQuery. + The tie breaker capability allows results that include the same term in multiple fields to be judged better than results that + include this term in only the best of those multiple fields, without confusing this with the better case of two different terms + in the multiple fields. + + + + Creates a new empty DisjunctionMaxQuery. Use add() to add the subqueries. + the score of each non-maximum disjunct for a document is multiplied by this weight + and added into the final score. If non-zero, the value should be small, on the order of 0.1, which says that + 10 occurrences of word in a lower-scored field that is also in a higher scored field is just as good as a unique + word in the lower scored field (i.e., one that is not in any higher scored field. + + + + Creates a new DisjunctionMaxQuery + a Collection<Query> of all the disjuncts to add + + the weight to give to each matching non-maximum disjunct + + + + Add a subquery to this disjunction + the disjunct added + + + + Add a collection of disjuncts to this disjunction + via Iterable + + + + An Iterator<Query> over the disjuncts + + + Optimize our representation and our subqueries representations + the IndexReader we query + + an optimized copy of us (which may not be a copy if there is nothing to optimize) + + + + Create a shallow copy of us -- used in rewriting if necessary + a copy of us (but reuse, don't copy, our subqueries) + + + + Prettyprint us. + the field to which we are applied + + a string that shows what we do, of the form "(disjunct1 | disjunct2 | ... | disjunctn)^boost" + + + + Return true iff we represent the same query as o + another object + + true iff o is a DisjunctionMaxQuery with the same boost and the same subqueries, in the same order, as us + + + + Compute a hash code for hashing us + the hash code + + + + Expert: the Weight for DisjunctionMaxQuery, used to + normalize, score and explain these queries. + +

    NOTE: this API and implementation is subject to + change suddenly in the next release.

    +

    +     + + The Similarity implementation. + + + The Weights for our subqueries, in 1-1 correspondence with disjuncts + + + Expert: Default scoring implementation. + + + Implemented as + state.getBoost()*lengthNorm(numTerms), where + numTerms is {@link FieldInvertState#GetLength()} if {@link + #setDiscountOverlaps} is false, else it's {@link + FieldInvertState#GetLength()} - {@link + FieldInvertState#GetNumOverlap()}. + +

    WARNING: This API is new and experimental, and may suddenly + change.

    +

    +     + + Implemented as 1/sqrt(numTerms). + + + Implemented as 1/sqrt(sumOfSquaredWeights). + + + Implemented as sqrt(freq). + + + Implemented as 1 / (distance + 1). + + + Implemented as log(numDocs/(docFreq+1)) + 1. + + + Implemented as overlap / maxOverlap. + + + Determines whether overlap tokens (Tokens with + 0 position increment) are ignored when computing + norm. By default this is false, meaning overlap + tokens are counted just like non-overlap tokens. + +

    WARNING: This API is new and experimental, and may suddenly + change.

    + +

    + + +     + + + + + + Called once per field per document if term vectors + are enabled, to write the vectors to + RAMOutputStream, which is then quickly flushed to + * the real term vectors files in the Directory. + + + + Convenience class for holding TermVector information. + + + Collapse the hash table & sort in-place. + + + Compares term text for two Posting instance and + returns -1 if p1 < p2; 1 if p1 > p2; else 0. + + + + Test whether the text for current RawPostingList p equals + current tokenText. + + + + Called when postings hash is too small (> 50% + occupied) or too large (< 20% occupied). + + + + This is a {@link LogMergePolicy} that measures size of a + segment as the total byte size of the segment's files. + + + + + + + + Default maximum segment size. A segment of this size + + + + +

    Determines the largest segment (measured by total + byte size of the segment's files, in MB) that may be + merged with other segments. Small values (e.g., less + than 50 MB) are best for interactive indexing, as this + limits the length of pauses while indexing to a few + seconds. Larger values are best for batched indexing + and speedier searches.

    + +

    Note that {@link #setMaxMergeDocs} is also + used to check whether a segment is too large for + merging (it's either or).

    +

    +     + + Returns the largest segment (meaured by total byte + size of the segment's files, in MB) that may be merged + with other segments. + + + + + + Sets the minimum size for the lowest level segments. + Any segments below this size are considered to be on + the same level (even if they vary drastically in size) + and will be merged whenever there are mergeFactor of + them. This effectively truncates the "long tail" of + small segments that would otherwise be created into a + single level. If you set this too large, it could + greatly increase the merging cost during indexing (if + you flush many small segments). + + + + Get the minimum size for a segment to remain + un-merged. + + + + + + Adds a new term in this field + + + Called when we are done adding terms to this field + + + Removes words that are too long or too short from the stream. + + + + $Id: LengthFilter.java 807201 2009-08-24 13:22:34Z markrmiller $ + + + + Build a filter that removes words that are too long or too + short from the text. + + + + Returns the next input Token whose term() is the right len + + + Simple DocIdSet and DocIdSetIterator backed by a BitSet + + + This DocIdSet implementation is cacheable. + + + Returns the underlying BitSet. + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + This exception is thrown when you try to list a + non-existent directory. + + + + A {@link HitCollector} implementation that collects the top-sorting + documents, returning them as a {@link TopFieldDocs}. This is used by {@link + IndexSearcher} to implement {@link TopFieldDocs}-based search. + +

    This may be extended, overriding the collect method to, e.g., + conditionally invoke super() in order to filter which + documents are collected. + +

    + Please use {@link TopFieldCollector} instead. + +     + + A {@link HitCollector} implementation that collects the top-scoring + documents, returning them as a {@link TopDocs}. This is used by {@link + IndexSearcher} to implement {@link TopDocs}-based search. + +

    This may be extended, overriding the collect method to, e.g., + conditionally invoke super() in order to filter which + documents are collected. + +

    + Please use {@link TopScoreDocCollector} + instead, which has better performance. + + +     + + The total number of hits the collector encountered. + + + The priority queue which holds the top-scoring documents. + + + Construct to collect a given number of hits. + the maximum number of hits to collect + + + + use TopDocCollector(hq) instead. numHits is not used by this + constructor. It will be removed in a future release. + + + + Constructor to collect the top-scoring documents by using the given PQ. + the PQ to use by this instance. + + + + The total number of documents that matched this query. + + + The top-scoring hits. + + + Construct to collect a given number of hits. + the index to be searched + + the sort criteria + + the maximum number of hits to collect + + + + Expert: A Scorer for documents matching a Term. + + + Construct a TermScorer. + + + The weight of the Term in the query. + + An iterator over the documents matching the Term. + + The Similarity implementation to be used for score + computations. + + The field norms of the document fields for the Term. + + + + use {@link #Score(Collector)} instead. + + + + use {@link #Score(Collector, int, int)} instead. + + + + use {@link #DocID()} instead. + + + + Advances to the next document matching the query.
    + The iterator over the matching documents is buffered using + {@link TermDocs#Read(int[],int[])}. + +     + true iff there is another document matching the query. + + use {@link #NextDoc()} instead. + +     + + Advances to the next document matching the query.
    + The iterator over the matching documents is buffered using + {@link TermDocs#Read(int[],int[])}. + +     + the document matching the query or -1 if there are no more documents. + +     + + Skips to the first match beyond the current whose document number is + greater than or equal to a given target.
    + The implementation uses {@link TermDocs#SkipTo(int)}. + +     + The target document number. + + true iff there is such a match. + + use {@link #Advance(int)} instead. + +     + + Advances to the first match beyond the current whose document number is + greater than or equal to a given target.
    + The implementation uses {@link TermDocs#SkipTo(int)}. + +     + The target document number. + + the matching document or -1 if none exist. + +     + + Returns an explanation of the score for a document. +
    When this method is used, the {@link #Next()} method + and the {@link #Score(HitCollector)} method should not be used. +     + The document number for the explanation. + +     + + Returns a string representation of this TermScorer. + + + Matches spans near the beginning of a field. + + + Construct a SpanFirstQuery matching spans in match whose end + position is less than or equal to end. + + + + Return the SpanQuery whose matches are filtered. + + + Return the maximum end position permitted in a match. + + + Returns a collection of all terms matched by this query. + use extractTerms instead + + + + + + Constrains search results to only match those which also match a provided + query. Also provides position information about where each document matches + at the cost of extra space compared with the QueryWrapperFilter. + There is an added cost to this above what is stored in a {@link QueryWrapperFilter}. Namely, + the position information for each matching document is stored. +

    + This filter does not cache. See the {@link Lucene.Net.Search.CachingSpanFilter} for a wrapper that + caches. + + +

    + $Id:$ + +     + + Constructs a filter which only matches documents matching + query. + + The {@link Lucene.Net.Search.Spans.SpanQuery} to use as the basis for the Filter. + + + + A {@link Scorer} which wraps another scorer and caches the score of the + current document. Successive calls to {@link #Score()} will return the same + result and will not invoke the wrapped Scorer's score() method, unless the + current document has changed.
    + This class might be useful due to the changes done to the {@link Collector} + interface, in which the score is not computed for a document by default, only + if the collector requests it. Some collectors may need to use the score in + several places, however all they have in hand is a {@link Scorer} object, and + might end up computing the score of a document more than once. +     +     + + Creates a new instance by wrapping the given scorer. + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + A Query that matches documents within an exclusive range of terms. + +

    This query matches the documents looking for terms that fall into the + supplied range according to {@link Term#CompareTo(Term)}. It is not intended + for numerical ranges, use {@link NumericRangeQuery} instead. + +

    This query uses {@linkplain + MultiTermQuery#SCORING_BOOLEAN_QUERY_REWRITE}. If you + want to change this, use the new {@link TermRangeQuery} + instead. + +

    + Use {@link TermRangeQuery} for term ranges or + {@link NumericRangeQuery} for numeric ranges instead. + This class will be removed in Lucene 3.0. + +     + + Constructs a query selecting all terms greater than + lowerTerm but less than upperTerm. + There must be at least one term and either term may be null, + in which case there is no bound on that side, but if there are + two terms, both terms must be for the same field. + + + The Term at the lower end of the range + + The Term at the upper end of the range + + If true, both lowerTerm and + upperTerm will themselves be included in the range. + + + + Constructs a query selecting all terms greater than + lowerTerm but less than upperTerm. + There must be at least one term and either term may be null, + in which case there is no bound on that side, but if there are + two terms, both terms must be for the same field. +

    + If collator is not null, it will be used to decide whether + index terms are within the given range, rather than using the Unicode code + point order in which index terms are stored. +

    + WARNING: Using this constructor and supplying a non-null + value in the collator parameter will cause every single + index Term in the Field referenced by lowerTerm and/or upperTerm to be + examined. Depending on the number of index Terms in this Field, the + operation could be very slow. + +

    + The Term at the lower end of the range + + The Term at the upper end of the range + + If true, both lowerTerm and + upperTerm will themselves be included in the range. + + The collator to use to collate index Terms, to determine + their membership in the range bounded by lowerTerm and + upperTerm. + +     + + Returns the field name for this query + + + Returns the lower term of this range query. + + + Returns the upper term of this range query. + + + Returns true if the range query is inclusive + + + Returns the collator used to determine range inclusion, if any. + + + Prints a user-readable version of this query. + + + Returns true iff o is equal to this. + + + Returns a hash code value for this object. + + + Expert: Collects sorted results from Searchable's and collates them. + The elements put into this queue must be of type FieldDoc. + +

    Created: Feb 11, 2004 2:04:21 PM + +

    + lucene 1.4 + + $Id: FieldDocSortedHitQueue.java 695514 2008-09-15 15:42:11Z otis $ + +     + + Creates a hit queue sorted by the given list of fields. + Fieldable names, in priority order (highest priority first). + + The number of hits to retain. Must be greater than zero. + + + + Allows redefinition of sort fields if they are null. + This is to handle the case using ParallelMultiSearcher where the + original list contains AUTO and we don't know the actual sort + type until the values come back. The fields can only be set once. + This method is thread safe. + + + + + + Returns the fields being used to sort. + + + Returns an array of collators, possibly null. The collators + correspond to any SortFields which were given a specific locale. + + Array of sort fields. + + Array, possibly null. + + + + Returns whether a is less relevant than b. + ScoreDoc + + ScoreDoc + + true if document a should be sorted after document b. + + + + Expert: Describes the score computation for document and query, and + can distinguish a match independent of a positive value. + + + + The match status of this explanation node. + May be null if match status is unknown + + + + Sets the match status assigned to this explanation node. + May be null if match status is unknown + + + + Indicates whether or not this Explanation models a good match. + +

    + If the match status is explicitly set (i.e.: not null) this method + uses it; otherwise it defers to the superclass. +

    +

    + + +     + + use {@link #Score(Collector, int, int)} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Score(Collector)} instead. + + + + use {@link #Advance(int)} instead. + + + + use {@link #DocID()} instead. + + + + use {@link #NextDoc()} instead. + + + + use {@link #Advance(int)} instead. + + + + A simple hash table of document scores within a range. + + + This class implements {@link InvertedDocConsumer}, which + is passed each token produced by the analyzer on each + field. It stores these tokens in a hash table, and + allocates separate byte streams per token. Consumers of + this class, eg {@link FreqProxTermsWriter} and {@link + TermVectorsTermsWriter}, write their own byte streams + under each term. + + + + Increments the enumeration to the next element. True if one exists. + + + Optimized scan, without allocating new terms. + Return number of invocations to next(). + + + + Returns the current Term in the enumeration. + Initially invalid, valid after next() called for the first time. + + + + Returns the previous Term enumerated. Initially null. + + + Returns the current TermInfo in the enumeration. + Initially invalid, valid after next() called for the first time. + + + + Sets the argument to the current TermInfo in the enumeration. + Initially invalid, valid after next() called for the first time. + + + + Returns the docFreq from the current TermInfo in the enumeration. + Initially invalid, valid after next() called for the first time. + + + + Closes the enumeration to further activity, freeing resources. + + + For each Field, store position by position information. It ignores frequency information +

    + This is not thread-safe. +

    +     + + A Map of Integer and TVPositionInfo + + + + + + + + Never ignores positions. This mapper doesn't make much sense unless there are positions + false + + + + Callback for the TermVectorReader. + + + + + + + + + + + Callback mechanism used by the TermVectorReader + The field being read + + The number of terms in the vector + + Whether offsets are available + + Whether positions are available + + + + Get the mapping between fields and terms, sorted by the comparator + + + A map between field names and a Map. The sub-Map key is the position as the integer, the value is {@link Lucene.Net.Index.PositionBasedTermVectorMapper.TVPositionInfo}. + + + + Container for a term at a position + + + + The position of the term + + + + Note, there may be multiple terms at the same position + A List of Strings + + + + Parallel list (to {@link #getTerms()}) of TermVectorOffsetInfo objects. There may be multiple entries since there may be multiple terms at a position + A List of TermVectorOffsetInfo objects, if offsets are store. + + + + Holds state for inverting all occurrences of a single + field in the document. This class doesn't do anything + itself; instead, it forwards the tokens produced by + analysis to its own consumer + (InvertedDocConsumerPerField). It also interacts with an + endConsumer (InvertedDocEndConsumerPerField). + + + + LowerCaseTokenizer performs the function of LetterTokenizer + and LowerCaseFilter together. It divides text at non-letters and converts + them to lower case. While it is functionally equivalent to the combination + of LetterTokenizer and LowerCaseFilter, there is a performance advantage + to doing the two tasks at once, hence this (redundant) implementation. +

    + Note: this does a decent job for most European languages, but does a terrible + job for some Asian languages, where words are not separated by spaces. +

    +     + + A LetterTokenizer is a tokenizer that divides text at non-letters. That's + to say, it defines tokens as maximal strings of adjacent letters, as defined + by java.lang.Character.isLetter() predicate. + Note: this does a decent job for most European languages, but does a terrible + job for some Asian languages, where words are not separated by spaces. + + + + Construct a new LetterTokenizer. + + + Construct a new LetterTokenizer using a given {@link AttributeSource}. + + + Construct a new LetterTokenizer using a given {@link Lucene.Net.Util.AttributeSource.AttributeFactory}. + + + Collects only characters which satisfy + {@link Character#isLetter(char)}. + + + + Construct a new LowerCaseTokenizer. + + + Construct a new LowerCaseTokenizer using a given {@link AttributeSource}. + + + Construct a new LowerCaseTokenizer using a given {@link Lucene.Net.Util.AttributeSource.AttributeFactory}. + + + Converts char to lower case + {@link Character#toLowerCase(char)}. + + + + + Not implemented. Waiting for volunteers. + + + + + Not implemented. Waiting for volunteers. + + + + Simple standalone tool that forever acquires & releases a + lock using a specific LockFactory. Run without any args + to see usage. + + + + + + + + + Expert: + Public for extension only + + + + Subclass of FilteredTermEnum for enumerating all terms that match the + specified prefix filter term. +

    + Term enumerations are always ordered by Term.compareTo(). Each term in + the enumeration is greater than all that precede it. + +

    +     + + Implements parallel search over a set of Searchables. + +

    Applications usually need only call the inherited {@link #Search(Query)} + or {@link #Search(Query,Filter)} methods. +

    +     + + Creates a searchable which searches searchables. + + + TODO: parallelize this one too + + + A search implementation which spans a new thread for each + Searchable, waits for each search to complete and merge + the results back together. + + + + A search implementation allowing sorting which spans a new thread for each + Searchable, waits for each search to complete and merges + the results back together. + + + + Lower-level search API. + +

    {@link Collector#Collect(int)} is called for every matching document. + +

    Applications should only use this if they need all of the + matching documents. The high-level search API ({@link + Searcher#Search(Query)}) is usually more efficient, as it skips + non-high-scoring hits. + +

    + to match documents + + if non-null, a bitset used to eliminate some documents + + to receive hits + + TODO: parallelize this one too + +     + + A thread subclass for searching a single searchable + + + MultiPhraseQuery is a generalized version of PhraseQuery, with an added + method {@link #Add(Term[])}. + To use this class, to search for the phrase "Microsoft app*" first use + add(Term) on the term "Microsoft", then find all terms that have "app" as + prefix using IndexReader.terms(Term), and use MultiPhraseQuery.add(Term[] + terms) to add them to the query. + + + 1.0 + + + + Sets the phrase slop for this query. + + + + + Sets the phrase slop for this query. + + + + + Add a single term at the next position in the phrase. + + + + + Add multiple terms at the next position in the phrase. Any of the terms + may match. + + + + + + + Allows to specify the relative position of terms within the phrase. + + + + + + + + + + + Returns a List<Term[]> of the terms in the multiphrase. + Do not modify the List or its contents. + + + + Returns the relative positions of terms in this phrase. + + + Prints a user-readable version of this query. + + + Returns true if o is equal to this. + + + Returns a hash code value for this object. + Lucene's package information, including version. * + + This stores a monotonically increasing set of <Term, TermInfo> pairs in a + Directory. A TermInfos can be written once, in order. + + + + The file format version, a negative number. + + + Expert: The fraction of terms in the "dictionary" which should be stored + in RAM. Smaller values use more memory, but make searching slightly + faster, while larger values use less memory and make searching slightly + slower. Searching is typically not dominated by dictionary lookup, so + tweaking this is rarely useful. + + + + Expert: The fraction of {@link TermDocs} entries stored in skip tables, + used to accellerate {@link TermDocs#SkipTo(int)}. Larger values result in + smaller indexes, greater acceleration, but fewer accelerable cases, while + smaller values result in bigger indexes, less acceleration and more + accelerable cases. More detailed experiments would be useful here. + + + + Expert: The maximum number of skip levels. Smaller values result in + slightly smaller indexes, but slower skipping in big posting lists. + + + + Adds a new <fieldNumber, termBytes>, TermInfo> pair to the set. + Term must be lexicographically greater than all previous Terms added. + TermInfo pointers must be positive and greater than all previous. + + + + Called to complete TermInfos creation. + + + This stores a monotonically increasing set of <Term, TermInfo> pairs in a + Directory. Pairs are accessed either by Term or by ordinal position the + set. + + + + Returns the number of term/value pairs in the set. + + + Returns the offset of the greatest index entry which is less than or equal to term. + + + Returns the TermInfo for a Term in the set, or null. + + + Returns the TermInfo for a Term in the set, or null. + + + Returns the position of a Term in the set or -1. + + + Returns an enumeration of all the Terms and TermInfos in the set. + + + Returns an enumeration of terms starting at or after the named term. + + + Per-thread resources managed by ThreadLocal + + + Information about a segment such as it's name, directory, and files related + to the segment. + + *

    NOTE: This API is new and still experimental + (subject to change suddenly in the next release)

    +

    +     + + Copy everything from src SegmentInfo into our instance. + + + Construct a new SegmentInfo instance by reading a + previously saved SegmentInfo from input. + + + directory to load from + + format of the segments info file + + input handle to read segment info from + + + + Returns total size in bytes of all of files used by + this segment. + + + + Returns true if this field for this segment has saved a separate norms file (_<segment>_N.sX). + + + the field index to check + + + + Returns true if any fields in this segment have separate norms. + + + Increment the generation count for the norms file for + this field. + + + field whose norm file will be rewritten + + + + Get the file name for the norms file for this field. + + + field index + + + + Mark whether this segment is stored as a compound file. + + + true if this is a compound file; + else, false + + + + Returns true if this segment is stored as a compound + file; else, false. + + + + Save this segment's info. + + + Used for debugging + + + We consider another SegmentInfo instance equal if it + has the same dir and same name. + + + + This {@link IndexDeletionPolicy} implementation that + keeps only the most recent commit and immediately removes + all prior commits after a new commit is done. This is + the default deletion policy. + + + + Deletes all commits except the most recent one. + + + Deletes all commits except the most recent one. + + + Used by DocumentsWriter to merge the postings from + multiple ThreadStates when creating a segment + + + + Provides support for converting dates to strings and vice-versa. + The strings are structured so that lexicographic sorting orders by date, + which makes them suitable for use as field values and search terms. + +

    Note that this class saves dates with millisecond granularity, + which is bad for {@link TermRangeQuery} and {@link PrefixQuery}, as those + queries are expanded to a BooleanQuery with a potentially large number + of terms when searching. Thus you might want to use + {@link DateTools} instead. + +

    + Note: dates before 1970 cannot be used, and therefore cannot be + indexed when using this class. See {@link DateTools} for an + alternative without such a limitation. + +

    + Another approach is {@link NumericUtils}, which provides + a sortable binary representation (prefix encoded) of numeric values, which + date/time are. + For indexing a {@link Date} or {@link Calendar}, just get the unix timestamp as + long using {@link Date#getTime} or {@link Calendar#getTimeInMillis} and + index this as a numeric value with {@link NumericField} + and use {@link NumericRangeQuery} to query it. + +

    + If you build a new index, use {@link DateTools} or + {@link NumericField} instead. + This class is included for use with existing + indices and will be removed in a future release. + +     + + Converts a Date to a string suitable for indexing. + RuntimeException if the date specified in the + method argument is before 1970 + + + + Converts a millisecond time to a string suitable for indexing. + RuntimeException if the time specified in the + method argument is negative, that is, before 1970 + + + + Converts a string-encoded date into a millisecond time. + + + Converts a string-encoded date into a Date object. + + + A WhitespaceTokenizer is a tokenizer that divides text at whitespace. + Adjacent sequences of non-Whitespace characters form tokens. + + + + Construct a new WhitespaceTokenizer. + + + Construct a new WhitespaceTokenizer using a given {@link AttributeSource}. + + + Construct a new WhitespaceTokenizer using a given {@link Lucene.Net.Util.AttributeSource.AttributeFactory}. + + + Collects only characters which do not satisfy + {@link Character#isWhitespace(char)}. + + + + The start and end character offset of a Token. + + + Returns this Token's starting offset, the position of the first character + corresponding to this token in the source text. + Note that the difference between endOffset() and startOffset() may not be + equal to termText.length(), as the term text may have been altered by a + stemmer or some other filter. + + + + Set the starting and ending offset. + See StartOffset() and EndOffset() + + + + Returns this Token's ending offset, one greater than the position of the + last character corresponding to this token in the source text. The length + of the token in the source text is (endOffset - startOffset). + + + + Filters {@link StandardTokenizer} with {@link StandardFilter}, + {@link LowerCaseFilter} and {@link StopFilter}, using a list of English stop + words. + + +

    + You must specify the required {@link Version} compatibility when creating + StandardAnalyzer: +

    + +     + $Id: StandardAnalyzer.java 829134 2009-10-23 17:18:53Z mikemccand $ + +     + + Default maximum allowed token length + + + Specifies whether deprecated acronyms should be replaced with HOST type. + This is false by default to support backward compatibility. + + + this should be removed in the next release (3.0). + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + + + true if new instances of StandardTokenizer will + replace mischaracterized acronyms + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + This will be removed (hardwired to true) in 3.0 + + + + + Set to true to have new + instances of StandardTokenizer replace mischaracterized + acronyms by default. Set to false to preserve the + previous (before 2.4) buggy behavior. Alternatively, + set the system property + Lucene.Net.Analysis.Standard.StandardAnalyzer.replaceInvalidAcronym + to false. + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + This will be removed (hardwired to true) in 3.0 + + + + An array containing some common English words that are usually not + useful for searching. + + Use {@link #STOP_WORDS_SET} instead + + + + An unmodifiable set containing some common English words that are usually not + useful for searching. + + + + Builds an analyzer with the default stop words ({@link + #STOP_WORDS_SET}). + + Use {@link #StandardAnalyzer(Version)} instead. + + + + Builds an analyzer with the default stop words ({@link + #STOP_WORDS}). + + Lucene version to match See {@link + above} + + + + Builds an analyzer with the given stop words. + Use {@link #StandardAnalyzer(Version, Set)} + instead + + + + Builds an analyzer with the given stop words. + Lucene version to match See {@link + above} + + stop words + + + + Builds an analyzer with the given stop words. + Use {@link #StandardAnalyzer(Version, Set)} instead + + + + Builds an analyzer with the stop words from the given file. + + + Use {@link #StandardAnalyzer(Version, File)} + instead + + + + Builds an analyzer with the stop words from the given file. + + + Lucene version to match See {@link + above} + + File to read stop words from + + + + Builds an analyzer with the stop words from the given reader. + + + Use {@link #StandardAnalyzer(Version, Reader)} + instead + + + + Builds an analyzer with the stop words from the given reader. + + + Lucene version to match See {@link + above} + + Reader to read stop words from + + + + + Set to true if this analyzer should replace mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + Remove in 3.X and make true the only valid value + + + + The stopwords to use + + Set to true if this analyzer should replace mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + Remove in 3.X and make true the only valid value + + + + The stopwords to use + + Set to true if this analyzer should replace mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + Remove in 3.X and make true the only valid value + + + + + The stopwords to use + + Set to true if this analyzer should replace mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + Remove in 3.X and make true the only valid value + + + + The stopwords to use + + Set to true if this analyzer should replace mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + + Remove in 3.X and make true the only valid value + + + + Constructs a {@link StandardTokenizer} filtered by a {@link + StandardFilter}, a {@link LowerCaseFilter} and a {@link StopFilter}. + + + + Set maximum allowed token length. If a token is seen + that exceeds this length then it is discarded. This + setting only takes effect the next time tokenStream or + reusableTokenStream is called. + + + + + + + + Use {@link #tokenStream} instead + + + + + true if this Analyzer is replacing mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + This will be removed (hardwired to true) in 3.0 + + + + + Set to true if this Analyzer is replacing mischaracterized acronyms in the StandardTokenizer + + See https://issues.apache.org/jira/browse/LUCENE-1068 + + This will be removed (hardwired to true) in 3.0 + + + + Use by certain classes to match version compatibility + across releases of Lucene. +

    + WARNING: When changing the version parameter + that you supply to components in Lucene, do not simply + change the version at search-time, but instead also adjust + your indexing code to match, and re-index. +

    +     + + +

    WARNING: if you use this setting, and then + upgrade to a newer release of Lucene, sizable changes + may happen. If precise back compatibility is important + then you should instead explicitly specify an actual + version. + If you use this constant then you may need to + re-index all of your documents when upgrading + Lucene, as the way text is indexed may have changed. + Additionally, you may need to re-test your entire + application to ensure it behaves as expected, as + some defaults may have changed and may break functionality + in your application. +

    +     + + Match settings and bugs in Lucene's 2.0 release. + + + Match settings and bugs in Lucene's 2.1 release. + + + Match settings and bugs in Lucene's 2.2 release. + + + Match settings and bugs in Lucene's 2.3 release. + + + Match settings and bugs in Lucene's 2.3 release. + + + + Class to encode java's UTF16 char[] into UTF8 byte[] + without always allocating a new byte[] as + String.getBytes("UTF-8") does. + +

    WARNING: This API is a new and experimental and + may suddenly change.

    +

    +     + + Encode characters from a char[] source, starting at + offset and stopping when the character 0xffff is seen. + Returns the number of bytes written to bytesOut. + + + + Encode characters from a char[] source, starting at + offset for length chars. Returns the number of bytes + written to bytesOut. + + + + Encode characters from this String, starting at offset + for length characters. Returns the number of bytes + written to bytesOut. + + + + Convert UTF8 bytes into UTF16 characters. If offset + is non-zero, conversion starts at that starting point + in utf8, re-using the results from the previous call + up until offset. + + + + This exception is thrown when the write.lock + could not be acquired. This + happens when a writer tries to open an index + that another writer already has open. + + + + + + Expert: A Directory instance that switches files between + two other Directory instances. +

    Files with the specified extensions are placed in the + primary directory; others are placed in the secondary + directory. The provided Set must not change once passed + to this class, and must allow multiple threads to call + contains at once.

    + +

    NOTE: this API is new and experimental and is + subject to suddenly change in the next release. +

    +     + + Return the primary directory + + + Return the secondary directory + + + Utility method to return a file's extension. + + + Constrains search results to only match those which also match a provided + query. + +

    This could be used, for example, with a {@link TermRangeQuery} on a suitably + formatted date field to implement date filtering. One could re-use a single + QueryFilter that matches, e.g., only documents modified within the last + week. The QueryFilter and TermRangeQuery would only need to be reconstructed + once per day. + +

    + $Id:$ + +     + + Constructs a filter which only matches documents matching + query. + + + + Use {@link #GetDocIdSet(IndexReader)} instead. + + + + Expert: obtains the ordinal of the field value from the default Lucene + {@link Lucene.Net.Search.FieldCache FieldCache} using getStringIndex() + and reverses the order. +

    + The native lucene index order is used to assign an ordinal value for each field value. +

    + Field values (terms) are lexicographically ordered by unicode value, and numbered starting at 1. +
    + Example of reverse ordinal (rord): +
    If there were only three field values: "apple","banana","pear" +
    then rord("apple")=3, rord("banana")=2, ord("pear")=1 +

    + WARNING: + rord() depends on the position in an index and can thus change + when other documents are inserted or deleted, + or if a MultiSearcher is used. + +

    + WARNING: The status of the Search.Function package is experimental. + The APIs introduced here might change in the future and will not be + supported anymore in such a case. + +

    NOTE: with the switch in 2.9 to segment-based + searching, if {@link #getValues} is invoked with a + composite (multi-segment) reader, this can easily cause + double RAM usage for the values in the FieldCache. It's + best to switch your application to pass only atomic + (single segment) readers to this API. Alternatively, for + a short-term fix, you could wrap your ValueSource using + {@link MultiValueSource}, which costs more CPU per lookup + but will not consume double the FieldCache RAM.

    +

    +     + + Contructor for a certain field. + field whose values reverse order is used. + + + + The Scorer for DisjunctionMaxQuery's. The union of all documents generated by the the subquery scorers + is generated in document number order. The score for each document is the maximum of the scores computed + by the subquery scorers that generate that document, plus tieBreakerMultiplier times the sum of the scores + for the other subqueries that generate the document. + + + + Creates a new instance of DisjunctionMaxScorer + + + Multiplier applied to non-maximum-scoring subqueries for a + document as they are summed into the result. + + -- not used since our definition involves neither coord nor terms + directly + + The sub scorers this Scorer should iterate on + + The actual number of scorers to iterate on. Note that the array's + length may be larger than the actual number of scorers. + + + + Generate the next document matching our associated DisjunctionMaxQuery. + + + true iff there is a next document + + use {@link #NextDoc()} instead. + + + + use {@link #DocID()} instead. + + + + Determine the current document score. Initially invalid, until {@link #Next()} is called the first time. + the score of the current generated document + + + + Advance to the first document beyond the current whose number is greater + than or equal to target. + + + the minimum number of the next desired document + + true iff there is a document to be generated whose number is at + least target + + use {@link #Advance(int)} instead. + + + + Explain a score that we computed. UNSUPPORTED -- see explanation capability in DisjunctionMaxQuery. + the number of a document we scored + + the Explanation for our score + + + + A Query that matches documents matching boolean combinations of other + queries, e.g. {@link TermQuery}s, {@link PhraseQuery}s or other + BooleanQuerys. + + + + Return the maximum number of clauses permitted, 1024 by default. + Attempts to add more than the permitted number of clauses cause {@link + TooManyClauses} to be thrown. + + + + + + Set the maximum number of clauses permitted per BooleanQuery. + Default value is 1024. + + + + Constructs an empty boolean query. + + + Constructs an empty boolean query. + + {@link Similarity#Coord(int,int)} may be disabled in scoring, as + appropriate. For example, this score factor does not make sense for most + automatically generated queries, like {@link WildcardQuery} and {@link + FuzzyQuery}. + + + disables {@link Similarity#Coord(int,int)} in scoring. + + + + Returns true iff {@link Similarity#Coord(int,int)} is disabled in + scoring for this query instance. + + + + + + Specifies a minimum number of the optional BooleanClauses + which must be satisfied. + +

    + By default no optional clauses are necessary for a match + (unless there are no required clauses). If this method is used, + then the specified number of clauses is required. +

    +

    + Use of this method is totally independent of specifying that + any specific clauses are required (or prohibited). This number will + only be compared against the number of matching optional clauses. +

    +

    + EXPERT NOTE: Using this method may force collecting docs in order, + regardless of whether setAllowDocsOutOfOrder(true) has been called. +

    + +

    + the number of optional clauses that must match + + + +     + + Gets the minimum number of the optional BooleanClauses + which must be satisifed. + + + + Adds a clause to a boolean query. + + + TooManyClauses if the new number of clauses exceeds the maximum clause number + + + + + Adds a clause to a boolean query. + TooManyClauses if the new number of clauses exceeds the maximum clause number + + + + + Returns the set of clauses in this query. + + + Returns the list of clauses in this query. + + + Whether hit docs may be collected out of docid order. + + + this will not be needed anymore, as + {@link Weight#ScoresDocsOutOfOrder()} is used. + + + + Expert: Indicates whether hit docs may be collected out of docid order. + +

    + Background: although the contract of the Scorer class requires that + documents be iterated in order of doc id, this was not true in early + versions of Lucene. Many pieces of functionality in the current Lucene code + base have undefined behavior if this contract is not upheld, but in some + specific simple cases may be faster. (For example: disjunction queries with + less than 32 prohibited clauses; This setting has no effect for other + queries.) +

    + +

    + Specifics: By setting this option to true, docid N might be scored for a + single segment before docid N-1. Across multiple segments, docs may be + scored out of order regardless of this setting - it only applies to scoring + a single segment. + + Being static, this setting is system wide. +

    + +

    + this is not needed anymore, as + {@link Weight#ScoresDocsOutOfOrder()} is used. + +     + + Whether hit docs may be collected out of docid order. + + + + + this is not needed anymore, as + {@link Weight#ScoresDocsOutOfOrder()} is used. + + + + Use {@link #SetAllowDocsOutOfOrder(boolean)} instead. + + + + Use {@link #GetAllowDocsOutOfOrder()} instead. + + + + Prints a user-readable version of this query. + + + Returns true iff o is equal to this. + + + Returns a hash code value for this object. + + + Thrown when an attempt is made to add more than {@link + #GetMaxClauseCount()} clauses. This typically happens if + a PrefixQuery, FuzzyQuery, WildcardQuery, or TermRangeQuery + is expanded to many terms during search. + + + + Expert: the Weight for BooleanQuery, used to + normalize, score and explain these queries. + +

    NOTE: this API and implementation is subject to + change suddenly in the next release.

    +

    +     + + The Similarity implementation. + + + Fills in no-term-vectors for all docs we haven't seen + since the last doc that had term vectors. + + + + Taps into DocInverter, as an InvertedDocEndConsumer, + which is called at the end of inverting each field. We + just look at the length for the field (docState.length) + and record the norm. + + + + + + + + + + Constructs a new runtime exception with null as its + detail message. The cause is not initialized, and may subsequently be + initialized by a call to {@link #innerException}. + + + + Constructs a new runtime exception with the specified cause and a + detail message of (cause==null ? null : cause.toString()) + (which typically contains the class and detail message of + cause). +

    + This constructor is useful for runtime exceptions + that are little more than wrappers for other throwables. + +

    + the cause (which is saved for later retrieval by the + {@link #InnerException()} method). (A null value is + permitted, and indicates that the cause is nonexistent or + unknown.) + + 1.4 + +     + + Constructs a new runtime exception with the specified detail message. + The cause is not initialized, and may subsequently be initialized by a + call to {@link #innerException}. + + + the detail message. The detail message is saved for + later retrieval by the {@link #getMessage()} method. + + + + Constructs a new runtime exception with the specified detail message and + cause.

    Note that the detail message associated with + cause is not automatically incorporated in + this runtime exception's detail message. + +

    + the detail message (which is saved for later retrieval + by the {@link #getMessage()} method). + + the cause (which is saved for later retrieval by the + {@link #InnerException()} method). (A null value is + permitted, and indicates that the cause is nonexistent or + unknown.) + + 1.4 + +     + + Documents are the unit of indexing and search. + + A Document is a set of fields. Each field has a name and a textual value. + A field may be {@link Fieldable#IsStored() stored} with the document, in which + case it is returned with search hits on the document. Thus each document + should typically contain one or more stored fields which uniquely identify + it. + +

    Note that fields which are not {@link Fieldable#IsStored() stored} are + not available in documents retrieved from the index, e.g. with {@link + ScoreDoc#doc}, {@link Searcher#Doc(int)} or {@link + IndexReader#Document(int)}. +

    +     + + Constructs a new document with no fields. + + + Sets a boost factor for hits on any field of this document. This value + will be multiplied into the score of all hits on this document. + +

    The default value is 1.0. + +

    Values are multiplied into the value of {@link Fieldable#GetBoost()} of + each field in this document. Thus, this method in effect sets a default + boost for the fields of this document. + +

    + + +     + + Returns, at indexing time, the boost factor as set by {@link #SetBoost(float)}. + +

    Note that once a document is indexed this value is no longer available + from the index. At search time, for retrieved documents, this method always + returns 1. This however does not mean that the boost value set at indexing + time was ignored - it was just combined with other indexing time factors and + stored elsewhere, for better indexing and search performance. (For more + information see the "norm(t,d)" part of the scoring formula in + {@link Lucene.Net.Search.Similarity Similarity}.) + +

    + + +     + +

    Adds a field to a document. Several fields may be added with + the same name. In this case, if the fields are indexed, their text is + treated as though appended for the purposes of search.

    +

    Note that add like the removeField(s) methods only makes sense + prior to adding a document to an index. These methods cannot + be used to change the content of an existing index! In order to achieve this, + a document has to be deleted from an index and a new changed version of that + document has to be added.

    +

    +     + +

    Removes field with the specified name from the document. + If multiple fields exist with this name, this method removes the first field that has been added. + If there is no field with the specified name, the document remains unchanged.

    +

    Note that the removeField(s) methods like the add method only make sense + prior to adding a document to an index. These methods cannot + be used to change the content of an existing index! In order to achieve this, + a document has to be deleted from an index and a new changed version of that + document has to be added.

    +

    +     + +

    Removes all fields with the given name from the document. + If there is no field with the specified name, the document remains unchanged.

    +

    Note that the removeField(s) methods like the add method only make sense + prior to adding a document to an index. These methods cannot + be used to change the content of an existing index! In order to achieve this, + a document has to be deleted from an index and a new changed version of that + document has to be added.

    +

    +     + + Returns a field with the given name if any exist in this document, or + null. If multiple fields exists with this name, this method returns the + first value added. + Do not use this method with lazy loaded fields. + + + + Returns a field with the given name if any exist in this document, or + null. If multiple fields exists with this name, this method returns the + first value added. + + + + Returns the string value of the field with the given name if any exist in + this document, or null. If multiple fields exist with this name, this + method returns the first value added. If only binary fields with this name + exist, returns null. + + + + Returns an Enumeration of all the fields in a document. + use {@link #GetFields()} instead + + + + Returns a List of all the fields in a document. +

    Note that fields which are not {@link Fieldable#IsStored() stored} are + not available in documents retrieved from the + index, e.g. {@link Searcher#Doc(int)} or {@link + IndexReader#Document(int)}. +

    +     + + Returns an array of {@link Field}s with the given name. + Do not use with lazy loaded fields. + This method returns an empty array when there are no + matching fields. It never returns null. + + + the name of the field + + a Field[] array + + + + Returns an array of {@link Fieldable}s with the given name. + This method returns an empty array when there are no + matching fields. It never returns null. + + + the name of the field + + a Fieldable[] array + + + + Returns an array of values of the field specified as the method parameter. + This method returns an empty array when there are no + matching fields. It never returns null. + + the name of the field + + a String[] of field values + + + + Returns an array of byte arrays for of the fields that have the name specified + as the method parameter. This method returns an empty + array when there are no matching fields. It never + returns null. + + + the name of the field + + a byte[][] of binary field values + + + + Returns an array of bytes for the first (or only) field that has the name + specified as the method parameter. This method will return null + if no binary fields with the specified name are available. + There may be non-binary fields with the same name. + + + the name of the field. + + a byte[] containing the binary field value or null + + + + Prints the fields of a document for human consumption. + + + Simple utility class providing static methods to + compress and decompress binary data for stored fields. + This class uses java.util.zip.Deflater and Inflater + classes to compress and decompress, which is the same + format previously used by the now deprecated + Field.Store.COMPRESS. + + + + Compresses the specified byte range using the + specified compressionLevel (constants are defined in + java.util.zip.Deflater). + + + + Compresses the specified byte range, with default BEST_COMPRESSION level + + + Compresses all bytes in the array, with default BEST_COMPRESSION level + + + Compresses the String value, with default BEST_COMPRESSION level + + + Compresses the String value using the specified + compressionLevel (constants are defined in + java.util.zip.Deflater). + + + + Decompress the byte array previously returned by + compress + + + + Decompress the byte array previously returned by + compressString back into a String + + + + The term text of a Token. + + + Returns the Token's term text. + + This method has a performance penalty + because the text is stored internally in a char[]. If + possible, use {@link #TermBuffer()} and {@link + #TermLength()} directly instead. If you really need a + String, use this method, which is nothing more than + a convenience call to new String(token.termBuffer(), 0, token.termLength()) + + + + Copies the contents of buffer, starting at offset for + length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Copies the contents of buffer into the termBuffer array. + the buffer to copy + + + + Copies the contents of buffer, starting at offset and continuing + for length characters, into the termBuffer array. + + the buffer to copy + + the index in the buffer of the first character to copy + + the number of characters to copy + + + + Returns the internal termBuffer character array which + you can then directly alter. If the array is too + small for your token, use {@link + #ResizeTermBuffer(int)} to increase it. After + altering the buffer be sure to call {@link + #setTermLength} to record the number of valid + characters that were placed into the termBuffer. + + + + Grows the termBuffer to at least size newSize, preserving the + existing content. Note: If the next operation is to change + the contents of the term buffer use + {@link #SetTermBuffer(char[], int, int)}, + {@link #SetTermBuffer(String)}, or + {@link #SetTermBuffer(String, int, int)} + to optimally combine the resize with the setting of the termBuffer. + + minimum size of the new termBuffer + + newly created termBuffer with length >= newSize + + + + Allocates a buffer char[] of at least newSize, without preserving the existing content. + its always used in places that set the content + + minimum size of the buffer + + + + Return number of valid characters (length of the term) + in the termBuffer array. + + + + Set number of valid characters (length of the term) in + the termBuffer array. Use this to truncate the termBuffer + or to synchronize with external manipulation of the termBuffer. + Note: to grow the size of the array, + use {@link #ResizeTermBuffer(int)} first. + + the truncated length + + + + The positionIncrement determines the position of this token + relative to the previous Token in a {@link TokenStream}, used in phrase + searching. + +

    The default value is one. + +

    Some common uses for this are:

      + +
    • Set it to zero to put multiple terms in the same position. This is + useful if, e.g., a word has multiple stems. Searches for phrases + including either stem will match. In this case, all but the first stem's + increment should be set to zero: the increment of the first instance + should be one. Repeating a token with an increment of zero can also be + used to boost the scores of matches on that token.
      • + +
    • Set it to values greater than one to inhibit exact phrase matches. + If, for example, one does not want phrases to match across removed stop + words, then one could build a stop word filter that removes stop words and + also sets the increment to the number of stop words removed before each + non-stop word. Then exact phrase queries will only match when the terms + occur with no intervening stop words.
      • + +
    +     +     + + Set the position increment. The default value is one. + + + the distance from the prior term + + + + Returns the position increment of this Token. + + + diff --git a/Lib/Portoa.Log4Net.dll b/Lib/Portoa.Log4Net.dll index b406b2ceef6b6a9da246075bbef2dc865375aae3..c62e8fa42b157586eb8b3544cbea94086fc414b6 100644 GIT binary patch delta 87 zcmZqBXwaC@!MwyeV`KMRP63U#vrcxIoO0Y0bNN6V>*s{c7F<4zx^3=BcRF2N!%ZSCfWzVmC_CwKf<`Ryx=n>TX%a{vHecOH%a delta 87 zcmZqBXwaC@!Tfo8;>PZ|oC2zRH`G?AMLJJ^;8R)X7!$JDg3E_d7bxq?00c}xoD9Ts lG=Z3#fgvc^C0KozPOJCd#a=yjy^9imS(^!L-pK9G0RSS}9NPc@ diff --git a/Lib/Portoa.NHibernate.dll b/Lib/Portoa.NHibernate.dll index 6c03032fffa88638e0e4e7e32a0201c97a694f95..6016cd615dd37137d9e7ef434ae888dbffd54fa8 100644 GIT binary patch delta 89 zcmZo@U~Fh$oY29%#5!YRH?N_9y0Ph;;Qu^c+a?(I$)<>?Y+hk_gH;zO>&pNHOhB9o n#4|#H*qnhODA*-9Or&T|!=Xs$HR;!Xi{E;-g>my*^I#4D3BMi4 delta 89 zcmZo@U~Fh$oY2Aid3xf;ZeBxybBd>zPi6^n-&5;UcG^*P&E^$`H&}Invc3#Jzy!pZ oKs+N9h|L)of`VOw!*2GPc3jxuyR0tJXN%kZFRYu_ng??L0M@!7-T(jq diff --git a/Lib/Portoa.Web.dll b/Lib/Portoa.Web.dll index 0a77f53704763aa310c3a7df46f67823eaebae6d..829519621dfb983645b4918385c1c8175599c775 100644 GIT binary patch literal 48128 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Ξ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 - - - Configures interception to occur for any subsequent container registrations - that are not part of NHibernate - - Flattens a FilterInfo object into a single IEnumerable containing @@ -298,11 +292,6 @@ The key of the item to retrieve The value stored in the specified key, or null if no such key exists - - - Extension methods for UnityContainer - - Adds an extension if it hasn't already been registered with the container @@ -321,6 +310,45 @@ + + + Registers the type and configures an for + + + This must be an interface type + The type to resolve the interface to + + + + Registers the interface type and configures interception for it + + + + + Registers the type and configures interception for it + + + + + Registers the type and configures interception for it + + + + + Registers the instance and configures interception for it + + + + + Registers the type and configures interception for it + + This must be an interface type + + + + Registers the type and configures interception for it + + Error result factory that returns a result suitable @@ -518,6 +546,18 @@ does nothing + + + Adds extensions to the container; default implementation does nothing + + + + + Performs any needed cleanup when the application ends; default implementation + does nothing. Be aware that the container gets disposed of + later. + + IControllerFactory that provides a mechanism to perform injection @@ -624,19 +664,15 @@ Controller factory that uses a service provider to resolve controllers - + - ActionResult decorator that enables you to override the HTTP status code + Verifies that an uploaded file has a certain mimetype - - + - Gets an object from the request variables, or its default value if - the key does not exist + Gets or sets the expected mimetype (i.e. text/plain, image/png, etc.) - The type to convert the value to - The request key of the object to retrieve @@ -656,14 +692,49 @@ Gets or sets the (inclusive) minimum length of the uploaded file - + - Verifies that an uploaded file has a certain mimetype + ActionResult decorator that enables you to override the HTTP status code + + + + + + Gets an object from the request variables, or its default value if + the key does not exist + + The type to convert the value to + The request key of the object to retrieve + + + + A matching rule that always matches - + - Gets or sets the expected mimetype (i.e. text/plain, image/png, etc.) + Matching rule where a member is match if it is assignable from + + The base class/interface to match against + + + + Negates a matching rule + + The type of matching rule to negate + + + + Negates a matching rule + + + + The matching rule to negate + + + + Matching rule that matches compiler-generated methods for property + getters and setters diff --git a/Lib/Portoa.dll b/Lib/Portoa.dll index b4f4e28bb92cd4cfa9774c5731d9650ff3f58cf5..e08fcf0009d4ae2b0e5cd7383d2ed29f0c399ab8 100644 GIT binary patch delta 12516 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 v(S&LpO~^NDH+-Z1qr$jhV@6 collection - + - Represents a domain object that can be persisted by a repository + Convenience class for data transfer objects that have an integral + identifier - The entity type - The entity's identifier type @@ -90,6 +89,13 @@ The unique identifier of this object + + + Represents a domain object that can be persisted by a repository + + The entity type + The entity's identifier type + Implodes an enumeration given a selector function and a separator @@ -627,11 +633,5 @@ Signifies that this object should not be logged - - - Convenience class for data transfer objects that have an integral - identifier - - diff --git a/Lib/UnityGenerics.dll b/Lib/UnityGenerics.dll index 299d92c89c2d9387d0cdf65dd911fcd209c949d6..b151033ce7a5b0618abef01ef73feffea673c600 100644 GIT binary patch delta 1038 zcmY*YZD>ENr2VBBLy(zC^iT50RUYJoCs61SV)_(6{l$w zNBrkllcSrbfGSAYe(?v=S?98mDgZwSs~$ibZUaC~F-urmLfy4UhwLl zmqUvg76r_b66YY-%21F}49b}(0>q+%!5ss&?F-?EF5zr6!N8^4w#*97A6)shA1#_F5~#Xf-luv-Vza5$qMR|s`g%{0A)aqz-t*n%3Y#_Jq!DaSJ$Yw#RtgK}A&R$9;t z_bHNldA(1;Wdt8H9Tmpuy2)nTxNec z_d{JDrqK)brqD+}xt7L17u*^c=k_7&D8~{7 zuIk^TZ6fL zb~v54vR&Kv?xm2o$?oyKbdY6yNz08G{b{_Rljb2&xJI{)ZIm$g`5|9@d{5`ro!#fB zj`fb%6W>usFoJdV+F(BhJxz!~Bgk_;2KYKL5;h_3Lpj)a9P zXw=c2IrYv-W7tbtT`9pYv{#;#`wlyKhUH@n0c_Z~eB-B<+5h*&e^#D3dHC#CH*d#f vC%Tqx?WfLAx98OC3uO&{qhhE*oJ-QBP#>kxXM5{kIK-`_?f+l~iyi8J@=Dq! delta 999 zcmYjQZEQnkQ08R7@2l1a8sKO(-Si;s}` zYEC4`l1U_FzNsHbBunr^Bw~K~C5S{2A%2J;<=n1hZ*rb{p69&xo{#&!xt3hZsUxNn z30uC;kFWBB?drh@Ks)ei0q8d6gSxT_Kw)m?fRBP=GOfotd`G>w-#NsZv6iq2ut2on z6vH@igD`~}0Bq)CGC*~xkzL*}iA`@5u!o-(8Z`TZte{*-eksY_*?ML&)a$OIG>e^d9YfBL!cdBY5Fi{94E8X{ zG|%z{f6x@kFC;-Lq(|~zsTNiELteSHsuLP`5EgI%LM8Mvb26)-eR4Ivq_c8gB92yg z8{`_{@Ypq }_#0b9QA+*B*Zha)yhYFnh&(5I(`v0@bSOKp~EDsKG7c1drnO&0J zpp%YTr#Gz@#vh9_BFrzLp&*RbcZ`ZYmI`03l^8SX@WL8gRKh!A6&{yV#(wF(aIqdo z1Jf8SWe&2x64ztV5)n~&DZOW%YoM4d?+S`tUIyI^V8_C!3>k?dNS>`G@+*?1d7O2hgB^6Eai z?&_rHdXE#Tq}am;+dfCH)LopLjcof#lihxF6_&ZzBHi&sXu#v9Po57=R=4I7I_M~L zv;+jIK1%?!+-aL^QMKHlmQ{u1)_kagRW@n4YknU|V~fpv_gak(dDgInEx?B^;00LS z7Hx~P9m{V0*3)`^VF#$)^QQ61h4}1^S(@ox;<#GAd#u4TI_|9&Ly>&YMYp}n3+lL^ PCh where T : Entity { + IEnumerable FindByIds(IEnumerable ids); + IEnumerable GetAllIndexableRecords(); + } + + public class SearchService : ISearchService where T : Entity { + private readonly IRepository repository; + + public SearchService(IRepository repository) { + this.repository = repository; + } + + [UnitOfWork] + public IEnumerable FindByIds(IEnumerable ids) { + + return repository + .Records + .Where(entity => ids.ToArray().Contains(entity.Id)); + } + + [UnitOfWork] + public IEnumerable GetAllIndexableRecords() { + return repository.Records; + } + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Persistence/UserService.cs b/Src/VideoGameQuotes.Api/Persistence/UserService.cs index abb1dd3..e568c9c 100644 --- a/Src/VideoGameQuotes.Api/Persistence/UserService.cs +++ b/Src/VideoGameQuotes.Api/Persistence/UserService.cs @@ -4,7 +4,6 @@ using JetBrains.Annotations; using Portoa.Persistence; namespace VideoGameQuotes.Api.Persistence { - public interface IUserService { User Save(User user); [CanBeNull] diff --git a/Src/VideoGameQuotes.Api/Search/ISearchIndexBuilder.cs b/Src/VideoGameQuotes.Api/Search/ISearchIndexBuilder.cs new file mode 100644 index 0000000..e45b1a8 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/ISearchIndexBuilder.cs @@ -0,0 +1,17 @@ +namespace VideoGameQuotes.Api.Search { + /// + /// Exposes an interface to build and update a search index + /// + public interface ISearchIndexBuilder { + /// + /// (Re)builds the search index + /// + void BuildIndex(); + + /// + /// Updates the index for the specified + /// + /// The object that needs its index updated + void UpdateIndex(T indexableObject); + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/ISearcher.cs b/Src/VideoGameQuotes.Api/Search/ISearcher.cs new file mode 100644 index 0000000..e75e8f8 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/ISearcher.cs @@ -0,0 +1,15 @@ +using System.Collections.Generic; + +namespace VideoGameQuotes.Api.Search { + /// + /// Exposes an interface to perform a full-text search + /// + public interface ISearcher { + /// + /// Searches for records based on the given search query + /// + /// The search term(s) to search for + /// The maximum number of results to return (0 is unlimited); the default is 10 + IEnumerable> Search(string query, int maxResults = 10); + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/Lucene/ILuceneDocumentHandler.cs b/Src/VideoGameQuotes.Api/Search/Lucene/ILuceneDocumentHandler.cs new file mode 100644 index 0000000..bd1b778 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/Lucene/ILuceneDocumentHandler.cs @@ -0,0 +1,9 @@ +using Lucene.Net.Documents; +using Lucene.Net.Index; + +namespace VideoGameQuotes.Api.Search.Lucene { + public interface ILuceneDocumentHandler { + Document BuildDocument(T source); + Term GetIdTerm(T source); + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntityIndexBuilder.cs b/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntityIndexBuilder.cs new file mode 100644 index 0000000..382cea2 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntityIndexBuilder.cs @@ -0,0 +1,45 @@ +using Lucene.Net.Index; +using Portoa.Logging; +using Portoa.Persistence; +using VideoGameQuotes.Api.Persistence; + +namespace VideoGameQuotes.Api.Search.Lucene { + public class LuceneEntityIndexBuilder : ISearchIndexBuilder where T : Entity { + private readonly ILogger logger; + private readonly IndexWriter indexWriter; + private readonly ISearchService searchService; + private readonly ILuceneDocumentHandler documentHandler; + + public LuceneEntityIndexBuilder(IndexWriter indexWriter, ISearchService searchService, ILuceneDocumentHandler documentHandler, ILogger logger) { + this.indexWriter = indexWriter; + this.searchService = searchService; + this.documentHandler = documentHandler; + this.logger = logger; + } + + public void BuildIndex() { + logger.Info("Building lucene index"); + foreach (var quote in searchService.GetAllIndexableRecords()) { + indexWriter.AddDocument(documentHandler.BuildDocument(quote)); + } + + indexWriter.Optimize(); + indexWriter.Commit(); + logger.Info("Finished building lucene index"); + } + + public void UpdateIndex(T entity) { + if (entity.IsTransient()) { + throw new SearchIndexException(string.Format("Cannot add a transient entity to the index ({0})", entity)); + } + + logger.Info(string.Format("Updating index for {0}", entity)); + //delete current document, if it exists + indexWriter.DeleteDocuments(documentHandler.GetIdTerm(entity)); + indexWriter.AddDocument(documentHandler.BuildDocument(entity)); + + indexWriter.Commit(); + logger.Info(string.Format("Finished updating index for {0}", entity)); + } + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntitySearcher.cs b/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntitySearcher.cs new file mode 100644 index 0000000..39b8d44 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/Lucene/LuceneEntitySearcher.cs @@ -0,0 +1,50 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using Lucene.Net.QueryParsers; +using Lucene.Net.Search; +using Portoa.Persistence; +using VideoGameQuotes.Api.Persistence; +using Directory = Lucene.Net.Store.Directory; + +namespace VideoGameQuotes.Api.Search.Lucene { + /// + /// implementation for entities based on Lucene.NET + /// + public class LuceneEntitySearcher : ISearcher where T : Entity { + private readonly QueryParser queryParser; + private readonly Directory indexDirectory; + private readonly ISearchService searchService; + + public LuceneEntitySearcher(QueryParser queryParser, Directory indexDirectory, ISearchService searchService) { + this.queryParser = queryParser; + this.indexDirectory = indexDirectory; + this.searchService = searchService; + } + + public IEnumerable> Search(string searchString, int maxResults = 10) { + if (string.IsNullOrWhiteSpace(searchString)) { + return Enumerable.Empty>(); + } + if (maxResults < 0) { + throw new ArgumentOutOfRangeException("maxResults", maxResults, "Maximum number of results must be greater than or equal to zero"); + } + if (maxResults == 0) { + maxResults = int.MaxValue; + } + + var query = queryParser.Parse(QueryParser.Escape(searchString)); + var searcher = new IndexSearcher(indexDirectory, true); + try { + var docs = searcher + .Search(query, maxResults) + .scoreDocs; + + var quotes = searchService.FindByIds(docs.Select(doc => int.Parse(searcher.Doc(doc.doc).GetField("id").StringValue()))); + return quotes.Zip(docs, (entity, doc) => new SearchResult { Entity = entity, Score = doc.score }).ToArray(); + } finally { + searcher.Close(); + } + } + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/Lucene/QuoteDocumentHandler.cs b/Src/VideoGameQuotes.Api/Search/Lucene/QuoteDocumentHandler.cs new file mode 100644 index 0000000..87c7354 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/Lucene/QuoteDocumentHandler.cs @@ -0,0 +1,18 @@ +using Lucene.Net.Documents; +using Lucene.Net.Index; + +namespace VideoGameQuotes.Api.Search.Lucene { + public class QuoteDocumentHandler : ILuceneDocumentHandler { + + public Document BuildDocument(Quote quote) { + var document = new Document(); + document.Add(new Field("id", quote.Id.ToString(), Field.Store.YES, Field.Index.NOT_ANALYZED)); + document.Add(new Field("text", quote.Text, Field.Store.YES, Field.Index.ANALYZED)); + return document; + } + + public Term GetIdTerm(Quote quote) { + return new Term("id", quote.Id.ToString()); + } + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/SearchIndexException.cs b/Src/VideoGameQuotes.Api/Search/SearchIndexException.cs new file mode 100644 index 0000000..ad275c4 --- /dev/null +++ b/Src/VideoGameQuotes.Api/Search/SearchIndexException.cs @@ -0,0 +1,10 @@ +using System; + +namespace VideoGameQuotes.Api.Search { + /// + /// Raised when an error occurs while reading/writing a search index + /// + public class SearchIndexException : Exception { + public SearchIndexException(string message = null, Exception innerException = null) : base(message, innerException) { } + } +} \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/Search/SearchResult.cs b/Src/VideoGameQuotes.Api/Search/SearchResult.cs index 5d6c37c..1605de8 100644 --- a/Src/VideoGameQuotes.Api/Search/SearchResult.cs +++ b/Src/VideoGameQuotes.Api/Search/SearchResult.cs @@ -2,7 +2,7 @@ /// /// Represents a search result /// - public class SearchResult { + public class SearchResult { /// /// A value (between 0 and 1, the higher the better) representing how good /// the match is between the search query and the value @@ -12,6 +12,6 @@ /// /// The matched quote /// - public Quote Quote { get; set; } + public T Entity { get; set; } } } \ No newline at end of file diff --git a/Src/VideoGameQuotes.Api/VideoGameQuotes.Api.csproj b/Src/VideoGameQuotes.Api/VideoGameQuotes.Api.csproj index fb9a549..409d4a8 100644 --- a/Src/VideoGameQuotes.Api/VideoGameQuotes.Api.csproj +++ b/Src/VideoGameQuotes.Api/VideoGameQuotes.Api.csproj @@ -69,10 +69,13 @@ - + + + - - + + + @@ -82,6 +85,8 @@ + + @@ -104,6 +109,7 @@ +