Add support for ai-generated photos (#55)

* add support for ai-generated photos

* add tests and example

* fix intendation

* fix intendation

Author: tsolakoua

README.md

@@ -350,6 +350,10 @@ SeatMap[] seatmap = amadeus.shopping.seatMaps.get(Params
 // What is the the seat map of a given flight?
 // The body can be a String version of your JSON or a JsonObject
 SeatMap[] seatmap = amadeus.shopping.seatMaps.post(body);
+
+// AI-Generated Photos
+GeneratedPhoto photo = amadeus.media.files.generatedPhotos.get(Params
+    .with("category", "BEACH"));
 ```
 
 ## Development & Contributing

src/main/java/com/amadeus/Amadeus.java

@@ -69,6 +69,13 @@ public class Amadeus extends HTTPClient {
    */
   public Booking booking;
 
+  /**
+   * <p>
+   * A namespaced client for the <code>/v2/media</code> endpoints.
+   * </p>
+   */
+  public Media media;
+
   protected Amadeus(Configuration configuration) {
     super(configuration);
     this.referenceData = new ReferenceData(this);
@@ -77,6 +84,8 @@ protected Amadeus(Configuration configuration) {
     this.ereputation = new EReputation(this);
     this.airport = new Airport(this);
     this.booking = new Booking(this);
+    this.media = new Media(this);
+
   }
 
   /**

src/main/java/com/amadeus/Media.java

@@ -0,0 +1,37 @@
+package com.amadeus;
+
+import com.amadeus.media.Files;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v2/media</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.media;</pre>
+ *
+ * @hide
+ */
+public class Media {
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v2/media/files</code> endpoints.
+   * </p>
+   */
+  public Files files;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public Media(Amadeus client) {
+    this.files = new Files(client);
+  }
+}

src/main/java/com/amadeus/media/Files.java

@@ -0,0 +1,39 @@
+package com.amadeus.media;
+
+import com.amadeus.Amadeus;
+import com.amadeus.media.files.GeneratedPhotos;
+
+/**
+ * <p>
+ * A namespaced client for the
+ * <code>/v2/media/files</code> endpoints.
+ * </p>
+ *
+ * <p>
+ * Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.media.files;</pre>
+ *
+ * @hide
+ */
+public class Files {
+  /**
+   * <p>
+   * A namespaced client for the
+   * <code>/v2/media/files/generated-photos</code> endpoints.
+   * </p>
+   */
+  public GeneratedPhotos generatedPhotos;
+
+  /**
+   * Constructor.
+   *
+   * @hide
+   */
+  public Files(Amadeus client) {
+    this.generatedPhotos = new GeneratedPhotos(client);
+  }
+}

src/main/java/com/amadeus/media/files/GeneratedPhotos.java

@@ -0,0 +1,60 @@
+package com.amadeus.media.files;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+import com.amadeus.resources.GeneratedPhoto;
+import com.amadeus.resources.Resource;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v2/media/files/generated-photos</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.media.files.generatedPhotos;</pre>
+ */
+public class GeneratedPhotos {
+  private Amadeus client;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public GeneratedPhotos(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   Returns a link to download a rendered image of a landscape.
+   * </p>
+   *
+   * <pre>
+   * amadeus.media.files.generatedPhotos.get(Params
+   *   .with("category", "BEACH"));</pre>
+   *
+   * @param params the parameters to send to the API
+   * @return an API response object
+   * @throws ResponseException when an exception occurs
+   */
+  public GeneratedPhoto get(Params params) throws ResponseException {
+    Response response = client.get("/v2/media/files/generated-photos", params);
+    return (GeneratedPhoto) Resource.fromObject(response, GeneratedPhoto.class);
+  }
+
+  /**
+   * Convenience method for calling <code>get</code> without any parameters.
+   * @see GeneratedPhotos#get()
+   */
+  public GeneratedPhoto get() throws ResponseException {
+    return get(null);
+  }
+}

src/main/java/com/amadeus/resources/GeneratedPhoto.java

@@ -0,0 +1,45 @@
+package com.amadeus.resources;
+
+import lombok.Getter;
+import lombok.ToString;
+
+/**
+ * An GeneratedPhoto object as returned by the AI-Generated Photos API.
+ * @see Traveled#get()
+ */
+@ToString
+public class GeneratedPhoto extends Resource {
+  protected GeneratedPhoto() {}
+
+  private @Getter String type;
+  private @Getter String owner;
+  private @Getter String attachmentUri;
+  private @Getter String description;
+  private @Getter String fileKbSize;
+  private @Getter String expirationDateTime;
+  private @Getter MediaMetadata mediaMetadata;
+
+  /**
+   * A MediaMetadata-related object as returned by the AI-Generated Photos API.
+   * @see GeneratedPhotos#get()
+   */
+  @ToString
+  public class MediaMetadata {
+    protected MediaMetadata() {}
+
+    private @Getter Dimension dimensions;
+
+    /**
+     * A MediaMetadata-related object as returned by the AI-Generated Photos API.
+     * @see GeneratedPhotos#get()
+     */
+    @ToString
+    public class Dimension {
+      protected Dimension() {}
+
+      private @Getter String height;
+      private @Getter String width;
+
+    }
+  }
+}

src/main/java/com/amadeus/resources/PointOfInterest.java

@@ -4,7 +4,7 @@
 import lombok.ToString;
 
 /**
- * An PointOfInterest object as returned by the Locaion API.
+ * An PointOfInterest object as returned by the Location API.
  * @see com.amadeus.referenceData.locations.PointOfInterest#get()
  */
 @ToString

src/main/java/examples/media/AIGeneratedPhotos.java

@@ -0,0 +1,34 @@
+package examples.media.files;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.exceptions.ResponseException;
+import com.amadeus.resources.GeneratedPhoto;
+
+public class AIGeneratedPhotos {
+  /**
+   * <p>
+   *   An example to call the AI-Generated Photos API
+   *   <code>/v2/media/files/generated-photos</code> endpoints.
+   * </p>
+   *
+   * <p>
+   *   Access via the Amadeus client object.
+   * </p>
+   *
+   * <pre>
+   * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+   * amadeus.media.files.generatedPhotos;</pre>
+   */
+  public static void main(String[] args) throws ResponseException {
+
+
+    Amadeus amadeus = Amadeus
+        .builder("YOUR_API_ID","YOUR_API_SECRET")
+        .build();
+
+    GeneratedPhoto photo = amadeus.media.files.generatedPhotos.get(Params
+        .with("category", "BEACH"));
+    System.out.println(photo);
+  }
+}

src/test/java/com/amadeus/NamespaceTest.java

@@ -5,6 +5,7 @@
 import com.amadeus.booking.FlightOrders;
 import com.amadeus.ereputation.HotelSentiments;
 import com.amadeus.exceptions.ResponseException;
+import com.amadeus.media.files.GeneratedPhotos;
 import com.amadeus.referenceData.Airlines;
 import com.amadeus.referenceData.Location;
 import com.amadeus.referenceData.Locations;
@@ -64,6 +65,7 @@ public void testAllNamespacesExist() {
     TestCase.assertNotNull(client.shopping.hotelOffer("XXX"));
     TestCase.assertNotNull(client.airport.predictions.onTime);
     TestCase.assertNotNull(client.booking.flightOrder("XXX"));
+    TestCase.assertNotNull(client.media.files.generatedPhotos);
   }
 
   @Before
@@ -298,6 +300,15 @@ public void testGetMethods() throws ResponseException {
     FlightOrder flightOrder = new FlightOrder(client, "XXX");
     TestCase.assertNotNull(flightOrder.get());
     TestCase.assertNotNull(flightOrder.get(params));
+
+    // Testing AI-generated photos
+    Mockito.when(client.get("/v2/media/files/generated-photos", null))
+        .thenReturn(singleResponse);
+    Mockito.when(client.get("/v2/media/files/generated-photos", params))
+        .thenReturn(singleResponse);
+    GeneratedPhotos photo = new GeneratedPhotos(client);
+    TestCase.assertNotNull(photo.get());
+    TestCase.assertNotNull(photo.get(params));
   }
 
   @Test