QueryBatchRunner (YABR)

tonic@yabr:~$ Source Portfolio tonicbox.dev

java.lang.Object
- com.tonic.analysis.query.exec.QueryBatchRunner

```
public class QueryBatchRunner
extends Object
```
Executor of a ProbePlan over a class pool, evaluating the query condition on every candidate the plan's scope filter admits and projecting each hit into a QueryMatch carrying the evaluator's evidence.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`static interface`	`QueryBatchRunner.ProgressListener`	Callback for run progress, invoked on the thread executing the run.
`static class`	`QueryBatchRunner.QueryBatchResult`	The outcome of one run - the ordered matches plus whether the run was cut short by cancellation.

Constructor Summary

Constructors
Constructor Description

QueryBatchRunner(ClassPool classPool)
Creates a runner over a pool, defaulting to a 60 second budget and no user-class restriction.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`cancel()`	Requests that an in-flight run stop at the next candidate; the flag is cleared when a run starts.
`QueryBatchRunner.QueryBatchResult`	`run(ProbePlan plan, QueryBatchRunner.ProgressListener listener)`	Evaluates the plan's condition over every class or method the scope filter admits, then applies the query's ordering and limit.
`void`	`setTimeBudgetMs(long ms)`	Sets the wall-clock budget after which a run stops early and reports what it has.
`void`	`setUserClassNames(Set<String> userClassNames)`	Restricts the search to named classes; a null or empty set searches the whole pool.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - QueryBatchRunner
```
public QueryBatchRunner(ClassPool classPool)
```
    Creates a runner over a pool, defaulting to a 60 second budget and no user-class restriction.
    
    Parameters:
    
    classPool - the classes to search
- Method Detail
  - setUserClassNames
```
public void setUserClassNames(Set<String> userClassNames)
```
    Restricts the search to named classes; a null or empty set searches the whole pool.
    
    Parameters:
    
    userClassNames - the class names to keep
  - setTimeBudgetMs
```
public void setTimeBudgetMs(long ms)
```
    Sets the wall-clock budget after which a run stops early and reports what it has.
    
    Parameters:
    
    ms - the budget in milliseconds
  - cancel
```
public void cancel()
```
    Requests that an in-flight run stop at the next candidate; the flag is cleared when a run starts.
  - run
```
public QueryBatchRunner.QueryBatchResult run(ProbePlan plan,
                                             QueryBatchRunner.ProgressListener listener)
```
    Evaluates the plan's condition over every class or method the scope filter admits, then applies the query's ordering and limit.
    
    Parameters:
    
    plan - the planned query
    
    listener - notified of phase start, progress every 200 methods, and completion, or null
    
    Returns:
    
    the matches and whether the run was cancelled