Record Class BetweenNode

java.lang.Object
java.lang.Record
cloud.opencode.base.expression.ast.BetweenNode
Record Components:
value - the value to test | 要测试的值
lower - the lower bound (inclusive) | 下界(包含)
upper - the upper bound (inclusive) | 上界(包含)
All Implemented Interfaces:
Node

public record BetweenNode(Node value, Node lower, Node upper) extends Record implements Node
Range Test Node 范围测试节点

Represents the between operator which tests whether a value falls within a range (inclusive on both ends).

表示 between 运算符,用于测试一个值是否在范围内(两端包含)。

Features | 主要功能:

  • Inclusive range test: lower <= value <= upper - 包含范围测试:下界 <= 值 <= 上界
  • Numeric comparison via doubleValue for Number types - 数值类型通过 doubleValue 比较
  • Comparable comparison for other types - 其他类型通过 Comparable 比较

Usage Examples | 使用示例:

// age between 18 and 65
Node between = BetweenNode.of(ageNode, lowerNode, upperNode);
Object result = between.evaluate(ctx);  // true or false

Security | 安全性:

  • Thread-safe: Yes, immutable record - 线程安全: 是,不可变记录
  • Null-safe: No, value/lower/upper required non-null - 空值安全: 否,值/下界/上界要求非空
Since:
JDK 25, opencode-base-expression V1.0.3
Author:
Leon Soo www.LeonSoo.com
See Also:
  • Constructor Details

    • BetweenNode

      public BetweenNode(Node value, Node lower, Node upper)
      Creates an instance of a BetweenNode record class.
      Parameters:
      value - the value for the value record component
      lower - the value for the lower record component
      upper - the value for the upper record component
  • Method Details

    • of

      public static BetweenNode of(Node value, Node lower, Node upper)
      Create range test node 创建范围测试节点
      Parameters:
      value - the value to test | 要测试的值
      lower - the lower bound (inclusive) | 下界(包含)
      upper - the upper bound (inclusive) | 上界(包含)
      Returns:
      the range test 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.
    • value

      public Node value()
      Returns the value of the value record component.
      Returns:
      the value of the value record component
    • lower

      public Node lower()
      Returns the value of the lower record component.
      Returns:
      the value of the lower record component
    • upper

      public Node upper()
      Returns the value of the upper record component.
      Returns:
      the value of the upper record component