[webclient] Annotate getValue with @JsonValue in enum Classes (#389)

Annotates the `getValue` method in generated `enum` classes with `@JsonValue`, when the `serializationLibrary` is set to `jackson` (_default_ for the `webclient`-library). This allows Jackson to serialize `enum` values using the `getValue` method. _MAY_ be a **BREAKING** change for `enum` classes where constant `value`s differ from their `name`.

Author: Chrimle

CITATION.cff

@@ -5,6 +5,6 @@ authors:
   given-names: "Christopher"
   orcid: "https://orcid.org/0009-0002-1005-3942"
 title: "OpenAPI to Java Records Mustache Templates"
-version: 2.8.1
+version: 2.8.2
 date-released: 2025-01-06
 url: "https://github.com/Chrimle/openapi-to-java-records-mustache-templates"

README.md

@@ -37,7 +37,7 @@ The mustache templates are best acquired by importing the project as a dependenc
 <dependency>
     <groupId>io.github.chrimle</groupId>
     <artifactId>openapi-to-java-records-mustache-templates</artifactId>
-    <version>2.8.1</version>
+    <version>2.8.2</version>
 </dependency>
 ```
 It is **strongly recommended** to import the project as a dependency. It has officially been published to:

docs/index.md

@@ -32,7 +32,7 @@ The mustache templates are best acquired by importing the project as a dependenc
 <dependency>
     <groupId>io.github.chrimle</groupId>
     <artifactId>openapi-to-java-records-mustache-templates</artifactId>
-    <version>2.8.1</version>
+    <version>2.8.2</version>
 </dependency>
 ```
 It is **strongly recommended** to import the project as a dependency. It has officially been published to:

mustache-templates/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>io.github.chrimle</groupId>
         <artifactId>openapi-to-java-records-mustache-templates-parent</artifactId>
-        <version>2.8.1</version>
+        <version>2.8.2</version>
     </parent>
 
     <artifactId>openapi-to-java-records-mustache-templates</artifactId>

mustache-templates/src/main/resources/templates/modelEnum.mustache

@@ -28,6 +28,7 @@
 
 }}{{!
 }}{{#jackson}}import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
 
 {{/jackson}}{{!
 }}{{#gson}}import java.io.IOException;
@@ -62,6 +63,8 @@ import com.google.gson.JsonElement;
    *
    * @return the value of this enum.
    */
+{{#jackson}}  @JsonValue
+{{/jackson}}
   public {{{dataType}}} getValue() {
     return value;
   }

mustache-templates/src/main/resources/templates/pojo.mustache

@@ -30,7 +30,9 @@
 
 }}{{!
     Imports needed for 'okhttp-gson'
-}}{{#jackson}}import com.fasterxml.jackson.annotation.JsonCreator;
+}}{{#jackson}}import com.fasterxml.jackson.annotation.JsonCreator;{{!
+}}{{#vars}}{{#isEnum}}{{#-first}}
+import com.fasterxml.jackson.annotation.JsonValue;{{/-first}}{{/isEnum}}{{/vars}}
 
 {{/jackson}}{{!
 }}{{#gson}}{{!
@@ -106,6 +108,8 @@ import java.util.Set;
      *
      * @return the value of this enum.
      */
+{{#jackson}}    @JsonValue
+{{/jackson}}
     public {{{dataType}}} getValue() {
       return value;
     }

mustache-templates/target/classes/templates/generateBuilders.mustache

@@ -15,7 +15,7 @@
 
 }}{{!
   Source: openapi-to-java-records-mustache-templates
-  Version: 2.8.1
+  Version: 2.8.2
   Type: Custom
   Dependencies:
     - none

mustache-templates/target/classes/templates/javadoc.mustache

@@ -15,7 +15,7 @@
 
 }}{{!
   Source: openapi-to-java-records-mustache-templates
-  Version: 2.8.1
+  Version: 2.8.2
   Type: Custom
   Dependencies:
     - none

mustache-templates/target/classes/templates/licenseInfo.mustache

@@ -15,7 +15,7 @@
 
 }}{{!
   Source: openapi-to-java-records-mustache-templates
-  Version: 2.8.1
+  Version: 2.8.2
   Type: Override
   Dependencies:
     - none
@@ -39,6 +39,6 @@
  * openapi-to-java-records-mustache-templates. For further information,
  * questions, requesting features or reporting issues, please visit:
  * https://github.com/Chrimle/openapi-to-java-records-mustache-templates.
- * Generated with Version: 2.8.1
+ * Generated with Version: 2.8.2
  *
  */

mustache-templates/target/classes/templates/modelEnum.mustache

@@ -15,7 +15,7 @@
 
 }}{{!
   Source: openapi-to-java-records-mustache-templates
-  Version: 2.8.1
+  Version: 2.8.2
   Type: Override
   Dependencies:
     - `additionalEnumTypeAnnotations.mustache` (Official)
@@ -28,6 +28,7 @@
 
 }}{{!
 }}{{#jackson}}import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
 
 {{/jackson}}{{!
 }}{{#gson}}import java.io.IOException;
@@ -62,6 +63,8 @@ import com.google.gson.JsonElement;
    *
    * @return the value of this enum.
    */
+{{#jackson}}  @JsonValue
+{{/jackson}}
   public {{{dataType}}} getValue() {
     return value;
   }