From 1b3aa0828d632b74a767caa2f15df30e486a357b Mon Sep 17 00:00:00 2001 From: Radu Sebastian LAZIN Date: Wed, 11 Mar 2026 17:05:41 +0200 Subject: [PATCH 1/3] Release `v1.0.6`. --- pom.xml | 41 ++++++++++++++----- .../java/org/oogp/GeneratorException.java | 3 ++ src/main/java/org/oogp/OpenApiGenerator.java | 10 ++++- .../jakarta/OpenApiSpecJakartaGenerator.java | 6 ++- .../spring/OpenApiSpecSpringDocGenerator.java | 6 ++- .../controller/OffsetDateTimeController.java | 2 +- 6 files changed, 53 insertions(+), 15 deletions(-) diff --git a/pom.xml b/pom.xml index 02ed0f2..86916f0 100644 --- a/pom.xml +++ b/pom.xml @@ -11,13 +11,13 @@ org.springframework.boot spring-boot-starter-parent - 3.5.3 + 3.5.11 io.github.raduking openapi-offline-generator-plugin - 1.0.5 + 1.0.6 maven-plugin ${project.groupId}:${project.artifactId} @@ -57,18 +57,24 @@ 2.2.41 2.8.13 - 1.0.20 + 1.1.8 0.15.0 + + 2.0.17 + 1.5.32 + 3.27.7 + 3.2.8 0.9.0 3.15.2 - 2.46.1 - 3.42.0 - 4.36 + 3.3.0 + 3.44.0 + 4.38 + 1.0.0 @@ -145,6 +151,7 @@ org.slf4j slf4j-api + ${slf4j.api.version} @@ -165,6 +172,7 @@ ch.qos.logback logback-classic + ${logback.classic.version} test @@ -204,6 +212,12 @@ test + + org.assertj + assertj-core + ${assertj.version} + + org.springframework.boot spring-boot-starter-test @@ -369,15 +383,22 @@ org.eclipse.jdt.core ${org.eclipse.jdt.core.version} + + io.github.raduking + code-format + ${code.format.version} + - ${project.basedir}/formatter/java-formatter.xml + java-code-style.xml ${eclipse.formatter.version} - - + + + + @@ -480,7 +501,7 @@ org.jacoco jacoco-maven-plugin - ${jacoco.plugin.version} + ${jacoco.maven.plugin.version} diff --git a/src/main/java/org/oogp/GeneratorException.java b/src/main/java/org/oogp/GeneratorException.java index ea31908..fd6cd3a 100644 --- a/src/main/java/org/oogp/GeneratorException.java +++ b/src/main/java/org/oogp/GeneratorException.java @@ -1,5 +1,7 @@ package org.oogp; +import java.io.Serial; + /** * Exception class for generator-related errors. * @@ -10,6 +12,7 @@ public class GeneratorException extends RuntimeException { /** * Serial version UID. */ + @Serial private static final long serialVersionUID = -4336559629781875288L; /** diff --git a/src/main/java/org/oogp/OpenApiGenerator.java b/src/main/java/org/oogp/OpenApiGenerator.java index be20f58..19f8bdb 100644 --- a/src/main/java/org/oogp/OpenApiGenerator.java +++ b/src/main/java/org/oogp/OpenApiGenerator.java @@ -8,6 +8,8 @@ import org.morphix.reflection.Constructors; import org.oogp.jakarta.OpenApiSpecJakartaGenerator; import org.oogp.spring.OpenApiSpecSpringDocGenerator; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; /** * Main class for OpenAPI generation used in the CLI mode. @@ -16,11 +18,15 @@ */ public class OpenApiGenerator { + /** + * Logger instance. + */ + private static final Logger LOGGER = LoggerFactory.getLogger(OpenApiGenerator.class); + /** * Main method. * * @param args the command line arguments - * @throws Exception in case of errors */ static void main(final String[] args) { if (args.length != 1) { @@ -36,7 +42,7 @@ static void main(final String[] args) { generate(properties); } catch (Exception e) { - e.printStackTrace(); + LOGGER.error("Error while generating OpenAPI specification", e); System.exit(3); } } diff --git a/src/main/java/org/oogp/jakarta/OpenApiSpecJakartaGenerator.java b/src/main/java/org/oogp/jakarta/OpenApiSpecJakartaGenerator.java index 1e0dcb9..d16ef8f 100644 --- a/src/main/java/org/oogp/jakarta/OpenApiSpecJakartaGenerator.java +++ b/src/main/java/org/oogp/jakarta/OpenApiSpecJakartaGenerator.java @@ -134,7 +134,11 @@ public static void generate(final GeneratorProperties properties) throws IOExcep String outputFile = properties.getOutputFile(); File out = new File(outputFile); - out.getParentFile().mkdirs(); + boolean created = out.getParentFile().mkdirs(); + if (!created) { + // could not create directories, but maybe they already exist, log a warning just in case + LOGGER.warn("Could not create directories for output file: {}", out.getAbsolutePath()); + } ObjectMapper mapper = switch (outputFile) { case String s when s.endsWith(".json") -> Json.mapper(); diff --git a/src/main/java/org/oogp/spring/OpenApiSpecSpringDocGenerator.java b/src/main/java/org/oogp/spring/OpenApiSpecSpringDocGenerator.java index 72609bc..9204467 100644 --- a/src/main/java/org/oogp/spring/OpenApiSpecSpringDocGenerator.java +++ b/src/main/java/org/oogp/spring/OpenApiSpecSpringDocGenerator.java @@ -210,7 +210,11 @@ public static void generate(final GeneratorProperties properties) throws IOExcep addExtensions(openAPI, properties.getExtensions()); File out = new File(outputFile); - out.getParentFile().mkdirs(); + boolean created = out.getParentFile().mkdirs(); + if (!created) { + // could not create directories, but maybe they already exist, log a warning just in case + LOGGER.warn("Could not create directories for output file: {}", out.getAbsolutePath()); + } boolean isOpenapi31 = openApiResource.getSpringDocConfigProperties().isOpenapi31(); ObjectMapper mapper = switch (outputFile) { diff --git a/src/test/java/org/oogp/isolated/offsetdatetime/controller/OffsetDateTimeController.java b/src/test/java/org/oogp/isolated/offsetdatetime/controller/OffsetDateTimeController.java index b60f3ea..e03c304 100644 --- a/src/test/java/org/oogp/isolated/offsetdatetime/controller/OffsetDateTimeController.java +++ b/src/test/java/org/oogp/isolated/offsetdatetime/controller/OffsetDateTimeController.java @@ -17,7 +17,7 @@ public class OffsetDateTimeController implements OffsetDateTimeApi { private static final Logger LOGGER = LoggerFactory.getLogger(OffsetDateTimeController.class); - private ObjectMapper objectMapper = new ObjectMapper(); + private final ObjectMapper objectMapper = new ObjectMapper(); @Override public ResponseEntity getObjectWithOffsetDateTime(final OffsetDateTime dateTime) { From 1e6d99f6a7a456187ab75f3aff83c19327e75744 Mon Sep 17 00:00:00 2001 From: Radu Sebastian LAZIN Date: Thu, 12 Mar 2026 01:25:50 +0200 Subject: [PATCH 2/3] Removed managed versions. --- pom.xml | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/pom.xml b/pom.xml index 86916f0..e70bf84 100644 --- a/pom.xml +++ b/pom.xml @@ -60,10 +60,7 @@ 1.1.8 0.15.0 - - 2.0.17 - 1.5.32 - 3.27.7 + 3.2.8 @@ -151,7 +148,6 @@ org.slf4j slf4j-api - ${slf4j.api.version} @@ -172,7 +168,6 @@ ch.qos.logback logback-classic - ${logback.classic.version} test @@ -215,7 +210,6 @@ org.assertj assertj-core - ${assertj.version} From 7d1fbc0c69a5bfb9479b848f1e7e5b33027e51cb Mon Sep 17 00:00:00 2001 From: Radu Sebastian LAZIN Date: Thu, 12 Mar 2026 01:28:08 +0200 Subject: [PATCH 3/3] No need to specify `assertj-core` anymore. --- pom.xml | 5 ----- 1 file changed, 5 deletions(-) diff --git a/pom.xml b/pom.xml index e70bf84..baf4c1e 100644 --- a/pom.xml +++ b/pom.xml @@ -207,11 +207,6 @@ test - - org.assertj - assertj-core - - org.springframework.boot spring-boot-starter-test