Merge remote-tracking branch 'origin/main'

README.md

@@ -121,64 +121,40 @@ Understanding: You must be able to explain your implementation
 ## Bonus Tasks ✒️
 1. Fetch and display movie information using movie ID
 
-In this section, you must implement the ability to search for a movie by its ID. The user enters an ID, and the program displays complete movie details.
+Implement movie search by ID. User enters an ID, program displays complete movie details.
 
-Movie Class Fields (already defined):
+### ⚠️ First: Add Missing Fields to Movie Class
+The API returns more data than your current class supports. Add these fields:
+- `actors`, `awards`, `director`, `imdb_id`, `imdb_votes`, `metascore`, `plot`, `rated`, `released`, `runtime`, `type`, `writer`
 
-- id (Long) - Movie identifier
+### Implementation Steps:
 
-- title (String) - Movie title
+1. **Complete `getMovieById(movieId)`**
+   - Build request to: `https://api.meshcomp.ir/api/v1/movies/{movieId}`
+   - If status 200 → return JSON body, else → return null
 
-- year (String) - Release year
+2. **Complete `displayMovieDetails(movieId)`**
+   - Call `getMovieById()` → check for null
+   - Use Gson to parse JSON to Movie object (after adding fields above)
+   - Print formatted output (see example below)
 
-- genres (List<Genre>) - List of genres
+### Example Output:
-
+```
-- images (String) - Poster image URL
+           =======================================================================
-
+                               THE SHAWSHANK REDEMPTION (1994)
-- country (String) - Production country
+           =======================================================================
-
+           Rating: 9.3/10  |  Votes: 1,738,596
-- imdbRating (String) - IMDB rating
+           Director: Frank Darabont
-
+           Cast: Tim Robbins, Morgan Freeman, Bob Gunton, William Sadler
-Implementation Steps:
+           Genre: Crime, Drama
-
+           Runtime: 142 min  |  Rated: R
-- Build and Send Request (getMovieById method):
+           Country: USA  |  Released: 14 Oct 1994
-
+           Plot: Two imprisoned men bond over a number of years, finding
-      - Create HTTP request to: https://api.meshcomp.ir/api/v1/movies/{movieId}
+           solace and eventual redemption through acts of common decency.
-
+           Awards: Nominated for 7 Oscars. Another 19 wins & 30 nominations.
-      - Replace {movieId} with the ID from user
+           =======================================================================
-
-      - Send request and get response
-
-- Handle Response (getMovieById method):
-
-      - If status code is 200, return JSON body
-
-      - Otherwise, print error and return null
-
-- Parse JSON and Create Movie Object (displayMovieDetails method):
-
-      - Parse JSON response to JsonObject
-
-      - Extract all fields: id, title, year, poster, country, imdb_rating
-
-      - Parse "genres" array and convert each to Genre object
-
-      - Create a Movie object with all extracted data
-
-- Display Results (displayMovieDetails method):
-
-      - Print all movie details in a clean format
-
-2. Advanced search (title, genre, year, rating, etc.)
-
-3. Sorting options for movies
-
-4. Save/load favorite movies to/from a file
-
-5. Improved console menu design
-
-6. GUI version using JavaFX
            
+```
 ---
 ## References 📚
 
@@ -202,4 +178,3 @@ Jackson Tutorial:
 ---
 ## Submission ⌛
 Deadline: May 1st (11 Ordibehesht)
-

src/main/java/Rational/Rational.java

@@ -51,38 +51,46 @@ public class Rational {
         return r1.add(r2);
     }
 
+    // TODO: Instance method - this - other
     // Formula: a/b - c/d = (a*d - c*b) / (b*d)
     public Rational subtract(Rational other) {
-        int newNumerator = this.numerator * other.denominator - other.numerator * this.denominator;
+        // YOUR CODE HERE
-        int newDenominator = this.denominator * other.denominator;
+        return null; // Remove this line when implemented
-        return new Rational(newNumerator, newDenominator);
     }
 
-    public static Rational subtract(Rational r1, Rational r2) { return r1.subtract(r2); }
+    // TODO: Static method - r1 - r2
+    public static Rational subtract(Rational r1, Rational r2) {
+        // YOUR CODE HERE
+        return null; // Remove this line when implemented
+    }
 
+    // TODO: Instance method - this * other
     // Formula: (a/b) * (c/d) = (a*c) / (b*d)
     public Rational multiply(Rational other) {
-        int newNumerator = this.numerator * other.numerator;
+        // YOUR CODE HERE
-        int newDenominator = this.denominator * other.denominator;
+        return null; // Remove this line when implemented
-        return new Rational(newNumerator, newDenominator);
     }
 
-    public static Rational multiply(Rational r1, Rational r2) { return r1.multiply(r2); }
+    // TODO: Static method - r1 * r2
+    public static Rational multiply(Rational r1, Rational r2) {
+        // YOUR CODE HERE
+        return null; // Remove this line when implemented
+    }
 
+    // TODO: Instance method - this / other
     // Formula: (a/b) ÷ (c/d) = (a*d) / (b*c)
     public Rational divide(Rational other) {
-        if(other.numerator == 0) {
+        // YOUR CODE HERE
-            System.out.println("Error !");
+        // HINT: Division is multiplication by reciprocal
-        }
+        // Don't forget to check if other.numerator is zero!
-        else {
+        return null; // Remove this line when implemented
-            int newNumerator = this.numerator * other.denominator;
-            int newDenominator = this.denominator * other.numerator;
-            return new Rational(newNumerator, newDenominator);
-        }
-        return null;
     }
 
-    public static Rational divide(Rational r1, Rational r2) { return r1.divide(r2); }
+    // TODO: Static method - r1 / r2
+    public static Rational divide(Rational r1, Rational r2) {
+        // YOUR CODE HERE
+        return null; // Remove this line when implemented
+    }
 
     //  PROVIDED - String representation
     @Override

src/main/java/movie/apis/Main.java

@@ -21,18 +21,14 @@ public class Main {
                     break;
 
                 case 2:
-                    System.out.println("Enter genre id :");
+                    // TODO: Get genre ID and page from user, then call movieService.displayMoviesByGenre()
-                    Long genreId = scanner.nextLong();
+
-                    System.out.println("Enter the page number :");
-                    Long page = scanner.nextLong();
-                    movieService.displayMoviesByGenre(genreId, page);
                     break;
 
 
                 case 3:
-                    System.out.println("Enter the movie id :");
+                    // TODO (BONUS): Get movie ID from user, then call movieService.displayMovieDetails()
-                    Long movieId = scanner.nextLong();
+
-                    movieService.displayMovieDetails(movieId);
 
                     break;
 

src/main/java/movie/apis/Movie.java

@@ -6,8 +6,8 @@ import java.util.List;
  * Model class representing a movie
  * Fields: id, title, genres, images
  */
-public class Movie
+public class Movie {
-{
+
     private Long id;
     private String title;
     private List<String> genres;
@@ -15,109 +15,10 @@ public class Movie
     private String year;
     private String imdb_rating;
     private String country;
-    private String actors;
-    private String awards;
-    private String director;
-    private String imdb_id;
-    private String imdb_votes;
-    private String metascore;
-    private String plot;
-    private String rated;
-    private String released;
-    private String runtime;
-    private String type;
-    private String writer;
 
-    public Movie(Long id, String title, List<String> genres, List<String> images, String year, String imdb_rating, String country)
+    // TODO: Create a constructor with all fields
-    {
-        this.id = id;
-        this.title = title;
-        this.genres = genres;
-        this.images = images;
-        this.year = year;
-        this.imdb_rating = imdb_rating;
-        this.country = country;
-    }
 
-    public Movie(Long id, String title)
+    // TODO: Create a simple constructor with id and title only
-    {
-        this.id = id;
-        this.title = title;
-    }
 
-    public Long getId() { return id; }
+    // TODO: Create getters and setters for all fields
-
-    public void setId(Long id) { this.id = id; }
-
-    public String getTitle() { return title; }
-
-    public void setTitle(String title) { this.title = title; }
-
-    public List<String> getGenres() { return genres; }
-
-    public void setGenres(List<String> genres) { this.genres = genres; }
-
-    public List<String> getImages() { return images; }
-
-    public void setImages(List<String> images) { this.images = images; }
-
-    public String getYear() { return year; }
-
-    public void setYear(String year) { this.year = year; }
-
-    public String getImdbRating() { return imdb_rating; }
-
-    public void setImdbRating(String imdbRating) { this.imdb_rating = imdb_rating; }
-
-    public String getCountry() { return country; }
-
-    public void setCountry(String country) { this.country = country; }
-
-    public String getActors() { return actors; }
-
-    public void setActors(String actors) { this.actors = actors; }
-
-    public String getAwards() { return awards; }
-
-    public void setAwards(String awards) { this.awards = awards; }
-
-    public String getDirector() { return director; }
-
-    public void setDirector(String director) { this.director = director; }
-
-    public String getImdb_id() { return imdb_id; }
-
-    public void setImdb_id(String imdb_id) { this.imdb_id = imdb_id; }
-
-    public String getImdb_votes() { return imdb_votes; }
-
-    public void setImdb_votes(String imdb_votes) { this.imdb_votes = imdb_votes; }
-
-    public String getMetascore() { return metascore; }
-
-    public void setMetascore(String metascore) { this.metascore = metascore; }
-
-    public String getPlot() { return plot; }
-
-    public void setPlot(String plot) { this.plot = plot; }
-
-    public String getRated() { return rated; }
-
-    public void setRated(String rated) { this.rated = rated; }
-
-    public String getReleased() { return released; }
-
-    public void setReleased(String released) { this.released = released; }
-
-    public String getRuntime() { return runtime; }
-
-    public void setRuntime(String runtime) { this.runtime = runtime; }
-
-    public String getType() {return type; }
-
-    public void setType(String type) { this.type = type; }
-
-    public String getWriter() { return writer; }
-
-    public void setWriter(String writer) { this.writer = writer; }
 }

src/main/java/movie/apis/MovieService.java

@@ -90,7 +90,8 @@ public class MovieService {
     /**
      * TODO 1: Display movies for a specific genre and page
      *
-     * JSON format: { "movies": [ { "id": 1, "title": "Movie", "year": "1994" } ], "total": 177, "total_pages": 18 }
+     * Open this link in your browser (and check Pretty-print checkbox) to view json format:
+     * https://api.meshcomp.ir/api/v1/genres/1/movies
      *
      * Steps:
      * - Call getMoviesByGenreList(genreId, page) to get JSON
@@ -102,129 +103,88 @@ public class MovieService {
      * PUT ALL PARSING CODE INSIDE try-catch
      */
     public void displayMoviesByGenre(Long genreId, Long page) {
-        String jsonResponse = getMoviesByGenreList(genreId, page);
+        // TODO: Write your code here
-
+        // All parsing code must be inside try-catch
-        if (jsonResponse == null) {
-            System.out.println("Failed !");
-            return;
-        }
-
         try {
-            JsonObject rootObject = JsonParser.parseString(jsonResponse).getAsJsonObject();
+            // Your code here
-            JsonArray moviesArray = rootObject.getAsJsonArray("movies");
-            Type movieListType = new TypeToken<ArrayList<Movie>>(){}.getType();
-            Gson gson = new Gson();
-            List<Movie> movies = gson.fromJson(moviesArray, movieListType);
-
-            System.out.println();
-            System.out.println("Total : " + rootObject.get("total").getAsLong());
-            System.out.println("Taotal pages : " + rootObject.get("total_pages").getAsLong());
-            System.out.println("\nALL MOVIES:");
-            for (Movie movie : movies) {
-                System.out.println("ID : " + movie.getId() + " | " + movie.getTitle() + " (" + movie.getYear() + ")");
-            }
 
         } catch (Exception e) {
             System.err.println("ERROR: " + e.getMessage());
         }
     }
 
+
     /**
      * BONUS: Fetch movie details from API using movie ID
      * URL format: https://api.meshcomp.ir/api/v1/movies/{movieId}
      */
     private String getMovieById(Long movieId) {
         try {
-            HttpRequest request = HttpRequest.newBuilder()
+            // TODO: Complete this method
-                    .uri(URI.create(MOVIE_BY_ID_URL + movieId))
+            // String url = MOVIE_BY_ID_URL + movieId;
-                    .build();
+            // HttpRequest request = HttpRequest.newBuilder().uri(URI.create(url)).build();
+            // HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+            // if (response.statusCode() == 200) return response.body();
 
-            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+            return null;
-
-            if(response.statusCode() == 200) {
-                System.out.println("MOVIE_BY_ID_URL List recieved successfully");
-                return response.body();
-            }
-            else {
-                throw new IOException("Http error code : " + response.statusCode());
-            }
         } catch (Exception e) {
             System.out.println("!!Exception : " + e.getMessage());
         }
         return null;
     }
 
-    /**
+     /*
-     * BONUS TODO: Display complete movie details for a given movie ID
+     BONUS TODO: Display complete movie details for a given movie ID
-     *
+
-     * Expected JSON format from getMovieById():
+     Open this link in your browser (and check Pretty-print checkbox) to view json format:
-     * {
+     https://api.meshcomp.ir/api/v1/movies/1
-     *   "id": 1,
+
-     *   "title": "The Shawshank Redemption",
+     INSTRUCTIONS:
-     *   "year": "1994",
+     1. Call getMovieById(movieId) to get the JSON response string
-     *   "genres": ["Crime", "Drama"],
+     2. Check if response is null (if yes, print error and return)
-     *   "poster": "https://moviesapi.ir/images/tt0111161_poster.jpg",
+     3. Parse the JSON string to JsonObject (inside try-catch)
-     *   "country": "USA",
+     4. Use Gson to extract all fields from the JSON and map them to your Movie class:
-     *   "imdb_rating": "9.3"
+        - Add missing JSON fields to your Movie class first (actors, awards, director,
-     * }
+          imdb_id, imdb_votes, metascore, plot, rated, released, runtime, type, writer)
-     *
+        - Then use Gson to parse your json string
-     * INSTRUCTIONS:
+     5. Print all movie details in a readable format
-     * 1. Call getMovieById(movieId) to get the JSON response
+
-     * 2. Check if response is null (if yes, print error and return)
+     (PUT ALL PARSING CODE INSIDE THE EXISTING try-catch)
-     * 3. Parse the JSON string to JsonObject (inside try-catch)
-     * 4. Extract all fields: id, title, year, genres array, poster, country, imdb_rating
-     * 5. Convert genres array to comma-separated string
-     * 6. Print all movie details in a readable format
-     *
-     * PUT ALL PARSING CODE INSIDE THE EXISTING try-catch
-     *
-     * @param movieId The ID of the movie to display
      */
+
+    /* EXAMPLE OUTPUT:
+
+           =======================================================================
+                               THE SHAWSHANK REDEMPTION (1994)
+           =======================================================================
+           Rating: 9.3/10  |  Votes: 1,738,596
+           Director: Frank Darabont
+           Cast: Tim Robbins, Morgan Freeman, Bob Gunton, William Sadler
+           Genre: Crime, Drama
+           Runtime: 142 min  |  Rated: R
+           Country: USA  |  Released: 14 Oct 1994
+           Plot: Two imprisoned men bond over a number of years, finding
+           solace and eventual redemption through acts of common decency.
+           Awards: Nominated for 7 Oscars. Another 19 wins & 30 nominations.
+           =======================================================================
+
+     */
+
     public void displayMovieDetails(Long movieId) {
         // Step 1: Get JSON response from API
         String jsonResponse = getMovieById(movieId);
 
         // Step 2: Check if we got valid data
+        // Step 3-5: Parse JSON and display details (PUT YOUR CODE INSIDE try-catch)
         if (jsonResponse == null) {
             System.out.println("Failed to get movie details for ID: " + movieId);
             return;
         }
-
-        // Step 3-6: Parse JSON and display details (PUT YOUR CODE INSIDE try-catch)
         try {
-            JsonObject rootObject = JsonParser.parseString(jsonResponse).getAsJsonObject();
+            // TODO: Parse jsonResponse to JsonObject
-            JsonArray genresArray = rootObject.getAsJsonArray("genres");
+            // HINT: Use JsonParser.parseString(jsonResponse).getAsJsonObject()
-            Type genreListType = new TypeToken<ArrayList<Genre>>(){}.getType();
+            // TODO: use Gson to parse the json
-            Gson gson = new Gson();
+            // Your code here:
-            Movie movie = gson.fromJson(jsonResponse, Movie.class);
-
-            String genresReadable = "";
-            for (int i = 0; i < movie.getGenres().size(); i++) {
-                genresReadable += movie.getGenres().get(i).toString();
-                if (i < movie.getGenres().size() - 1) {
-                    genresReadable += ", ";
-                }
-            }
-
-            System.out.println();
-            System.out.println("===============================================================================================");
-            System.out.println("                              " + movie.getTitle() + " (" + movie.getYear() + ")");
-            System.out.println("===============================================================================================");
-            System.out.println("Movie ID : " + movie.getId());
-            System.out.println("Genres : " + genresReadable);
-            System.out.println("IMDB Rating : " + movie.getImdbRating() + " | " +"Votes : " + movie.getImdb_votes() + " | " + "IMDB id : " + movie.getImdb_id());
-            System.out.println("Meta Score : " + movie.getMetascore());
-            System.out.println("Director : " + movie.getDirector());
-            System.out.println("Cast : " + movie.getActors());
-            System.out.println("Writer : " + movie.getWriter());
-            System.out.println("Type : " + movie.getType());
-            System.out.println("Run time : " + movie.getRuntime() + " | " + "Rated : " + movie.getRated());
-            System.out.println("Country: " + movie.getCountry() + " | " + "Released : " + movie.getReleased());
-            System.out.println("Plot : " + movie.getPlot());
-            System.out.println("Awards : " + movie.getAwards());
-            System.out.println("Posters : " + movie.getImages());
-            System.out.println("===============================================================================================");
-
         } catch (Exception e) {
             System.err.println("ERROR parsing movie details: " + e.getMessage());
         }