chore: bump to 0.18.1-SNAPSHOT and fix spring example escaping

Update project versions to 0.18.1-SNAPSHOT, add 0.18.1 release notes, and fix boat-spring ExampleObject value rendering by unwrapping escaped quotes with regression coverage.

Made-with: Cursor

Author: AnjBB72

README.md

@@ -16,6 +16,11 @@ It currently consists of
 # Release Notes
 BOAT is still under development and subject to change.
 
+## 0.18.1
+* Spring generator: fixed `@ExampleObject` rendering in `api.mustache` by unwrapping escaped quotes in example payloads.
+* Added `unwrapEscapedQuotes` lambda to `boat-spring` generator templates to prevent malformed annotation values (for example `value = "\"{...}"`).
+* Added a regression test to verify generated Spring API interfaces include valid `@ExampleObject` annotation values and remain parseable Java code.
+
 ## 0.18.0
 * openapi-generator `7.20.0` baseline (Spring Boot 4, Jackson 3)
 * moved Java and JavaSpring templates to `7.20.0` adding remaing custom features

boat-engine/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>backbase-openapi-tools</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
     <artifactId>boat-engine</artifactId>
     <packaging>jar</packaging>

boat-maven-plugin/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>backbase-openapi-tools</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
     <artifactId>boat-maven-plugin</artifactId>
 

boat-quay/boat-quay-lint/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>boat-quay</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>boat-quay-lint</artifactId>

boat-quay/boat-quay-rules/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>boat-quay</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>boat-quay-rules</artifactId>

boat-quay/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>backbase-openapi-tools</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
 
 

boat-scaffold/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.backbase.oss</groupId>
         <artifactId>backbase-openapi-tools</artifactId>
-        <version>0.18.0-SNAPSHOT</version>
+        <version>0.18.1-SNAPSHOT</version>
     </parent>
 
     <artifactId>boat-scaffold</artifactId>
@@ -102,7 +102,7 @@
         <dependency>
             <groupId>com.backbase.oss</groupId>
             <artifactId>boat-trail-resources</artifactId>
-            <version>0.18.0-SNAPSHOT</version>
+            <version>0.18.1-SNAPSHOT</version>
             <scope>test</scope>
         </dependency>
         <dependency>

boat-scaffold/src/main/java/com/backbase/oss/codegen/java/BoatSpringCodeGen.java

@@ -48,6 +48,7 @@ public class BoatSpringCodeGen extends SpringCodegen {
 
     public static final String ADD_SERVLET_REQUEST = "addServletRequest";
     public static final String ADD_BINDING_RESULT = "addBindingResult";
+    public static final String UNWRAP_ESCAPED_QUOTES = "unwrapEscapedQuotes";
 
     private static final String VENDOR_EXTENSION_NOT_NULL = "x-not-null";
 
@@ -147,6 +148,23 @@ protected String postProcessLine(String line) {
         }
     }
 
+    static class UnwrapEscapedQuotes implements Mustache.Lambda {
+
+        @Override
+        public void execute(Fragment frag, Writer out) throws IOException {
+            String text = frag.execute();
+            if (text == null) {
+                return;
+            }
+            String normalized = text.replace("\\\\\"", "\\\"");
+            if (normalized.length() >= 4 && normalized.startsWith("\\\"") && normalized.endsWith("\\\"")) {
+                out.write(normalized.substring(2, normalized.length() - 2));
+                return;
+            }
+            out.write(normalized);
+        }
+    }
+
     /**
      * Adds a HttpServletRequest object to the API definition method.
      */
@@ -332,6 +350,7 @@ public void processOpts() {
         this.additionalProperties.put("newLine8", new NewLineIndent(8, " "));
         this.additionalProperties.put("toOneLine", new FormatToOneLine());
         this.additionalProperties.put("trimAndIndent4", new TrimAndIndent(4, " "));
+        this.additionalProperties.put(UNWRAP_ESCAPED_QUOTES, new UnwrapEscapedQuotes());
     }
 
     @Override

boat-scaffold/src/main/templates/boat-spring/api.mustache

@@ -187,7 +187,7 @@ public interface {{classname}} {
                 {{#examples}}
                     @ExampleObject(
                         name = "{{{exampleName}}}",
-                        value = "{{{exampleValue}}}"
+                        value = "{{#unwrapEscapedQuotes}}{{{exampleValue}}}{{/unwrapEscapedQuotes}}"
                     ){{^-last}},{{/-last}}
                 {{/examples}}
                 {{#-last}}

boat-scaffold/src/test/java/com/backbase/oss/codegen/java/BoatSpringCodeGenTests.java

@@ -6,6 +6,7 @@
 import static org.hamcrest.Matchers.is;
 import static org.hamcrest.Matchers.isA;
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
@@ -139,6 +140,45 @@ void multipartWithFileAndObject() throws IOException {
         assertThat(filesParam.getTypeAsString(), equalTo("List<MultipartFile>"));
     }
 
+    @Test
+    void shouldGenerateValidExampleObjectAnnotation() throws IOException {
+        var codegen = new BoatSpringCodeGen();
+        var input = new File("src/test/resources/openapi-with-examples/openapi-with-multiple-permissions.yaml");
+        codegen.setLibrary("spring-boot");
+        codegen.setInterfaceOnly(true);
+        codegen.setSkipDefaultInterface(true);
+        codegen.setOutputDir(TEST_OUTPUT + "/example-object");
+        codegen.setInputSpec(input.getAbsolutePath());
+        codegen.additionalProperties().put(SpringCodegen.USE_SPRING_BOOT3, Boolean.TRUE.toString());
+
+        var openApiInput = new OpenAPIParser().readLocation(input.getAbsolutePath(), null, new ParseOptions())
+                .getOpenAPI();
+        var clientOptInput = new ClientOptInput();
+        clientOptInput.config(codegen);
+        clientOptInput.openAPI(openApiInput);
+
+        List<File> files = new DefaultGenerator().opts(clientOptInput).generate();
+
+        File apiFile = files.stream()
+                .filter(file -> file.getName().endsWith("Api.java"))
+                .filter(file -> {
+                    try {
+                        return Files.readString(file.toPath()).contains("@ExampleObject(");
+                    } catch (IOException e) {
+                        throw new UnhandledException(e);
+                    }
+                })
+                .findFirst()
+                .orElseThrow();
+
+        String apiContent = Files.readString(apiFile.toPath());
+        assertTrue(apiContent.contains("@ExampleObject("));
+        assertTrue(apiContent.contains("Value Exceeded. Must be between {min} and {max}."));
+        assertTrue(apiContent.contains("Bad Request"));
+        assertFalse(apiContent.contains("value = \"\\\"{"));
+        StaticJavaParser.parse(apiFile);
+    }
+
     @Test
     void testReplaceBeanValidationCollectionType() {
         var codegen = new BoatSpringCodeGen();