Spring MVC & REST API development

Spring Boot হলো Spring Framework এর উপর ভিত্তি করে তৈরি একটি production-ready framework, যা দিয়ে খুব সহজে ওয়েব অ্যাপ্লিকেশন ও RESTful API তৈরি করা যায়। এই টিউটোরিয়ালে আমরা শিখব কীভাবে Spring MVC আর্কিটেকচার ব্যবহার করে REST API ডেভেলপ করা যায়।

Spring MVC কী?

Spring MVC (Model-View-Controller) হলো একটি ওয়েব ফ্রেমওয়ার্ক যা অ্যাপ্লিকেশনকে তিনটি প্রধান অংশে ভাগ করে:

REST API তৈরিতে আমরা সাধারণত View অংশ ব্যবহার করি না, কারণ এখানে JSON বা XML response ফেরত দেওয়া হয়।

Spring Boot প্রজেক্ট তৈরি

👉 তুমি Spring Initializr থেকে একটি নতুন প্রজেক্ট তৈরি করতে পারো:
🔗 https://start.spring.io

Dependencies:

- Spring Web

- Spring Boot DevTools

- Spring Data JPA (optional)

- H2 বা MySQL Database (optional)

Controller তৈরি করা

চলো একটি সাধারণ REST Controller তৈরি করি 👇

@RestController
@RequestMapping("/api/users")
public class UserController {
private final UserService userService;

public UserController(UserService userService) {
    this.userService = userService;
}

@GetMapping
public List<User> getAllUsers() {
    return userService.getAllUsers();
}

@GetMapping("/{id}")
public User getUserById(@PathVariable Long id) {
    return userService.getUserById(id);
}

@PostMapping
public User createUser(@RequestBody User user) {
    return userService.saveUser(user);
}

@PutMapping("/{id}")
public User updateUser(@PathVariable Long id, @RequestBody User user) {
    return userService.updateUser(id, user);
}

@DeleteMapping("/{id}")
public void deleteUser(@PathVariable Long id) {
    userService.deleteUser(id);
}

}

এখানে প্রতিটি HTTP মেথড (GET, POST, PUT, DELETE) Spring এর Annotation দিয়ে ম্যাপ করা হয়েছে।

Service Layer

@Service
public class UserService {
private final UserRepository userRepository;

public UserService(UserRepository userRepository) {
    this.userRepository = userRepository;
}

public List<User> getAllUsers() {
    return userRepository.findAll();
}

public User getUserById(Long id) {
    return userRepository.findById(id)
            .orElseThrow(() -> new RuntimeException("User not found"));
}

public User saveUser(User user) {
    return userRepository.save(user);
}

public User updateUser(Long id, User user) {
    User existing = getUserById(id);
    existing.setName(user.getName());
    existing.setEmail(user.getEmail());
    return userRepository.save(existing);
}

public void deleteUser(Long id) {
    userRepository.deleteById(id);
}

}

Repository Layer

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
}

Entity Class

@Entity
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

private String name;
private String email;

// Getter & Setter

}

REST API Endpoint গুলো

JSON Request উদাহরণ

POST /api/users

{
  "name": "Maruf Hasan",
  "email": "maruf@example.com"
}

Response:

{
  "id": 1,
  "name": "Maruf Hasan",
  "email": "maruf@example.com"
}

Exception Handling যোগ করা

API তে সুন্দর error response দিতে @ControllerAdvice ব্যবহার করা যায় 👇

@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RuntimeException.class)
public ResponseEntity<Map<String, String>> handleRuntimeException(RuntimeException ex) {
    Map<String, String> error = new HashMap<>();
    error.put("message", ex.getMessage());
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
}

}

Validation যোগ করা

@Entity
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

@NotBlank(message = "Name cannot be blank")
private String name;

@Email(message = "Email must be valid")
private String email;

}

এবং Controller এ @Valid ব্যবহার করো

@PostMapping
public User createUser(@Valid @RequestBody User user) {
    return userService.saveUser(user);
}

API টেস্ট করা

তুমি Postman বা cURL দিয়ে API টেস্ট করতে পারো।

curl -X GET http://localhost:8080/api/users

Advanced Topic: Versioning API

একাধিক ভার্সন রাখতে পারো header বা path ভিত্তিকভাবে 👇

@RestController
@RequestMapping("/api/v1/users")
public class UserControllerV1 { ... }

@RestController
@RequestMapping("/api/v2/users")
public class UserControllerV2 { ... }

Best Practices

- Controller-এ শুধুমাত্র HTTP হ্যান্ডলিং রাখো
- Service-এ Business Logic রাখো
- Repository-তে শুধুমাত্র Database Operations রাখো
- Proper Exception Handling করো
- Logging & Monitoring ব্যবহার করো (Spring Boot Actuator সহ)
- Validation সবসময় যোগ করো
- DTO ব্যবহার করে Response ক্লিন রাখো