如何在 JSqlParser 中实现未支持 SQL 特性自动报错机制-java教程-PHP中文网

本文介绍如何通过自定义 visitor adapter，在 jsqlparser 中对未显式支持的 sql 语法（如 insert、group by、having 等）主动抛出异常，从而严格限制仅允许解析预设的极小子集。

本文介绍如何通过自定义 visitor adapter，在 jsqlparser 中对未显式支持的 sql 语法（如 insert、group by、having 等）主动抛出异常，从而严格限制仅允许解析预设的极小子集。

JSqlParser 默认提供的 *VisitorAdapter（如 StatementVisitorAdapter、ExpressionVisitorAdapter）采用“空实现”策略：每个访问方法体为空，即对未覆盖的方法静默忽略。这虽便于快速上手，但在构建轻量级专用数据库时极易导致非法语句被意外跳过——例如用户输入 INSERT INTO ... 却无任何提示，系统误判为合法查询。

要实现严格白名单式解析，核心思路是：替换默认 Adapter，改用“失败优先”（fail-fast）实现。具体做法如下：

继承标准 Visitor 接口（非 Adapter），并手动实现所有方法；
每个方法默认抛出 UnsupportedOperationException，附带清晰的 SQL 元素类型与位置信息；
仅对明确支持的节点类型，才覆写对应方法并添加业务逻辑。

以下是一个精简示例，针对仅支持 SELECT ... FROM ... WHERE ... = ... 的场景：

public class StrictSelectVisitor implements StatementVisitor, ExpressionVisitor {
    @Override
    public void visit(Select select) {
        select.getSelectBody().accept(this);
    }

    @Override
    public void visit(PlainSelect plainSelect) {
        plainSelect.getSelectItems().forEach(item -> item.accept(this));
        plainSelect.getFromItem().accept(this);
        if (plainSelect.getWhere() != null) {
            plainSelect.getWhere().accept(this);
        }
        // 显式禁止 GROUP BY / HAVING / ORDER BY / LIMIT
        if (plainSelect.getGroupBy() != null) {
            throw new UnsupportedOperationException("GROUP BY is not supported");
        }
        if (plainSelect.getHaving() != null) {
            throw new UnsupportedOperationException("HAVING clause is not supported");
        }
        if (plainSelect.getOrderByElements() != null && !plainSelect.getOrderByElements().isEmpty()) {
            throw new UnsupportedOperationException("ORDER BY is not supported");
        }
    }

    @Override
    public void visit(Column column) {
        // 允许列引用
    }

    @Override
    public void visit(EqualsTo equalsTo) {
        equalsTo.getLeftExpression().accept(this);
        equalsTo.getRightExpression().accept(this);
    }

    // ⚠️ 关键：所有其他方法均抛出异常
    @Override public void visit(Insert insert) { throw unsupported("INSERT"); }
    @Override public void visit(Update update) { throw unsupported("UPDATE"); }
    @Override public void visit(Delete delete) { throw unsupported("DELETE"); }
    @Override public void visit(AndExpression andExpression) { andExpression.getLeftExpression().accept(this); andExpression.getRightExpression().accept(this); }
    // 其他表达式/语句方法同理...

    private RuntimeException unsupported(String feature) {
        return new UnsupportedOperationException("SQL feature not allowed: " + feature);
    }
}

使用时，直接将该 visitor 应用于解析后的 AST：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

CCJSqlParser parser = new CCJSqlParser(new StringReader(sql));
Statement stmt = parser.Statement();
stmt.accept(new StrictSelectVisitor()); // 若含不支持语法，此处立即抛异常

✅ 优势总结：