Deprecated List (core 6.1.2 API)

Deprecated Interfaces
Interface and Description

org.elasticsearch.cluster.metadata.IndexMetaData.Custom

Deprecated Interfaces
Interface and Description
org.elasticsearch.cluster.metadata.IndexMetaData.Custom

Deprecated Classes
Class and Description
org.elasticsearch.index.analysis.SnowballAnalyzer (3.1) Use the language-specific analyzer in modules/analysis instead. This analyzer WAS removed in Lucene 5.0
org.elasticsearch.action.delete.TransportDeleteAction
org.elasticsearch.action.index.TransportIndexAction
org.elasticsearch.action.bulk.TransportSingleItemBulkWriteAction

Deprecated Exceptions
Exceptions and Description
org.elasticsearch.index.engine.DeleteFailedEngineException
org.elasticsearch.script.GeneralScriptException Use ScriptException for exceptions from the scripting engine, otherwise use a more appropriate exception (e.g. if thrown from various abstractions)
org.elasticsearch.index.engine.IndexFailedEngineException

Deprecated Annotation Types
Annotation Type and Description
org.elasticsearch.common.inject.assistedinject.AssistedInject `FactoryProvider` now works better with the standard @Inject annotation. When using that annotation, parameters are matched by name and type rather than by position. In addition, values that use the standard @Inject constructor annotation are eligible for method interception.

Deprecated Fields
Field and Description
org.elasticsearch.index.analysis.SynonymTokenFilterFactory.ignoreCase this property only works with tokenizer property
org.elasticsearch.common.network.NetworkUtils.SUPPORTS_V6 transition mechanism only, do not use
org.elasticsearch.index.analysis.SynonymTokenFilterFactory.tokenizerFactory This filter tokenize synonyms with whatever tokenizer and token filters appear before it in the chain in 6.0.

Deprecated Methods
Method and Description
org.elasticsearch.action.update.UpdateRequest.addScriptParam(String, Object) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.index.query.QueryStringQueryBuilder.autoGeneratePhraseQueries()
org.elasticsearch.index.query.QueryStringQueryBuilder.autoGeneratePhraseQueries(boolean)
org.elasticsearch.common.xcontent.XContentParser.booleanValueLenient() Just present for providing backwards compatibility. Use `XContentParser.booleanValue()` instead.
org.elasticsearch.common.xcontent.support.AbstractXContentParser.booleanValueLenient()
org.elasticsearch.common.xcontent.XContentHelper.convertToJson(BytesReference, boolean)
org.elasticsearch.common.xcontent.XContentHelper.convertToJson(BytesReference, boolean, boolean)
org.elasticsearch.common.xcontent.XContentHelper.convertToMap(BytesReference, boolean) this method relies on auto-detection of content type. Use `XContentHelper.convertToMap(BytesReference, boolean, XContentType)` instead with the proper `XContentType`
org.elasticsearch.common.xcontent.XContentHelper.createParser(NamedXContentRegistry, BytesReference) use `XContentHelper.createParser(NamedXContentRegistry, BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.env.Environment.dataWithClusterFiles() Used to upgrade old data paths to new ones that do not include the cluster name, should not be used to write files to and will be removed in ES 6.0
org.elasticsearch.ExceptionsHelper.detailedMessage(Throwable) Don't swallow exceptions, allow them to propagate.
org.elasticsearch.action.termvectors.TermVectorsRequest.doc(BytesReference, boolean) use `TermVectorsRequest.doc(BytesReference, boolean, XContentType)` to avoid content auto detection
org.elasticsearch.action.update.UpdateRequest.fields() Use `UpdateRequest.fetchSource()` instead
org.elasticsearch.action.update.UpdateRequest.fields(String...) Use `UpdateRequest.fetchSource(String[], String[])` instead
org.elasticsearch.action.search.SearchRequestBuilder.fields(String...) Use `SearchRequestBuilder.storedFields(String...)` instead.
org.elasticsearch.search.sort.GeoDistanceSortBuilder.geohashes(String...)
org.elasticsearch.common.settings.Settings.getAsBooleanLenientForPreEs6Indices(Version, String, Boolean, DeprecationLogger) Only used to provide automatic upgrades for pre 6.0 indices.
org.elasticsearch.index.fielddata.ScriptDocValues.Longs.getDate()
org.elasticsearch.index.fielddata.ScriptDocValues.Dates.getDate()
org.elasticsearch.index.fielddata.ScriptDocValues.Longs.getDates()
org.elasticsearch.index.fielddata.ScriptDocValues.Dates.getDates()
org.elasticsearch.index.query.InnerHitBuilder.getFieldNames() Use `InnerHitBuilder.getStoredFieldsContext()` instead.
org.elasticsearch.search.sort.ScriptSortBuilder.getNestedFilter() set nested sort with `ScriptSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `ScriptSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.GeoDistanceSortBuilder.getNestedFilter() set nested sort with `GeoDistanceSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `GeoDistanceSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.FieldSortBuilder.getNestedFilter() set nested sort with `FieldSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `FieldSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.ScriptSortBuilder.getNestedPath() set nested sort with `ScriptSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `ScriptSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.GeoDistanceSortBuilder.getNestedPath() set nested sort with `GeoDistanceSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `GeoDistanceSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.FieldSortBuilder.getNestedPath() set nested sort with `FieldSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `FieldSortBuilder.getNestedSort()`
org.elasticsearch.index.query.MoreLikeThisQueryBuilder.ids(String...) construct the items array externally and use it in the constructor / setter
org.elasticsearch.index.mapper.FieldNamesFieldMapper.Builder.index(boolean)
org.elasticsearch.common.Booleans.isBooleanLenient(char[], int, int) Only kept to provide automatic upgrades for pre 6.0 indices. Use `Booleans.isBoolean(char[], int, int)` instead.
org.elasticsearch.common.xcontent.XContentParser.isBooleanValueLenient() Just present for providing backwards compatibility. Use `XContentParser.isBooleanValue()` instead.
org.elasticsearch.common.xcontent.support.AbstractXContentParser.isBooleanValueLenient()
org.elasticsearch.action.get.GetResponse.iterator() Use `GetResponse.getSource()` instead
org.elasticsearch.plugins.Plugin.onModule(ActionModule) implement `ActionPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(AnalysisModule) implement `AnalysisPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(ClusterModule) implement `ClusterPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(DiscoveryModule) implement `DiscoveryPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(IndexModule) use #onIndexModule instead
org.elasticsearch.plugins.Plugin.onModule(NetworkModule) implement `NetworkPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(RepositoriesModule) implement `RepositoryPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(ScriptModule) implement `ScriptPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(SearchModule) implement `SearchPlugin` instead
org.elasticsearch.plugins.Plugin.onModule(SettingsModule) use #getSettings and #getSettingsFilter instead
org.elasticsearch.common.util.LocaleUtils.parse5x(String)
org.elasticsearch.common.Booleans.parseBooleanLenient(char[], int, int, boolean) Only kept to provide automatic upgrades for pre 6.0 indices. Use `Booleans.parseBoolean(char[], int, int, boolean)` instead
org.elasticsearch.common.Booleans.parseBooleanLenient(String, boolean) Only kept to provide automatic upgrades for pre 6.0 indices. Use `Booleans.parseBoolean(String, boolean)` instead.
org.elasticsearch.common.Booleans.parseBooleanLenient(String, Boolean) Only kept to provide automatic upgrades for pre 6.0 indices. Use `Booleans.parseBoolean(String, Boolean)` instead.
org.elasticsearch.client.ClusterAdminClient.preparePutPipeline(String, BytesReference) use `ClusterAdminClient.preparePutPipeline(String, BytesReference, XContentType)`
org.elasticsearch.client.ClusterAdminClient.prepareSimulatePipeline(BytesReference)
org.elasticsearch.client.support.AbstractClient.prepareTermVector()
org.elasticsearch.client.Client.prepareTermVector()
org.elasticsearch.client.support.AbstractClient.prepareTermVector(String, String, String)
org.elasticsearch.client.Client.prepareTermVector(String, String, String)
org.elasticsearch.common.xcontent.XContentBuilder.rawField(String, BytesReference) use `XContentBuilder.rawField(String name, BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentBuilder.rawField(String, InputStream) use `XContentBuilder.rawField(String, InputStream, XContentType)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentBuilder.rawValue(BytesReference) use `XContentBuilder.rawValue(BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.search.aggregations.metrics.cardinality.CardinalityAggregationBuilder.rehash(boolean) no replacement - values will always be rehashed
org.elasticsearch.action.update.UpdateRequest.script(String) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.script(String, ScriptType) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.script(String, ScriptType, Map<String, Object>) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.script(String, String, ScriptType, Map<String, Object>) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.scriptLang() Use `UpdateRequest.script()` instead
org.elasticsearch.action.update.UpdateRequest.scriptLang(String) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.scriptParams() Use `UpdateRequest.script()` instead
org.elasticsearch.action.update.UpdateRequest.scriptParams(Map<String, Object>) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.scriptString() Use `UpdateRequest.script()` instead
org.elasticsearch.action.update.UpdateRequest.scriptType() Use `UpdateRequest.script()` instead
org.elasticsearch.index.query.InnerHitBuilder.setFieldNames(List<String>) Use `InnerHitBuilder.setStoredFieldNames(List)` instead.
org.elasticsearch.action.update.UpdateRequestBuilder.setFields(String...) Use `UpdateRequestBuilder.setFetchSource(String[], String[])` instead
org.elasticsearch.index.query.MatchQueryBuilder.setLenient(boolean) use #lenient() instead
org.elasticsearch.search.sort.ScriptSortBuilder.setNestedFilter(QueryBuilder) set nested sort with `ScriptSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `ScriptSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.GeoDistanceSortBuilder.setNestedFilter(QueryBuilder) set nested sort with `GeoDistanceSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `GeoDistanceSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.FieldSortBuilder.setNestedFilter(QueryBuilder) set nested sort with `FieldSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `FieldSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.ScriptSortBuilder.setNestedPath(String) set nested sort with `ScriptSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `ScriptSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.GeoDistanceSortBuilder.setNestedPath(String) set nested sort with `GeoDistanceSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `GeoDistanceSortBuilder.getNestedSort()`
org.elasticsearch.search.sort.FieldSortBuilder.setNestedPath(String) set nested sort with `FieldSortBuilder.setNestedSort(NestedSortBuilder)` and retrieve with `FieldSortBuilder.getNestedSort()`
org.elasticsearch.common.io.UTF8StreamWriter.setOutputStream(OutputStream) Replaced by `UTF8StreamWriter.setOutput(OutputStream)`
org.elasticsearch.action.admin.indices.template.put.PutIndexTemplateRequestBuilder.setTemplate(String) Replaced by `PutIndexTemplateRequestBuilder.setPatterns(List)`
org.elasticsearch.common.network.NetworkUtils.sortAddresses(List<InetAddress>) remove this when multihoming is really correct
org.elasticsearch.index.query.QueryStringQueryBuilder.splitOnWhitespace()
org.elasticsearch.index.query.QueryStringQueryBuilder.splitOnWhitespace(boolean)
org.elasticsearch.client.support.AbstractClient.termVector(TermVectorsRequest)
org.elasticsearch.client.Client.termVector(TermVectorsRequest)
org.elasticsearch.client.support.AbstractClient.termVector(TermVectorsRequest, ActionListener<TermVectorsResponse>)
org.elasticsearch.client.Client.termVector(TermVectorsRequest, ActionListener<TermVectorsResponse>)
org.elasticsearch.index.query.QueryStringQueryBuilder.useAllFields()
org.elasticsearch.index.query.SimpleQueryStringBuilder.useAllFields()
org.elasticsearch.index.query.QueryStringQueryBuilder.useAllFields(Boolean)
org.elasticsearch.index.query.SimpleQueryStringBuilder.useAllFields(Boolean)
org.elasticsearch.index.query.QueryStringQueryBuilder.useDisMax()
org.elasticsearch.index.query.QueryStringQueryBuilder.useDisMax(boolean)
org.elasticsearch.index.query.MultiMatchQueryBuilder.useDisMax(Boolean) use a tieBreaker of 1.0f to disable "dis-max" query or select the appropriate `MultiMatchQueryBuilder.Type`
org.elasticsearch.common.xcontent.XContentGenerator.writeRawField(String, BytesReference) use `XContentGenerator.writeRawField(String, BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentHelper.writeRawField(String, BytesReference, XContentBuilder, ToXContent.Params) use `#writeRawField(String, BytesReference, XContentType, XContentBuilder, Params)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentGenerator.writeRawField(String, InputStream) use `XContentGenerator.writeRawField(String, InputStream, XContentType)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentGenerator.writeRawValue(BytesReference) use `XContentGenerator.writeRawValue(BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.common.xcontent.XContentFactory.xContent(byte[]) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContent(byte[], int, int) guessing the content type should not be needed ideally. We should rather know the content type upfront or read it from headers. Till we fixed the REST layer to read the Content-Type header, that should be the only place where guessing is needed.
org.elasticsearch.common.xcontent.XContentFactory.xContent(BytesReference) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContent(CharSequence) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContentType(byte[]) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContentType(byte[], int, int) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContentType(BytesReference) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContentType(CharSequence) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.
org.elasticsearch.common.xcontent.XContentFactory.xContentType(InputStream) the content type should not be guessed except for few cases where we effectively don't know the content type. The REST layer should move to reading the Content-Type header instead. There are other places where auto-detection may be needed. This method is deprecated to prevent usages of it from spreading further without specific reasons.

Deprecated Constructors
Constructor and Description
org.elasticsearch.action.ingest.PutPipelineRequest(String, BytesReference) use `PutPipelineRequest.PutPipelineRequest(String, BytesReference, XContentType)` to avoid content type auto-detection
org.elasticsearch.action.ingest.PutPipelineRequestBuilder(ElasticsearchClient, PutPipelineAction, String, BytesReference)
org.elasticsearch.common.settings.SecureString(String) Only use for compatibility between deprecated string settings and new secure strings
org.elasticsearch.action.ingest.SimulatePipelineRequest(BytesReference) use `SimulatePipelineRequest.SimulatePipelineRequest(BytesReference, XContentType)` that does not attempt content autodetection
org.elasticsearch.action.ingest.SimulatePipelineRequestBuilder(ElasticsearchClient, SimulatePipelineAction, BytesReference) use `SimulatePipelineRequestBuilder.SimulatePipelineRequestBuilder(ElasticsearchClient, SimulatePipelineAction, BytesReference, XContentType)` to avoid content type auto-detection on the source bytes
org.elasticsearch.index.analysis.StandardHtmlStripAnalyzer() use `StandardHtmlStripAnalyzer.StandardHtmlStripAnalyzer(CharArraySet)` instead

Deprecated Enum Constants
Enum Constant and Description
org.elasticsearch.index.translog.Translog.Operation.Type.CREATE
org.elasticsearch.index.VersionType.FORCE this will be removed in 7.0 and should not be used! It is ONLY for backward compatibility with 5.0 indices
org.elasticsearch.action.search.SearchType.QUERY_AND_FETCH

Deprecated API

Contents