Package org.antlr.v4.test.runtime.java.api.perf.jmh

Class ParseWorkload

java.lang.Object

org.antlr.v4.test.runtime.java.api.perf.jmh.ParseWorkload

public final class ParseWorkload
extends Object

Shared parse/lex helpers for JMH and the comparative harness.

Threading model matches real multi-file front ends (Groovy, etc.):

• Each worker owns its own lexer/parser (simulators are not shared across concurrent predictions).
• DFA is stored on the static ATN and is therefore shared across workers when not cleared — the common "warm shared cache" case.
• clearDfa forces ATN simulation on the hot path (stresses retained scratch, HPPC maps, hash cache, sparse clear).

Language-specific construction is a ParseWorkload.FrontEnd. Java and the compact Groovy-like grammar share parseSerial(java.util.List<org.antlr.v4.test.runtime.java.api.perf.jmh.CorpusLoader.SourceFile>, org.antlr.v4.test.runtime.java.api.perf.jmh.ParseWorkload.PredictionStrategy, boolean, boolean) / parseParallel(java.util.List<org.antlr.v4.test.runtime.java.api.perf.jmh.CorpusLoader.SourceFile>, org.antlr.v4.test.runtime.java.api.perf.jmh.ParseWorkload.PredictionStrategy, boolean, boolean, int) instead of copying the thread pool.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ParseWorkload.FrontEnd	Lexer/parser factory for one generated language front end.
static enum	ParseWorkload.PredictionStrategy
static final class	ParseWorkload.Stats

Field Summary

Fields

Modifier and Type	Field	Description
static final ParseWorkload.FrontEnd	JAVA

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ParseWorkload()

Method Summary

Modifier and Type	Method	Description
static boolean	acceptsTwoStage(String text)	True if two-stage parse completes without throwing.
static boolean	acceptsTwoStage(ParseWorkload.FrontEnd frontEnd, String text)
static void	clearSharedDfa()
private static void	invokeJava(JavaParser parser, CommonTokenStream tokens, ParseWorkload.PredictionStrategy strategy, boolean buildTree)
static int	lexFile(String text, boolean clearDfa)
static int	lexFile(ParseWorkload.FrontEnd frontEnd, String text, boolean clearDfa)
static int	lexReuse(Lexer lexer, String text)	Rebind lexer to text and fill a token stream.
static int	parseFile(String text, ParseWorkload.PredictionStrategy strategy, boolean clearDfa, boolean buildTree)
static int	parseFile(ParseWorkload.FrontEnd frontEnd, String text, ParseWorkload.PredictionStrategy strategy, boolean clearDfa, boolean buildTree)
static ParseWorkload.Stats	parseParallel(List<CorpusLoader.SourceFile> files, ParseWorkload.PredictionStrategy strategy, boolean clearDfaAtStart, boolean buildTree, int threads)	Parse all files with threads workers (file-granularity parallelism).
static ParseWorkload.Stats	parseParallel(ParseWorkload.FrontEnd frontEnd, List<CorpusLoader.SourceFile> files, ParseWorkload.PredictionStrategy strategy, boolean clearDfaAtStart, boolean buildTree, int threads)
static ParseWorkload.Stats	parseSerial(List<CorpusLoader.SourceFile> files, ParseWorkload.PredictionStrategy strategy, boolean clearDfaPerFile, boolean buildTree)	Parse all files on the calling thread.
static ParseWorkload.Stats	parseSerial(ParseWorkload.FrontEnd frontEnd, List<CorpusLoader.SourceFile> files, ParseWorkload.PredictionStrategy strategy, boolean clearDfaPerFile, boolean buildTree)
private static void	runStartRule(ParseWorkload.FrontEnd frontEnd, Parser parser, CommonTokenStream tokens, ParseWorkload.PredictionStrategy strategy, boolean buildTree)
static void	touch()	Force class/ATN initialization and a tiny parse for JIT warmup helpers.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

JAVA

public static final ParseWorkload.FrontEnd JAVA

Constructor Details

ParseWorkload

private ParseWorkload()

Method Details

clearSharedDfa

public static void clearSharedDfa()

lexFile

public static int lexFile(String text,
 boolean clearDfa)

lexFile

public static int lexFile(ParseWorkload.FrontEnd frontEnd,
 String text,
 boolean clearDfa)

lexReuse

public static int lexReuse(Lexer lexer,
 String text)

Rebind lexer to text and fill a token stream. Exercises Lexer.setInputStream(org.antlr.v4.runtime.CharStream) / Lexer.reset() without allocating a new lexer class (IDE / REPL / batch reuse).

parseFile

public static int parseFile(String text,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfa,
 boolean buildTree)

Returns:

token count; never throws for ordinary syntax issues when using ParseWorkload.PredictionStrategy.LL or ParseWorkload.PredictionStrategy.TWO_STAGE (error recovery / two-stage retry). ParseWorkload.PredictionStrategy.SLL uses BailErrorStrategy and may throw ParseCancellationException.

invokeJava

private static void invokeJava(JavaParser parser,
 CommonTokenStream tokens,
 ParseWorkload.PredictionStrategy strategy,
 boolean buildTree)

parseFile

public static int parseFile(ParseWorkload.FrontEnd frontEnd,
 String text,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfa,
 boolean buildTree)

runStartRule

private static void runStartRule(ParseWorkload.FrontEnd frontEnd,
 Parser parser,
 CommonTokenStream tokens,
 ParseWorkload.PredictionStrategy strategy,
 boolean buildTree)

acceptsTwoStage

public static boolean acceptsTwoStage(String text)

True if two-stage parse completes without throwing.

acceptsTwoStage

public static boolean acceptsTwoStage(ParseWorkload.FrontEnd frontEnd,
 String text)

parseSerial

public static ParseWorkload.Stats parseSerial(List<CorpusLoader.SourceFile> files,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfaPerFile,
 boolean buildTree)

Parse all files on the calling thread.

Parameters:

clearDfaPerFile - when true, clear shared DFA before each file (serial-only ATN hot path; invalid under concurrent shared-ATN use)

parseSerial

public static ParseWorkload.Stats parseSerial(ParseWorkload.FrontEnd frontEnd,
 List<CorpusLoader.SourceFile> files,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfaPerFile,
 boolean buildTree)

parseParallel

public static ParseWorkload.Stats parseParallel(List<CorpusLoader.SourceFile> files,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfaAtStart,
 boolean buildTree,
 int threads)
                                         throws InterruptedException,
ExecutionException

Parse all files with threads workers (file-granularity parallelism). Each task uses its own lexer/parser; DFA is shared via the static ATN (Groovy-style parallel front end).

Parameters:

clearDfaAtStart - when true, clear shared DFA once before the batch so this iteration measures concurrent DFA construction; never clears per-file (would race on the shared ATN)

Throws:

InterruptedException

ExecutionException

parseParallel

public static ParseWorkload.Stats parseParallel(ParseWorkload.FrontEnd frontEnd,
 List<CorpusLoader.SourceFile> files,
 ParseWorkload.PredictionStrategy strategy,
 boolean clearDfaAtStart,
 boolean buildTree,
 int threads)
                                         throws InterruptedException,
ExecutionException

Throws:

InterruptedException

ExecutionException

touch

public static void touch()

Force class/ATN initialization and a tiny parse for JIT warmup helpers.