org.hibernate.search.backend.elasticsearch.cfg.ElasticsearchIndexSettings Maven / Gradle / Ivy
/*
* Hibernate Search, full-text search for your domain model
*
* License: GNU Lesser General Public License (LGPL), version 2.1 or later
* See the lgpl.txt file in the root directory or .
*/
package org.hibernate.search.backend.elasticsearch.cfg;
import org.hibernate.search.backend.elasticsearch.analysis.ElasticsearchAnalysisConfigurer;
import org.hibernate.search.backend.elasticsearch.index.DynamicMapping;
import org.hibernate.search.backend.elasticsearch.index.IndexStatus;
/**
* Configuration properties for Elasticsearch indexes.
*
* Constants in this class are to be appended to a prefix to form a property key;
* see {@link org.hibernate.search.engine.cfg.IndexSettings} for details.
*/
public final class ElasticsearchIndexSettings {
private ElasticsearchIndexSettings() {
}
/**
* The analysis configurer applied to this index.
*
* Expects a reference to a bean of type {@link ElasticsearchAnalysisConfigurer}.
*
* Defaults to no value.
*
* @see org.hibernate.search.engine.cfg The core documentation of configuration properties,
* which includes a description of the "bean reference" properties and accepted values.
*/
public static final String ANALYSIS_CONFIGURER = "analysis.configurer";
/**
* The minimal required status of an index on startup, before Hibernate Search can start using it.
*
* Expects an {@link IndexStatus} value, or a String representation of such value.
*
* Defaults to {@link Defaults#SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS}.
*/
public static final String SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS = "schema_management.minimal_required_status";
/**
* The timeout when waiting for the {@link #SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS required status}.
*
* Expects a positive Integer value in milliseconds, such as {@code 60000},
* or a String that can be parsed into such Integer value.
*
* Defaults to {@link Defaults#SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS_WAIT_TIMEOUT}.
*/
public static final String SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS_WAIT_TIMEOUT = "schema_management.minimal_required_status_wait_timeout";
/**
* Specify the default behavior to handle dynamically-mapped fields in the Elasticsearch mapping.
*
* Defaults to {@link Defaults#DYNAMIC_MAPPING}.
*
* In case of dynamic fields with field templates, the value will be ignored,
* since this feature requires a {@link DynamicMapping#TRUE} to operate.
*
* @see DynamicMapping
*/
public static final String DYNAMIC_MAPPING = "dynamic_mapping";
/**
* The prefix for indexing-related property keys.
*/
public static final String INDEXING_PREFIX = "indexing.";
/**
* The number of indexing queues assigned to each index.
*
* Expects a strictly positive integer value,
* or a string that can be parsed to such integer value.
*
* Defaults to {@link Defaults#INDEXING_QUEUE_COUNT}.
*
* See the reference documentation, section "Elasticsearch backend - Indexing",
* for more information about this setting and its implications.
*/
public static final String INDEXING_QUEUE_COUNT = INDEXING_PREFIX + IndexingRadicals.QUEUE_COUNT;
/**
* The size of indexing queues.
*
* Expects a strictly positive integer value,
* or a string that can be parsed to such integer value.
*
* Defaults to {@link Defaults#INDEXING_QUEUE_SIZE}.
*
* See the reference documentation, section "Elasticsearch backend - Indexing",
* for more information about this setting and its implications.
*/
public static final String INDEXING_QUEUE_SIZE = INDEXING_PREFIX + IndexingRadicals.QUEUE_SIZE;
/**
* The maximum size of bulk requests created when processing indexing queues.
*
* Expects a strictly positive integer value,
* or a string that can be parsed to such integer value.
*
* Defaults to {@link Defaults#INDEXING_MAX_BULK_SIZE}.
*
* See the reference documentation, section "Elasticsearch backend - Indexing",
* for more information about this setting and its implications.
*/
public static final String INDEXING_MAX_BULK_SIZE = INDEXING_PREFIX + IndexingRadicals.MAX_BULK_SIZE;
/**
* Configuration property keys for indexing, without the {@link #INDEXING_PREFIX prefix}.
*/
public static final class IndexingRadicals {
private IndexingRadicals() {
}
public static final String QUEUE_COUNT = "queue_count";
public static final String QUEUE_SIZE = "queue_size";
public static final String MAX_BULK_SIZE = "max_bulk_size";
}
/**
* Default values for the different settings if no values are given.
*/
public static final class Defaults {
private Defaults() {
}
public static final IndexStatus SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS = IndexStatus.YELLOW;
public static final int SCHEMA_MANAGEMENT_MINIMAL_REQUIRED_STATUS_WAIT_TIMEOUT = 10_000;
public static final int INDEXING_QUEUE_COUNT = 10;
public static final int INDEXING_QUEUE_SIZE = 1000;
public static final int INDEXING_MAX_BULK_SIZE = 100;
public static final DynamicMapping DYNAMIC_MAPPING = DynamicMapping.STRICT;
}
}