PUT i POST

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

 package sklep.rest;
 
+import java.math.BigDecimal;
 import java.util.List;
 
+import jakarta.ws.rs.Consumes;
 import jakarta.ws.rs.GET;
+import jakarta.ws.rs.POST;
+import jakarta.ws.rs.PUT;
 import jakarta.ws.rs.Path;
 import jakarta.ws.rs.PathParam;
 import jakarta.ws.rs.Produces;
@@ -12,6 +16,18 @@ import sklep.db.ProductDAO;
 import sklep.db.RecordNotFound;
 import sklep.model.Product;
 
+/* W usługach REST struktura adresów URL odpowiada logicznej strukturze danych.
+ * Typowe jest, że * pod adresem "katalogu", np. /products , dostępna jest lista wszystkich rekordów
+ * (lub ogólne informacje, lub jakiś sposób przeglądania - gdyby było ich za dużo do zwrócenia na raz)
+ * a idąc dalej wgłąb ścieżki przechodzimy do "pojedynczych rekordów", np. /products/2
+ * 
+ * W tej klasie wejdziemynawet do wnętrza produktów i udostępnimy osobno cenę
+ * /products/2/price
+ * W praktyce nie robi się tego zbyt często, ale tu zobaczymy jako przykład możliwości.
+ * 
+ * To od programisty (twórcy usługi) zależy jakie adresy i jakie operacje pod tymi adresami udostępnia.
+ */
+
 @Path("/products")
 public class RProducts {
 
@@ -34,4 +50,56 @@ public class RProducts {
 		}
 	}
 	
+	@GET
+	@Path("/{id}/price")
+	@Produces("application/json")
+	public BigDecimal getPrice(@PathParam("id") int productId) throws DBException, RecordNotFound {
+		try(DBConnection db = DBConnection.open()) {
+			ProductDAO productDAO = db.productDAO();
+			return productDAO.findById(productId).getPrice();
+		}
+	}
+	
+	// W zapytaniach typu PUT i POST klient wysyła dane na serwer (treść zapytania: "body" / "entity" / "content" ...)
+	// W JAX-RS metoda może posiadać tylko jeden parametr bez adnotacji i to właśnie przez ten parametr przekazywana jest treść zapytania
+	// (te dane, które przysłał klient). Format tych danych opisuje adnotacja @Consumes
+	@PUT
+	@Path("/{id}/price")
+	@Consumes("application/json")
+	public void setPrice(@PathParam("id") int productId, BigDecimal newPrice) throws DBException, RecordNotFound {
+		try(DBConnection db = DBConnection.open()) {
+			ProductDAO productDAO = db.productDAO();
+			Product product = productDAO.findById(productId);
+			product.setPrice(newPrice);
+			productDAO.save(product);
+			db.commit();
+		}
+	}
+	
+	// W praktyce REST metoda POST jest używana do dodawania nowych rekordów do katalogu.
+	// Może być także używana w innych celach - gdy klient ma "przysłać dane na serwer", a serwer coś z tym zrobi (podobnie jak to było w SOAP).
+	
+	@POST
+	@Consumes("application/json")
+	public void zapiszProdukt(Product product) throws DBException {
+		try(DBConnection db = DBConnection.open()) {
+			ProductDAO productDAO = db.productDAO();
+			productDAO.save(product);
+			db.commit();
+		}
+	}
+	
+	// PUT vs POST
+	// PUT powinnismy używać wtedy, gdy z góry wiadomo, pod jakim adresem zostaną zapisane dane.
+	// W praktyce PUT uzywa 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ć dnae, 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.
 }
+
+
+
+
+
+