BC Java - Assignment 09 - RESTful API

• BC Java - Assignment 09 - RESTful API
  • Requirements
    • Question 1: API Hello World (Onboarding task)
    • Question 2: Service Greeting (Dependency Injection)
    • Question 3: API Máy tính đơn giản (Calculator)
    • Question 4: Quản lý sản phẩm (Product CRUD – In-Memory)
    • Question 5: Quản lý sinh viên (Student API)
    • Question 6: Tạo Bean Config thủ công (AppConfig)
    • Question 7: Tìm kiếm sách (Book Search API)
    • Question 8: Quản lý nhân viên (Employee + Exception Handling)
    • Question 9: Kiến trúc chuẩn 3 Layer (Customer API)
  • Prerequisites
    • Project Structure
    • Environment
  • Author

Requirements

Question 1: API Hello World (Onboarding task)

• Problem:
  • Team muốn kiểm tra môi trường của bạn.
  • Hãy xây dựng một REST API: GET /hello → trả về "Hello Spring Boot!"
• Solution: Full source: Question 1
  • HelloController
• URL: http:localhost:8080/hello

Question 2: Service Greeting (Dependency Injection)

• Problem:
  • Product Owner muốn một API chào người dùng.
  • Tạo GreetingService với method sayHello(String name).
  • API GET /greet?name=Alice → trả về Hello Alice!.
• Solution: Full source: Question 2
  • GreetingController
  • GreetingService
• URL: http:localhost:8080/greet?name=Alice

Question 3: API Máy tính đơn giản (Calculator)

• Problem:
  • Khách hàng muốn một service tính toán online.
    • GET /calc/add?x=10&y=5 → 15
    • GET /calc/subtract?x=10&y=5 → 5
    • GET /calc/multiply?x=10&y=5 → 50
    • GET /calc/divide?x=10&y=5 → 2
• Solution: Full source: Question 3
  • CalculatorController
  • CalculatorService
  • OperatorCalculation: Define operation calculator enum
  • StringToOperationTypeCalculator: Convert string (path) to enum
• URL:
  • Add: http:localhost:8080/calc/add?x=10&y=5
  • Subtract: http:localhost:8080/calc/subtract?x=10&y=5
  • Multiply: http:localhost:8080/calc/multiply?x=10&y=5
  • Divide: http:localhost:8080/calc/divide?x=10&y=5

Question 4: Quản lý sản phẩm (Product CRUD – In-Memory)

• Problem:
  • Team muốn mock thử một API quản lý sản phẩm.
    • GET /products → trả về danh sách.
    • POST /products (JSON) → thêm sản phẩm.
    • GET /products/{id} → xem chi tiết.
    • PUT /products/{id} → cập nhật sản phẩm.
    • DELETE /products/{id} → xóa sản phẩm.
• Solution: Full source: Question 4
  • Controller
  • DTO
  • Model
  • Repository
  • Service
• URLs:

  • Lấy danh sách sản phẩm (GET): http:localhost:8080/products

  • Lấy thông tin chi tiết của sản phầm theo ID (GET) http:localhost:8080/products/1

  • Thêm mới một sản phẩm (POST): http:localhost:8080/products/

    {
      "name": "iPhone Dual",
      "price": 999.99,
      "quantity": 1000
    }

  • Cập nhật thông tin sản phẩm (PUT): http:localhost:8080/products/1

    {
      "name": "iPhone 84",
      "price": 2026,
      "quantity": 84
    }

  • Xóa sản phẩm (DELETE): http:localhost:8080/products/1

Question 5: Quản lý sinh viên (Student API)

• Problem:
  • Team education cần API quản lý student.
  • API:
    • POST /students → thêm student từ JSON
    • GET /students/{id} → trả về student theo ID
• Solution: Full source: Question 5
  • Controller
  • Service
  • Model
• URLs:
  • Lấy thông tin sinh viên theo ID (GET): http://localhost:8080/students/1

    • Thêm mới sinh viên (POST): http://localhost:8080/students/

      {
        "email": "ngkhang@gmail.com",
        "fullName": "Nguyễn Khang"
      }

Question 6: Tạo Bean Config thủ công (AppConfig)

• Problem:
  • CTO muốn bạn thử tạo Bean thủ công thay vì @Service.
    • Tạo AppConfig với @Configuration.
    • Định nghĩa @Bean cho GreetingService.
    • Inject vào Controller để sử dụng.
• Solution: Full source: Question 6
  • Controller
  • Service
  • AppConfig
• URL: GET http://localhost:8080/greet-v2

Question 7: Tìm kiếm sách (Book Search API)

• Problem:
  • Khách hàng muốn API tìm kiếm sách theo tác giả.
    • GET /books/search?author=abc → trả về danh sách sách của tác giả đó.
• Solution: Full source: Question 7
  • Controller
  • Service
  • Model
• URL:
  • Tìm danh sách của sách theo tác giả (GET): http://localhost:8080/books/search?author=abc

Question 8: Quản lý nhân viên (Employee + Exception Handling)

• Problem:

  • Team HR cần API quản lý nhân viên.
  • GET /employees/{id} → trả về nhân viên.
    • Nếu không có ID → trả về lỗi: { "error": "Employee not found", "status": 404 }

• Solution: Full source: Question 8

• URL: Lấy thông tin nhân viên theo ID (GET)

  • ID tồn tại: http://localhost:8080/employees/1
  • ID không tồn tại: http://localhost:8080/employees/999

Question 9: Kiến trúc chuẩn 3 Layer (Customer API)

• Problem:
  • Tech lead muốn project chia đúng tầng:
    • Controller: nhận request.
    • Service: xử lý logic.
    • Repository: quản lý dữ liệu (In-memory).
    • Entity Customer(id, name, phone).
• Solution: Full source: Question 9
• URL:
  • Lấy danh sách khách hàng (GET): http://localhost:8080/customer

Prerequisites

Project Structure

Environment

• IDE: IntelliJ
• Java 21

Author

Khang Nguyen