Record Class InNode

java.lang.Object
java.lang.Record
cloud.opencode.base.expression.ast.InNode
Record Components:
value - the value to test | 要测试的值
collection - the collection to test against | 要测试的集合
All Implemented Interfaces:
Node
public record InNode(Node value, Node collection) extends Record implements Node
Membership Test Node 成员测试节点

Represents the in operator which tests whether a value is contained in a collection, array, or map key set.

表示 in 运算符，用于测试一个值是否包含在集合、数组或映射键集中。

Features | 主要功能:

  • Collection membership test via Collection.contains(Object) - 通过 Collection.contains 测试集合成员
  • Array membership test via linear scan - 通过线性扫描测试数组成员
  • Map key membership test via Map.containsKey(Object) - 通过 Map.containsKey 测试映射键成员

Usage Examples | 使用示例:

// status in {'active', 'pending', 'approved'}
Node in = InNode.of(statusNode, collectionNode);
Object result = in.evaluate(ctx);  // true or false

Security | 安全性:

  • Thread-safe: Yes, immutable record - 线程安全: 是，不可变记录
  • Null-safe: No, value and collection required non-null - 空值安全: 否，值和集合要求非空
Since:
JDK 25, opencode-base-expression V1.0.3
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Constructor Details

    • InNode

      public InNode(Node value, Node collection)
      Creates an instance of a InNode record class.
      Parameters:
      value - the value for the value record component
      collection - the value for the collection record component

  • Method Details

    • of

      public static InNode of(Node value, Node collection)
      Create membership test node 创建成员测试节点
      Parameters:
      value - the value to test | 要测试的值
      collection - the collection to test against | 要测试的集合
      Returns:
      the membership 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

    • collection

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