如何使用OData Service暴露Stored Procedure？

刚好我之前做过类似的需求，给你分享一套完整的实现步骤和示例，帮你用EclipseLink JPA结合OData把存储过程暴露出去：

如果是Spring Boot项目，你需要在pom.xml里添加Spring Data OData和EclipseLink的相关依赖，确保版本兼容（比如EclipseLink 2.7+搭配Spring Data OData 3.x）：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-odata</artifactId>
    </dependency>
    <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>eclipselink</artifactId>
        <version>2.7.10</version>
    </dependency>
    <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>org.eclipse.persistence.jpa.modelgen.processor</artifactId>
        <version>2.7.10</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

在你的实体类（或者专门建一个占位实体，如果你不需要持久化）上用@NamedStoredProcedureQuery注解绑定存储过程：

@Entity
@NamedStoredProcedureQuery(
    name = "GetUserOrders", // 自定义的查询名称
    procedureName = "GET_USER_ORDERS", // 数据库里的存储过程名称
    resultClasses = UserOrder.class, // 存储过程返回结果对应的实体类
    parameters = {
        @StoredProcedureParameter(mode = ParameterMode.IN, name = "USER_ID", type = Long.class),
        // 如果有输出参数也可以在这里定义
    }
)
@SqlResultSetMapping(
    name = "UserOrderMapping",
    entities = @EntityResult(entityClass = UserOrder.class)
)
public class UserOrder {
    @Id
    private Long orderId;
    private Long userId;
    private String orderNumber;
    private LocalDateTime orderDate;
    // 省略getter/setter
}

注意：如果存储过程返回的是无实体对应的结果集，一定要用@SqlResultSetMapping来做结果映射

用Spring Data OData的Repository接口，自动帮你生成OData兼容的端点：

@RepositoryRestResource(collectionResourceRel = "userOrders", path = "userOrders")
public interface UserOrderRepository extends ODataRepository<UserOrder, Long> {

    // 绑定存储过程的调用方法
    @Procedure(name = "GetUserOrders")
    List<UserOrder> getOrdersByUserId(@Param("USER_ID") Long userId);
}

这样Spring Data会自动把这个方法暴露成OData的函数导入（Function Import），你可以通过OData的URL来调用它。

在application.properties里添加必要的配置：

# OData基础路径
spring.data.odata.base-path=/odata
# 开启EclipseLink织入（确保JPA特性正常工作）
spring.jpa.properties.eclipselink.weaving=true
# 指定JPA提供者为EclipseLink
spring.jpa.provider=org.eclipse.persistence.jpa.PersistenceProvider

启动项目后，你可以通过以下URL调用存储过程：

GET http://localhost:8080/odata/userOrders/Default.GetOrdersByUserId?USER_ID=123

返回的结果会自动符合OData的JSON格式，支持OData的标准查询参数（比如$select、$filter）。

• 如果存储过程需要事务，记得在Repository方法或者Service方法上加上@Transactional注解
• 复杂的存储过程（比如返回多个结果集）可能需要手动用EntityManager调用，然后封装成OData响应
• 可以通过OData的元数据端点http://localhost:8080/odata/$metadata查看暴露的函数和实体结构

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