Deprecated List (core 5.0.0 API)

Deprecated Classes
Class and Description
org.elasticsearch.index.query.FuzzyQueryBuilder Fuzzy queries are not useful enough. This class will be removed with Elasticsearch 4.0. In most cases you may want to use a match query with the fuzziness parameter for strings or range queries for numeric and date fields.
org.elasticsearch.index.search.geo.GeoDistanceRangeQuery
org.elasticsearch.index.query.IndicesQueryBuilder instead search on the `_index` field
org.elasticsearch.index.search.geo.LegacyIndexedGeoBoundingBoxQuery This query is no longer used for geo_point indexes created after version 2.1
org.elasticsearch.index.search.geo.LegacyInMemoryGeoBoundingBoxQuery This query is no longer used for geo_point indexes created after version 2.1
org.elasticsearch.index.analysis.SnowballAnalyzer (3.1) Use the language-specific analyzer in modules/analysis instead. This analyzer WAS removed in Lucene 5.0

Deprecated Exceptions
Exceptions and Description
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)

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.common.geo.GeoDistance.DEFAULT
org.elasticsearch.index.query.GeoDistanceRangeQueryBuilder.DEFAULT_OPTIMIZE_BBOX
org.elasticsearch.index.query.GeoDistanceQueryBuilder.DEFAULT_OPTIMIZE_BBOX
org.elasticsearch.index.query.MatchQueryBuilder.DEFAULT_TYPE
org.elasticsearch.gateway.PrimaryShardAllocator.INDEX_RECOVERY_INITIAL_SHARDS_SETTING
org.elasticsearch.script.ScriptSettings.LEGACY_SCRIPT_SETTING
org.elasticsearch.index.mapper.MapperService.PERCOLATOR_LEGACY_TYPE_NAME
org.elasticsearch.common.network.NetworkUtils.SUPPORTS_V6 transition mechanism only, do not use

Deprecated Methods
Method and Description
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addCategory(String, CharSequence...)
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addCategory(String, Iterable<? extends CharSequence>)
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addContextField(String, CharSequence...)
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addContextField(String, Iterable<? extends CharSequence>)
org.elasticsearch.action.search.SearchRequestBuilder.addFieldDataField(String) Use `SearchRequestBuilder.addDocValueField(String)` instead.
org.elasticsearch.index.query.InnerHitBuilder.addFieldDataField(String) Use `InnerHitBuilder.addDocValueField(String)` instead.
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addGeoLocation(String, double, double, int...)
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addGeoLocation(String, String)
org.elasticsearch.search.suggest.completion.CompletionSuggestionBuilder.Contexts2x.addGeoLocationWithPrecision(String, double, double, String...)
org.elasticsearch.action.update.UpdateRequest.addScriptParam(String, Object) Use `UpdateRequest.script(Script)` instead
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.search.builder.SearchSourceBuilder.fieldDataField(String) Use `SearchSourceBuilder.docValueField(String)` instead.
org.elasticsearch.search.builder.SearchSourceBuilder.fieldDataFields() Use `SearchSourceBuilder.docValueFields()` instead.
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.index.query.QueryBuilders.fuzzyQuery(String, Object) Fuzzy queries are not useful enough and will be removed with Elasticsearch 4.0. In most cases you may want to use a match query with the fuzziness parameter for strings or range queries for numeric and date fields.
org.elasticsearch.index.query.QueryBuilders.fuzzyQuery(String, String) Fuzzy queries are not useful enough and will be removed with Elasticsearch 4.0. In most cases you may want to use a match query with the fuzziness parameter for strings or range queries for numeric and date fields.
org.elasticsearch.search.sort.GeoDistanceSortBuilder.geohashes(String...)
org.apache.lucene.queryparser.classic.MapperQueryParser.getBooleanQueryCoordDisabled(List<BooleanClause>) review all use of this, don't rely on coord
org.elasticsearch.action.get.GetResponse.getField(String) Use `GetResponse.getSource()` instead
org.elasticsearch.index.query.InnerHitBuilder.getFieldDataFields() Use `InnerHitBuilder.getDocValueFields()` instead.
org.elasticsearch.index.query.InnerHitBuilder.getFieldNames() Use `InnerHitBuilder.getStoredFieldsContext()` instead.
org.elasticsearch.action.get.GetResponse.getFields() Use `GetResponse.getSource()` instead
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.index.query.QueryBuilders.indicesQuery(QueryBuilder, String...) instead search on the `_index` field
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(IndexModule) use #onIndexModule 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.index.query.GeoDistanceRangeQueryBuilder.optimizeBbox()
org.elasticsearch.index.query.GeoDistanceQueryBuilder.optimizeBbox()
org.elasticsearch.index.query.GeoDistanceRangeQueryBuilder.optimizeBbox(String)
org.elasticsearch.index.query.GeoDistanceQueryBuilder.optimizeBbox(String)
org.elasticsearch.index.mapper.TypeParsers.parseNumberField(LegacyNumberFieldMapper.Builder, String, Map<String, Object>, Mapper.TypeParser.ParserContext)
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.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, ScriptService.ScriptType) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.script(String, ScriptService.ScriptType, Map<String, Object>) Use `UpdateRequest.script(Script)` instead
org.elasticsearch.action.update.UpdateRequest.script(String, String, ScriptService.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.setFieldDataFields(List<String>) Use `InnerHitBuilder.setDocValueFields(List)` 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.common.io.UTF8StreamWriter.setOutputStream(OutputStream) Replaced by `UTF8StreamWriter.setOutput(OutputStream)`
org.elasticsearch.index.query.MatchQueryBuilder.slop() for phrase queries use `MatchPhraseQueryBuilder`
org.elasticsearch.index.query.MatchQueryBuilder.slop(int) for phrase queries use `MatchPhraseQueryBuilder`
org.elasticsearch.common.network.NetworkUtils.sortAddresses(List<InetAddress>) remove this when multihoming is really correct
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.MatchQueryBuilder.type() Use `MatchPhraseQueryBuilder` for `phrase` queries and `MatchPhrasePrefixQueryBuilder` for `phrase_prefix` queries
org.elasticsearch.index.query.MatchQueryBuilder.type(MatchQuery.Type) Use `MatchPhraseQueryBuilder` for `phrase` queries and `MatchPhrasePrefixQueryBuilder` for `phrase_prefix` queries
org.elasticsearch.index.query.MultiMatchQueryBuilder.useDisMax(Boolean) use a tieBreaker of 1.0f to disable "dis-max" query or select the appropriate `MultiMatchQueryBuilder.Type`

Deprecated Constructors
Constructor and Description
org.elasticsearch.index.query.IndicesQueryBuilder(QueryBuilder, String...) instead search on the `_index` field
org.elasticsearch.index.analysis.StandardHtmlStripAnalyzer() use `StandardHtmlStripAnalyzer.StandardHtmlStripAnalyzer(CharArraySet)` instead

Deprecated Enum Constants
Enum Constant and Description
org.elasticsearch.common.geo.GeoDistance.ARC use `GeoUtils.arcDistance(double, double, double, double)`
org.elasticsearch.index.translog.Translog.Operation.Type.CREATE
org.elasticsearch.index.IndexModule.Type.DEFAULT
org.elasticsearch.common.geo.GeoDistance.FACTOR use `SloppyMath.haversinMeters(double, double, double, double)` to get distance in meters, law of cosines is being removed
org.elasticsearch.common.geo.GeoDistance.PLANE use `GeoUtils.planeDistance(double, double, double, double)`
org.elasticsearch.common.geo.GeoDistance.SLOPPY_ARC

Deprecated API

Contents