📘 Student API - RequestParam Demo

---

🚀 Project Overview

This project demonstrates how to use Request Parameters (@RequestParam) in a Spring Boot REST API.

It allows users to:

• Fetch student data
• Filter by name
• Sort by marks
• Apply pagination (page & size)

---

🛠️ Tech Stack

• Java
• Spring Boot
• Spring Web
• Maven

---

📂 API Endpoints

🔹 Get Students

GET /students

🔹 With Request Parameters

GET /students?name=Srinivas&sortBy=marks&page=0&size=5

---

⚙️ Request Parameters Explained

Parameter	Description
name	Filter students by name
sortBy	Sort by field (e.g., marks)
page	Page number (starts from 0)
size	Number of records per page

---

📥 Sample Request

http://localhost:8080/students?name=Srinivas&sortBy=marks&page=0&size=5

---

📤 Sample Response

[
  {"name": "Srinivas", "marks": 95},
  {"name": "Srinivas", "marks": 92},
  {"name": "Srinivas", "marks": 88}
]

---

💡 Features

• ✔ Filtering using @RequestParam
• ✔ Sorting using Sort
• ✔ Pagination using Pageable
• ✔ Clean REST API design

---

▶️ How to Run

1. Clone the repository
2. Open in IDE (IntelliJ / Eclipse)
3. Run the Spring Boot application
4. Use Postman or browser to test APIs

---

📌 Example Code Snippet

@GetMapping("/students")
public List<Student> getStudents(
        @RequestParam(required = false) String name,
        @RequestParam(defaultValue = "marks") String sortBy,
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "5") int size) {

    // logic here
}

---

👨‍💻 Author

Srinivas Dappu Java Full Stack Developer

---