使用Spring Data GemFire手动执行OQL查询时遭遇‘Unexpected Token’错误

嘿，我之前也碰到过类似的GemFire OQL语法报错，结合你的场景（涉及Trade实体类），大概率是下面几个常见原因导致的，咱们一步步来解决：

1. timestamp是GemFire OQL的保留关键字 #

GemFire的查询语言（OQL）里，timestamp属于内置的保留字。如果你的Trade实体类正好有一个字段叫timestamp，直接在查询语句里使用这个字段名就会触发语法解析错误。

解决方法：把字段名用双引号括起来，规避保留字冲突。比如：

• 错误写法：SELECT * FROM Trade t WHERE t.timestamp > ?
• 正确写法：SELECT * FROM Trade t WHERE t."timestamp" > ?

2. 查询中的时间字面量格式不符合要求 #

如果是你在查询里直接写了时间相关的字面量（比如想指定一个固定时间值），GemFire对时间类型的字面量有严格的格式规范，随便写timestamp('2024-05-20')这种写法会被解析器判定为非法。

解决方法：

• 优先使用参数绑定的方式，直接传入Java的java.sql.Timestamp或java.util.Date对象，避免手写字面量。
• 如果必须用字面量，要遵循GemFire的格式，比如用DATE('yyyy-MM-dd')或TIME('HH:mm:ss')函数，时间戳可以转换为日期后使用。

示例代码（参数绑定方式）：

import org.apache.geode.cache.query.Query;
import org.apache.geode.cache.query.QueryService;
import java.sql.Timestamp;
import java.util.List;

// 获取QueryService
QueryService queryService = gemfireCache.getQueryService();
// 编写带参数的查询，注意字段名用引号包裹
Query query = queryService.newQuery("SELECT * FROM /Trades t WHERE t.\"timestamp\" > $1");
// 传入时间戳参数，比如查询1小时内的交易
Timestamp oneHourAgo = new Timestamp(System.currentTimeMillis() - 3600 * 1000);
List<Trade> recentTrades = (List<Trade>) query.execute(oneHourAgo);

3. Trade实体类的字段映射或访问性问题 #

如果Trade类里的timestamp字段没有被GemFire正确识别，也会导致查询解析失败：

• 字段名大小写不匹配：GemFire OQL默认区分大小写，确保查询里的字段名和实体类的属性名完全一致（包括大小写）。
• 缺少getter方法：OQL是基于属性访问的，需要给timestamp字段提供对应的getTimestamp()方法，否则GemFire无法访问该属性。
• 注解配置错误：如果用了Spring Data GemFire的@Region等注解，确保实体类被正确扫描和映射到GemFire Region中。

检查示例Trade实体类：

import java.sql.Timestamp;
import org.springframework.data.gemfire.mapping.annotation.Region;

@Region("Trades") // 确保Region名称和查询里的一致
public class Trade {
    private String tradeId;
    private Timestamp timestamp; // 字段名和查询里的要匹配

    // 必须提供getter方法
    public Timestamp getTimestamp() {
        return timestamp;
    }

    // 其他字段的getter、setter和构造方法
}

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