✨ feat: Creature Recruitment | add REST API endpoints (#4)

Author: MateuszNaKodach

generated-requests.http

@@ -0,0 +1,36 @@
+### BuildDwelling
+@dwellingId = dwelling-1
+PUT http://localhost:8080/dwellings/{{dwellingId}}
+Content-Type: application/json
+
+{
+  "creatureId": "angel",
+  "costPerTroop": {
+    "gold": 3000,
+    "gems": 1
+  }
+}
+
+### IncreaseAvailableCreatures
+PUT http://localhost:8080/dwellings/{{dwellingId}}/available-creatures-increases
+Content-Type: application/json
+
+{
+  "creatureId": "angel",
+  "increaseBy": 1
+}
+
+### RecruitCreature
+PUT http://localhost:8080/dwellings/{{dwellingId}}/creature-recruitments
+Content-Type: application/json
+
+{
+  "creatureId": "angel",
+  "armyId": "army-1",
+  "quantity": 3
+}
+
+### Dwelling read model
+GET http://localhost:8080/dwellings/{{dwellingId}}
+Content-Type: application/json
+

src/main/java/com/dddheroes/heroesofddd/creaturerecruitment/read/getdwellingbyid/GetDwellingByIdRestApi.java

@@ -0,0 +1,31 @@
+package com.dddheroes.heroesofddd.creaturerecruitment.read.getdwellingbyid;
+
+import com.dddheroes.heroesofddd.creaturerecruitment.read.DwellingReadModel;
+import org.axonframework.queryhandling.QueryGateway;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.concurrent.CompletableFuture;
+
+@RestController
+class GetDwellingByIdRestApi {
+
+    private final QueryGateway queryGateway;
+
+    GetDwellingByIdRestApi(QueryGateway queryGateway) {
+        this.queryGateway = queryGateway;
+    }
+
+    @GetMapping("/dwellings/{dwellingId}")
+    CompletableFuture<DwellingReadModel> getDwellings(
+            @PathVariable String dwellingId
+    ) {
+        var query = GetDwellingById.query(dwellingId);
+
+        return queryGateway.query(
+                query,
+                DwellingReadModel.class
+        );
+    }
+}

src/main/java/com/dddheroes/heroesofddd/creaturerecruitment/write/builddwelling/BuildDwellingRestApi.java

@@ -0,0 +1,37 @@
+package com.dddheroes.heroesofddd.creaturerecruitment.write.builddwelling;
+
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+import java.util.concurrent.CompletableFuture;
+
+@RestController
+class BuildDwellingRestApi {
+
+    record Body(String creatureId, Map<String, Integer> costPerTroop) {
+
+    }
+
+    private final CommandGateway commandGateway;
+
+    BuildDwellingRestApi(CommandGateway commandGateway) {
+        this.commandGateway = commandGateway;
+    }
+
+    @PutMapping("/dwellings/{dwellingId}")
+    CompletableFuture<Void> putDwellings(
+            @PathVariable String dwellingId,
+            @RequestBody Body requestBody
+    ) {
+        var command = BuildDwelling.command(
+                dwellingId,
+                requestBody.creatureId(),
+                requestBody.costPerTroop()
+        );
+        return commandGateway.send(command);
+    }
+}

src/main/java/com/dddheroes/heroesofddd/creaturerecruitment/write/changeavailablecreatures/IncreaseAvailableCreaturesRestApi.java

@@ -0,0 +1,38 @@
+package com.dddheroes.heroesofddd.creaturerecruitment.write.changeavailablecreatures;
+
+import com.dddheroes.heroesofddd.creaturerecruitment.write.builddwelling.BuildDwelling;
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+import java.util.concurrent.CompletableFuture;
+
+@RestController
+class IncreaseAvailableCreaturesRestApi {
+
+    record Body(String creatureId, Integer increaseBy) {
+
+    }
+
+    private final CommandGateway commandGateway;
+
+    IncreaseAvailableCreaturesRestApi(CommandGateway commandGateway) {
+        this.commandGateway = commandGateway;
+    }
+
+    @PutMapping("/dwellings/{dwellingId}/available-creatures-increases")
+    CompletableFuture<Void> putDwellingAvailableCreaturesIncreases(
+            @PathVariable String dwellingId,
+            @RequestBody Body requestBody
+    ) {
+        var command = IncreaseAvailableCreatures.command(
+                dwellingId,
+                requestBody.creatureId(),
+                requestBody.increaseBy()
+        );
+        return commandGateway.send(command);
+    }
+}

src/main/java/com/dddheroes/heroesofddd/creaturerecruitment/write/recruitcreature/RecruitCreatureRestApi.java

@@ -0,0 +1,37 @@
+package com.dddheroes.heroesofddd.creaturerecruitment.write.recruitcreature;
+
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.concurrent.CompletableFuture;
+
+@RestController
+class RecruitCreatureRestApi {
+
+    record Body(String creatureId, String armyId, Integer quantity) {
+
+    }
+
+    private final CommandGateway commandGateway;
+
+    RecruitCreatureRestApi(CommandGateway commandGateway) {
+        this.commandGateway = commandGateway;
+    }
+
+    @PutMapping("/dwellings/{dwellingId}/creature-recruitments")
+    CompletableFuture<Void> putDwellingsCreatureRecruitments(
+            @PathVariable String dwellingId,
+            @RequestBody Body requestBody
+    ) {
+        var command = RecruitCreature.command(
+                dwellingId,
+                requestBody.creatureId(),
+                requestBody.armyId(),
+                requestBody.quantity()
+        );
+        return commandGateway.send(command);
+    }
+}

src/main/java/com/dddheroes/heroesofddd/shared/Cost.java

@@ -71,9 +71,14 @@ public Map<String, Integer> raw() {
     public static Cost fromRaw(Map<String, Integer> raw) {
         Map<ResourceType, Amount> resources = raw.entrySet().stream()
                                                  .collect(Collectors.toMap(
-                                                         entry -> ResourceType.valueOf(entry.getKey()),
+                                                         entry -> ResourceType.from(entry.getKey()),
                                                          entry -> new Amount(entry.getValue())
                                                  ));
         return new Cost(resources);
     }
+
+    // required by Jackson
+    public Map<ResourceType, Amount> getResources() {
+        return new HashMap<>(resources);
+    }
 }

src/test/java/com/dddheroes/heroesofddd/creaturerecruitment/write/DwellingTest.java

@@ -15,7 +15,7 @@ public class DwellingTest {
     protected final CreatureId angelId = CreatureId.of("angel");
     protected final Cost costPerTroop = Cost
             .resources(ResourceType.GOLD, Amount.of(3000))
-            .plus(ResourceType.CRYSTAL, Amount.of(1));
+            .plus(ResourceType.GEMS, Amount.of(1));
 
     protected AggregateTestFixture<?> fixture;