Exception Handling এর ধারণা

ওয়েব সার্ভিস ডেভেলপমেন্টে Exception Handling একটি গুরুত্বপূর্ণ বিষয়। এটি কোনো ত্রুটি (error) সনাক্ত করা এবং তা সঠিকভাবে পরিচালনা করার প্রক্রিয়া। স্প্রিং ওয়েব সার্ভিসে Exception Handling-কে এমনভাবে ডিজাইন করা হয়েছে যাতে SOAP বার্তা প্রক্রিয়াকরণের সময় ক্লায়েন্ট এবং সার্ভারের মধ্যে ত্রুটির তথ্য সঠিকভাবে আদান-প্রদান করা যায়।

Exception Handling এর গুরুত্ব

• ব্যবহারকারীকে ত্রুটির কারণ জানানো: ক্লায়েন্টকে উপযুক্ত ত্রুটির বার্তা প্রদান করা।
• ত্রুটির ধরন আলাদা করা: সাধারণ ত্রুটি এবং ক্রিটিক্যাল ত্রুটি আলাদা করা।
• অ্যাপ্লিকেশনের স্থিতিশীলতা: ত্রুটি সনাক্ত করে অ্যাপ্লিকেশন ক্র্যাশ হওয়া এড়ানো।
• ডিবাগিং সহজ করা: ত্রুটির তথ্য লগ করে সমস্যা সমাধান সহজ করা।

স্প্রিং ওয়েব সার্ভিসে Exception Handling এর প্রক্রিয়া

SOAPFaultException

স্প্রিং ওয়েব সার্ভিসে ত্রুটির তথ্য ক্লায়েন্টকে পাঠানোর জন্য SOAPFaultException ব্যবহার করা হয়। এটি SOAP বার্তার মাধ্যমে ক্লায়েন্টকে ত্রুটির বিবরণ পাঠায়।

WebServiceException

WebServiceException ক্লাসটি সাধারণ ত্রুটির জন্য ব্যবহৃত হয় যা SOAP বার্তার মাধ্যমে প্রেরণ করা হয় না।

Custom Exception ব্যবহার

ওয়েব সার্ভিসের নির্দিষ্ট ত্রুটিগুলোর জন্য কাস্টম এক্সসেপশন তৈরি করা হয়।

Exception Handling ইমপ্লিমেন্টেশন

১. কাস্টম Exception তৈরি করা

public class EmployeeNotFoundException extends RuntimeException {
    public EmployeeNotFoundException(String message) {
        super(message);
    }
}

২. SOAPFault তৈরি করা

import javax.xml.ws.soap.SOAPFaultException;
import javax.xml.soap.SOAPFactory;
import javax.xml.soap.SOAPFault;

@Endpoint
public class EmployeeEndpoint {

    @PayloadRoot(namespace = "http://example.com/namespace", localPart = "GetEmployeeRequest")
    public GetEmployeeResponse getEmployee(GetEmployeeRequest request) {
        if (request.getId() <= 0) {
            throw createSOAPFaultException("Invalid Employee ID: " + request.getId());
        }

        // যদি সঠিক ID হয়, তখন ডেটা রিটার্ন করুন
        GetEmployeeResponse response = new GetEmployeeResponse();
        response.setName("John Doe");
        return response;
    }

    private SOAPFaultException createSOAPFaultException(String message) {
        try {
            SOAPFault fault = SOAPFactory.newInstance().createFault();
            fault.setFaultString(message);
            return new SOAPFaultException(fault);
        } catch (Exception e) {
            throw new RuntimeException("Error creating SOAP Fault", e);
        }
    }
}

৩. @ExceptionHandler ব্যবহার

স্প্রিং এর @ExceptionHandler অ্যানোটেশন ব্যবহার করে কাস্টম এক্সসেপশন পরিচালনা করা যায়।

@ControllerAdvice
public class SoapExceptionHandler {

    @ExceptionHandler(EmployeeNotFoundException.class)
    public ResponseEntity<String> handleEmployeeNotFoundException(EmployeeNotFoundException ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
    }
}

৪. SOAPFaultMappingExceptionResolver ব্যবহার

SOAPFaultMappingExceptionResolver ক্লাস স্প্রিং ওয়েব সার্ভিসের মধ্যে Exception Handling সহজ করে। এটি SOAPFault তৈরি এবং ক্লায়েন্টের কাছে পাঠানোর কাজ করে।

কনফিগারেশন:

@Bean
public SOAPFaultMappingExceptionResolver exceptionResolver() {
    SOAPFaultMappingExceptionResolver resolver = new SOAPFaultMappingExceptionResolver();

    Properties errorMappings = new Properties();
    errorMappings.setProperty(EmployeeNotFoundException.class.getName(), "CLIENT");

    resolver.setExceptionMappings(errorMappings);
    resolver.setDefaultFault(fault -> fault.setFaultString("An unknown error occurred"));

    return resolver;
}

SOAP বার্তার আউটপুট উদাহরণ

ক্লায়েন্টকে SOAP বার্তায় ত্রুটির তথ্য পাঠানোর সময় নিম্নরূপ বার্তা তৈরি হয়:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <SOAP-ENV:Fault>
            <faultcode>SOAP-ENV:Client</faultcode>
            <faultstring>Invalid Employee ID: -1</faultstring>
        </SOAP-ENV:Fault>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Exception Handling এর সেরা পদ্ধতি

• কাস্টম এক্সসেপশন ব্যবহার করুন: নির্দিষ্ট ত্রুটির জন্য আলাদা এক্সসেপশন তৈরি করা।
• SOAPFaultException এড়িয়ে চলুন যেখানে সম্ভব: এটি বেশি কমপ্লেক্স হলে @ExceptionHandler বা অন্য পদ্ধতি ব্যবহার করুন।
• লগিং নিশ্চিত করুন: সার্ভারে সব ত্রুটির তথ্য লগ করে রাখা।
• ব্যবহারকারী-বান্ধব বার্তা প্রদান করুন: ক্লায়েন্টকে সঠিক এবং সহজবোধ্য ত্রুটির বার্তা দিন।

সারাংশ:
স্প্রিং ওয়েব সার্ভিসে Exception Handling ক্লায়েন্ট এবং সার্ভারের মধ্যে ত্রুটি যোগাযোগকে সহজ করে তোলে। SOAPFaultException, Custom Exception, এবং @ExceptionHandler ব্যবহার করে কার্যকরভাবে Exception পরিচালনা করা যায়। এটি সঠিক বার্তা প্রদান এবং সার্ভারের স্থিতিশীলতা নিশ্চিত করতে সহায়ক।