Struct QueryEngine 

pub struct QueryEngine { /* private fields */ }

Query engine - high-level interface for executing queries

Includes an LRU AST cache that eliminates repeated parsing overhead for identical queries. The cache is keyed by whitespace-normalized query strings and evicts least-recently-used entries when full.

Implementations

impl QueryEngine

pub fn new() -> QueryEngine

Create a new query engine with the default cache capacity (1024 entries)

pub fn with_capacity(capacity: usize) -> QueryEngine

Create a new query engine with a specific cache capacity

pub fn cache_stats(&self) -> &CacheStats

Return a reference to the cache statistics (hits/misses).

pub fn cache_len(&self) -> usize

Return the current number of entries in the cache.

pub fn strip_line_comments(input: &str) -> String

Split a query string on semicolons, respecting quoted strings. Returns individual statement strings (trimmed, non-empty). Strip // ... line comments (not inside strings). Returns a new string with comments removed.

pub fn split_statements(input: &str) -> Vec<&str>

pub fn execute( &self, query_str: &str, store: &GraphStore, ) -> Result<RecordBatch, Box<dyn Error>>

Parse and execute a read-only Cypher query (MATCH, RETURN, etc.) Supports multiple semicolon-separated statements.

pub fn execute_with_params( &self, query_str: &str, store: &GraphStore, params: &HashMap<String, PropertyValue>, ) -> Result<RecordBatch, Box<dyn Error>>

Execute a read-only query with parameters

pub fn execute_mut( &self, query_str: &str, store: &mut GraphStore, tenant_id: &str, ) -> Result<RecordBatch, Box<dyn Error>>

Parse and execute a write Cypher query (CREATE, DELETE, SET, etc.) Supports multiple semicolon-separated statements. Each statement sees the effects of previous statements (shared store). Also rewrites multi-CREATE queries to use WITH for variable sharing.

pub fn execute_mut_with_params( &self, query_str: &str, store: &mut GraphStore, tenant_id: &str, params: &HashMap<String, PropertyValue>, ) -> Result<RecordBatch, Box<dyn Error>>

Execute a write query with parameters

Trait Implementations

impl Default for QueryEngine

fn default() -> QueryEngine

Returns the “default value” for a type.