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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.restapi;// Copyright Yahoo. 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.AclMapping;
import com.yahoo.container.jdisc.HttpRequestBuilder;
import com.yahoo.container.jdisc.HttpResponse;
import com.yahoo.container.jdisc.RequestHandlerSpec;
import com.yahoo.container.jdisc.RequestView;
import com.yahoo.security.tls.Capability;
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.net.URI;
import java.nio.charset.StandardCharsets;
import java.time.Instant;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.Set;
import static com.yahoo.jdisc.http.HttpRequest.Method;
import static com.yahoo.restapi.RestApi.handlerConfig;
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.Handler<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, (ctx, entity) -> new MessageResponse("long value is " + entity))
.addExceptionMapper(ArithmeticException.class, (ctx, exception) -> 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.HandlerWithRequestEntity<TestEntity, TestEntity> handler = (context, requestEntity) -> requestEntity;
RestApi restApi = RestApi.builder()
.registerJacksonRequestEntity(TestEntity.class)
.registerJacksonResponseEntity(TestEntity.class)
.addRoute(route("/api").post(TestEntity.class, handler))
.build();
String rawJson = "{\"mystring\":\"my-string-value\", \"myinstant\":\"2000-01-01T00:00:00Z\"}";
verifyJsonResponse(restApi, Method.POST, "/api", rawJson, 200, rawJson);
}
@Test
void uri_builder_creates_valid_uri_prefix() {
RestApi restApi = RestApi.builder()
.addRoute(route("/test").get(ctx -> new MessageResponse(ctx.baseRequestURL().toString())))
.build();
verifyJsonResponse(restApi, Method.GET, "/test", null, 200, "{\"message\":\"http://localhost\"}");
verifyJsonResponse(restApi, Method.GET, "/test", null, 200, "{\"message\":\"http://mydomain:81\"}", Map.of("Host", "mydomain:81"));
}
@Test
void resolves_correct_acl_action() {
AclMapping.Action customAclAction = AclMapping.Action.custom("custom-action");
RestApi restApi = RestApi.builder()
.addRoute(route("/api1")
.get(ctx -> new MessageResponse(ctx.aclAction().name()),
handlerConfig().withCustomAclAction(customAclAction)))
.addRoute(route("/api2")
.post(ctx -> new MessageResponse(ctx.aclAction().name())))
.build();
verifyJsonResponse(restApi, Method.GET, "/api1", null, 200, "{\"message\":\"custom-action\"}");
verifyJsonResponse(restApi, Method.POST, "/api2", "ignored", 200, "{\"message\":\"write\"}");
RequestHandlerSpec spec = restApi.requestHandlerSpec();
assertRequestHandlerSpecAclMapping(spec, customAclAction, Method.GET, "/api1");
assertRequestHandlerSpecAclMapping(spec, AclMapping.Action.WRITE, Method.POST, "/api2");
}
@Test
void resolves_correct_capabilities() {
var restApi = RestApi.builder()
.requiredCapabilities(Capability.CONTENT__METRICS_API)
.addRoute(route("/api1")
.requiredCapabilities(Capability.CONTENT__SEARCH_API)
.get(ctx -> new MessageResponse(ctx.aclAction().name()),
handlerConfig().withRequiredCapabilities(Capability.SLOBROK__API))
.post(ctx -> new MessageResponse(ctx.aclAction().name())))
.addRoute(route("/api2")
.get(ctx -> new MessageResponse(ctx.aclAction().name()))
.post(ctx -> new MessageResponse(ctx.aclAction().name()),
handlerConfig().withRequiredCapabilities(Capability.CONTENT__DOCUMENT_API)))
.build();
assertRequiredCapability(restApi, Method.GET, "/api1", Capability.SLOBROK__API);
assertRequiredCapability(restApi, Method.POST, "/api1", Capability.CONTENT__SEARCH_API);
assertRequiredCapability(restApi, Method.GET, "/api2", Capability.CONTENT__METRICS_API);
assertRequiredCapability(restApi, Method.POST, "/api2", Capability.CONTENT__DOCUMENT_API);
}
private static void verifyJsonResponse(
RestApi restApi, Method method, String path, String requestContent, int expectedStatusCode,
String expectedJson) {
verifyJsonResponse(restApi, method, path, requestContent, expectedStatusCode, expectedJson, Map.of());
}
private static void verifyJsonResponse(
RestApi restApi, Method method, String path, String requestContent, int expectedStatusCode,
String expectedJson, Map<String, String> additionalHeaders) {
HttpRequestBuilder builder = HttpRequestBuilder.create(method, path);
additionalHeaders.forEach(builder::withHeader);
if (requestContent != null) {
builder.withHeader("Content-Type", "application/json");
builder.withRequestContent(new ByteArrayInputStream(requestContent.getBytes(StandardCharsets.UTF_8)));
}
HttpResponse response = restApi.handleRequest(builder.build());
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);
}
}
private static void assertRequestHandlerSpecAclMapping(
RequestHandlerSpec spec, AclMapping.Action expectedAction, Method method, String uriPath) {
assertEquals(expectedAction, spec.aclMapping().get(new View(method, uriPath)));
}
private static void assertRequiredCapability(RestApi api, Method method, String uriPath, Capability capability) {
assertEquals(Set.of(capability), api.requiredCapabilities(new View(method, uriPath)).asSet());
}
public static class TestEntity {
@JsonProperty("mystring") public String stringValue;
@JsonProperty("myinstant") public Instant instantValue;
}
private static class View implements RequestView {
final Method method; final String path;
View(Method m, String path) { this.method = m; this.path = path;}
@Override public Method method() { return method; }
@Override public URI uri() { return URI.create("http://localhost" + path); }
}
}
|
