src/main/java/openjdk/http/tutorial/exercise1/Retrievals.java
author chegar
Tue, 16 Jan 2018 21:08:16 +0000
branchhttp-client-tutorial
changeset 56018 40e766eb611b
parent 56017 fc030486080e
permissions -rw-r--r--
http-client-tutorial: additional informational comments and fixes
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     1
/*
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     2
 * Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     4
 *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     7
 * published by the Free Software Foundation.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     8
 *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
     9
 * This code is distributed in the hope that it will be useful, but WITHOUT
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    10
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    11
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    12
 * version 2 for more details (a copy is included in the LICENSE file that
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    13
 * accompanied this code).
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    14
 *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    15
 * You should have received a copy of the GNU General Public License version
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    16
 * 2 along with this work; if not, write to the Free Software Foundation,
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    17
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    18
 *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    19
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    20
 * or visit www.oracle.com if you need additional information or have any
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    21
 * questions.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    22
 */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    23
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    24
package openjdk.http.tutorial.exercise1;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    25
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    26
import java.io.IOException;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    27
import java.io.UncheckedIOException;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    28
import java.net.URI;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    29
import java.nio.file.Files;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    30
import java.nio.file.Path;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    31
import java.nio.file.Paths;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    32
import java.nio.file.StandardOpenOption;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    33
import java.util.Arrays;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    34
import java.util.Map;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    35
import java.util.concurrent.CompletableFuture;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    36
import java.util.function.Function;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    37
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    38
import com.fasterxml.jackson.core.type.TypeReference;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    39
import com.fasterxml.jackson.databind.ObjectMapper;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    40
import jdk.incubator.http.HttpClient;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    41
import jdk.incubator.http.HttpRequest;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    42
import jdk.incubator.http.HttpResponse;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    43
import jdk.incubator.http.HttpResponse.BodyHandler;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    44
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    45
import static java.lang.System.out;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    46
import static java.util.stream.Collectors.joining;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    47
import static jdk.incubator.http.HttpClient.Version.*;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    48
import static jdk.incubator.http.HttpResponse.BodyHandler.*;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    49
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    50
/**
56017
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    51
 * The JDK HTTP Client tutorial.
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    52
 *
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    53
 * Consists of a set of exercises that must be completed. Each exercise is
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    54
 * represented as a method, whose method body must be written successfully to
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    55
 * complete the exercise. Each method-level comment describes the particular
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    56
 * exercise, what must be done, and may provide a hint to help complete it.
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    57
 *
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    58
 * The test source tree contains `Exercise1Test` that contains a set of unit
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    59
 * tests, similarly named to the to the methods in this class, that, when
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    60
 * executed, verify that the exercises have been completed successfully ( by
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    61
 * checking the value returned by each exercise ). These can be run through the
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    62
 * Maven Project's `test` target.
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    63
 *
fc030486080e http-client-tutorial: comments
chegar
parents: 56013
diff changeset
    64
 *
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    65
 * @author Chris Hegarty
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    66
 */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    67
public class Retrievals {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    68
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    69
    /**
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    70
     * Exercise 1.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    71
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    72
     * Retrieve the response status code from a request to the given
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    73
     * URI. Return the response code, which is an integer.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    74
     *
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    75
     * Hint: use the {@link BodyHandler#discard(Object)BodyHandler} since
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    76
     * the response body is not interesting.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    77
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    78
     * Hint: static imports reduce boilerplate when using BodyHandlers
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    79
     * and BodyProcessors, e.g. import static
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    80
     * jdk.incubator.http.HttpResponse.BodyHandler.discard
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    81
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    82
    public static int retrieveTheStatusCode(URI uri)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    83
        throws IOException, InterruptedException
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    84
    {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    85
        HttpClient client = HttpClient.newBuilder().version(HTTP_1_1).build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    86
        HttpRequest request = HttpRequest.newBuilder(uri).GET().build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    87
        HttpResponse<?> response = client.send(request, discard(null));
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    88
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    89
        return response.statusCode();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    90
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    91
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    92
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    93
     * Exercise 2.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    94
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    95
     * Retrieve the response body from a given URI. Return the response
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    96
     * body as a String.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
    97
     *
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    98
     * Hint: use the {@link BodyHandler#asString()} BodyHandler to convert
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
    99
     * the HTTP response body to a String.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   100
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   101
     * Hint: static imports reduce boilerplate when using BodyHandlers
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   102
     * and BodyProcessors, e.g. import static
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   103
     * jdk.incubator.http.HttpResponse.BodyHandler.asString
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   104
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   105
    public static String retrieveResourceAsString(URI uri)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   106
        throws IOException, InterruptedException
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   107
    {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   108
        HttpClient client = HttpClient.newBuilder().version(HTTP_1_1).build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   109
        HttpRequest request = HttpRequest.newBuilder(uri).GET().build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   110
        HttpResponse<String> response = client.send(request, asString());
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   111
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   112
        return response.body();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   113
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   114
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   115
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   116
     * Exercise 3.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   117
     *
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   118
     * Retrieve the response body from a given URI, streaming the body
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   119
     * out to a file. Return the file's Path.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   120
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   121
     * Hint: use {@linkplain BodyHandler#asFile} to stream the HTTP
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   122
     * response body to a file.
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   123
     *
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   124
     * Hint: if a file already exists from a previous test run, either
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   125
     * remove it or use the {@link java.nio.file.StandardOpenOption#CREATE}
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   126
     * along with the {@link java.nio.file.StandardOpenOption#TRUNCATE_EXISTING}
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   127
     * to create or truncate as needed.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   128
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   129
    public static Path retrieveResourceAsFile(URI uri)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   130
        throws IOException, InterruptedException
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   131
    {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   132
        HttpClient client = HttpClient.newBuilder().build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   133
        HttpRequest request = HttpRequest.newBuilder()
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   134
                .uri(uri)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   135
                .version(HTTP_1_1)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   136
                .GET()
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   137
                .build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   138
        HttpResponse<Path> response = client.send(request,
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   139
                asFile(Paths.get("retrieveResourceAsFile.txt"),
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   140
                       StandardOpenOption.CREATE,
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   141
                       StandardOpenOption.TRUNCATE_EXISTING,
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   142
                       StandardOpenOption.WRITE));
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   143
        return response.body();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   144
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   145
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   146
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   147
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   148
     * A helper method, NOT an exercise.
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   149
     *
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   150
     * Asserts that the response code is 200 ( OK ). Throws IOException if
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   151
     * the response code is not 200.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   152
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   153
     * Can be used in CompletableFuture pipelines when checking the
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   154
     * response of an {@linkplain HttpClient#sendAsync} call. For
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   155
     * example:
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   156
     *    client.sendAsync(request, bodyHandler)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   157
     *          .thenApply(Retrievals::require200StatusCode)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   158
     *          .thenApply(...)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   159
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   160
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   161
    public static <T> HttpResponse<T> require200StatusCode(HttpResponse<T> response) {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   162
        int sc = response.statusCode();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   163
        if (sc != 200) {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   164
            IOException e = new IOException("Expected 200, got: " + sc);
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   165
            throw new UncheckedIOException(e);
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   166
        }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   167
        return response;
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   168
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   169
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   170
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   171
     * Exercise 4.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   172
     *
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   173
     * Retrieve the response body from a given URI, using thea synchronous
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   174
     * send API, {@link HttpClient#sendAsync(HttpRequest, BodyHandler)}.
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   175
     * Return a CompletableFuture that completes with the response body
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   176
     * as a String.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   177
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   178
     * Hint: The {@linkplain CompletableFuture#thenApply(Function)}
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   179
     * method can be used to map the HttpResponse to a String.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   180
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   181
    public static CompletableFuture<String> retrieveResourceAsStringUsingAsyncAPI(URI uri) {
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   182
        // TODO: why version needed?
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   183
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   184
        return HttpClient.newHttpClient()
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   185
                .sendAsync(HttpRequest.newBuilder(uri).version(HTTP_1_1).build(), asString())
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   186
                .thenApply(Retrievals::require200StatusCode)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   187
                .thenApply(HttpResponse::body);
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   188
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   189
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   190
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   191
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   192
     * A helper method, NOT an exercise.
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   193
     *
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   194
     * Wrapper around Jackson's ObjectMapper that provides an unchecked
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   195
     * {@code readValue}, what can be used to help solve the next
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   196
     * exercise, 5.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   197
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   198
    public static class UncheckedObjectMapper extends ObjectMapper {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   199
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   200
        /** Parses the given JSON string into a Map. */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   201
        Map<String,String> readValue(String content) {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   202
            try {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   203
                return this.readValue(content, new TypeReference<>(){});
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   204
            } catch (IOException ioe) {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   205
                throw new UncheckedIOException(ioe);
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   206
            }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   207
        }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   208
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   209
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   210
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   211
     * Exercise 5.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   212
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   213
     * Retrieve the response body from a given URI. The response body
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   214
     * will be in the JSON format. The Jackson based UncheckedObjectMapper
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   215
     * ( above ) can be used to parse the String response body into a
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   216
     * Map. Return the response body as a Map.
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   217
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   218
     * Hint: The asynchronous send API will allow construction of a
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   219
     * pipeline of CompletableFutures.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   220
     *
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   221
     * Hint: The {@linkplain CompletableFuture#thenApply(Function)}
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   222
     * method can be used to map the HttpResponse to a String, and then
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   223
     * again from a String ( of JSON ) to a Map ( via the object mapper ).
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   224
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   225
    public CompletableFuture<Map<String,String>> JSONBodyAsMap(URI uri) {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   226
        UncheckedObjectMapper objectMapper = new UncheckedObjectMapper();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   227
        return HttpClient.newHttpClient()
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   228
                .sendAsync(HttpRequest.newBuilder(uri).version(HTTP_1_1).build(), asString())
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   229
                .thenApply(HttpResponse::body)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   230
                .thenApply(objectMapper::readValue);
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   231
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   232
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   233
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   234
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   235
    /**
56018
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   236
     * Exercise 6.
40e766eb611b http-client-tutorial: additional informational comments and fixes
chegar
parents: 56017
diff changeset
   237
     *
56013
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   238
     * Post the given {@code data}, and receive the same data in
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   239
     * response. Return the response body data as a String.
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   240
     */
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   241
    public static String postData(URI uri, String data)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   242
        throws IOException, InterruptedException
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   243
    {
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   244
        HttpClient client = HttpClient.newBuilder().build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   245
        HttpRequest request = HttpRequest.newBuilder()
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   246
                .uri(uri)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   247
                .version(HTTP_1_1)
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   248
                .POST(HttpRequest.BodyProcessor.fromString(data))
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   249
                .build();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   250
        HttpResponse<String> response = client.send(request, asString());
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   251
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   252
        return response.body();
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   253
    }
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   254
08b6eca8daae http-client-tutorial: first cut
chegar
parents:
diff changeset
   255
}