如何将Java实体映射到Oracle对象类型？Spring Data JPA问题求助

核心步骤说明 #

要实现Java实体CardTransaction与Oracle自定义对象类型Card_Transaction的映射，并通过@NamedStoredProcedureQuery调用存储过程，需按以下步骤配置：

1. 修正Java实体的JPA注解 #

给CardTransaction添加@Struct注解，绑定Oracle对象类型，同时补充JPA要求的构造器、Getter/Setter：

import jakarta.persistence.Struct;

@Struct(name = "CARD_TRANSACTION", fields = {"card_id", "amount"})
public class CardTransaction {
    private String card_id;
    private Double amount;

    // JPA必须的无参构造器
    public CardTransaction() {}

    // 带参构造器，方便实例化
    public CardTransaction(String card_id, Double amount) {
        this.card_id = card_id;
        this.amount = amount;
    }

    // Getter和Setter必须实现，JPA需访问字段
    public String getCard_id() {
        return card_id;
    }

    public void setCard_id(String card_id) {
        this.card_id = card_id;
    }

    public Double getAmount() {
        return amount;
    }

    public void setAmount(Double amount) {
        this.amount = amount;
    }
}

注意：@Struct的name要与Oracle对象类型名一致（Oracle默认大写，所以用CARD_TRANSACTION），fields数组顺序需和Oracle对象定义的字段顺序完全匹配。

2. 定义存储过程映射的实体载体 #

由于@NamedStoredProcedureQuery必须标注在@Entity类上，可创建一个空实体类承载存储过程配置：

import jakarta.persistence.*;

@Entity
@NamedStoredProcedureQuery(
    name = "MyProc.call",
    procedureName = "MY_PROC",
    parameters = {
        @StoredProcedureParameter(
            mode = ParameterMode.IN,
            name = "p_Card_Transaction",
            type = CardTransaction.class
        ),
        @StoredProcedureParameter(
            mode = ParameterMode.OUT,
            name = "p_result",
            type = String.class
        )
    }
)
public class ProcedureHolder {
    @Id
    private Long id; // JPA实体必须有ID字段，无需映射实际表
}

注意：procedureName要与Oracle存储过程名一致（Oracle默认大写，用MY_PROC）。

3. 创建Spring Data JPA Repository接口 #

定义调用存储过程的方法：

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

public interface ProcedureHolderRepository extends JpaRepository<ProcedureHolder, Long> {

    @Procedure(name = "MyProc.call")
    String callMyProc(CardTransaction transaction);
}

4. 配置Hibernate与Oracle方言 #

在application.properties中添加Hibernate配置，确保支持Oracle自定义类型：

# 指定Oracle方言
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.OracleDialect
# 启用自定义结构类型支持
spring.jpa.properties.hibernate.type.preferred_instant_jdbc_type=TIMESTAMP
# 可选：开启SQL格式化，方便调试
spring.jpa.properties.hibernate.format_sql=true

5. 依赖与权限检查 #

• 确保使用ojdbc8及以上版本的Oracle JDBC驱动，早期版本对自定义对象类型支持有限。
• 确认数据库用户拥有Card_Transaction类型的访问权限。

测试调用示例 #

import org.springframework.stereotype.Service;

@Service
public class TransactionService {
    private final ProcedureHolderRepository repository;

    public TransactionService(ProcedureHolderRepository repository) {
        this.repository = repository;
    }

    public String processTransaction(String cardId, Double amount) {
        CardTransaction transaction = new CardTransaction(cardId, amount);
        return repository.callMyProc(transaction);
    }
}

内容的提问来源于stack exchange，提问作者Yashar