Class ASTHelper

src/main/java/org/codehaus/groovy/syntax/ASTHelper.java:36–271

Common base class providing shared AST helper methods used by both the classic and new parsers. Manages module-level information including the package, imports, and related AST construction utilities.

 * Manages module-level information including the package, imports, and related AST construction utilities.
 */
public class ASTHelper {

    /** The SourceUnit controlling this helper. */
    private SourceUnit controller;

    /** The ClassLoader providing information on external types. */
    private ClassLoader classLoader;

    /** The output module node being constructed. */
    protected ModuleNode output;

    /** The package name in which the module is located. */
    private String packageName;

    /** Static map for type resolutions, cleared on each build for safety. */
    protected static final Map resolutions = new HashMap();

    /**
     * Constructs an ASTHelper with a source unit and class loader.
     *
     * @param controller the {@link SourceUnit} that controls this helper
     * @param classLoader the {@link ClassLoader} for resolving external types
     */
    public ASTHelper(SourceUnit controller, ClassLoader classLoader) {
        this();
        this.controller = controller;
        this.classLoader = classLoader;
    }

    /**
     * Constructs an ASTHelper with no controller or class loader.
     * These must be set later via {@link #setController(SourceUnit)} and {@link #setClassLoader(ClassLoader)}.
     */
    public ASTHelper() {
    }

    /**
     * Returns the package name in which this module is located.
     *
     * @return the package name, or {@code null} if not set
     */
    public String getPackageName() {
        return packageName;
    }

    /**
     * Sets the package name for this module (without trailing dot).
     * Convenience method equivalent to {@code setPackage(packageName, new ArrayList<>())}.
     *
     * @param packageName the package name
     */
    public void setPackageName(String packageName) {
        setPackage(packageName, new ArrayList<>());
    }

    /**
     * Sets the package for this module with optional annotations.
     *