DATAES-512 - Polishing.

Update Javadoc and Readme to reflect recent back ports.

Author: christophstrobl

README.md

@@ -54,6 +54,7 @@ the appropriate dependency version.
 
 | spring data elasticsearch | elasticsearch |
 |:-------------------------:|:-------------:|
+| 3.2.x                     | 6.5.0         |
 | 3.1.x                     | 6.2.2         |
 | 3.0.x                     | 5.5.0         |
 | 2.1.x                     | 2.4.0         |
@@ -185,6 +186,78 @@ Searching entities using Elasticsearch Template
         Page<SampleEntity> sampleEntities = elasticsearchTemplate.queryForPage(searchQuery,SampleEntity.class);
 ```
 
+### Reactive Elasticsearch
+
+The `ReactiveElasticsearchClient` is a non official driver based on `WebClient`.
+It uses the request/response objects provided by the Elasticsearch core project.
+
+```java
+@Configuration
+public class Config {
+
+  @Bean
+  ReactiveElasticsearchClient client() {
+
+    ClientConfiguration clientConfiguration = ClientConfiguration.builder()
+      .connectedTo("localhost:9200", "localhost:9291")
+      .build();
+
+    return ReactiveRestClients.create(clientConfiguration);
+  }
+}
+
+// ...
+
+Mono<IndexResponse> response = client.index(request ->
+
+  request.index("spring-data")
+    .type("elasticsearch")
+    .id(randomID())
+    .source(singletonMap("feature", "reactive-client"))
+    .setRefreshPolicy(IMMEDIATE)
+);
+```
+
+The reactive client response, especially for search operations, is bound to the `from` (offset) & `size` (limit) options of the request.
+
+`ReactiveElasticsearchOperations` is the gateway to executing high level commands against an Elasticsearch cluster using the `ReactiveElasticsearchClient`.
+The easiest way of setting up the `ReactiveElasticsearchTemplate` is via `AbstractReactiveElasticsearchConfiguration`.
+
+```java
+@Configuration
+public class Config extends AbstractReactiveElasticsearchConfiguration {
+
+    @Bean
+    @Override
+    public ReactiveElasticsearchClient reactiveElasticsearchClient() {
+        // ...
+    }
+}
+```
+
+If needed the `ReactiveElasticsearchTemplate` can be configured with default `RefreshPolicy` and `IndicesOptions` that get applied to the related requests by overriding the defaults of `refreshPolicy()` and `indicesOptions()`.
+
+```java
+template.save(new Person("Bruce Banner", 42))
+    .doOnNext(System.out::println)
+    .flatMap(person -> template.findById(person.id, Person.class))
+    .doOnNext(System.out::println)
+    .flatMap(person -> template.delete(person))
+    .doOnNext(System.out::println)
+    .flatMap(id -> template.count(Person.class))
+    .doOnNext(System.out::println)
+    .subscribe();
+```
+
+The above outputs the following sequence on the console.
+
+```bash
+> Person(id=QjWCWWcBXiLAnp77ksfR, name=Bruce Banner, age=42)
+> Person(id=QjWCWWcBXiLAnp77ksfR, name=Bruce Banner, age=42)
+> QjWCWWcBXiLAnp77ksfR
+> 0
+```
+
 ### XML Namespace
 
 You can set up repository scanning via xml configuration, which will happily create your repositories.

src/main/java/org/springframework/data/elasticsearch/client/ClientConfiguration.java

@@ -29,7 +29,7 @@
  * Configuration interface exposing common client configuration properties for Elasticsearch clients.
  *
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public interface ClientConfiguration {
 

src/main/java/org/springframework/data/elasticsearch/client/ClientConfigurationBuilder.java

@@ -36,7 +36,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 class ClientConfigurationBuilder
 		implements ClientConfigurationBuilderWithRequiredEndpoint, MaybeSecureClientConfigurationBuilder {

src/main/java/org/springframework/data/elasticsearch/client/ClientLogger.java

@@ -29,7 +29,7 @@
  *
  * @author Mark Paluch
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 public abstract class ClientLogger {
 

src/main/java/org/springframework/data/elasticsearch/client/DefaultClientConfiguration.java

@@ -32,7 +32,7 @@
  *
  * @author Mark Paluch
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 class DefaultClientConfiguration implements ClientConfiguration {
 

src/main/java/org/springframework/data/elasticsearch/client/ElasticsearchHost.java

@@ -25,7 +25,7 @@
  * Value Object containing information about Elasticsearch cluster nodes.
  *
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 public class ElasticsearchHost {
 

src/main/java/org/springframework/data/elasticsearch/client/InetSocketAddressParser.java

@@ -24,7 +24,7 @@
  * Utility to parse endpoints in {@code host:port} format into {@link java.net.InetSocketAddress}.
  *
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 class InetSocketAddressParser {
 

src/main/java/org/springframework/data/elasticsearch/client/NoReachableHostException.java

@@ -22,7 +22,7 @@
  * {@link RuntimeException} to be emitted / thrown when the cluster is down (aka none of the known nodes is reachable).
  *
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 public class NoReachableHostException extends RuntimeException {
 

src/main/java/org/springframework/data/elasticsearch/client/RestClients.java

@@ -52,7 +52,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public final class RestClients {
 
@@ -157,7 +157,7 @@ default void close() throws IOException {
 	 * Logging interceptors for Elasticsearch client logging.
 	 *
 	 * @see ClientLogger
-	 * @since 4.0
+	 * @since 3.2
 	 */
 	private static class HttpLoggingInterceptor implements HttpResponseInterceptor, HttpRequestInterceptor {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/DefaultReactiveElasticsearchClient.java

@@ -110,7 +110,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  * @see ClientConfiguration
  * @see ReactiveRestClients
  */
@@ -657,7 +657,7 @@ public Collection<ElasticsearchHost> hosts() {
 	 * Mutable state object holding scrollId to be used for {@link SearchScrollRequest#scroll(Scroll)}
 	 *
 	 * @author Christoph Strobl
-	 * @since 4.0
+	 * @since 3.2
 	 */
 	private static class ScrollState {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/DefaultWebClientProvider.java

@@ -32,7 +32,7 @@
  *
  * @author Mark Paluch
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 class DefaultWebClientProvider implements WebClientProvider {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/HostProvider.java

@@ -32,7 +32,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public interface HostProvider {
 
@@ -113,7 +113,7 @@ default Mono<WebClient> getActive(Verification verification) {
 	 * {@link Verification} allows to influence the lookup strategy for active hosts.
 	 *
 	 * @author Christoph Strobl
-	 * @since 4.0
+	 * @since 3.2
 	 */
 	enum Verification {
 
@@ -132,7 +132,7 @@ enum Verification {
 	 * Value object accumulating information about an Elasticsearch cluster.
 	 *
 	 * @author Christoph Strobl
-	 * @since 4.0.
+	 * @since 3.2
 	 */
 	class ClusterInformation {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/MultiNodeHostProvider.java

@@ -40,7 +40,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 class MultiNodeHostProvider implements HostProvider {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/RawActionResponse.java

@@ -35,7 +35,7 @@
  * Extension to {@link ActionResponse} that also implements {@link ClientResponse}.
  *
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 class RawActionResponse extends ActionResponse implements ClientResponse {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/ReactiveElasticsearchClient.java

@@ -49,7 +49,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  * @see ClientConfiguration
  * @see ReactiveRestClients
  */
@@ -438,7 +438,7 @@ default Mono<BulkByScrollResponse> deleteBy(DeleteByQueryRequest deleteRequest)
 	 * Low level callback interface operating upon {@link WebClient} to send commands towards elasticsearch.
 	 *
 	 * @author Christoph Strobl
-	 * @since 4.0
+	 * @since 3.2
 	 */
 	interface ReactiveElasticsearchClientCallback {
 		Mono<ClientResponse> doWithClient(WebClient client);
@@ -448,7 +448,7 @@ interface ReactiveElasticsearchClientCallback {
 	 * Cumulative client {@link ElasticsearchHost} information.
 	 *
 	 * @author Christoph Strobl
-	 * @since 4.0
+	 * @since 3.2
 	 */
 	interface Status {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/ReactiveRestClients.java

@@ -24,7 +24,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public final class ReactiveRestClients {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/RequestBodyEncodingException.java

@@ -22,7 +22,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public class RequestBodyEncodingException extends WebClientException {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/SingleNodeHostProvider.java

@@ -30,7 +30,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 class SingleNodeHostProvider implements HostProvider {
 

src/main/java/org/springframework/data/elasticsearch/client/reactive/WebClientProvider.java

@@ -34,7 +34,7 @@
  *
  * @author Christoph Strobl
  * @author Mark Paluch
- * @since 4.0
+ * @since 3.2
  */
 public interface WebClientProvider {
 

src/main/java/org/springframework/data/elasticsearch/client/util/RequestConverters.java

@@ -87,7 +87,7 @@
  * </p>
  * Modified for usage with {@link ReactiveElasticsearchClient}.
  *
- * @since 4.0
+ * @since 3.2
  */
 public class RequestConverters {
 

src/main/java/org/springframework/data/elasticsearch/config/AbstractElasticsearchConfiguration.java

@@ -22,7 +22,7 @@
 
 /**
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  * @see ElasticsearchConfigurationSupport
  */
 public abstract class AbstractElasticsearchConfiguration extends ElasticsearchConfigurationSupport {

src/main/java/org/springframework/data/elasticsearch/config/AbstractReactiveElasticsearchConfiguration.java

@@ -26,7 +26,7 @@
 
 /**
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  * @see ElasticsearchConfigurationSupport
  */
 @Configuration

src/main/java/org/springframework/data/elasticsearch/config/ElasticsearchConfigurationSupport.java

@@ -39,7 +39,7 @@
 
 /**
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 @Configuration
 public class ElasticsearchConfigurationSupport {

src/main/java/org/springframework/data/elasticsearch/core/ElasticsearchExceptionTranslator.java

@@ -25,7 +25,7 @@
 
 /**
  * @author Christoph Strobl
- * @since 4.0
+ * @since 3.2
  */
 public class ElasticsearchExceptionTranslator implements PersistenceExceptionTranslator {