107 lines
2.7 KiB
Markdown
107 lines
2.7 KiB
Markdown
## Third Assignment: Movie Explorer 🎬 + Rational Calculator 🧮
|
|
---
|
|
Welcome to Your Third Assignment in the Advanced Programming Course!
|
|
|
|
This assignment consists of two separate parts. You must complete both parts.
|
|
---
|
|
|
|
## Part 1: Rational Class (Rational Numbers)
|
|
In this part, you will implement a Rational class that supports basic mathematical operations.
|
|
|
|
Tasks:
|
|
Define fields for numerator and denominator
|
|
|
|
Implement addition, subtraction, multiplication, and division as instance methods
|
|
|
|
Implement addition, subtraction, multiplication, and division as static methods
|
|
|
|
Note: Detailed TODO comments are provided inside Rational.java.
|
|
---
|
|
## Part 2: Movie Explorer 🎬 (Using API)
|
|
In this part, you will develop a Java application that fetches movie data from an API and allows users to browse and search movies.
|
|
|
|
Files Provided:
|
|
Movie.java
|
|
|
|
Genre.java
|
|
|
|
MovieService.java
|
|
|
|
Main.java
|
|
|
|
Tasks:
|
|
Complete the Movie class (fields, constructor, getters/setters)
|
|
|
|
Complete the Genre class (fields, constructor, getters/setters)
|
|
|
|
Parse JSON data from getGenresList() into a list of Genre objects
|
|
|
|
Display the list of genres to the user
|
|
|
|
Fetch and return a list of movies by genreId and page number
|
|
|
|
Display the genres of a specific movie
|
|
|
|
Implement a console menu in Main to receive user input and display data
|
|
|
|
Note: Detailed TODO comments are provided inside each of the above source files.
|
|
---
|
|
## Objectives ✏️
|
|
By completing this assignment, you will:
|
|
|
|
Reinforce OOP concepts: class design, constructors, encapsulation, collections
|
|
|
|
Practice instance methods vs. static methods
|
|
|
|
Work with JSON parsing and REST APIs
|
|
|
|
Design a simple console-based menu
|
|
|
|
Improve Git workflow and project management
|
|
----
|
|
## Prerequisites ✅
|
|
Git
|
|
|
|
Java (version 23 or 25)
|
|
|
|
Maven as a package manager
|
|
|
|
API key for movie database (e.g., TMDB)
|
|
---
|
|
## Tasks Summary 📝
|
|
Fork the repository and clone it locally
|
|
|
|
Create and switch to a development branch
|
|
|
|
Complete Part 1 (Rational.java) following the TODO comments
|
|
|
|
Complete Part 2 (Movie.java, Genre.java, MovieService.java, Main.java) following the TODO comments
|
|
|
|
Ensure the code compiles and runs correctly
|
|
|
|
Commit and push regularly
|
|
|
|
Submit a pull request from development to main
|
|
---
|
|
## Evaluation Criteria ⚖️
|
|
Functionality: Code compiles and runs without errors; all features work correctly
|
|
|
|
Code Quality: Clean, readable, well-structured code with proper naming
|
|
|
|
Understanding: You must be able to explain your implementation
|
|
---
|
|
## Bonus Tasks ✒️
|
|
Advanced search (title, genre, year, rating, etc.)
|
|
|
|
Sorting options for movies
|
|
|
|
Save/load favorite movies to/from a file
|
|
|
|
Improved console menu design
|
|
|
|
GUI version using JavaFX
|
|
---
|
|
## Submission ⌛
|
|
Deadline: May 1st (11 Ordibehesht)
|
|
|