উদাহরণ সহ Transaction Management

Spring Web Services-এ Transaction Management একটি গুরুত্বপূর্ণ বিষয়, বিশেষ করে যখন আপনার ওয়েব সার্ভিস বিভিন্ন ডেটাবেস অপারেশন অথবা বহিরাগত সিস্টেমের সাথে কাজ করে। নিচে একটি উদাহরণ সহ Transaction Management এর ব্যাখ্যা দেওয়া হলো।

1. Spring Transaction Management কী?

Spring Framework এ ট্রান্স্যাকশন ম্যানেজমেন্ট দুইভাবে কাজ করতে পারে:

• Declarative Transaction Management (অ্যানোটেশন বা XML কনফিগারেশন ব্যবহার করে)
• Programmatic Transaction Management (কোডের মধ্যে সরাসরি ট্রান্স্যাকশন ম্যানেজ করা)

Declarative Transaction Management সবচেয়ে বেশি ব্যবহৃত, কারণ এটি সহজ এবং কোড কম লাগে।

2. Spring Web Services এর ক্ষেত্রে Transaction Management

যদি আপনার Spring Web Service একটি ডেটাবেসে ডেটা ইনসার্ট, আপডেট, বা ডিলিট করে, তখন ট্রান্স্যাকশন ম্যানেজমেন্ট ব্যবহার করতে হবে যেন সবকিছু একটি ইউনিট হিসেবে কাজ করে। উদাহরণস্বরূপ, যদি কোনো অংশ ব্যর্থ হয়, তাহলে পুরো ট্রান্স্যাকশনটি ব্যর্থ হবে এবং রোলব্যাক হবে।

3. একটি উদাহরণ

নিচে একটি উদাহরণ দেওয়া হলো যেখানে Spring Web Service এ ট্রান্স্যাকশন ম্যানেজমেন্ট ব্যবহার করা হয়েছে:

ডিপেন্ডেন্সি অ্যাড করা (Maven Pom.xml)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.ws</groupId>
    <artifactId>spring-ws-core</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

Entity ক্লাস

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class Customer {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

Repository ইন্টারফেস

import org.springframework.data.jpa.repository.JpaRepository;

public interface CustomerRepository extends JpaRepository<Customer, Long> {
}

Service ক্লাস (Transaction Management সহ)

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public class CustomerService {

    @Autowired
    private CustomerRepository customerRepository;

    @Transactional
    public void createCustomer(Customer customer) {
        customerRepository.save(customer);

        // উদাহরণ হিসেবে একটি ইচ্ছাকৃত Runtime Exception
        if (customer.getName().equals("Error")) {
            throw new RuntimeException("Simulating an error to test rollback!");
        }
    }
}

Controller (RESTful API বা SOAP Endpoint)

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/customers")
public class CustomerController {

    @Autowired
    private CustomerService customerService;

    @PostMapping
    public String addCustomer(@RequestBody Customer customer) {
        try {
            customerService.createCustomer(customer);
            return "Customer created successfully!";
        } catch (Exception e) {
            return "Transaction failed: " + e.getMessage();
        }
    }
}

4. কীভাবে এটি কাজ করে

• @Transactional: এই অ্যানোটেশন Spring কে বলে দেয় যে এই মেথডটি একটি ট্রান্স্যাকশনাল কনটেক্সটে চলবে। যদি কোনো Exception ঘটে, তাহলে Spring পুরো ট্রান্স্যাকশনটি রোলব্যাক করবে।
• যদি createCustomer মেথডে Runtime Exception ঘটে, তাহলে ডাটাবেসে করা পরিবর্তনগুলো (যেমন save) রোলব্যাক হবে।

5. রেজাল্ট

• যদি আপনি একটি নতুন কাস্টমার পাঠান, তবে এটি সফলভাবে সেভ হবে।
• যদি name "Error" হয়, তাহলে ট্রান্স্যাকশনটি ব্যর্থ হবে এবং কোনো ডেটা সেভ হবে না।

গুরুত্বপূর্ণ বিষয়

1. ডেটাসোর্স কনফিগারেশন নিশ্চিত করুন।
2. Exception Handling সঠিকভাবে করুন।
3. প্রয়োজন হলে Custom Rollback Rules ব্যবহার করুন।

আপনার প্রকল্পের প্রয়োজন অনুযায়ী এই উদাহরণটি কাস্টমাইজ করতে পারেন।