@POST z odesłaniem uzupełnionego rekordu

PC32-RestSerwer/src/main/java/sklep/rest/RProducts.java

@@ -4,6 +4,7 @@ import java.math.BigDecimal;
 import java.util.List;
 
 import jakarta.ws.rs.Consumes;
+import jakarta.ws.rs.DELETE;
 import jakarta.ws.rs.GET;
 import jakarta.ws.rs.POST;
 import jakarta.ws.rs.PUT;
@@ -97,11 +98,38 @@ public class RProducts {
     // POST w tym miejscu jest lepszy niż PUT, bo zapisując nowy rekord, nie wiemy z góry jakie będzie będzie jego ID,
     // czyli nie wiemey, pod adresem zapisze się nowy produkt.
     // POST potrafi "dodać rekord do katalogu".
-    public void zapiszProdukt(Product product) throws DBException {
+    @POST
+    @Consumes("application/json")
+    @Produces("application/json")
+    public Product zapiszProdukt(Product product) throws DBException {
         try(DBConnection db = DBConnection.open()) {
             ProductDAO productDAO = db.productDAO();
             productDAO.save(product);
             db.commit();
+            return product;
+        }
+    }
+    
+    // PUT vs POST
+    // PUT powinniśmy używać wtedy, gdy z góry wiadomo, pod jakim adresem zostaną zapisane dane.
+    // W praktyce PUT używa się najczęściej do aktualizacji istniejących danych, ale teoretycznie PUT
+    // można też użyć do zapisania nowych danych pod konkretnym adresem.
+    // Gdy wyślemy dane za pomocą PUT pod adres, to następnie GET z tego samego adresu powinien odczytać dane, które wysłał PUT (być może w innym formacie).
+    
+    // POST używajmy wtedy, gdy nie wiemy z góry pod jakim adresem dane zostaną zapisane, np. gdy id rekordu jest generowane z sekwencji.
+    // Taka metoda powinna dać w odpowiedzi informację o ID utworzonego rekordu.
+    // Kilka możliwości:
+    // 1) (w tej klasie) - odesłanie uzupełnionego rekordu - trochę niewydajne, ale wygodne
+    // 2) minimalny dokumencik JSON, w którego wnętrzu jest zawarta ta informacja (tak robi wiele usług w praktyce, np. PayU)
+    // 3) (zobaczymy jeszcze) - odesłać odpowiedź typu Created z nagłówkiem Location - najlepsze z punktu widzenia standardów/dobrych praktyk
+
+    @DELETE
+    @Path("/{id}")
+    public void usun(@PathParam("id") int productId) throws DBException, RecordNotFound {
+        try(DBConnection db = DBConnection.open()) {
+            ProductDAO productDAO = db.productDAO();
+            productDAO.delete(productId);
+            db.commit();
         }
     }