Skip to content

added breaking changes for the Java API to the breaking changes doc for 5.0 #17243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 22, 2016
Merged

added breaking changes for the Java API to the breaking changes doc for 5.0 #17243

merged 3 commits into from
Mar 22, 2016

Conversation

colings86
Copy link
Contributor

Closes #14191

@colings86 colings86 added >docs General docs changes review :Core/Infra/Transport API Transport client API v5.0.0-alpha1 labels Mar 22, 2016
==== SearchSourceBuilder

All methods which take an `XContentBuilder`, `BytesReference` `Map<String, Object>` or `bytes[]` have been removed in favor of providing the
relevant builder object for that feature. This means that all search requests can now be validated at call time which results in much clearer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you add an example of what we mean by builder object? Also do we still want to remove the builder suffix? In that case we may want to start here by using a different name?

@javanna
Copy link
Member

javanna commented Mar 22, 2016

left a small comment, thanks a lot for doing this Colin

@javanna
Copy link
Member

javanna commented Mar 22, 2016

One more thing, do you mind adding the same things for validate query and explain?
See #14191 (comment)

@colings86
Copy link
Contributor Author

@javanna I pushed a commit to address your comments

@@ -229,16 +229,16 @@ The `field` setter has been deleted. Instead the field name needs to be specifie
==== SearchSourceBuilder

All methods which take an `XContentBuilder`, `BytesReference` `Map<String, Object>` or `bytes[]` have been removed in favor of providing the
relevant builder object for that feature. This means that all search requests can now be validated at call time which results in much clearer
errors.
relevant builder object for that feature (e.g. HighlightBuilder, AggregationBuilder, SuggesterBuilder) . This means that all search requests
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is it SuggesterBuilder or SuggestBuilder?

@javanna
Copy link
Member

javanna commented Mar 22, 2016

left very small comments, really nitpicks, LGTM though no need for another review

@javanna
Copy link
Member

javanna commented Mar 22, 2016

Do we want to go and deprecate these methods in the last 2.x release? That would probably be nice to java api users, as their code will not compile anymore against 5.0.

colings86 added a commit that referenced this pull request Mar 22, 2016
…anges

added breaking changes for the Java API to the breaking changes doc for 5.0
@colings86 colings86 merged commit d6fe751 into elastic:master Mar 22, 2016
@colings86 colings86 deleted the docs/searchRequestBreakingChanges branch March 22, 2016 15:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Core/Infra/Transport API Transport client API >docs General docs changes v5.0.0-alpha1
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants