Add travel APIs

Author: cbetta

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

@@ -22,11 +22,26 @@ public class Amadeus extends HTTPClient {
    */
   public static final String VERSION = "1.0.0";
 
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v2/reference-data</code> endpoints.
+   * </p>
+   */
   public ReferenceData referenceData;
 
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/travel</code> endpoints.
+   * </p>
+   */
+  public Travel travel;
+
   protected Amadeus(Configuration configuration) {
     super(configuration);
     this.referenceData = new ReferenceData(this);
+    this.travel = new Travel(this);
   }
 
   /**

src/main/java/com/amadeus/ReferenceData.java

@@ -15,6 +15,8 @@
  * <pre>
  * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
  * amadeus.referenceData;</pre>
+ *
+ * @hide
  */
 public class ReferenceData {
   /**

src/main/java/com/amadeus/Travel.java

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

src/main/java/com/amadeus/referenceData/Urls.java

@@ -16,6 +16,8 @@
  * <pre>
  * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
  * amadeus.referenceData.urls;</pre>
+ *
+ * @hide
  */
 public class Urls {
   /**

src/main/java/com/amadeus/travel/Analytics.java

@@ -0,0 +1,46 @@
+package com.amadeus.travel.analytics;
+
+import com.amadeus.Amadeus;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/travel/analytics</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.travel.analytics;</pre>
+ *
+ * @hide
+ */
+public class Analytics {
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/travel/analytics/air-traffics</code> endpoints.
+   * </p>
+   */
+  public AirTraffic airTraffic;
+
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/travel/analytics/fare-searches</code> endpoints.
+   * </p>
+   */
+  public FareSearches fareSearches;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public Analytics(Amadeus client) {
+    this.airTraffic = new AirTraffic(client);
+    this.fareSearches = new FareSearches(client);
+  }
+}

src/main/java/com/amadeus/travel/analytics/AirTraffic.java

@@ -0,0 +1,38 @@
+package com.amadeus.travel.analytics;
+
+import com.amadeus.Amadeus;
+import com.amadeus.travel.analytics.airTraffic.Traveled;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/travel/analytics/air-traffic</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.travel.analytics.airTraffic;</pre>
+ *
+ * @hide
+ */
+public class AirTraffic {
+  /**
+   * <p>
+   *   A namespaced client for the
+   *   <code>/v1/travel/analytics/air-traffic/traveled</code> endpoints.
+   * </p>
+   */
+  public Traveled traveled;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public AirTraffic(Amadeus client) {
+    this.traveled = new Traveled(client);
+  }
+}

src/main/java/com/amadeus/travel/analytics/FareSearches.java

@@ -0,0 +1,61 @@
+package com.amadeus.travel.analytics;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/travel/analytics/fare-searches</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.travel.analytics.fareSearches;</pre>
+ */
+public class FareSearches {
+  private Amadeus client;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public FareSearches(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   The Fare Search History API allows to find the number of
+   *   estimated searches from an origin, optionally a destination,
+   *   within a time period when travelers are performing the searches.
+   * </p>
+   *
+   * <pre>
+   * amadeus.travel.analytics.fareSearches.get(Params
+   *   .with("origin", "LHR")
+   *   .with("sourceCountry", "FR")
+   *   .with("period", 2011);</pre>
+   *
+   * @param params the parameters to send to the API
+   * @return an API response object
+   * @throws ResponseException when an exception occurs
+   */
+  public Response get(Params params) throws ResponseException {
+    return client.get("/v1/travel/analytics/air-traffic/traveled", params);
+  }
+
+  /**
+   * Convenience method for calling <code>get</code> without any parameters.
+   * @see FareSearches#get()
+   */
+  public Response get() throws ResponseException {
+    return get(null);
+  }
+}

src/main/java/com/amadeus/travel/analytics/airTraffic/Traveled.java

@@ -0,0 +1,58 @@
+package com.amadeus.travel.analytics.airTraffic;
+
+import com.amadeus.Amadeus;
+import com.amadeus.Params;
+import com.amadeus.Response;
+import com.amadeus.exceptions.ResponseException;
+
+/**
+ * <p>
+ *   A namespaced client for the
+ *   <code>/v1/travel/analytics/air-traffic/traveled</code> endpoints.
+ * </p>
+ *
+ * <p>
+ *   Access via the Amadeus client object.
+ * </p>
+ *
+ * <pre>
+ * Amadeus amadeus = Amadeus.builder("clientId", "secret").build();
+ * amadeus.travel.analytics.airTraffis.traveled;</pre>
+ */
+public class Traveled {
+  private Amadeus client;
+
+  /**
+   * Constructor.
+   * @hide
+   */
+  public Traveled(Amadeus client) {
+    this.client = client;
+  }
+
+  /**
+   * <p>
+   *   Returns a list of air traffic reports.
+   * </p>
+   *
+   * <pre>
+   * amadeus.travel.analytics.airTraffic.traveled.get(Params
+   *   .with("origin", "LHR")
+   *   .with("period", "2017-03");</pre>
+   *
+   * @param params the parameters to send to the API
+   * @return an API response object
+   * @throws ResponseException when an exception occurs
+   */
+  public Response get(Params params) throws ResponseException {
+    return client.get("/v1/travel/analytics/air-traffic/traveled", params);
+  }
+
+  /**
+   * Convenience method for calling <code>get</code> without any parameters.
+   * @see Traveled#get()
+   */
+  public Response get() throws ResponseException {
+    return get(null);
+  }
+}

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

@@ -7,26 +7,44 @@
 
 import com.amadeus.exceptions.ResponseException;
 import com.amadeus.referenceData.urls.CheckinLinks;
+import com.amadeus.travel.analytics.FareSearches;
+import com.amadeus.travel.analytics.airTraffic.Traveled;
 import org.junit.Test;
 
 public class NamespaceTest {
   @Test public void testAllNamespacesExist() {
     Amadeus client = Amadeus.builder("id", "secret").build();
     assertNotNull(client.referenceData.urls.checkinLinks);
+    assertNotNull(client.travel.analytics.airTraffic.traveled);
+    assertNotNull(client.travel.analytics.fareSearches);
   }
 
   @Test public void testGetMethods() throws ResponseException {
     Amadeus client = mock(Amadeus.class);
+    Params params = Params.with("airline", "1X");
 
     when(client.get("/v2/reference-data/urls/checkin-links", null))
             .thenReturn(mock(Response.class));
+    when(client.get("/v2/reference-data/urls/checkin-links", params))
+            .thenReturn(mock(Response.class));
     CheckinLinks checkinLinks = new CheckinLinks(client);
     assertTrue(checkinLinks.get() instanceof Response);
+    assertTrue(checkinLinks.get(params) instanceof Response);
 
-    Params params = Params.with("airline", "1X");
-    when(client.get("/v2/reference-data/urls/checkin-links", params))
+    when(client.get("/v1/travel/analytics/air-traffic/traveled", null))
             .thenReturn(mock(Response.class));
-    checkinLinks = new CheckinLinks(client);
-    assertTrue(checkinLinks.get(params) instanceof Response);
+    when(client.get("/v1/travel/analytics/air-traffic/traveled", params))
+            .thenReturn(mock(Response.class));
+    Traveled traveled = new Traveled(client);
+    assertTrue(traveled.get() instanceof Response);
+    assertTrue(traveled.get(params) instanceof Response);
+
+    when(client.get("/v1/travel/analytics/fare-searches", null))
+            .thenReturn(mock(Response.class));
+    when(client.get("/v1/travel/analytics/fare-searches", params))
+            .thenReturn(mock(Response.class));
+    FareSearches fareSearches = new FareSearches(client);
+    assertTrue(fareSearches.get() instanceof Response);
+    assertTrue(fareSearches.get(params) instanceof Response);
   }
 }