elasticsearch/docs/reference/migration/migrate_8_0/java.asciidoc
James Rodewig ab8766777b
[DOCS] Fix tags and xrefs for 8.0 breaking changes (#75712)
A tag is required to reuse Elasticsearch breaking changes in the Stack
Guide. To display properly, the breaking changes must use external
links rather than xrefs.

This PR correctly places those tags for reuse. It also replaces
several xrefs with external links for reuse.
2021-07-26 17:43:39 -04:00

42 lines
1.4 KiB
Text

[discrete]
[[breaking_80_java_changes]]
==== Java API changes
//NOTE: The notable-breaking-changes tagged regions are re-used in the
//Installation and Upgrade Guide
//tag::notable-breaking-changes[]
.Changes to `Fuzziness`.
[%collapsible]
====
*Details* +
To create `Fuzziness` instances, use the `fromString` and `fromEdits` method
instead of the `build` method that used to accept both Strings and numeric
values. Several fuzziness setters on query builders (e.g.
MatchQueryBuilder#fuzziness) now accept only a `Fuzziness`instance instead of
an Object.
Fuzziness used to be lenient when it comes to parsing arbitrary numeric values
while silently truncating them to one of the three allowed edit distances 0, 1
or 2. This leniency is now removed and the class will throw errors when trying
to construct an instance with another value (e.g. floats like 1.3 used to get
accepted but truncated to 1).
*Impact* +
Use the available constants (e.g. `Fuzziness.ONE`, `Fuzziness.AUTO`) or build
your own instance using the above mentioned factory methods. Use only allowed
`Fuzziness` values.
====
.Changes to `Repository`.
[%collapsible]
====
*Details* +
Repository has no dependency on IndexShard anymore. The contract of restoreShard
and snapshotShard has been reduced to Store and MappingService in order to improve
testability.
*Impact* +
No action needed.
====
// end::notable-breaking-changes[]