Merge pull request #44 from aviemzur/get-movie-recommendations

Get movie recommendations method

src/main/java/com/omertron/themoviedbapi/enumeration/MovieMethod.java

@@ -35,6 +35,7 @@ public enum MovieMethod implements AppendToResponseMethod {
     IMAGES,
     KEYWORDS,
     LISTS,
+    RECOMMENDATIONS,
     RELEASES,
     REVIEWS,
     SIMILAR,

src/main/java/com/omertron/themoviedbapi/methods/TmdbMovies.java

@@ -262,6 +262,24 @@ public class TmdbMovies extends AbstractMethod {
         }
     }
 
+    /**
+     * The recommendations method will let you retrieve the movie recommendations for a particular movie.
+     *
+     * @param movieId
+     * @param language
+     * @return
+     * @throws MovieDbException
+     */
+    public ResultList<MovieInfo> getRecommendations(int movieId, String language) throws MovieDbException {
+        TmdbParameters parameters = new TmdbParameters();
+        parameters.add(Param.ID, movieId);
+        parameters.add(Param.LANGUAGE, language);
+
+        URL url = new ApiUrl(apiKey, MethodBase.MOVIE).subMethod(MethodSub.RECOMMENDATIONS).buildUrl(parameters);
+        WrapperGenericList<MovieInfo> wrapper = processWrapper(getTypeReference(MovieInfo.class), url, "recommendations");
+        return wrapper.getResultsList();
+    }
+
     /**
      * This method is used to retrieve all of the release and certification data we have for a specific movie.
      *

src/main/java/com/omertron/themoviedbapi/model/movie/MovieInfo.java

@@ -94,6 +94,7 @@ public class MovieInfo extends MovieBasic implements Serializable, Identificatio
     private List<Video> videos = Collections.emptyList();
     private List<Translation> translations = Collections.emptyList();
     private List<MovieInfo> similarMovies = Collections.emptyList();
+    private List<MovieInfo> recommendations = Collections.emptyList();
     private List<Review> reviews = Collections.emptyList();
     private List<UserList> lists = Collections.emptyList();
     private List<ChangeKeyItem> changes = Collections.emptyList();
@@ -295,6 +296,12 @@ public class MovieInfo extends MovieBasic implements Serializable, Identificatio
         addMethod(MovieMethod.LISTS);
     }
 
+    @JsonSetter("recommendations")
+    public void seRecommendations(WrapperGenericList<MovieInfo> recommendations) {
+        this.recommendations = recommendations.getResults();
+        addMethod(MovieMethod.RECOMMENDATIONS);
+    }
+
     @JsonSetter("reviews")
     public void setReviews(WrapperGenericList<Review> reviews) {
         this.reviews = reviews.getResults();

src/main/java/com/omertron/themoviedbapi/tools/MethodSub.java

@@ -62,6 +62,7 @@ public enum MethodSub {
     RATED_MOVIES_GUEST("rated_movies"),
     RATED_TV("rated/tv"),
     RATING("rating"),
+    RECOMMENDATIONS("recommendations"),
     RELEASES("releases"),
     REMOVE_ITEM("remove_item"),
     REVIEWS("reviews"),

src/test/java/com/omertron/themoviedbapi/methods/TmdbMoviesTest.java

@@ -326,6 +326,24 @@ public class TmdbMoviesTest extends AbstractTests {
         }
     }
 
+    /**
+     * Test of getRecommendations method, of class TmdbMovies.
+     *
+     * @throws com.omertron.themoviedbapi.MovieDbException
+     */
+    @Test
+    public void testGetRecommendations() throws MovieDbException {
+        LOG.info("getRecommendations");
+
+        String language = LANGUAGE_DEFAULT;
+
+        for (TestID test : FILM_IDS) {
+            ResultList<MovieInfo> result = instance.getRecommendations(test.getTmdb(), language);
+            TestSuite.test(result, "Recommendations");
+        }
+    }
+
+
     /**
      * Test of getMovieReviews method, of class TmdbMovies.
      *