Class QueryCompiler

java.lang.Object
org.litebridge.orm.engine.compiler.QueryCompiler

public final class QueryCompiler extends Object
Compiler for AST query nodes.

The compiler processes query node chains and producing PreparedOperation instances from them.

This class acts as a root-level query compiler that delegates responsibility to specialised compilers for different query types.

Specialised compilers are lazily initialised and maintained as private fields to ensure their reuse and improve performance.

This class is thread-safe.

  • Field Details

    • litebridgeContext

      protected final LitebridgeContext litebridgeContext
      The Litebridge context.
  • Constructor Details

    • QueryCompiler

      public QueryCompiler(LitebridgeContext litebridgeContext)
      Constructs a new QueryCompiler instance.
      Parameters:
      litebridgeContext - Current Litebridge context.
  • Method Details

    • compile

      public PreparedOperation compile(QueryNode node)
      Compiles a given query node into a prepared operation.

      This method resolves the appropriate query compiler for the root query node type and applies all nodes in the query chain to create a structured database operation along with its associated bind values.

      Parameters:
      node - the query node to be compiled
      Returns:
      a PreparedOperation containing the structured operation and bind values
      Throws:
      IllegalArgumentException - if the root query node type is unsupported
    • compile

      public PreparedOperation compile(QueryNode node, @Nullable List<SelectTarget> contextSelectTargets)
    • flatten

      protected static List<QueryNode> flatten(QueryNode node)
      Flattens the linked query node chain into a sequential list in root-to-leaf order.
      Parameters:
      node - the terminal query node
      Returns:
      the ordered list of query nodes