chore: use request body with name for record text in validation endpoint

Author: michaelwenk

src/main/java/massbank_export_api/api/ValidateApiDelegateImpl.java

@@ -1,6 +1,7 @@
 package massbank_export_api.api;
 
 import massbank.RecordParser;
+import massbank_export_api.model.Validation;
 import massbank_export_api.model.ValidationError;
 import org.petitparser.context.Result;
 import org.springframework.context.annotation.Primary;
@@ -22,14 +23,16 @@ public ValidateApiDelegateImpl() {
     }
 
     @Override
-    public ResponseEntity<Void> validatePost(final String body) {
-        if (body == null || body.trim().isEmpty()) {
+    public ResponseEntity<Void> validatePost(Validation validation) {
+        if (validation == null || validation.getText() == null) {
             return ResponseEntity.badRequest().build();
         }
 
+        final String recordText = validation.getText();
+
         ResponseEntity<ValidationError> respWithBody;
         final ValidationError error = new ValidationError();
-        final Result result = recordParser.parse(body);
+        final Result result = recordParser.parse(recordText);
         if (result.isSuccess()) {
             error.setMessage("Record is valid.");
             error.setLine(null);
@@ -41,7 +44,7 @@ public ResponseEntity<Void> validatePost(final String body) {
             final String message = result.getMessage();
             final int pos = result.getPosition();
 
-            final String[] tokens = body.split("\\n");
+            final String[] tokens = recordText.split("\\n");
             int offset = 0;
             int lineNumber = 1;
             int col = 0;

src/main/resources/openapi.yaml

@@ -1,8 +1,7 @@
 openapi: 3.0.3
 info:
   title: Export MassBank content in different formats
-  description:
-    This microservice converts MassBank records into a number of different other formats.
+  description: This microservice converts MassBank records into a number of different other formats.
   version: "0.1"
 servers:
   - url: http://localhost:8080
@@ -109,12 +108,9 @@ paths:
       requestBody:
         required: true
         content:
-          text/plain; charset=utf-8:
+          application/json:
             schema:
-              type: string
-              example: |
-                ACCESSION: MSBNK-IPB_Halle-PB001341
-                RECORD_TITLE: ...
+              $ref: "#/components/schemas/validation"
       responses:
         "200":
           description: Record is valid.
@@ -159,6 +155,16 @@ components:
         format:
           $ref: "#/components/schemas/format"
 
+    validation:
+      description: a single record as plain text
+      type: object
+      properties:
+        text:
+          type: string
+          example: |
+            ACCESSION: MSBNK-IPB_Halle-PB001341
+            RECORD_TITLE: ...
+
     validation_error:
       description: Detailed validation errors for an invalid record.
       type: object
@@ -171,4 +177,4 @@ components:
           example: 12
         column:
           type: integer
-          example: 5
+          example: 5