summaryrefslogtreecommitdiffstats
path: root/container-core/src/test/java/com/yahoo/restapi/RestApiImplTest.java
blob: 16cc2353986d391f783151eb091fc01f5f1e08e9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
package com.yahoo.restapi;// Copyright Verizon Media. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.

import com.fasterxml.jackson.annotation.JsonProperty;
import com.yahoo.container.jdisc.HttpRequest;
import com.yahoo.container.jdisc.HttpResponse;
import com.yahoo.test.json.JsonTestHelper;
import com.yahoo.yolean.Exceptions;
import org.junit.jupiter.api.Test;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.nio.charset.StandardCharsets;
import java.time.Instant;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;

import static com.yahoo.jdisc.http.HttpRequest.Method;
import static com.yahoo.restapi.RestApi.route;
import static org.junit.jupiter.api.Assertions.assertEquals;

/**
 * @author bjorncs
 */
class RestApiImplTest {

    @Test
    void routes_requests_to_correct_handler() {
        RestApi restApi = RestApi.builder()
                .addRoute(route("/api1/{*}").get(ctx -> new MessageResponse("get-method-response")))
                .addRoute(route("/api2/{*}").post(ctx -> new MessageResponse("post-method-response")))
                .setDefaultRoute(route("{*}").defaultHandler(ctx -> ErrorResponse.notFoundError("default-method-response")))
                .build();
        verifyJsonResponse(restApi, Method.GET, "/api1/subpath", null, 200, "{\"message\":\"get-method-response\"}");
        verifyJsonResponse(restApi, Method.POST, "/api1/subpath", "{}", 405, null);
        verifyJsonResponse(restApi, Method.GET, "/api2/subpath", null, 405, null);
        verifyJsonResponse(restApi, Method.POST, "/api2/subpath", "{}", 200, "{\"message\":\"post-method-response\"}");
        verifyJsonResponse(restApi, Method.PUT, "/api2/subpath", "{}", 405, null);
        verifyJsonResponse(restApi, Method.GET, "/unknown/subpath", null, 404, "{\"error-code\":\"NOT_FOUND\",\"message\":\"default-method-response\"}");
        verifyJsonResponse(restApi, Method.DELETE, "/unknown/subpath", "{}", 404, "{\"error-code\":\"NOT_FOUND\",\"message\":\"default-method-response\"}");
    }

    @Test
    void executes_filters_and_handler_in_correct_order() {
        List<String> actualEvaluationOrdering = new ArrayList<>();
        RestApi.MethodHandler<HttpResponse> handler = context -> {
            actualEvaluationOrdering.add("handler");
            return new MessageResponse("get-method-response");
        };
        class NamedTestFilter implements RestApi.Filter {
            final String name;
            NamedTestFilter(String name) { this.name = name; }

            @Override
            public HttpResponse filterRequest(RestApi.FilterContext context) {
                actualEvaluationOrdering.add("pre-" + name);
                HttpResponse response = context.executeNext();
                actualEvaluationOrdering.add("post-" + name);
                return response;
            }
        }
        RestApi restApi = RestApi.builder()
                .setDefaultRoute(route("{*}")
                        .defaultHandler(handler)
                        .addFilter(new NamedTestFilter("route-filter-1"))
                        .addFilter(new NamedTestFilter("route-filter-2")))
                .addFilter(new NamedTestFilter("global-filter-1"))
                .addFilter(new NamedTestFilter("global-filter-2"))
                .build();
        verifyJsonResponse(restApi, Method.GET, "/", null, 200, "{\"message\":\"get-method-response\"}");
        List<String> expectedOrdering = List.of(
                "pre-global-filter-1", "pre-global-filter-2", "pre-route-filter-1", "pre-route-filter-2",
                "handler",
                "post-route-filter-2", "post-route-filter-1", "post-global-filter-2", "post-global-filter-1");
        assertEquals(expectedOrdering, actualEvaluationOrdering);
    }

    @SuppressWarnings("divzero")
    @Test
    void handles_custom_response_and_exception_mapper() {
        RestApi restApi = RestApi.builder()
                .disableDefaultExceptionMappers()
                .disableDefaultResponseMappers()
                .addRoute(route("/long").get(ctx -> 123456L))
                .addRoute(route("/exception").get(ctx -> 123L / 0L))
                .addResponseMapper(Long.class, (entity, ctx) -> new MessageResponse("long value is " + entity))
                .addExceptionMapper(ArithmeticException.class, (exception, ctx) -> ErrorResponse.internalServerError("oops division by zero"))
                .build();
        verifyJsonResponse(restApi, Method.GET, "/long", null, 200, "{\"message\":\"long value is 123456\"}");
        verifyJsonResponse(restApi, Method.GET, "/exception", null, 500, "{\"message\":\"oops division by zero\", \"error-code\":\"INTERNAL_SERVER_ERROR\"}");
    }

    @Test
    void method_handler_can_consume_and_produce_json() {
        RestApi restApi = RestApi.builder()
                .addRoute(route("/api").post(
                        ctx -> ctx.requestContent().get().consumeJacksonEntity(TestEntity.class)))
                .build();
        String rawJson = "{\"mystring\":\"my-string-value\", \"myinstant\":\"2000-01-01T00:00:00Z\"}";
        verifyJsonResponse(restApi, Method.POST, "/api", rawJson, 200, rawJson);
    }

    private static void verifyJsonResponse(RestApi restApi, Method method, String path, String requestContent, int expectedStatusCode, String expectedJson) {
        HttpRequest testRequest = requestContent != null ?
                HttpRequest.createTestRequest(
                        path, method,
                        new ByteArrayInputStream(requestContent.getBytes(StandardCharsets.UTF_8)),
                        Map.of("Content-Type", "application/json")) :
                HttpRequest.createTestRequest(path, method);
        HttpResponse response = restApi.handleRequest(testRequest);
        assertEquals(expectedStatusCode, response.getStatus());
        if (expectedJson != null) {
            assertEquals("application/json", response.getContentType());
            var outputStream = new ByteArrayOutputStream();
            Exceptions.uncheck(() -> response.render(outputStream));
            String content = outputStream.toString(StandardCharsets.UTF_8);
            JsonTestHelper.assertJsonEquals(content, expectedJson);
        }
    }

    public static class TestEntity implements RestApi.JacksonRequestEntity, RestApi.JacksonResponseEntity {
        @JsonProperty("mystring") public String stringValue;
        @JsonProperty("myinstant") public Instant instantValue;
    }
}