Struct ExecutionContext 

pub struct ExecutionContext { /* private fields */ }

Execution context for query cancellation support.

This struct provides a mechanism for gracefully cancelling long-running queries via cancellation tokens, enabling proper cleanup and error reporting when:

• A client connection closes
• A user explicitly cancels a query
• A system shutdown is initiated

Example

// Requires: a running tokio runtime and an Executor with a live database adapter.
// See: tests/integration/ for runnable examples.
use fraiseql_core::runtime::ExecutionContext;
use std::time::Duration;

let ctx = ExecutionContext::new("query-123".to_string());

// Spawn a task that cancels after 5 seconds
let cancel_token = ctx.cancellation_token().clone();
tokio::spawn(async move {
    tokio::time::sleep(Duration::from_secs(5)).await;
    cancel_token.cancel();
});

// Execute query with cancellation support
// let result = executor.execute_with_context(query, None, &ctx).await;

Implementations

impl ExecutionContext

pub fn new(query_id: String) -> Self

Create a new execution context with a cancellation token.

Arguments

• query_id - Unique identifier for this query execution

Example

let ctx = ExecutionContext::new("user-query-001".to_string());
assert_eq!(ctx.query_id(), "user-query-001");

pub fn query_id(&self) -> &str

Get the query ID.

pub const fn cancellation_token(&self) -> &CancellationToken

Get a reference to the cancellation token.

The returned token can be used to:

• Clone and pass to background tasks
• Check if cancellation was requested
• Propagate cancellation through the call stack

pub fn is_cancelled(&self) -> bool

Check if cancellation has been requested.

Trait Implementations

impl Clone for ExecutionContext

fn clone(&self) -> ExecutionContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExecutionContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.