Java Technologies Practical উদাহরণ: JSON Response সহ REST API তৈরি গাইড ও নোট

এই গাইডে, আমরা একটি REST API তৈরি করব যেখানে JSON রেসপন্স থাকবে। আমরা Spring Boot ফ্রেমওয়ার্ক ব্যবহার করে এটি তৈরি করব। Spring Boot হল একটি জনপ্রিয় Java ফ্রেমওয়ার্ক যা দ্রুত এবং সহজে ওয়েব অ্যাপ্লিকেশন ও RESTful API তৈরি করতে সাহায্য করে।

প্রয়োজনীয় সরঞ্জাম:

1. JDK (Java Development Kit)
2. Spring Boot (Spring Initializr ব্যবহার করে প্রকল্প তৈরি)
3. Maven (ডিপেনডেন্সি ম্যানেজমেন্ট)
4. IDE (যেমন IntelliJ IDEA, Eclipse)

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

প্রথমে, Spring Initializr ব্যবহার করে একটি Spring Boot প্রজেক্ট তৈরি করুন:

1. URL: https://start.spring.io
2. প্রজেক্ট টেমপ্লেট নির্বাচন করুন:
   • Project: Maven Project
   • Language: Java
   • Spring Boot: (সবচেয়ে সাম্প্রতিক ভার্সন)
   • Project Metadata:
     • Group: com.example
     • Artifact: restapi
     • Name: restapi
     • Description: A simple REST API with JSON response
     • Package Name: com.example.restapi
     • Packaging: Jar
     • Java: 11 বা 17
3. Dependencies:
   • Spring Web
   • Spring Boot DevTools
   • Spring Data JPA
   • H2 Database (ডেমো ডাটাবেস হিসেবে)

এটি একটি ZIP ফাইল ডাউনলোড করবে। ফাইলটি আনজিপ করুন এবং আপনার পছন্দের IDE তে খুলুন।

2. REST Controller তৈরি করা

এখন আমরা একটি REST Controller তৈরি করব যা JSON রেসপন্স প্রদান করবে। একটি সাধারণ GET রিকোয়েস্ট হ্যান্ডলিং এর মাধ্যমে JSON রেসপন্স পাঠানো হবে।

UserController.java ফাইল তৈরি করুন:

package com.example.restapi.controller;

import com.example.restapi.model.User;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Arrays;
import java.util.List;

@RestController
public class UserController {

    // GET endpoint to return list of users
    @GetMapping("/users")
    public List<User> getUsers() {
        User user1 = new User(1, "John Doe", "john.doe@example.com");
        User user2 = new User(2, "Jane Doe", "jane.doe@example.com");
        return Arrays.asList(user1, user2);
    }
}

এখানে, /users রুটে একটি GET রিকোয়েস্ট করা হলে, এটি একটি List রিটার্ন করবে।

3. Model Class তৈরি করা

এখন আমাদের User নামক একটি ক্লাস তৈরি করতে হবে যা id, name, এবং email ধারণ করবে। এই ক্লাসটিকে Model Class হিসেবে ব্যবহার করা হবে।

User.java ফাইল তৈরি করুন:

package com.example.restapi.model;

public class User {
    private int id;
    private String name;
    private String email;

    // Constructor
    public User(int id, String name, String email) {
        this.id = id;
        this.name = name;
        this.email = email;
    }

    // Getters and Setters
    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

এখানে:

• User ক্লাসের মধ্যে ৩টি প্রপার্টি রয়েছে: id, name, এবং email।
• এর কনস্ট্রাক্টর, গেটার এবং সেটার মেথডগুলো JSON রেসপন্স তৈরি করতে সহায়তা করবে।

4. Spring Boot Application শুরু করা

এখন আমাদের Spring Boot অ্যাপ্লিকেশন চালু করতে হবে। RestapiApplication.java ক্লাসটি সাধারণত Spring Initializr থেকে তৈরি হয়।

package com.example.restapi;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class RestapiApplication {

    public static void main(String[] args) {
        SpringApplication.run(RestapiApplication.class, args);
    }
}

এখন, আপনার অ্যাপ্লিকেশনটি রান করানোর জন্য RestapiApplication.java ক্লাসে main() মেথড রান করুন। অ্যাপ্লিকেশনটি localhost:8080 তে চলে আসবে।

5. JSON রেসপন্স পরীক্ষা করা

এখন আমাদের GET রিকোয়েস্ট পাঠিয়ে JSON রেসপন্স পরীক্ষা করা যাক। এটি করার জন্য, আপনি আপনার ব্রাউজার বা Postman ব্যবহার করতে পারেন।

GET রিকোয়েস্ট:

GET http://localhost:8080/users

JSON রেসপন্স:

[
    {
        "id": 1,
        "name": "John Doe",
        "email": "john.doe@example.com"
    },
    {
        "id": 2,
        "name": "Jane Doe",
        "email": "jane.doe@example.com"
    }
]

এখানে, /users এ GET রিকোয়েস্ট পাঠালে আপনি JSON ফরম্যাটে ২টি ব্যবহারকারীর ডেটা পাবেন।

সারাংশ

এটি ছিল Spring Boot ব্যবহার করে একটি REST API তৈরি করার প্রক্রিয়া, যা JSON রেসপন্স প্রদান করে। এই উদাহরণে আমরা:

1. Spring Boot অ্যাপ্লিকেশন তৈরি করেছি।
2. একটি REST Controller তৈরি করেছি যা GET রিকোয়েস্টে JSON রেসপন্স প্রদান করে।
3. একটি Model Class তৈরি করেছি যা User অবজেক্টের জন্য ডেটা ধারণ করে।
4. শেষে Postman বা ব্রাউজার ব্যবহার করে API রেসপন্স পরীক্ষা করেছি।

এই প্রক্রিয়াটি REST API তৈরি করতে এবং JSON ডেটা পাঠানোর জন্য খুবই কার্যকরী এবং এটি ওয়েব ডেভেলপমেন্টের জন্য একটি গুরুত্বপূর্ণ স্কিল।