HSQLDB এবং REST API Integration

HSQLDB একটি হালকা এবং ইন-মেমরি ডেটাবেস যা Java অ্যাপ্লিকেশনগুলির জন্য খুবই উপযুক্ত। এটি বিশেষভাবে টেস্টিং, ডেভেলপমেন্ট এবং ছোট থেকে মাঝারি আকারের অ্যাপ্লিকেশনগুলির জন্য ব্যবহৃত হয়। একদিকে, REST (Representational State Transfer) API একটি আর্কিটেকচারাল স্টাইল যা ওয়েব সার্ভিসের মাধ্যমে ক্লায়েন্ট এবং সার্ভারের মধ্যে যোগাযোগ স্থাপন করতে ব্যবহৃত হয়।

HSQLDB এবং REST API-এর ইন্টিগ্রেশন আপনি Spring Boot বা JAX-RS ব্যবহার করে সহজেই করতে পারেন। এটি আপনাকে ডেটাবেসে ডেটা ইনসার্ট, আপডেট, ডিলিট, এবং রিট্রিভ করার জন্য RESTful এন্ডপয়েন্ট তৈরি করতে সহায়ক হবে।

এখানে HSQLDB এবং REST API Integration সম্পর্কে বিস্তারিত আলোচনা করা হলো।

1. Spring Boot Setup for HSQLDB Integration

Spring Boot একটি জনপ্রিয় ফ্রেমওয়ার্ক যা RESTful APIs দ্রুত তৈরি করতে সহায়ক। HSQLDB এর সাথে Spring Boot ইন্টিগ্রেট করতে, প্রথমে আমাদের প্রয়োজনীয় ডিপেনডেন্সি যোগ করতে হবে।

Maven Dependencies (pom.xml)

<dependencies>
    <!-- Spring Boot Starter Web for REST API -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- HSQLDB Dependency -->
    <dependency>
        <groupId>org.hsqldb</groupId>
        <artifactId>hsqldb</artifactId>
        <version>2.5.1</version>
    </dependency>

    <!-- Spring Boot Starter Data JPA for database integration -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>

    <!-- Spring Boot Starter Test for testing purposes -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

• spring-boot-starter-web REST API এর জন্য প্রয়োজনীয় সকল লাইব্রেরি অন্তর্ভুক্ত করে।
• hsqldb HSQLDB ডেটাবেসের জন্য ডিপেনডেন্সি।
• spring-boot-starter-data-jpa ডেটাবেসের সাথে JPA (Java Persistence API) ইন্টিগ্রেট করার জন্য।

2. Application Properties Configuration (application.properties)

Spring Boot অ্যাপ্লিকেশনের জন্য HSQLDB কনফিগারেশন ফাইলটি application.properties এ করতে হবে।

# HSQLDB configuration for Spring Boot
spring.datasource.url=jdbc:hsqldb:mem:testdb
spring.datasource.driverClassName=org.hsqldb.jdbc.JDBCDriver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.HSQLDialect
spring.jpa.hibernate.ddl-auto=create

এখানে:

• jdbc:hsqldb:mem:testdb URL ইন-মেমরি HSQLDB ডেটাবেসের জন্য ব্যবহৃত হয়।
• spring.jpa.hibernate.ddl-auto=create কনফিগারেশন Hibernate ORM ব্যবহারের মাধ্যমে ডেটাবেসের স্কিমা স্বয়ংক্রিয়ভাবে তৈরি করবে।

3. Model Class (Entity)

Spring Boot এবং HSQLDB এর মধ্যে ডেটাবেসের ডেটা সঞ্চালনের জন্য JPA Entity ক্লাস তৈরি করতে হবে। এখানে একটি উদাহরণ দেখানো হচ্ছে যেখানে একটি User টেবিল তৈরি করা হবে।

User.java (Entity Class)

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
public class User {

    @Id
    private Long id;
    private String name;
    private String email;

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

    public void setId(Long 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 নামক একটি Entity ক্লাস, যা users টেবিলের তথ্য সংরক্ষণ করবে।

4. Repository Interface (JPA Repository)

Spring Data JPA দিয়ে ডেটাবেস অপারেশন করতে JpaRepository ব্যবহার করতে হবে।

UserRepository.java

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

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

JpaRepository ইন্টারফেসের মাধ্যমে আমরা CRUD অপারেশন (Create, Read, Update, Delete) সহজেই সম্পাদন করতে পারি।

5. REST API Controller

এখন আমরা RESTful Web Services তৈরি করব যা HTTP রিকোয়েস্টে ডেটাবেস অপারেশন (CRUD) পরিচালনা করবে।

UserController.java (REST Controller)

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;
import java.util.Optional;

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    private UserRepository userRepository;

    // Get all users
    @GetMapping
    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    // Get a user by ID
    @GetMapping("/{id}")
    public Optional<User> getUserById(@PathVariable Long id) {
        return userRepository.findById(id);
    }

    // Create a new user
    @PostMapping
    public User createUser(@RequestBody User user) {
        return userRepository.save(user);
    }

    // Update a user
    @PutMapping("/{id}")
    public User updateUser(@PathVariable Long id, @RequestBody User user) {
        user.setId(id);
        return userRepository.save(user);
    }

    // Delete a user
    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable Long id) {
        userRepository.deleteById(id);
    }
}

এখানে:

• @GetMapping ব্যবহার করে ডেটা রিট্রিভ করা হচ্ছে।
• @PostMapping নতুন ব্যবহারকারী তৈরি করতে ব্যবহৃত হচ্ছে।
• @PutMapping ব্যবহারকারী আপডেট করতে ব্যবহৃত হচ্ছে।
• @DeleteMapping ব্যবহারকারী মুছে ফেলতে ব্যবহৃত হচ্ছে।

6. Run the Application

এখন, আপনার Spring Boot অ্যাপ্লিকেশনটি চালু করুন এবং আপনার API পরীক্ষা করুন।

Run the Application:

mvn spring-boot:run

এটি Spring Boot অ্যাপ্লিকেশন শুরু করবে এবং আপনার REST API প্রস্তুত থাকবে।

7. Testing the API

API পরীক্ষা করার জন্য আপনি Postman বা cURL ব্যবহার করতে পারেন।

• GET Request (All users): GET http://localhost:8080/api/users

• POST Request (Create a new user):

  POST http://localhost:8080/api/users
  {
      "name": "John Doe",
      "email": "john@example.com"
  }
  

• PUT Request (Update a user): PUT http://localhost:8080/api/users/1
• DELETE Request (Delete a user): DELETE http://localhost:8080/api/users/1

সারাংশ

HSQLDB এবং REST API ইন্টিগ্রেশন Spring Boot ব্যবহার করে খুবই সহজ। এই প্রক্রিয়ায়:

• JPA ব্যবহার করে HSQLDB ডেটাবেসের সাথে সংযোগ স্থাপন করা হয়েছে।
• RESTful Web Services তৈরি করে ডেটাবেস থেকে তথ্য ইনসার্ট, আপডেট, ডিলিট এবং রিট্রিভ করা হয়েছে।
• POST, GET, PUT, এবং DELETE HTTP মেথডের মাধ্যমে REST API তৈরি করা হয়েছে যা ডেটাবেসের সাথে ইন্টারঅ্যাক্ট করে।

এই ধরনের ইন্টিগ্রেশন ছোট থেকে বড় অ্যাপ্লিকেশনগুলিতে অত্যন্ত কার্যকরী এবং শক্তিশালী।