Skip to content

README-ZH.md

Latest commit

 

History

History
104 lines (81 loc) · 2.89 KB

README-ZH.md

File metadata and controls

104 lines (81 loc) · 2.89 KB
Raw

Simple Java Ops DSL

English Documentation

项目亮点

  • DSL 转换为 SpEL：将自定义 DSL 表达式转换为 Spring 表达式语言 (SpEL)。
  • 支持 1 个 DSL 转换为 N 个 SpEL：将一个 DSL 表达式转换为多个 SpEL 表达式。
  • 动态方法调用：支持动态调用 Java 方法和 Groovy 脚本。

特性

  • 逻辑表达式解析：解析和评估带有自定义条件的逻辑表达式。
  • 函数调用：支持在表达式中调用函数。
  • 字面量处理：处理表达式中的字符串和数字字面量。
  • 动态 Groovy 脚本执行：在表达式中动态执行 Groovy 脚本。

快速启动

  1. 克隆仓库：

    git clone https://github.com/yourusername/your-repo-name.git
cd your-repo-name

  2. 使用 Maven 构建项目：

    mvn clean install

  3. 运行应用程序：

    mvn exec:java -Dexec.mainClass="com.ze.gao.App"

  4. 示例用法：

    • 修改 App.java 中的 input 字符串以测试不同的 DSL 表达式。
    • 运行应用程序以查看转换后的 SpEL 及其对 Contract 对象的影响。

语法说明

grammar SimpleParser;

// 顶层语法规则
statement: assignment | expression ;

// 赋值语句
assignment: leftExpression '=' rightExpression ;

// 左值表达式（只能是路径表达式）
leftExpression: pathExpression ;

// 右值表达式（支持所有表达式类型）
rightExpression: expression ;

// 表达式
expression: pathExpression
          | literal
          | functionCall ;

// 路径表达式
pathExpression: identifier ( '.' pathComponent )* ;
pathComponent: identifier | arrayAccess ;

// 数组访问与过滤
arrayAccess: identifier '[' filterExpression ']' ;
filterExpression: simpleFilter
                | numberFilter
                | wildcardFilter
                | functionCall
                | logicalExpression ;

numberFilter: numberLiteral ;
wildcardFilter: '*' ;

// 简单过滤器
simpleFilter: identifier ':' literal ;

// 逻辑表达式
logicalExpression: condition ( logicalOperator condition )* ;
condition: identifier comparisonOperator ( literal | expression ) ;
logicalOperator: 'and' | 'or' ;
comparisonOperator: '=' | '!=' | '>' | '<' | '>=' | '<=' ;

// 函数调用
functionCall: identifier '(' functionArgs ')' ;
functionArgs: functionArg ( ',' functionArg )* ;
functionArg: literal | pathExpression ;

// 基础元素
identifier: LETTER ( LETTER | DIGIT )* ;
LETTER: [A-Za-z_] ;
DIGIT: [0-9] ;

// 字面量
literal: stringLiteral | numberLiteral ;
stringLiteral: '\'' (~'\'' | '\\\'' | '\\\\')* '\'' ; // 支持转义字符
numberLiteral: DIGIT+ ( '.' DIGIT+ )? ;

// 忽略空白字符和注释
WS: [ \t\r\n]+ -> skip ;
SL_COMMENT: '//' ~[\r\n]* -> skip ;
ML_COMMENT: '/*' .*? '*/' -> skip ;

许可证

此项目使用 MIT 许可证。详情请参阅 LICENSE 文件。