eva4j 1.0.13 → 1.0.15

package/templates/crud/ScaffoldQueryHandler.java.ejs

@@ -0,0 +1,41 @@
+package <%= packageName %>.<%= moduleName %>.application.usecases;
+
+import <%= packageName %>.<%= moduleName %>.application.dtos.<%= aggregateName %>ResponseDto;
+import <%= packageName %>.<%= moduleName %>.application.queries.<%= useCaseName %>Query;
+import <%= packageName %>.<%= moduleName %>.domain.repositories.<%= aggregateName %>Repository;
+import <%= packageName %>.shared.domain.annotations.ApplicationComponent;
+import <%= packageName %>.shared.domain.interfaces.QueryHandler;
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * <%= useCaseName %>QueryHandler
+ * TODO: Implement the query logic for "<%= useCaseName %>".
+ *
+ * Suggested steps:
+ *   1. Read parameters from the query record
+ *   2. Retrieve data from the repository
+ *   3. Map the result to a DTO and return it
+ */
+@Slf4j
+@ApplicationComponent
+public class <%= useCaseName %>QueryHandler implements QueryHandler<<%= useCaseName %>Query, <%= aggregateName %>ResponseDto> {
+
+    private final <%= aggregateName %>Repository repository;
+
+    public <%= useCaseName %>QueryHandler(<%= aggregateName %>Repository repository) {
+        this.repository = repository;
+    }
+
+    @Override
+    public <%= aggregateName %>ResponseDto handle(<%= useCaseName %>Query query) {
+        log.info("Handling <%= useCaseName %>Query: {}", query);
+
+        // TODO: Implement query logic
+        // Example:
+        // return repository.findById(query.id())
+        //         .map(mapper::toDto)
+        //         .orElseThrow(() -> new EntityNotFoundException("<%= aggregateName %> not found"));
+
+        throw new UnsupportedOperationException("<%= useCaseName %> not yet implemented");
+    }
+}

package/templates/crud/SubEntityAddCommand.java.ejs

@@ -0,0 +1,21 @@
+package <%= packageName %>.<%= moduleName %>.application.commands;
+
+<% (imports || []).forEach(imp => { %>
+<%- imp %>
+<% }); %>
+import <%= packageName %>.shared.domain.interfaces.Command;
+import io.swagger.v3.oas.annotations.media.Schema;
+
+/**
+ * <%= useCaseName %>Command
+ * Adds a new <%= entityName %> to the <%= aggregateName %> aggregate.
+ */
+public record <%= useCaseName %>Command(
+        <%- idType %> id<% if (entityFields && entityFields.length > 0) { %>,<% } %>
+<% (entityFields || []).forEach(function(field, idx) { %>
+<% if (field.schemaExample) { %>
+        @Schema(example = "<%= field.schemaExample %>")
+<% } %>
+        <%- field.javaType %> <%= field.name %><% if (idx < entityFields.length - 1) { %>,<% } %>
+<% }); %>
+) implements Command {}

package/templates/crud/SubEntityAddCommandHandler.java.ejs

@@ -0,0 +1,43 @@
+package <%= packageName %>.<%= moduleName %>.application.usecases;
+
+import <%= packageName %>.<%= moduleName %>.application.commands.<%= useCaseName %>Command;
+import <%= packageName %>.<%= moduleName %>.domain.models.entities.<%= aggregateName %>;
+import <%= packageName %>.<%= moduleName %>.domain.models.entities.<%= entityName %>;
+import <%= packageName %>.<%= moduleName %>.domain.repositories.<%= aggregateName %>Repository;
+import <%= packageName %>.shared.domain.annotations.ApplicationComponent;
+import <%= packageName %>.shared.domain.customExceptions.NotFoundException;
+import <%= packageName %>.shared.domain.interfaces.CommandHandler;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * <%= useCaseName %>CommandHandler
+ * Loads the <%= aggregateName %> aggregate and adds a new <%= entityName %> to it.
+ *
+ * The aggregate root must expose: <%= addMethodName %>(<%= entityName %> item)
+ */
+@Slf4j
+@ApplicationComponent
+public class <%= useCaseName %>CommandHandler implements CommandHandler<<%= useCaseName %>Command> {
+
+    private final <%= aggregateName %>Repository repository;
+
+    public <%= useCaseName %>CommandHandler(<%= aggregateName %>Repository repository) {
+        this.repository = repository;
+    }
+
+    @Override
+    @Transactional
+    public void handle(<%= useCaseName %>Command command) {
+        log.info("Handling <%= useCaseName %>Command for <%= aggregateName %> id: {}", command.id());
+
+        <%= aggregateName %> entity = repository.findById(command.id())
+                .orElseThrow(() -> new NotFoundException("<%= aggregateName %> not found with id: " + command.id()));
+
+        <%= entityName %> item = new <%= entityName %>(<% (entityFields || []).forEach(function(field, idx) { %>command.<%= field.name %>()<% if (idx < entityFields.length - 1) { %>, <% } %><% }); %>);
+        entity.<%= addMethodName %>(item);
+        repository.save(entity);
+
+        log.info("<%= entityName %> added to <%= aggregateName %> id: {}", command.id());
+    }
+}

package/templates/crud/SubEntityRemoveCommand.java.ejs

@@ -0,0 +1,9 @@
+package <%= packageName %>.<%= moduleName %>.application.commands;
+
+import <%= packageName %>.shared.domain.interfaces.Command;
+
+/**
+ * <%= useCaseName %>Command
+ * Removes the <%= entityName %> identified by itemId from the <%= aggregateName %> aggregate.
+ */
+public record <%= useCaseName %>Command(<%- idType %> id, String itemId) implements Command {}

package/templates/crud/SubEntityRemoveCommandHandler.java.ejs

@@ -0,0 +1,42 @@
+package <%= packageName %>.<%= moduleName %>.application.usecases;
+
+import <%= packageName %>.<%= moduleName %>.application.commands.<%= useCaseName %>Command;
+import <%= packageName %>.<%= moduleName %>.domain.models.entities.<%= aggregateName %>;
+import <%= packageName %>.<%= moduleName %>.domain.repositories.<%= aggregateName %>Repository;
+import <%= packageName %>.shared.domain.annotations.ApplicationComponent;
+import <%= packageName %>.shared.domain.customExceptions.NotFoundException;
+import <%= packageName %>.shared.domain.interfaces.CommandHandler;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * <%= useCaseName %>CommandHandler
+ * Loads the <%= aggregateName %> aggregate and removes the <%= entityName %> by itemId.
+ *
+ * The aggregate root must expose: <%= removeMethodName %>(String itemId)
+ */
+@Slf4j
+@ApplicationComponent
+public class <%= useCaseName %>CommandHandler implements CommandHandler<<%= useCaseName %>Command> {
+
+    private final <%= aggregateName %>Repository repository;
+
+    public <%= useCaseName %>CommandHandler(<%= aggregateName %>Repository repository) {
+        this.repository = repository;
+    }
+
+    @Override
+    @Transactional
+    public void handle(<%= useCaseName %>Command command) {
+        log.info("Handling <%= useCaseName %>Command for <%= aggregateName %> id: {}, itemId: {}",
+                command.id(), command.itemId());
+
+        <%= aggregateName %> entity = repository.findById(command.id())
+                .orElseThrow(() -> new NotFoundException("<%= aggregateName %> not found with id: " + command.id()));
+
+        entity.<%= removeMethodName %>(command.itemId());
+        repository.save(entity);
+
+        log.info("<%= entityName %> id: {} removed from <%= aggregateName %> id: {}", command.itemId(), command.id());
+    }
+}

package/templates/crud/TransitionCommand.java.ejs

@@ -0,0 +1,9 @@
+package <%= packageName %>.<%= moduleName %>.application.commands;
+
+import <%= packageName %>.shared.domain.interfaces.Command;
+
+/**
+ * <%= useCaseName %>Command
+ * Triggers the '<%= domainMethod %>' state transition on the <%= aggregateName %> aggregate.
+ */
+public record <%= useCaseName %>Command(<%- idType %> id) implements Command {}

package/templates/crud/TransitionCommandHandler.java.ejs

@@ -0,0 +1,39 @@
+package <%= packageName %>.<%= moduleName %>.application.usecases;
+
+import <%= packageName %>.<%= moduleName %>.application.commands.<%= useCaseName %>Command;
+import <%= packageName %>.<%= moduleName %>.domain.models.entities.<%= aggregateName %>;
+import <%= packageName %>.<%= moduleName %>.domain.repositories.<%= aggregateName %>Repository;
+import <%= packageName %>.shared.domain.annotations.ApplicationComponent;
+import <%= packageName %>.shared.domain.customExceptions.NotFoundException;
+import <%= packageName %>.shared.domain.interfaces.CommandHandler;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * <%= useCaseName %>CommandHandler
+ * Loads the <%= aggregateName %> aggregate and calls entity.<%= domainMethod %>() to execute the transition.
+ */
+@Slf4j
+@ApplicationComponent
+public class <%= useCaseName %>CommandHandler implements CommandHandler<<%= useCaseName %>Command> {
+
+    private final <%= aggregateName %>Repository repository;
+
+    public <%= useCaseName %>CommandHandler(<%= aggregateName %>Repository repository) {
+        this.repository = repository;
+    }
+
+    @Override
+    @Transactional
+    public void handle(<%= useCaseName %>Command command) {
+        log.info("Handling <%= useCaseName %>Command for id: {}", command.id());
+
+        <%= aggregateName %> entity = repository.findById(command.id())
+                .orElseThrow(() -> new NotFoundException("<%= aggregateName %> not found with id: " + command.id()));
+
+        entity.<%= domainMethod %>();
+        repository.save(entity);
+
+        log.info("<%= aggregateName %> id: {} transitioned via <%= domainMethod %>()", command.id());
+    }
+}

package/templates/crud/UpdateCommand.java.ejs

@@ -1,6 +1,7 @@
 package <%= packageName %>.<%= moduleName %>.application.commands;
 
 import <%= packageName %>.shared.domain.interfaces.Command;
+import io.swagger.v3.oas.annotations.media.Schema;
 <% if (hasValueObjects) { %>
 import <%= packageName %>.<%= moduleName %>.domain.models.valueObjects.*;
 <% } %>
@@ -34,6 +35,9 @@ import <%= packageName %>.<%= moduleName %>.application.dtos.Create<%= rel.targe
 public record Update<%= aggregateName %>Command(
     <%- idType %> id<% if (commandFields && commandFields.length > 0) { %>,<% } %>
 <% commandFields.forEach((field, idx) => { %>
+<% if (field.schemaExample) { %>
+    @Schema(example = "<%= field.schemaExample %>")
+<% } %>
     <%- field.javaType %> <%= field.name %><% if (idx < commandFields.length - 1 || (oneToManyRelationships && oneToManyRelationships.length > 0) || (oneToOneRelationships && oneToOneRelationships.length > 0)) { %>,<% } %>
 <% }); %>
 <% if (oneToManyRelationships && oneToManyRelationships.length > 0) { %>