Java api: Remove unneeded getTookInMillis method (#23923)

Some response classes in the java api expose both `getTook()` which returns a `TimeValue` and `getTookInMillis` which returns a `long` value. `getTook()` is enough as one can do `getTook().millis()` to obtain the same result as `getTookInMillis()`, which can be removed.

client/rest-high-level/src/test/java/org/elasticsearch/client/CrudIT.java

@@ -580,7 +580,7 @@ public class CrudIT extends ESRestHighLevelClientTestCase {
 
         BulkResponse bulkResponse = execute(bulkRequest, highLevelClient()::bulk, highLevelClient()::bulkAsync);
         assertEquals(RestStatus.OK, bulkResponse.status());
-        assertTrue(bulkResponse.getTookInMillis() > 0);
+        assertTrue(bulkResponse.getTook().getMillis() > 0);
         assertEquals(nbItems, bulkResponse.getItems().length);
 
         validateBulkResponses(nbItems, errors, bulkResponse, bulkRequest);
@@ -671,7 +671,7 @@ public class CrudIT extends ESRestHighLevelClientTestCase {
         BulkRequest bulkRequest = requestRef.get();
 
         assertEquals(RestStatus.OK, bulkResponse.status());
-        assertTrue(bulkResponse.getTookInMillis() > 0);
+        assertTrue(bulkResponse.getTook().getMillis() > 0);
         assertEquals(nbItems, bulkResponse.getItems().length);
         assertNull(error.get());
 

core/src/main/java/org/elasticsearch/action/bulk/BulkResponse.java

@@ -76,13 +76,6 @@ public class BulkResponse extends ActionResponse implements Iterable<BulkItemRes
         return new TimeValue(tookInMillis);
     }
 
-    /**
-     * How long the bulk execution took in milliseconds. Excluding ingest preprocessing.
-     */
-    public long getTookInMillis() {
-        return tookInMillis;
-    }
-
     /**
      * If ingest is enabled returns the bulk ingest preprocessing time, otherwise 0 is returned.
      */

core/src/main/java/org/elasticsearch/action/bulk/TransportBulkAction.java

@@ -569,8 +569,8 @@ public class TransportBulkAction extends HandledTransportAction<BulkRequest, Bul
         ActionListener<BulkResponse> wrapActionListenerIfNeeded(long ingestTookInMillis, ActionListener<BulkResponse> actionListener) {
             if (itemResponses.isEmpty()) {
                 return ActionListener.wrap(
-                    response -> actionListener.onResponse(
-                        new BulkResponse(response.getItems(), response.getTookInMillis(), ingestTookInMillis)),
+                        response -> actionListener.onResponse(new BulkResponse(response.getItems(),
+                                response.getTook().getMillis(), ingestTookInMillis)),
                         actionListener::onFailure);
             } else {
                 return new IngestBulkResponseListener(ingestTookInMillis, originalSlots, itemResponses, actionListener);
@@ -610,7 +610,9 @@ public class TransportBulkAction extends HandledTransportAction<BulkRequest, Bul
             for (int i = 0; i < items.length; i++) {
                 itemResponses.add(originalSlots[i], response.getItems()[i]);
             }
-            actionListener.onResponse(new BulkResponse(itemResponses.toArray(new BulkItemResponse[itemResponses.size()]), response.getTookInMillis(), ingestTookInMillis));
+            actionListener.onResponse(new BulkResponse(
+                    itemResponses.toArray(new BulkItemResponse[itemResponses.size()]),
+                    response.getTook().getMillis(), ingestTookInMillis));
         }
 
         @Override

core/src/main/java/org/elasticsearch/action/search/SearchResponse.java

@@ -135,13 +135,6 @@ public class SearchResponse extends ActionResponse implements StatusToXContentOb
         return new TimeValue(tookInMillis);
     }
 
-    /**
-     * How long the search took in milliseconds.
-     */
-    public long getTookInMillis() {
-        return tookInMillis;
-    }
-
     /**
      * The total number of shards the search was executed on.
      */

core/src/main/java/org/elasticsearch/action/termvectors/TermVectorsResponse.java

@@ -334,10 +334,6 @@ public class TermVectorsResponse extends ActionResponse implements ToXContentObj
         return new TimeValue(tookInMillis);
     }
 
-    public long getTookInMillis() {
-        return tookInMillis;
-    }
-
     private void buildScore(XContentBuilder builder, BoostAttribute boostAtt) throws IOException {
         if (hasScores) {
             builder.field(FieldStrings.SCORE, boostAtt.getBoost());

core/src/test/java/org/elasticsearch/action/bulk/BulkResponseTests.java

@@ -95,7 +95,7 @@ public class BulkResponseTests extends ESTestCase {
             assertNull(parser.nextToken());
         }
 
-        assertEquals(took, parsedBulkResponse.getTookInMillis());
+        assertEquals(took, parsedBulkResponse.getTook().getMillis());
         assertEquals(ingestTook, parsedBulkResponse.getIngestTookInMillis());
         assertEquals(expectedBulkItems.length, parsedBulkResponse.getItems().length);
 

core/src/test/java/org/elasticsearch/index/termvectors/TermVectorsServiceTests.java

@@ -73,7 +73,8 @@ public class TermVectorsServiceTests extends ESSingleNodeTestCase {
         TermVectorsResponse response = TermVectorsService.getTermVectors(shard, request, longs.iterator()::next);
 
         assertThat(response, notNullValue());
-        assertThat(response.getTookInMillis(), equalTo(TimeUnit.NANOSECONDS.toMillis(longs.get(1) - longs.get(0))));
+        assertThat(response.getTook().getMillis(),
+                equalTo(TimeUnit.NANOSECONDS.toMillis(longs.get(1) - longs.get(0))));
     }
 
     public void testDocFreqs() throws IOException {

core/src/test/java/org/elasticsearch/search/fetch/subphase/highlight/HighlighterSearchIT.java

@@ -802,7 +802,8 @@ public class HighlighterSearchIT extends ESIntegTestCase {
          * in the neighborhood of 300ms and the large phrase limit is in the
          * neighborhood of 8 seconds.
          */
-        assertThat(defaultPhraseLimit.getTookInMillis(), lessThan(largePhraseLimit.getTookInMillis()));
+        assertThat(defaultPhraseLimit.getTook().getMillis(),
+                lessThan(largePhraseLimit.getTook().getMillis()));
     }
 
 

docs/reference/migration/migrate_6_0/java.asciidoc

@@ -35,3 +35,9 @@ code for ordering buckets. The `BucketOrder` class must be used instead of `Term
 `Histogram.Order`. The `static` methods in the `BucketOrder` class must be called instead of directly
 accessing internal order instances, e.g. `BucketOrder.count(boolean)` and `BucketOrder.aggregation(String, boolean)`.
 Use `BucketOrder.key(boolean)` to order the `terms` aggregation buckets by `_term`.
+
+=== `getTookInMillis()` removed in `BulkResponse`, `SearchResponse` and `TermVectorsResponse`
+
+In `BulkResponse`, `SearchResponse` and `TermVectorsResponse` `getTookInMiilis()` method
+has been removed in favor of `getTook` method. `getTookInMiilis()` is easily replaced by
+`getTook().getMillis()`.