Klient pobierający String

PC34-RestKlient/src/main/java/sklep/klient_rest/P05_RestClient.java

@@ -10,6 +10,12 @@ import jakarta.ws.rs.client.Invocation;
 import jakarta.ws.rs.client.WebTarget;
 import jakarta.ws.rs.core.Response;
 
+// Ten i kolejne przykłady pokazują jak aplikacja kliencka napisana w Javie może wysyłać
+// zapytania do usługi REST-owej (głównie GET, jest też gdzieś POST)
+// korzystając z technologii JAX-RS "po stronie klienta".
+// Aby z tego skorzystać, do projektu trzeba dodać bibliotekę z implementacją JAX-RS.
+// Tutaj jest to resteasy-client.
+
 public class P05_RestClient {
 
 	public static void main(String[] args) {
@@ -22,12 +28,17 @@ public class P05_RestClient {
 		
 		System.out.println("Wysyłam zapytanie");
 		Response response = invocation.invoke();
+        // Wynikiem jest obiekt klasy Response - tej samej, co na serwerze (używaliśmy np. do generowania kodów 404).
+        // W obiekcie można sprawdzić informacji o odpowiedzi: media type, status code.
 		
 		System.out.println("Mam odpowiedź: " + response);
 		System.out.println("Status: " + response.getStatus());
 		System.out.println("C-Type: " + response.getMediaType());
 		System.out.println("Length: " + response.getLength());
 		
+        // Aby odczytać zawartość zwróconą przez serwer, używamy metody readEntity.
+        // (przy domyślnych ustawieniach) tę metodę można wywołać tylko raz.
+
 		byte[] dane = response.readEntity(byte[].class);
 		System.out.println("Dane mają " + dane.length + " bajtów.");
 		try {

PC34-RestKlient/src/main/java/sklep/klient_rest/P06_RestClient_String.java

+package sklep.klient_rest;
+
+import jakarta.ws.rs.client.Client;
+import jakarta.ws.rs.client.ClientBuilder;
+import jakarta.ws.rs.core.Response;
+
+public class P06_RestClient_String {
+
+	public static void main(String[] args) {
+		Client client = ClientBuilder.newClient();
+		
+		// Taki styl programowania to "fluent API"
+		Response response = client.target(Ustawienia.ADRES_USLUGI)
+			.path("products.json")
+			.request().buildGet()
+			.invoke();
+		
+		System.out.println("Mam odpowiedź: " + response);
+		System.out.println("Status: " + response.getStatus());
+		System.out.println("C-Type: " + response.getMediaType());
+		System.out.println("Length: " + response.getLength());
+		
+		// readEntity(OKREŚLENIE TYPU) stara się odczytać tresc odpowiedzi jako obiekt podanego typu
+		// Obsługiwane typy to m.in: byte[], String, InputStream, File
+		// Dodając odpowiednie "MeassgeBodyReader", możemy obsługiwać dowolne typy.
+		// W szczególności, gdy dodamy do projektu obsługę XML lub JSON (zob. zależności Mavena),
+		// będziemy mogli odczytywać dane w postaci obiektów naszego modelu, np. Product.
+		String dane = response.readEntity(String.class);
+		System.out.println("Otrzymane dane:");
+		System.out.println(dane);
+		
+	}
+
+}