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

Class CorpusLoader

java.lang.Object

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

public final class CorpusLoader
extends Object

Loads the ANTLR Java runtime sources that are already packaged as resources of antlr4-perf-testsuite (see ../runtime resource directory in the module POM). The corpus approximates multi-file language front-end workloads (e.g. Groovy serial/parallel compilation).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CorpusLoader.SourceFile

Field Summary

Fields

Modifier and Type	Field	Description
static final String	RUNTIME_SRC_ROOT	Resource root of the Java runtime sources inside the test classpath.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	CorpusLoader()

Method Summary

Modifier and Type	Method	Description
static List<CorpusLoader.SourceFile>	loadAcceptedOrSynthetic(int maxFiles, int minAccepted)	Prefer real runtime sources that the bundled grammar accepts; if fewer than minAccepted survive, fall back to a synthetic corpus of maxFiles units so A/B runs remain comparable.
private static List<CorpusLoader.SourceFile>	loadAllUnder(String rootResource, String suffix)
static CorpusLoader.SourceFile	loadLargest(String relativeUnderRuntimeSrc)
static CorpusLoader.SourceFile	loadParserJava()	Load a single well-known large file used by the historical lexer bench.
static List<CorpusLoader.SourceFile>	loadRuntimeJavaSources()	Load every .java file under the packaged runtime sources.
static List<CorpusLoader.SourceFile>	loadRuntimeJavaSources(int maxFiles)	Load up to maxFiles largest runtime .java sources (stable tie-break by path).
private static String	readResource(String resource)
static List<CorpusLoader.SourceFile>	syntheticJava7Corpus(int fileCount, int methodsPerFile)	Build a deterministic synthetic Java 1.7-shaped corpus that the bundled Java.g4 accepts fully.
static int	totalChars(List<CorpusLoader.SourceFile> files)
private static void	walk(Path root, Path start, String suffix, List<CorpusLoader.SourceFile> out)

Methods inherited from class java.lang.Object

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

Field Details

RUNTIME_SRC_ROOT

public static final String RUNTIME_SRC_ROOT

Resource root of the Java runtime sources inside the test classpath.

See Also:

• Constant Field Values

Constructor Details

CorpusLoader

private CorpusLoader()

Method Details

loadRuntimeJavaSources

public static List<CorpusLoader.SourceFile> loadRuntimeJavaSources()
                                                            throws IOException

Load every .java file under the packaged runtime sources. Results are sorted by path for stable iteration order across runs.

Throws:

IOException

loadRuntimeJavaSources

public static List<CorpusLoader.SourceFile> loadRuntimeJavaSources(int maxFiles)
                                                            throws IOException

Load up to maxFiles largest runtime .java sources (stable tie-break by path). Useful for keeping JMH iterations bounded.

Throws:

IOException

loadParserJava

public static CorpusLoader.SourceFile loadParserJava()
                                              throws IOException

Load a single well-known large file used by the historical lexer bench.

Throws:

IOException

loadLargest

public static CorpusLoader.SourceFile loadLargest(String relativeUnderRuntimeSrc)
                                           throws IOException

Throws:

IOException

totalChars

public static int totalChars(List<CorpusLoader.SourceFile> files)

syntheticJava7Corpus

public static List<CorpusLoader.SourceFile> syntheticJava7Corpus(int fileCount,
 int methodsPerFile)

Build a deterministic synthetic Java 1.7-shaped corpus that the bundled Java.g4 accepts fully. Sized to stress lexer/parser without depending on real-world language level drift in runtime sources.

Parameters:

fileCount - number of compilation units

methodsPerFile - methods per class (drives expression/statement load)

loadAcceptedOrSynthetic

public static List<CorpusLoader.SourceFile> loadAcceptedOrSynthetic(int maxFiles,
 int minAccepted)
                                                             throws IOException

Prefer real runtime sources that the bundled grammar accepts; if fewer than minAccepted survive, fall back to a synthetic corpus of maxFiles units so A/B runs remain comparable.

Throws:

IOException

loadAllUnder

private static List<CorpusLoader.SourceFile> loadAllUnder(String rootResource,
 String suffix)
                                                   throws IOException

Throws:

IOException

walk

private static void walk(Path root,
 Path start,
 String suffix,
 List<CorpusLoader.SourceFile> out)
                  throws IOException

Throws:

IOException

readResource

private static String readResource(String resource)
                            throws IOException

Throws:

IOException