স্প্রিং বুট ত্রুটি সংশোধন করা: অক্ষর পরিবর্তিত এবং ছোট প্রকারের একটি অপারেটর নেই

স্প্রিং বুট এসকিউএল কোয়েরিগুলির সাথে সাধারণ সমস্যাগুলি: পোস্টগ্রেএসকিউএল-এ টাইপ অমিল হ্যান্ডলিং

বিকাশকারী হিসাবে, আমরা সকলেই গোপনীয় ত্রুটির বার্তাগুলির সম্মুখীন হয়েছি যা মনে হয় কোথাও থেকে আসেনি৷ এক মিনিট, আমাদের স্প্রিং বুট অ্যাপ্লিকেশন মসৃণভাবে চলছে; পরেরটি, আমরা বেমানান ডেটা প্রকার সম্পর্কে একটি ত্রুটির দিকে তাকিয়ে আছি। 😅 এটি হতাশাজনক এবং বিভ্রান্তিকর উভয়ই, বিশেষ করে যখন জটিল ক্যোয়ারী সেটআপ নিয়ে কাজ করা হয়।

সম্প্রতি, আমি স্প্রিং বুটে একটি PostgreSQL ত্রুটির মধ্যে পড়েছি: "অপারেটর বিদ্যমান নেই: অক্ষর পরিবর্তিত = ছোট ছোট।" একটি ব্যবহার করার চেষ্টা করার সময় এই বার্তাটি প্রদর্শিত হয়েছিল enums সেট একটি এসকিউএল ক্যোয়ারী এর ইন ক্লজে। এনাম টাইপ এবং ডাটাবেস কলাম টাইপের মধ্যে অমিল একটি অপ্রত্যাশিত হেঁচকি তৈরি করেছে যা সহজবোধ্য কোডের মতো মনে হয়েছিল।

যদিও এটি ডাটাবেস কুইর্ক বা স্প্রিং বুটকে দোষারোপ করতে প্রলুব্ধ করে, আসল সমস্যাটি প্রায়শই কীভাবে enums এবং ডাটাবেস প্রকারগুলি ম্যাপ করা হয় তার মধ্যে থাকে। Java enums, যখন ডাটাবেসে ম্যাপ করা হয়, তখন বিশেষ হ্যান্ডলিং প্রয়োজন, বিশেষ করে PostgreSQL এর সাথে। এই বিবরণগুলি বোঝা সময় বাঁচাতে পারে এবং স্প্রিং বুটে enums এর সাথে কাজ করার সময় ভবিষ্যতের সমস্যাগুলি প্রতিরোধ করতে পারে।

এই নির্দেশিকায়, আমি ব্যাখ্যা করব কিভাবে আমি সমস্যাটি চিহ্নিত করেছি এবং একটি বাস্তব সমাধানের মধ্য দিয়ে চলেছি। আমার নিজস্ব ডিবাগিং যাত্রা থেকে নির্দিষ্ট কোড সংশোধন পর্যন্ত, আপনি আপনার প্রশ্নের টাইপ অমিল এড়াতে এবং নির্বিঘ্ন ডাটাবেস মিথস্ক্রিয়া নিশ্চিত করতে আপনার প্রয়োজনীয় সরঞ্জামগুলি অর্জন করবেন। 🔧

PostgreSQL এর সাথে স্প্রিং বুটে ডেটা টাইপের অমিল সমাধান করা

সাথে কাজ করার সময় বসন্ত বুট এবং PostgreSQL, ডেভেলপাররা প্রায়ই টাইপ অমিল সমস্যার সম্মুখীন হয়, বিশেষ করে enums এর সাথে। এই ক্ষেত্রে, ত্রুটি "অপারেটর বিদ্যমান নেই: অক্ষর পরিবর্তিত = ছোট ছোট" ঘটে কারণ PostgreSQL নেটিভ কোয়েরিতে একটি SQL টাইপ হিসাবে Java enum কে সরাসরি ব্যাখ্যা করতে পারে না। এখানে, SystemAccounts সত্তায় AccountType enum দ্বারা উপস্থাপিত একটি userCode ক্ষেত্র রয়েছে, যা জাভাতে "PERSONAL" বা "CORPORATE" এর মতো মানগুলিকে ম্যাপ করে৷ যাইহোক, enums এর একটি সেট সহ একটি নেটিভ SQL ক্যোয়ারী করার চেষ্টা করার সময়, PostgreSQL স্বয়ংক্রিয়ভাবে enum প্রকারের সাথে মেলে না, ফলে এই ত্রুটি দেখা দেয়। এটি কাটিয়ে ওঠার জন্য, ক্যোয়ারীতে পাঠানোর আগে enum-কে একটি স্ট্রিং-এ রূপান্তর করা অত্যন্ত গুরুত্বপূর্ণ। 🎯

প্রদত্ত সমাধানে, আমরা @Enumerated(EnumType.STRING) টীকা ব্যবহার করে SystemAccounts-এ enum ম্যাপিং সামঞ্জস্য করে শুরু করি। এটি JPA-কে প্রতিটি AccountType-কে সাংখ্যিক অর্ডিন্যালের পরিবর্তে একটি পঠনযোগ্য স্ট্রিং হিসাবে সংরক্ষণ করার নির্দেশ দেয়। এটি একটি ছোট পরিবর্তন, তবে এটি সংখ্যাসূচক মানগুলি এড়িয়ে ভবিষ্যতে ডেটা পরিচালনাকে সহজ করে, যা ডাটাবেসে ডিবাগিংকে জটিল করে তুলবে। আমাদের সংগ্রহস্থলে, আমরা SQL লজিক নির্দিষ্ট করতে একটি কাস্টম @Query টীকা ব্যবহার করতে পারি। যাইহোক, যেহেতু PostgreSQL-এর এখনও ক্যোয়ারীতে স্ট্রিং হিসাবে enums প্রয়োজন, সেগুলি পাস করার আগে আমাদের AccountType মানগুলিকে একটি স্ট্রিং বিন্যাসে প্রক্রিয়া করতে হবে।

CriteriaBuilder API এই সমস্যার একটি গতিশীল সমাধান প্রদান করে। CriteriaBuilder ব্যবহার করে, আমরা জাভাতে প্রোগ্রামগতভাবে প্রশ্ন তৈরি করে নেটিভ এসকিউএল এড়াতে পারি। এই পদ্ধতিটি আমাদের হাতে এসকিউএল না লিখে এনাম ফিল্টার যোগ করতে সক্ষম করে, যা এসকিউএল ত্রুটি হ্রাস করে এবং বজায় রাখতে সহায়তা করে। আমাদের স্ক্রিপ্টে, সেটের প্রতিটি AccountType-এর সাথে মেলে cb.equal() ব্যবহার করে আমরা প্রতিটি enum-এর স্ট্রিং মানের উপর ভিত্তি করে Predicate অবস্থার একটি তালিকা তৈরি করি। তারপর, cb.or() এই পূর্বাভাসগুলিকে একত্রিত করে, একই ক্যোয়ারীতে একাধিক মানকে অনুমতি দেয়। এই নমনীয় সেটআপটি গতিশীলভাবে এনাম-টু-স্ট্রিং রূপান্তর পরিচালনা করে, PostgreSQL-এর সাথে সামঞ্জস্যের সমস্যাগুলি কমিয়ে দেয়।

অবশেষে, সমাধানটি সামঞ্জস্য যাচাই করার জন্য একটি ইউনিট পরীক্ষা অন্তর্ভুক্ত করে। JUnit ব্যবহার করে, আমরা নিশ্চিত করি যে প্রতিটি AccountType আমাদের প্রশ্নের সাথে কাজ করে, এটি যাচাই করে যে userCode ক্ষেত্রটি "ব্যক্তিগত" বা "কর্পোরেট" মান সংরক্ষণ করতে পারে এবং ত্রুটি ছাড়াই সেগুলি পুনরুদ্ধার করতে পারে। এই পরীক্ষা পদ্ধতিটি প্রথমে প্রয়োজনীয় AccountType মান সেট আপ করে এবং ফলাফল চেক করতে findAllByUserCodes() ক্যোয়ারী চালায়। assertNotNull() এবং assertTrue() চেক যোগ করা গ্যারান্টি দেয় যে আমরা নাল বা ভুল মানগুলির সম্মুখীন হব না, আমাদের সমাধানটি কার্যকরভাবে সমস্ত ক্ষেত্রে পরিচালনা করে তা নিশ্চিত করে। এই সেটআপের সাথে, অ্যাপ্লিকেশনটি উত্পাদনের বিভিন্ন শর্ত জুড়ে enum প্রশ্নগুলি পরিচালনা করার জন্য আরও ভালভাবে প্রস্তুত। 🧪

// Problem: PostgreSQL expects specific data types in queries.
// Solution: Convert enums to strings for query compatibility with PostgreSQL.
// This Spring Boot backend solution is clear, optimized, and includes type checks.

@Entity
@Table(name = "system_accounts")
@Getter
@Setter
public class SystemAccounts {
    @Id
    @Column(name = "id", nullable = false)
    private UUID id;
    @Column(name = "user_code")
    private String userCode;  // Store as String to avoid type mismatch
}

// Enumeration for AccountType
public enum AccountType {
    PERSONAL,
    CORPORATE
}

// Repository Query with Enum Handling
@Query(value = """
    SELECT sa.id FROM system_accounts sa
    WHERE sa.user_code IN :accountTypes""", nativeQuery = true)
Optional<List<SystemAccounts>> findAllByUserCodes(@Param("accountTypes") List<String> accountTypes);
// This query accepts a List of strings to avoid casting issues.

// Convert AccountType enums to Strings in Service
List<String> accountTypeStrings = accountTypes.stream()
    .map(Enum::name)
    .collect(Collectors.toList());

// Using CriteriaBuilder to dynamically handle enums in queries with automatic type checking.
// This approach uses Java’s Criteria API to avoid type mismatches directly in the code.

public List<SystemAccounts> findAllByUserCodes(Set<AccountType> accountTypes) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<SystemAccounts> query = cb.createQuery(SystemAccounts.class);
    Root<SystemAccounts> root = query.from(SystemAccounts.class);
    Path<String> userCodePath = root.get("userCode");
    List<Predicate> predicates = new ArrayList<>();

    // Add predicates for enum values, converting to String for matching
    for (AccountType type : accountTypes) {
        predicates.add(cb.equal(userCodePath, type.name()));
    }

    query.select(root)
         .where(cb.or(predicates.toArray(new Predicate[0])));
    return entityManager.createQuery(query).getResultList();
}

// This JUnit test ensures both solutions handle enums correctly with PostgreSQL.
// Tests database retrieval for both AccountType values: PERSONAL and CORPORATE.

@SpringBootTest
public class SystemAccountsRepositoryTest {
    @Autowired
    private SystemAccountsRepository repository;

    @Test
    public void testFindAllByUserCodes() {
        Set<AccountType> accountTypes = Set.of(AccountType.PERSONAL, AccountType.CORPORATE);
        List<SystemAccounts> results = repository.findAllByUserCodes(accountTypes);

        // Verify results are returned and types match
        assertNotNull(results);
        assertTrue(results.size() > 0);
        results.forEach(account ->
            assertTrue(account.getUserCode().equals("PERSONAL") || account.getUserCode().equals("CORPORATE"))
        );
    }
}

স্প্রিং বুটের মাধ্যমে PostgreSQL-এ Enum থেকে স্ট্রিং রূপান্তর পরিচালনা করা

ব্যবহার করার সময় বসন্ত বুট PostgreSQL এর সাথে, ডাটাবেস কোয়েরিতে enums পরিচালনার জন্য প্রায়ই বিশেষ মনোযোগের প্রয়োজন হয়, বিশেষ করে যখন enums জড়িত থাকে নেটিভ এসকিউএল কোয়েরি. ডিফল্টরূপে, PostgreSQL সরাসরি Java enums সমর্থন করে না এবং পরিবর্তে একটি সামঞ্জস্যপূর্ণ ডেটা টাইপ আশা করে varchar বা পাঠ্য প্রশ্নে উদাহরণ স্বরূপ, যখন AccountType-এর মতো একটি enum-এর উপর ভিত্তি করে ফলাফল ফিল্টার করতে হয়, তখন PostgreSQL-এর জন্য আমাদেরকে জাভা এনামকে একটি স্ট্রিং ভ্যালুতে রূপান্তর করতে হবে কোয়েরি চালানোর আগে। এই রূপান্তরটি সাধারণ "অপারেটর বিদ্যমান নেই" ত্রুটিকে প্রতিরোধ করে, যা ঘটে যখন ডাটাবেস একটি এনামকে ছোট বা অক্ষর পরিবর্তিত করার মতো বেমানান প্রকারের সাথে তুলনা করার চেষ্টা করে।

এই সমস্যাটি পরিচালনা করার একটি উপায় হল লিভারেজ করা @Enumerated(EnumType.STRING) স্প্রিং বুটে টীকা, যা ডাটাবেসে সরাসরি স্ট্রিং মান হিসাবে enums সংরক্ষণ করে। যাইহোক, নেটিভ কোয়েরি জড়িত পরিস্থিতিতে, প্রায়শই ক্যোয়ারির মধ্যেই enumsকে স্ট্রিং-এ রূপান্তর করতে হয়। মত পদ্ধতি ব্যবহার করে .stream() এবং map(Enum::name), আমরা আমাদের enum মানগুলির জন্য স্ট্রিং উপস্থাপনাগুলির একটি তালিকা তৈরি করতে পারি, যা পরবর্তীতে কোনো প্রকার অমিল সমস্যা ছাড়াই PostgreSQL-এ পাস করা যেতে পারে। এই পদ্ধতিটি নমনীয়তা নিশ্চিত করে, আমাদেরকে ত্রুটি ছাড়াই নির্বিঘ্নে একাধিক AccountType মান দ্বারা ফিল্টার করার অনুমতি দেয়।

আরো জটিল enum ব্যবহার সহ অ্যাপ্লিকেশনের জন্য, আরেকটি পদ্ধতি হল ব্যবহার করা CriteriaBuilder API, যা আমাদেরকে ম্যানুয়ালি SQL না লিখে টাইপ-নিরাপদ উপায়ে গতিশীলভাবে প্রশ্ন তৈরি করতে দেয়। এই APIটি পুনঃব্যবহারযোগ্য এবং ডাটাবেস-অজ্ঞেয়মূলক কোড তৈরি করার জন্য বিশেষভাবে উপযোগী, কারণ এটি এনামগুলিকে স্বয়ংক্রিয়ভাবে সামঞ্জস্যপূর্ণ ডাটাবেস প্রকারে অনুবাদ করে, টাইপ ত্রুটির ঝুঁকি হ্রাস করে। এই পদ্ধতির সাহায্যে, ক্যোয়ারী নির্মাণ প্রক্রিয়া সরলীকৃত হয়, এবং বিকাশকারীরা একীভূত উপায়ে বিভিন্ন এনাম-ভিত্তিক ফিল্টার পরিচালনা করার নমনীয়তা অর্জন করে।