fix: retorna localização ao criar ordem

README.md

@@ -22,7 +22,7 @@ No Windows, confirme que o Java está disponível no `PATH` e execute
 
 | Método | Rota | Descrição |
 | --- | --- | --- |
-| `POST` | `/ordens` | Cria uma ordem de serviço |
+| `POST` | `/ordens` | Cria uma ordem e retorna `201 Created` com o cabeçalho `Location` |
 | `GET` | `/ordens?page=0&size=20&sort=cliente,asc` | Lista as ordens com paginação e ordenação |
 | `GET` | `/ordens?cliente=nome&page=0&size=20` | Filtra ordens pelo cliente e mantém a paginação |
 | `GET` | `/ordens/{id}` | Consulta uma ordem pelo ID |

src/main/java/com/exemplo/ordem_servico/controller/OrdemServicoController.java

@@ -1,6 +1,9 @@
 package com.exemplo.ordem_servico.controller;
 
+import java.net.URI;
+
 import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.web.PageableDefault;
@@ -33,8 +36,11 @@ public OrdemServicoController(OrdemServicoService service) {
     }
 
     @PostMapping
-    public OrdemServico criar(@Valid @RequestBody OrdemServico ordem) {
-        return service.criar(ordem);
+    public ResponseEntity<OrdemServico> criar(
+            @Valid @RequestBody OrdemServico ordem) {
+        OrdemServico criada = service.criar(ordem);
+        URI localizacao = URI.create("/ordens/" + criada.getId());
+        return ResponseEntity.created(localizacao).body(criada);
     }
 
     @GetMapping

src/test/java/com/exemplo/ordem_servico/controller/OrdemServicoControllerTests.java

@@ -0,0 +1,42 @@
+package com.exemplo.ordem_servico.controller;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertSame;
+import static org.mockito.Mockito.when;
+
+import java.net.URI;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+
+import com.exemplo.ordem_servico.model.OrdemServico;
+import com.exemplo.ordem_servico.service.OrdemServicoService;
+
+@ExtendWith(MockitoExtension.class)
+class OrdemServicoControllerTests {
+
+    @Mock
+    private OrdemServicoService service;
+
+    @InjectMocks
+    private OrdemServicoController controller;
+
+    @Test
+    void deveRetornarCreatedComLocalizacaoDaNovaOrdem() {
+        OrdemServico entrada = new OrdemServico();
+        OrdemServico criada = new OrdemServico();
+        criada.setId(7L);
+        when(service.criar(entrada)).thenReturn(criada);
+
+        ResponseEntity<OrdemServico> resposta = controller.criar(entrada);
+
+        assertEquals(HttpStatus.CREATED, resposta.getStatusCode());
+        assertEquals(URI.create("/ordens/7"), resposta.getHeaders().getLocation());
+        assertSame(criada, resposta.getBody());
+    }
+}