Skip to content

GROOVY-12570: let super.m() reach a package-private method of a superclass of another class loader - #3099

Open
codeconsole wants to merge 24 commits into
apache:masterfrom
codeconsole:c2-super-package-private-method
Open

codeconsole wants to merge 24 commits into
apache:masterfrom
codeconsole:c2-super-package-private-method

Conversation

@codeconsole

Copy link
Copy Markdown
Contributor

A class that declares m() and calls super.m(), where m() is package-private in a superclass with the same package name but defined by another class loader (for example a class of an earlier parse of the same GroovyShell), failed with MissingMethodException. The JVM does not let the subclass method override a package-private method of another run-time package, so no super$ method can call it; without one, the meta-class removed the subclass method from the methods for super calls and kept nothing, as the superclass method had already been replaced by the subclass method in the index.

The meta-class now keeps the superclass method for super calls in that case. Invoked reflectively it is the superclass method, because the JVM does not consider it overridden. Super calls that a super$ method serves, and package-private methods of another package, are unchanged.

This needs #3097, which stops generating a super$ method for a package-private method of another run-time package and routes the statically compiled call through the meta-class; its commits are included until it is merged. It touches the same lines of MetaClassImpl as #3048, so whichever is merged second needs a rebase.

Tests

bugs.Groovy12568.testSuperCallOfPackagePrivateMethodOfClassOfAnotherClassLoaderWithMethodOfSameName (marked // GROOVY-12570), dynamic and @CompileStatic, with and without invokedynamic; it fails without the change.

bugs, groovy.ThisAndSuperTest, groovy.lang.* and StaticCompileRuntimePackageTest pass (1,144 tests), as do the Checkstyle and CodeNarc gates.

…h new directly only within the compilation unit

Under static compilation, new A(...) of a protected or package-private
constructor of a class with the same package name was compiled to NEW and
INVOKESPECIAL. The JVM allows that call only within the same run-time
package, which is the package name and the class loader, so it failed
with IllegalAccessError when A came from another class loader: a class of
an earlier parse of the same GroovyShell, which GroovyClassLoader defines
with another InnerLoader, or a precompiled class used by a script.
Dynamic and type-checked code create such an object through the
meta-class and work.

Such a constructor is now called directly only when its class is
compiled in the same compilation unit, which defines all its classes with
one class loader, as for a constructor reference. Otherwise the object is
created through the meta-class, which selects the constructor at run
time. This also applies to the no-argument constructor that a map-style
construction such as new A(name: 'x') calls before it sets the
properties. Public constructors, and constructors of classes of the same
compilation unit, are still called directly. The constructor reference
writer uses the same check.
… only within the compilation unit

Under static compilation, a call to a protected or package-private method
of a class with the same package name was compiled to a direct
INVOKEVIRTUAL, INVOKESTATIC or INVOKESPECIAL. As for a constructor, the
JVM allows that call only within the same run-time package, so it failed
with IllegalAccessError when the class came from another class loader, for
example a class of an earlier parse of the same GroovyShell. This also hit
a protected or package-private getter or setter used as a property, such
as a.name or a.name = value.

Such a method is now called directly only when its class is compiled in
the same compilation unit, or when the JVM allows the call from any
package: a protected method called from a subclass on this, super or a
receiver of the subclass type, or a protected static method called from a
subclass. Otherwise the method is selected at run time through the
meta-class, as dynamic code does. Public methods, and methods of classes
of the same compilation unit, are still called directly.
…nother compilation unit through a synthetic method

A statically compiled method reference such as m::pm, M::pm or M::spm
gives LambdaMetafactory a method handle for the method. For a protected or
package-private method of a class with the same package name, the JVM
resolves that handle only within the same run-time package, so the
reference failed with IllegalAccessError when the class came from another
class loader, for example a class of an earlier parse of the same
GroovyShell.

For such a method of a class of another compilation unit, the reference
now targets a synthetic static method of the current class that calls the
method. The invocation writer compiles that call directly when the JVM
allows it from any package (a protected method called through the
subclass), or else selects the method at run time. Method references to
methods of classes of the same compilation unit, and to public methods,
still use a method handle for the method itself.
…ly within the compilation unit

AsmClassGenerator.isFieldDirectlyAccessible decided by the package name
if a protected or package-private field can be read or written with
GETFIELD, PUTFIELD, GETSTATIC or PUTSTATIC. As for methods and
constructors, the JVM allows that only within the same run-time package,
so the access failed with IllegalAccessError when the class came from
another class loader, for example a class of an earlier parse of the same
GroovyShell. Under static compilation this hit a.field, a.@field, Type.field,
an implicit field of a superclass, compound assignments and increments.
Dynamic code hit it for super.field, super.@field and this.@field of a
superclass. A protected field of a superclass with the same package name
but of another compilation unit was also read through a receiver of the
superclass type, which fails verification ("Bad access to protected data
in getfield") when the classes are in different run-time packages.

Such a field is now accessed directly only when its class is compiled in
the same compilation unit, or through the subclass rule for a protected
field (with a receiver of the current class). Otherwise it is read and
written through the meta-class, as dynamic code does. Public fields, and
fields of classes of the same compilation unit, are still accessed
directly.
…ckage instead of failing verification

Outside its package, a protected constructor can only be called by
super(...) or by creating an anonymous inner class (JLS 6.6.2.2). The type
checker accepts new A(...) of such a constructor in a subclass of A, as it
accepts other protected members there, and type-checked code creates the
object through the meta-class. Under static compilation, the call was
compiled to NEW and INVOKESPECIAL, and the class failed verification when
it was loaded: "VerifyError: Bad access to protected <init> method". The
same happened for a map-style construction such as new A([:]), which calls
the protected no-argument constructor.

The static compiler now reports "Cannot call protected constructor for A
from class B", as it reports a protected method called on a receiver that
is not the subclass (GROOVY-7325). super(...), this(...) and
new A(...) {} still call the constructor directly. A constructor reference
A::new to such a constructor still selects it at run time.
… through a superclass receiver

Outside its package, a protected instance method or field can be used
only through a receiver of the subclass (JLS 6.6.2.1, JVMS 4.10.1.8). For
a method, the static compiler meant to report such a call (GROOVY-7325),
but its check compared the types the wrong way round: it tested whether
the current class is a subtype of the receiver type instead of the
reverse. So a.m() with a receiver of the superclass type, in a subclass in
another package, was compiled to a direct call and the class failed
verification: "VerifyError: Bad access to protected data in
invokevirtual". This also hit a protected getter or setter used as a
property (a.name, a.name = value). A method reference such as a::m or
A::m to such a method failed with BootstrapMethodError, and an attribute
assignment a.@field = value failed verification in putfield.

The check now requires the receiver to be of the current class (or this,
super or a static method), so such a call or method reference is reported
as "Cannot access method", as GROOVY-7325 intended and as javac does. An
attribute assignment through such a receiver is now made through the
meta-class, as the attribute read a.@field already was. Calls through
this, super or a receiver of the subclass type are still direct.
…amic cannot access the constructor

A dynamic new of a protected constructor of another package, in a
subclass, is accepted by Groovy and by the type checker. With
invokedynamic, the constructor selector unreflected the selected
constructor with the lookup of the calling class and turned an
IllegalAccessException into GroovyBugError. For a constructor that the JVM
refuses to the caller, such as the protected ObjectInputStream() of the
encapsulated java.io package called by new in a subclass, the call failed
with "BUG! UNCAUGHT EXCEPTION: member is protected".

As the property selectors do since GROOVY-12314, the constructor selector
now treats the refusal as an access-control outcome and leaves the call to
the meta-class, which reports "could not access constructor", as the call
does without invokedynamic. A constructor that reflection can reach, such
as a protected constructor of a class of another package in the unnamed
module, is still called.
…ethod of another run-time package

For a dynamic super.m() call, the class gets a synthetic super$N$m method
that calls the superclass method with INVOKESPECIAL. For a package-private
method of a superclass with the same package name but of another
compilation unit, the classes may be in different run-time packages, for
example when the superclass comes from an earlier parse of the same
GroovyShell, and the JVM refuses the call: super.m() failed with
IllegalAccessError.

Such a method, and a package-private method of a superclass of another
package, no longer gets a super$ method, and the meta-class calls the
superclass method reflectively, as it does for a statically compiled
super.m() of such a method.
…ugh the meta-class only for classes defined in memory

The previous commits accessed a protected or package-private member of a
class with the same package name through the meta-class whenever that
class was compiled by another compilation unit. That also hit class files:
a Java class of a joint compilation, a main class used by a test, a class
left over from an incremental compilation. Such classes are loaded by one
class loader at run time, as javac assumes, so the direct access worked;
the meta-class path was slower, followed meta-class semantics, needed
reflection metadata in a native image, and made an incremental build give
other bytecode than a full one.

The run-time package of such a class only differs when the classes are
defined in memory by a GroovyClassLoader, which defines each compilation
(a GroovyShell script, parseClass, JSR-223) with an InnerLoader of its
own. GroovyClassLoader now records that on the compilation unit, and
AsmClassGenerator.isInSameRuntimePackage treats a class of another
compilation unit as another run-time package only then. Constructors,
map-style construction, methods, getters and setters, method references,
fields, dynamic super and this.@ access and super$ methods all use this
check. Compiling to class files keeps direct access, as before these
changes and as javac does.

(The rest of the change: new, map-style construction, methods, getters
and setters, method references to methods, fields, dynamic super and
this.@ access and super$ methods. The GroovyClassLoader marker,
isInSameRuntimePackage and constructor references come first.)
The tests for protected and package-private members of a class of
another compilation now compile it through a GroovyClassLoader, which
defines it with another class loader; classes compiled to class files keep
direct access. Name the tests accordingly.
…rules of constructor references

- isInSameRuntimePackage: isPrimaryClassNode() stands for "defined by the
  class loader of the accessing class", not for "compiled from source".
- StaticInvocationWriter.isDirectlyAccessible: unlike
  isMemberDirectlyAccessible it has no subclass rule, since the verifier
  rejects NEW and INVOKESPECIAL of a protected constructor of another
  package in a subclass too.
- findConstructorReferenceTarget: a selected constructor is called
  directly, so a meta-class constructor override is not used, as for a
  statically compiled new. The guard comment now says why enums are left
  to the meta-class: the type checker accepts an enum constructor reference
  whose arguments match the generated constructor, but Java code cannot
  instantiate an enum.
- addSyntheticMethod: the ACC_FINAL rule of JVMS 4.6 applies to every helper
  method of a method reference in an interface.

(The part on statically compiled new; the rest comes with constructor
references.)
… interface

All helper methods that a method reference adds to the current class are
created by addSyntheticMethod, which leaves out ACC_FINAL in an interface.
The interface tests covered the constructor-reference and variadic
helpers; they now also cover the array constructor reference, the static
extension method helper (Thread::startDaemon), the Class method helper
(String::getName) and the helper that calls a package-private method of a
class of another class loader (M::spm, M::pm), in static and default
methods, and check that every helper is private and not final. With
ACC_FINAL put back, both tests fail with ClassFormatError (illegal
modifiers 0x101A).

(The case of a method of another run-time package; the other helper
methods are tested with constructor references.)
…AbstractBytecodeTestCase

MethodReferenceTest and StaticCompileRuntimePackageTest each had a copy of
the helper that compiles a script against the classes of an earlier parse
of the same GroovyClassLoader, and of the code that keeps only the
instructions of one method. AbstractBytecodeTestCase now provides them as
compileAgainstLibrary, extractMethodSequence and selectMethod, and both
tests use them. Test code only; the tests are unchanged.

(Here StaticCompileRuntimePackageTest; MethodReferenceTest was moved to
the helpers with constructor references.)
…errors

COMPATIBILITY.md describes how statically compiled code of a compilation
that a GroovyClassLoader defines in memory reaches protected and
package-private members of classes of other compilations, and the new
compile errors for new of a protected constructor of another package and
for a protected method of another package called through a superclass
receiver. StaticInvocationWriter notes that the constructor error is
reported during class generation, so @TypeChecked code is not checked for
it and works dynamically.
…ass of another class loader

Since GROOVY-12454, new A(map) with a Map variable, under static
compilation, calls the no-argument constructor and then sets the
properties of the map at run time. For a class of an earlier parse of the
same GroovyShell whose no-argument constructor is package-private, the
constructor is called through the meta-class, as for a map literal.
…class of another class loader

A class that declares m() and calls super.m(), where m() is package-private
in a superclass with the same package name but defined by another class
loader, for example a class of an earlier parse of the same GroovyShell,
failed with MissingMethodException. The JVM does not let the subclass
method override a package-private method of another run-time package, so
no super$ method can call it; without one, the meta-class removed the
subclass method from the methods for super calls and kept nothing, as the
superclass method had already been replaced by the subclass method in the
index.

The meta-class now keeps the superclass method for super calls in that
case. Invoked reflectively it is the superclass method, because the JVM
does not consider it overridden. Super calls that a super$ method serves,
and package-private methods of another package, are unchanged.
@codecov-commenter

codecov-commenter commented Oct 30, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 84.48276% with 18 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.1745%. Comparing base (0cc667e) to head (84c3d3d).
⚠️ Report is 1 commits behind head on master.

Files with missing lines Patch % Lines
...sc/StaticTypesMethodReferenceExpressionWriter.java 86.8421% 0 Missing and 5 partials ⚠️
...groovy/classgen/asm/sc/StaticInvocationWriter.java 80.9524% 0 Missing and 4 partials ⚠️
...ovy/classgen/asm/sc/StaticTypesCallSiteWriter.java 75.0000% 0 Missing and 4 partials ⚠️
...rm/sc/transformers/ConstructorCallTransformer.java 83.3333% 0 Missing and 3 partials ⚠️
...rg/codehaus/groovy/classgen/AsmClassGenerator.java 85.7143% 0 Missing and 1 partial ⚠️
...java/org/codehaus/groovy/vmplugin/v8/Selector.java 50.0000% 0 Missing and 1 partial ⚠️
Additional details and impacted files

Impacted file tree graph

@@                Coverage Diff                 @@
##               master      #3099        +/-   ##
==================================================
+ Coverage     74.1374%   74.1745%   +0.0372%     
- Complexity      43718      43786        +68     
==================================================
  Files            1692       1692                
  Lines          149513     149612        +99     
  Branches        28359      28403        +44     
==================================================
+ Hits           110845     110974       +129     
+ Misses          28458      28422        -36     
- Partials        10210      10216         +6     
Files with missing lines Coverage Δ
src/main/java/groovy/lang/MetaClassImpl.java 79.6235% <100.0000%> (+0.4591%) ⬆️
...va/org/codehaus/groovy/classgen/asm/MopWriter.java 86.0760% <100.0000%> (+0.1785%) ⬆️
...rg/codehaus/groovy/classgen/AsmClassGenerator.java 85.9375% <85.7143%> (+0.0501%) ⬆️
...java/org/codehaus/groovy/vmplugin/v8/Selector.java 81.4262% <50.0000%> (+0.1970%) ⬆️
...rm/sc/transformers/ConstructorCallTransformer.java 94.0298% <83.3333%> (-1.1702%) ⬇️
...groovy/classgen/asm/sc/StaticInvocationWriter.java 77.8793% <80.9524%> (+0.4600%) ⬆️
...ovy/classgen/asm/sc/StaticTypesCallSiteWriter.java 80.4436% <75.0000%> (+2.4810%) ⬆️
...sc/StaticTypesMethodReferenceExpressionWriter.java 89.3082% <86.8421%> (-0.0100%) ⬇️

... and 17 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@daniellansun daniellansun left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GROOVY-12570 diagnosis matches the JVM rule: a subclass method does not override a package-private method of another run-time package, so no super$ MOP bridge can reach it; reflective invoke of the superclass method is what super.m() must do.

MetaClassImpl.superMethodOfAnotherRuntimePackage (replace in the super index when notSuperUseful would otherwise drop the entry) is the right place. Test covers dynamic + @CompileStatic, indy on/off, and both super.pm() and overriding pm().

Please before approve:

  1. Re-run lts (17, windows-latest, 1) (60m timeout).
  2. Confirm search order: the first superclass method with the same name+params wins, and returns null if that match is not package-private/other-loader — so an intermediate same-loader override correctly suppresses a deeper foreign package-private. Worth a one-line comment on that early-return, and maybe a Mid/B/C fixture if not already implied by #3097 tests.
  3. Codecov still shows partials on the shared #3097 surface plus MetaClassImpl (~62% on the new lines) — a direct assert on the super-index entry would help.

Depends on #3097; sibling of #3098.

@codeconsole

Copy link
Copy Markdown
Contributor Author

@daniellansun

  1. CI: the push of this commit starts a new run.

  2. Search order. superMethodOfAnotherRuntimePackage returns from the inner loop at the first superclass method with the same name and parameters. That nearest method is used only if it is package-private of another run-time package; otherwise the method returns null and the entry is dropped as before, so it hides any deeper method. Added the comment on that return (ef2eeba).

    Groovy12568.testSuperCallReachesNearestSuperclassMethodOfSameNameAndParameters (indy on and off) has A in loader 1 with a package-private pm(), and four intermediate classes extending it: MidOfOtherLoader (package-private pm()), PublicMid (public pm()) and MidWithoutPm in loader 2, and MidOfSameLoader (package-private pm()) in loader 3, the subclasses' loader. For each, a dynamic D… and a @CompileStatic S… subclass override pm() and call super.pm(); each call reaches the nearest method (MidOfOtherLoader, PublicMid, A, MidOfSameLoader), never a deeper A.pm(). A dynamic D reaches a public or same-run-time-package intermediate through its super$ method, so the early return decides the entry only for a class without one, such as S; the test asserts the meta-class has no super entry there rather than A.pm(), and fails if the loop goes on past the nearest method. testSuperCallOfPackagePrivateMethodOfClassOfAnotherPackage checks the package-name condition: for p.B extends q.M, super.pm() still throws MissingMethodException.

  3. Super index entry. MetaClassImpl.getMethodWithoutCaching(sender, name, types, true) is public and returns the super index entry as it is. testSuperMethodsOfMetaClassForPackagePrivateMethodsOfClassOfAnotherClassLoader asserts that B's super entries are M's methods and that invoking them runs M's code, for the overloads pm() and pm(String) (a FastArray entry) and qm() (a single entry), and that the non-super lookup still gives B's methods; the search-order test checks the super entry of each of its 8 classes. I also removed the isDGM(method) check from superMethodOfAnotherRuntimePackage: notSuperUseful, which guards both calls, already excludes DGM methods. All lines and branches of the MetaClassImpl change are covered now; the other partials Codecov shows here are GROOVY-12568: SC: reach protected and package-private members of a class of another GroovyClassLoader compilation through the meta-class #3097's lines.

The new tests fail without the change (MissingMethodException for pm, and no super entry). The Checkstyle and CodeNarc gates pass.

# Conflicts:
#	src/main/java/org/codehaus/groovy/classgen/asm/sc/StaticTypesMethodReferenceExpressionWriter.java
…to the language rule

For a public or private field the language rule of isMemberDirectlyAccessible
decides. For a protected or package-private field, JVMS 5.4.4 allows access
from the run-time package of the declaring class, or to a protected field
from a subclass. That condition implies isMemberDirectlyAccessible, so it
replaces it there instead of being checked after it.
@codeconsole

Copy link
Copy Markdown
Contributor Author

Merged the updated #3097 (master, now with #3022, and the simplified isFieldDirectlyAccessible). MethodReferenceTest.testMethodReferencesInStaticAndDefaultMethodsOfInterface fails on master itself since #3056; #3116 fixes it.

…ivate-method

# Conflicts:
#	COMPATIBILITY.md
@testlens-app

testlens-app Bot commented Nov 4, 2026

Copy link
Copy Markdown

✅ All tests passed ✅

🏷️ Commit: 84c3d3d
▶️ Tests: 124369 executed
⚪️ Checks: 27/27 completed


Learn more about TestLens at testlens.app/docs.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants