Introduce hotel ratings Api Support (#34)

#29 Add support for Hotel Ratings API

Author: spirosbatzio

README.md

@@ -307,6 +307,8 @@ HotelOffer[] offers = amadeus.shopping.hotelOffers.get(Params
 HotelOffer hotelOffer = amadeus.shopping.hotelOffersByHotel.get(Params.with("hotelId", "BGLONBGB"));
 // Confirm the availability of a specific offer
 HotelOffer offer = amadeus.shopping.hotelOffer("4BA070CE929E135B3268A9F2D0C51E9D4A6CF318BA10485322FA2C7E78C7852E").get();
+// Hotel Ratings / Sentiments
+HotelSentiment[] hotelSentiments = amadeus.ereputation.hotelSentiments.get(Params.with("hotelIds", "ELONMFS,ADNYCCTB"));
 
 // Points of Interest
 // What are the popular places in Barcelona (based a geo location and a radius)

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

@@ -48,11 +48,19 @@ public class Amadeus extends HTTPClient {
    */
   public Shopping shopping;
 
+  /**
+   * <p>
+   * A namespaced client for the <code>/v2/e-reputation</code> endpoints.
+   * </p>
+   */
+  public EReputation ereputation;
+
   protected Amadeus(Configuration configuration) {
     super(configuration);
     this.referenceData = new ReferenceData(this);
     this.travel = new Travel(this);
     this.shopping = new Shopping(this);
+    this.ereputation = new EReputation(this);
   }
 
   /**

src/main/java/com/amadeus/EReputation.java

@@ -0,0 +1,20 @@
+package com.amadeus;
+
+import com.amadeus.ereputation.HotelSentiments;
+
+public class EReputation {
+  private Amadeus client;
+
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v2/e-reputation/hotel-sentiments</code> endpoints.
+   * </p>
+   */
+  public HotelSentiments hotelSentiments;
+
+  public EReputation(Amadeus client) {
+    this.client = client;
+    this.hotelSentiments = new HotelSentiments(client);
+  }
+}

src/main/java/com/amadeus/Response.java

@@ -41,6 +41,10 @@ public class Response {
    * The data extracted from the JSON data - if the body contained JSON.
    */
   private @Getter JsonElement data;
+  /**
+   * The warnings received from the API call.
+   */
+  private @Getter JsonElement warnings;
   /**
    * The raw body received from the API.
    */
@@ -105,6 +109,14 @@ private void parseData(HTTPClient client) {
         this.data = result.get("data").getAsJsonObject();
       }
     }
+    if (parsed && result.has("warnings")) {
+      if (result.get("warnings").isJsonArray()) {
+        this.warnings = result.get("warnings").getAsJsonArray();
+      }
+      if (result.get("warnings").isJsonObject()) {
+        this.warnings = result.get("warnings").getAsJsonObject();
+      }
+    }
   }
 
   // Tries to read the body.

src/main/java/com/amadeus/ereputation/HotelSentiments.java

@@ -0,0 +1,54 @@
+package com.amadeus.ereputation;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+import com.amadeus.resources.HotelSentiment;
+import com.amadeus.resources.Resource;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v2/e-reputation/hotel-sentiments</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.ereputation.hotelSentiments;</pre>
+ */
+
+public class HotelSentiments {
+  private Amadeus client;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public HotelSentiments(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   Hotel ratings based on automated sentiment analysis algorithm
+   *    applied on the online reviews.
+   * </p>
+   *
+   * <pre>
+   * amadeus.ereputation.hotelSentiments.get(Params
+   *   .with("hotelIds", "ELONMFS,ADNYCCTB"));</pre>
+   *
+   * @param params the parameters to send to the API
+   * @return an API response object
+   * @throws ResponseException when an exception occurs
+   */
+  public HotelSentiment[] get(Params params) throws ResponseException {
+    Response response = client.get("/v2/e-reputation/hotel-sentiments", params);
+    return (HotelSentiment[]) Resource.fromArray(response, HotelSentiment[].class);
+  }
+}

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

@@ -0,0 +1,37 @@
+package com.amadeus.resources;
+
+import lombok.Getter;
+import lombok.ToString;
+
+/**
+ * An HotelSentiment object as returned by the Hotel Ratings API.
+ * @see HotelSentiments#get()
+ */
+
+@ToString
+public class HotelSentiment extends Resource {
+  protected HotelSentiment() {}
+
+  private @Getter String hotelId;
+  private @Getter String type;
+  private @Getter int overallRating;
+  private @Getter int numberOfReviews;
+  private @Getter Sentiment sentiments;
+
+  @ToString
+  public class Sentiment {
+    protected Sentiment() {}
+
+    private @Getter int staff;
+    private @Getter int location;
+    private @Getter int service;
+    private @Getter int roomComforts;
+    private @Getter int sleepQuality;
+    private @Getter int swimmingPool;
+    private @Getter int valueForMoney;
+    private @Getter int facilities;
+    private @Getter int catering;
+    private @Getter int pointsOfInterest;
+  }
+
+}

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

@@ -1,12 +1,12 @@
 package com.amadeus;
 
+import com.amadeus.ereputation.HotelSentiments;
 import com.amadeus.exceptions.ResponseException;
 import com.amadeus.referenceData.Airlines;
 import com.amadeus.referenceData.Location;
 import com.amadeus.referenceData.Locations;
 import com.amadeus.referenceData.locations.Airports;
 import com.amadeus.referenceData.locations.PointsOfInterest;
-import com.amadeus.referenceData.locations.pointsOfInterest.BySquare;
 import com.amadeus.referenceData.urls.CheckinLinks;
 import com.amadeus.shopping.FlightDates;
 import com.amadeus.shopping.FlightDestinations;
@@ -56,6 +56,7 @@ public void testAllNamespacesExist() {
     TestCase.assertNotNull(client.shopping.flightOffers.prediction);
     TestCase.assertNotNull(client.shopping.hotelOffers);
     TestCase.assertNotNull(client.shopping.hotelOffersByHotel);
+    TestCase.assertNotNull(client.ereputation.hotelSentiments);
     TestCase.assertNotNull(client.shopping.hotelOffer("XXX"));
   }
 
@@ -268,6 +269,14 @@ public void testGetMethods() throws ResponseException {
     FlightOffersSearch flightOfferSearch = new FlightOffersSearch(client);
     TestCase.assertNotNull(flightOfferSearch.get(params));
 
+    // Test hotel ratings
+    Mockito.when(client.get("/v2/e-reputation/hotel-sentiments", null))
+            .thenReturn(multiResponse);
+    Mockito.when(client.get("/v2/e-reputation/hotel-sentiments", params))
+            .thenReturn(multiResponse);
+    HotelSentiments hotelSentiments = new HotelSentiments(client);
+    TestCase.assertNotNull(hotelSentiments.get(params));
+
   }
 
   @Test