Record Class IdentifierNode

java.lang.Object
java.lang.Record
cloud.opencode.base.expression.ast.IdentifierNode
Record Components:
name - the identifier name | 标识符名称
All Implemented Interfaces:
Node
public record IdentifierNode(String name) extends Record implements Node
Identifier Node 标识符节点

Represents variable references in expressions.

表示表达式中的变量引用。

Features | 主要功能:

  • Variable lookup with # prefix support - 支持#前缀的变量查找
  • Special identifiers: #root, #this - 特殊标识符: #root, #this
  • Fallback to root object property access - 回退到根对象属性访问

Usage Examples | 使用示例:

Node id = IdentifierNode.of("name");
ctx.setVariable("name", "John");
Object result = id.evaluate(ctx);  // "John"

Node root = IdentifierNode.of("#root");
Object rootObj = root.evaluate(ctx);

Security | 安全性:

  • Thread-safe: Yes, immutable record - 线程安全: 是，不可变记录
  • Null-safe: No, null/blank name rejected at construction - 空值安全: 否，null/空名称在构造时被拒绝
Since:
JDK 25, opencode-base-expression V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • IdentifierNode

      public IdentifierNode(String name)
      Create identifier node 创建标识符节点
      Parameters:
      name - the identifier name | 标识符名称

  • Method Details

    • of

      public static IdentifierNode of(String name)
      Create identifier node 创建标识符节点
      Parameters:
      name - the identifier name | 标识符名称
      Returns:
      the identifier node | 标识符节点

    • evaluate

      public Object evaluate(EvaluationContext context)
      Description copied from interface: Node
      Evaluate this node 求值此节点
      Specified by:
      evaluate in interface Node
      Parameters:
      context - the evaluation context | 求值上下文
      Returns:
      the evaluation result | 求值结果

    • toExpressionString

      public String toExpressionString()
      Description copied from interface: Node
      Get string representation for debugging 获取用于调试的字符串表示
      Specified by:
      toExpressionString in interface Node
      Returns:
      the string representation | 字符串表示

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • name

      public String name()
      Returns the value of the name record component.
      Returns:
      the value of the name record component