Исправљање грешке при покретању пролећа: типови знакова који варирају и Смаллинт типови немају оператора

Уобичајене замке са Спринг Боот СКЛ упитима: руковање неподударностима типова у ПостгреСКЛ-у

Као програмери, сви смо се сусрели са загонетним порукама о грешкама које као да долазе ниоткуда. Један минут, наш Спринг Боот апликација ради глатко; следеће, буљимо у грешку о некомпатибилним типовима података. 😅 То је и фрустрирајуће и збуњујуће, посебно када се ради о сложеним поставкама упита.

Недавно сам наишао на ПостгреСКЛ грешку у Спринг Боот-у: "оператор не постоји: карактер варира = смаллинт." Ова порука се појавила приликом покушаја коришћења а Скуп набрајања у ИН клаузули СКЛ упита. Неподударност између типа енума и типа колоне базе података створила је неочекивани проблем у ономе што је изгледало као једноставан код.

Иако је примамљиво окривити хировите базе података или Спринг Боот, прави проблем често лежи у томе како се мапирају енумови и типови базе података. Јава набрајања, када се мапирају у базе података, захтевају посебно руковање, посебно са ПостгреСКЛ. Разумевање ових детаља може уштедети време и спречити будуће проблеме при раду са енумима у Спринг Боот-у.

У овом водичу ћу објаснити како сам идентификовао проблем и прошао кроз практично решење. Од мог сопственог путовања за отклањање грешака до одређених исправки кода, добићете алате који су вам потребни да избегнете неподударање типова у вашим упитима и обезбедите беспрекорну интеракцију базе података. 🔧

Решавање неслагања типова података у пролећном покретању са ПостгреСКЛ-ом

При раду са Спринг Боот и ПостгреСКЛ, програмери се често сусрећу са проблемима неусклађености типова, посебно са енумима. У овом случају, грешка „оператор не постоји: карактер варира = смаллинт“ се дешава зато што ПостгреСКЛ не може директно да интерпретира Јава енум као СКЛ тип у изворним упитима. Овде, ентитет СистемАццоунтс укључује поље усерЦоде представљено АццоунтТипе енумом, које мапира вредности као што су „ПЕРСОНАЛ“ или „ЦОРПОРАТЕ“ у Јави. Међутим, када покушавате изворни СКЛ упит са скупом енума, ПостгреСКЛ не може аутоматски да упари типове енума, што доводи до ове грешке. Да бисте ово превазишли, кључно је конвертовати енум у стринг пре него што га проследите упиту. 🎯

У понуђеном решењу, почињемо прилагођавањем мапирања енума у ​​СистемАццоунтс користећи напомену @Енумератед(ЕнумТипе.СТРИНГ). Ово упућује ЈПА да чува сваки АццоунтТипе као читљив стринг уместо нумеричког редног броја. То је мала промена, али поједностављује будуће руковање подацима избегавањем нумеричких вредности, што би отклањање грешака у бази података учинило сложеним. У нашем спремишту, онда можемо да користимо прилагођену @Куери напомену да наведемо СКЛ логику. Међутим, пошто су ПостгреСКЛ-у и даље потребни енумови као стрингови у упиту, морамо да обрадимо АццоунтТипе вредности у формат стринга пре него што их проследимо.

ЦритериаБуилдер АПИ нуди динамичко решење за овај проблем. Користећи ЦритериаБуилдер, можемо избећи изворни СКЛ тако што ћемо програмски изградити упите у Јави. Овај приступ нам омогућава да додамо енум филтере без ручног писања СКЛ-а, што смањује СКЛ грешке и помаже у одржавању. У нашој скрипти, креирамо листу услова предиката на основу вредности стринга сваког енума, користећи цб.екуал() да одговара сваком АццоунтТипе-у у скупу. Затим, цб.ор() комбинује ове предикате, дозвољавајући више вредности у истом упиту. Ово флексибилно подешавање динамички управља конверзијом енум-то-стринг, минимизирајући проблеме компатибилности са ПостгреСКЛ-ом.

Коначно, решење укључује јединични тест за проверу компатибилности. Користећи ЈУнит, потврђујемо да сваки АццоунтТипе ради са нашим упитом, потврђујући да поље усерЦоде може да ускладишти вредности „ПЕРСОНАЛ“ или „ЦОРПОРАТЕ“ и да их преузме без грешака. Овај метод тестирања прво поставља потребне вредности АццоунтТипе и покреће упит финдАллБиУсерЦодес() да провери резултате. Додавање ассертНотНулл() и ассертТруе() провера гарантује да нећемо наићи на нулте или нетачне вредности, обезбеђујући да наше решење ефикасно решава све случајеве. Са овим подешавањем, апликација је боље припремљена за руковање енум упитима у различитим условима у производњи. 🧪

// 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"))
        );
    }
}

Руковање конверзијом енума у ​​стринг у ПостгреСКЛ-у са Спринг Боот-ом

Приликом употребе Спринг Боот са ПостгреСКЛ-ом, руковање енумима у упитима базе података често захтева посебну пажњу, посебно када су енумови укључени у изворни СКЛ упити. ПостгреСКЛ подразумевано не подржава Јава енуме директно и уместо тога очекује компатибилан тип података као што је варцхар или текст у упитима. На пример, када треба да филтрирамо резултате на основу енума као што је АццоунтТипе, ПостгреСКЛ захтева од нас да конвертујемо Јава енум у вредност низа пре извршавања упита. Ова конверзија спречава уобичајену грешку „оператор не постоји“ која се јавља када база података покуша да упореди енум са некомпатибилним типом као што је смаллинт или карактер који варира.

Један од начина да се реши овај проблем је да се искористи @Enumerated(EnumType.STRING) анотацију у Спринг Боот-у, која складишти енуме као вредности стрингова директно у бази података. Међутим, за сценарије који укључују изворне упите, често је потребно конвертовати енуме у низове унутар самог упита. Коришћењем метода као што су .stream() и map(Enum::name), можемо да генеришемо листу стрингова репрезентација за наше енум вредности, које се затим могу проследити у ПостгреСКЛ без икаквих проблема са неусклађеношћу типова. Овај приступ обезбеђује флексибилност, омогућавајући нам да неприметно филтрирамо по више вредности АццоунтТипе без грешака.

За апликације са сложенијом употребом енума, други приступ је коришћење CriteriaBuilder АПИ, који нам омогућава да динамички конструишемо упите на безбедан начин без ручног писања СКЛ-а. Овај АПИ је посебно користан за креирање кода за вишекратну употребу и базиран на бази података, јер аутоматски преводи енуме у компатибилне типове базе података, смањујући ризик од грешака у типу. Са овом методом, процес изградње упита је поједностављен, а програмери добијају флексибилност да на јединствен начин рукују разним филтерима заснованим на енумима.