IndexSettings
Inheritance: java.lang.Object
public class IndexSettings
Represents the index settings that allow to customize the indexing operations.
Learn more
The example demonstrates a typical usage of the class.
String indexFolder = "c:\\MyIndex\\";
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.CompactIndex); // Setting the index type
Index index = new Index(indexFolder, settings); // Creating an index
Constructors
| Constructor | Description |
|---|---|
| IndexSettings() | Initializes a new instance of the IndexSettings class. |
Methods
| Method | Description |
|---|---|
| getInMemoryIndex() | Gets a value indicating whether the index is stored in memory or on disk. |
| getUseStopWords() | Gets a value indicating whether to use stop words or not. |
| setUseStopWords(boolean value) | Sets a value indicating whether to use stop words or not. |
| getMaxIndexingReportCount() | Gets the maximum number of indexing reports. |
| setMaxIndexingReportCount(int value) | Sets the maximum number of indexing reports. |
| getMaxSearchReportCount() | Gets the maximum number of search reports. |
| setMaxSearchReportCount(int value) | Sets the maximum number of search reports. |
| getUseCharacterReplacements() | Gets a value indicating whether to use character replacements or not. |
| setUseCharacterReplacements(boolean value) | Sets a value indicating whether to use character replacements or not. |
| getDocumentFilter() | Gets a document filter. |
| setDocumentFilter(DocumentFilter value) | Sets a document filter. |
| getTextStorageSettings() | Gets the text storage settings. |
| setTextStorageSettings(TextStorageSettings value) | Sets the text storage settings. |
| getIndexType() | Gets the index type. |
| setIndexType(IndexType value) | Sets the index type. |
| getSearchThreads() | Gets the number of threads used for the search. |
| setSearchThreads(NumberOfThreads value) | Sets the number of threads used for the search. |
| getCustomExtractors() | Gets the custom extractor collection. |
| getLogger() | Gets a logger that is used for logging events and errors in the index. |
| setLogger(ILogger value) | Sets a logger that is used for logging events and errors in the index. |
IndexSettings()
public IndexSettings()
Initializes a new instance of the IndexSettings class.
getInMemoryIndex()
public final boolean getInMemoryIndex()
Gets a value indicating whether the index is stored in memory or on disk.
Returns: boolean - A value indicating whether the index is stored in memory or on disk.
getUseStopWords()
public final boolean getUseStopWords()
Gets a value indicating whether to use stop words or not. The default value is true .
Returns: boolean - A value indicating whether to use stop words or not.
setUseStopWords(boolean value)
public final void setUseStopWords(boolean value)
Sets a value indicating whether to use stop words or not. The default value is true .
Parameters:
| Parameter | Type | Description |
|---|---|---|
| value | boolean | A value indicating whether to use stop words or not. |
getMaxIndexingReportCount()
public final int getMaxIndexingReportCount()
Gets the maximum number of indexing reports. The default value is 5 .
Returns: int - The maximum number of indexing reports.
setMaxIndexingReportCount(int value)
public final void setMaxIndexingReportCount(int value)
Sets the maximum number of indexing reports. The default value is 5 .
Parameters:
| Parameter | Type | Description |
|---|---|---|
| value | int | The maximum number of indexing reports. |
getMaxSearchReportCount()
public final int getMaxSearchReportCount()
Gets the maximum number of search reports. The default value is 10 .
Returns: int - The maximum number of search reports.
setMaxSearchReportCount(int value)
public final void setMaxSearchReportCount(int value)
Sets the maximum number of search reports. The default value is 10 .
Parameters:
| Parameter | Type | Description |
|---|---|---|
| value | int | The maximum number of search reports. |
getUseCharacterReplacements()
public final boolean getUseCharacterReplacements()
Gets a value indicating whether to use character replacements or not. The default value is false .
Returns: boolean - A value indicating whether to use character replacements or not.
setUseCharacterReplacements(boolean value)
public final void setUseCharacterReplacements(boolean value)
Sets a value indicating whether to use character replacements or not. The default value is false .
Parameters:
| Parameter | Type | Description |
|---|---|---|
| value | boolean | A value indicating whether to use character replacements or not. |
getDocumentFilter()
public final DocumentFilter getDocumentFilter()
Gets a document filter. The DocumentFilter works on the inclusion logic. Use the DocumentFilter class for creation a document filter instance. The default value is null , which means that all added documents are indexed.
Returns: DocumentFilter - The document filter.
The example demonstrates how to set the document filter.
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
// Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf'
IndexSettings settings = new IndexSettings();
DocumentFilter fileExtensionFilter = DocumentFilter.createFileExtension(".doc", ".docx", ".rtf"); // Creating file extension filter
DocumentFilter invertedFilter = DocumentFilter.createNot(fileExtensionFilter); // Inverting file extension filter
settings.setDocumentFilter(invertedFilter);
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
// Indexing documents
index.add(documentsFolder);
// Searching
SearchResult result = index.search("Einstein");
setDocumentFilter(DocumentFilter value)
public final void setDocumentFilter(DocumentFilter value)
Sets a document filter. The DocumentFilter works on the inclusion logic. Use the GroupDocs.Search.Options.DocumentFilter class for creation of a document filter instances. The default value is null , which means that all added documents are indexed.
Parameters:
| Parameter | Type | Description |
|---|---|---|
| value | DocumentFilter | The document filter. |
The example demonstrates how to set the document filter.
String indexFolder = "c:\\MyIndex\\";
String documentsFolder = "c:\\MyDocuments\\";
// Creating a filter that skips documents with extensions '.doc', '.docx', '.rtf'
IndexSettings settings = new IndexSettings();
DocumentFilter fileExtensionFilter = DocumentFilter.createFileExtension(".doc", ".docx", ".rtf"); // Creating file extension filter
DocumentFilter invertedFilter = DocumentFilter.createNot(fileExtensionFilter); // Inverting file extension filter
settings.setDocumentFilter(invertedFilter);
// Creating an index in the specified folder
Index index = new Index(indexFolder, settings);
// Indexing documents
index.add(documentsFolder);
// Searching
SearchResult result = index.search("Einstein");
``` |
### getTextStorageSettings() {#getTextStorageSettings--}
public final TextStorageSettings getTextStorageSettings()
Gets the text storage settings. The default value is null , which means that document texts are not stored.
**Returns:**
[TextStorageSettings](../../com.groupdocs.search.options/textstoragesettings) - The text storage settings.
The example demonstrates how to set the text storage settings.
String indexFolder = “c:\MyIndex\”; String documentsFolder = “c:\MyDocuments\”; // Creating index settings instance IndexSettings settings = new IndexSettings(); settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Setting high compression level for the index text storage // Creating an index in the specified folder Index index = new Index(indexFolder, settings); // Indexing documents index.add(documentsFolder); // Searching SearchResult result = index.search(“Einstein”);
### setTextStorageSettings(TextStorageSettings value) {#setTextStorageSettings-com.groupdocs.search.options.TextStorageSettings-}
public final void setTextStorageSettings(TextStorageSettings value)
Sets the text storage settings. The default value is null , which means that document texts are not stored.
**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | [TextStorageSettings](../../com.groupdocs.search.options/textstoragesettings) | The text storage settings.
The example demonstrates how to set the text storage settings.
String indexFolder = “c:\MyIndex\”; String documentsFolder = “c:\MyDocuments\”; // Creating index settings instance IndexSettings settings = new IndexSettings(); settings.setTextStorageSettings(new TextStorageSettings(Compression.High)); // Setting high compression level for the index text storage // Creating an index in the specified folder Index index = new Index(indexFolder, settings); // Indexing documents index.add(documentsFolder); // Searching SearchResult result = index.search(“Einstein”);
### getIndexType() {#getIndexType--}
public final IndexType getIndexType()
Gets the index type. The default value is GroupDocs.Search.Options.IndexType.NormalIndex .
**Returns:**
[IndexType](../../com.groupdocs.search.options/indextype) - The index type.
### setIndexType(IndexType value) {#setIndexType-com.groupdocs.search.options.IndexType-}
public final void setIndexType(IndexType value)
Sets the index type. The default value is GroupDocs.Search.Options.IndexType.NormalIndex .
**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | [IndexType](../../com.groupdocs.search.options/indextype) | The index type. |
### getSearchThreads() {#getSearchThreads--}
public final NumberOfThreads getSearchThreads()
Gets the number of threads used for the search. The default value is GroupDocs.Search.Options.NumberOfThreads.Default , which means that the search will be performed using the number of threads equal to the number of processor cores.
**Returns:**
[NumberOfThreads](../../com.groupdocs.search.options/numberofthreads) - The number of threads used for the search.
### setSearchThreads(NumberOfThreads value) {#setSearchThreads-com.groupdocs.search.options.NumberOfThreads-}
public final void setSearchThreads(NumberOfThreads value)
Sets the number of threads used for the search. The default value is GroupDocs.Search.Options.NumberOfThreads.Default , which means that the search will be performed using the number of threads equal to the number of processor cores.
**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | [NumberOfThreads](../../com.groupdocs.search.options/numberofthreads) | The number of threads used for the search. |
### getCustomExtractors() {#getCustomExtractors--}
public final CustomExtractorCollection getCustomExtractors()
Gets the custom extractor collection. The full example of implementing a custom extractor is presented in documentation for GroupDocs.Search.Common.IFieldExtractor interface.
**Returns:**
[CustomExtractorCollection](../../com.groupdocs.search.common/customextractorcollection) - The custom extractor collection.
### getLogger() {#getLogger--}
public final ILogger getLogger()
Gets a logger that is used for logging events and errors in the index. Note that the logger is not saved and must be created and assigned each time the index is created or loaded.
**Returns:**
[ILogger](../../com.groupdocs.search.common/ilogger) - A logger that is used for logging events and errors in the index.
### setLogger(ILogger value) {#setLogger-com.groupdocs.search.common.ILogger-}
public final void setLogger(ILogger value)
Sets a logger that is used for logging events and errors in the index. Note that the logger is not saved and must be created and assigned each time the index is created or loaded.
**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | [ILogger](../../com.groupdocs.search.common/ilogger) | A logger that is used for logging events and errors in the index. |