feat(spec): Add Parameter, RequestBody, MediaType, Response, Server, Info records

Author: thced

src/main/java/com/retailsvc/http/spec/Info.java

@@ -0,0 +1,3 @@
+package com.retailsvc.http.spec;
+
+public record Info(String title, String version) {}

src/main/java/com/retailsvc/http/spec/MediaType.java

@@ -0,0 +1,5 @@
+package com.retailsvc.http.spec;
+
+import com.retailsvc.http.spec.schema.Schema;
+
+public record MediaType(Schema schema) {}

src/main/java/com/retailsvc/http/spec/Parameter.java

@@ -0,0 +1,12 @@
+package com.retailsvc.http.spec;
+
+import com.retailsvc.http.spec.schema.Schema;
+
+public record Parameter(String name, Location in, boolean required, Schema schema) {
+  public enum Location {
+    PATH,
+    QUERY,
+    HEADER,
+    COOKIE
+  }
+}

src/main/java/com/retailsvc/http/spec/RequestBody.java

@@ -0,0 +1,5 @@
+package com.retailsvc.http.spec;
+
+import java.util.Map;
+
+public record RequestBody(boolean required, Map<String, MediaType> content) {}

src/main/java/com/retailsvc/http/spec/Response.java

@@ -0,0 +1,5 @@
+package com.retailsvc.http.spec;
+
+import java.util.Map;
+
+public record Response(Map<String, MediaType> content) {}

src/main/java/com/retailsvc/http/spec/Server.java

@@ -0,0 +1,9 @@
+package com.retailsvc.http.spec;
+
+import java.net.URI;
+
+public record Server(String url) {
+  public String basePath() {
+    return URI.create(url).getPath();
+  }
+}

src/test/java/com/retailsvc/http/spec/SpecRecordsTest.java

@@ -0,0 +1,40 @@
+package com.retailsvc.http.spec;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import com.retailsvc.http.spec.schema.BooleanSchema;
+import com.retailsvc.http.spec.schema.Schema;
+import com.retailsvc.http.spec.schema.TypeName;
+import java.util.Map;
+import java.util.Set;
+import org.junit.jupiter.api.Test;
+
+class SpecRecordsTest {
+  private final Schema s = new BooleanSchema(Set.of(TypeName.BOOLEAN));
+
+  @Test
+  void parameterLocationEnum() {
+    Parameter p = new Parameter("x", Parameter.Location.QUERY, true, s);
+    assertThat(p.in()).isEqualTo(Parameter.Location.QUERY);
+    assertThat(p.required()).isTrue();
+  }
+
+  @Test
+  void requestBodyStoresContent() {
+    RequestBody body = new RequestBody(true, Map.of("application/json", new MediaType(s)));
+    assertThat(body.content()).containsKey("application/json");
+    assertThat(body.required()).isTrue();
+  }
+
+  @Test
+  void serverHasUrl() {
+    assertThat(new Server("http://localhost/api").url()).isEqualTo("http://localhost/api");
+  }
+
+  @Test
+  void infoHasTitleAndVersion() {
+    Info i = new Info("test", "1.0.0");
+    assertThat(i.title()).isEqualTo("test");
+    assertThat(i.version()).isEqualTo("1.0.0");
+  }
+}