Rename getStaticReceiver to getStaticScope. GetStaticScope is supported only on meta object.

Author: tzezula

sdk/CHANGELOG.md

@@ -12,7 +12,7 @@ This changelog summarizes major changes between GraalVM SDK versions. The main f
 * GR-69590: Closing a garbage-collected engine or context now logs only the first failure by default. To log all failures, use `engine.CloseOnGCFailureAction.PrintAll`.
 * GR-35913: Updated the Javadoc of `Value#asHostObject()`, `Value#asNativePointer()`, and `Value#asProxyObject()` to clarify that these methods throw a `ClassCastException` rather than an `UnsupportedOperationException` when the value is not of the expected type.
 * GR-35913: `Value#asHostObject()` throws `UnsupportedOperationException` if object is allocated in a foreign heap.
-* GR-71402: Added `Value#hasStaticReceiver` and `Value#getStaticReceiver` returning the Value's static receiver.
+* GR-71402: Added `Value#hasStaticScope` and `Value#getStaticScope` returning the static scope representing static or class-level members associated with the meta object.
 
 ## Version 25.0.0
 * GR-60636 Truffle now stops compiling when the code cache fills up on HotSpot. A warning is printed when that happens.

sdk/src/org.graalvm.polyglot/snapshot.sigtest

@@ -598,7 +598,7 @@ meth public boolean hasIteratorNextElement()
 meth public boolean hasMember(java.lang.String)
 meth public boolean hasMembers()
 meth public boolean hasMetaParents()
-meth public boolean hasStaticReceiver()
+meth public boolean hasStaticScope()
 meth public boolean isBoolean()
 meth public boolean isBufferWritable()
 meth public boolean isDate()
@@ -660,7 +660,7 @@ meth public org.graalvm.polyglot.Value getIteratorNextElement()
 meth public org.graalvm.polyglot.Value getMember(java.lang.String)
 meth public org.graalvm.polyglot.Value getMetaObject()
 meth public org.graalvm.polyglot.Value getMetaParents()
-meth public org.graalvm.polyglot.Value getStaticReceiver()
+meth public org.graalvm.polyglot.Value getStaticScope()
 meth public short asShort()
 meth public short readBufferShort(java.nio.ByteOrder,long)
 meth public static org.graalvm.polyglot.Value asValue(java.lang.Object)

sdk/src/org.graalvm.polyglot/src/org/graalvm/polyglot/Value.java

@@ -1009,52 +1009,52 @@ public boolean removeMember(String identifier) {
     }
 
     /**
-     * Returns {@code true} if this value provides a {@linkplain #getStaticReceiver() static
-     * receiver}. A static receiver represents the static or class-level members associated with
-     * this value's type, such as static fields or methods.
+     * Returns {@code true} if this value is a {@linkplain #isMetaObject() meta object} that
+     * provides a {@linkplain #getStaticScope() static scope}. A static scope represents the static
+     * or class level members associated with the type described by this meta object, such as static
+     * fields or methods.
      *
      * @throws IllegalStateException if the context is already {@linkplain Context#close() closed}
      * @throws PolyglotException if a guest language error occurs during execution
-     * @see #getStaticReceiver()
+     * @see #isMetaObject()
+     * @see #getStaticScope()
      * @since 25.1
      */
-    public boolean hasStaticReceiver() {
-        return dispatch.hasStaticReceiver(this.context, receiver);
+    public boolean hasStaticScope() {
+        return dispatch.hasStaticScope(this.context, receiver);
     }
 
     /**
-     * Returns the static receiver associated with this value. A static receiver is an object that
-     * exposes static members, members whose values or behaviors are independent of any particular
-     * instance of this value. If this value is a {@link #isMetaObject() metaobject}, its static
-     * receiver is the same object that would be returned for an instance of the type represented by
-     * that metaobject, it exposes the static members of the represented type rather than static
-     * members of the metaobject itself.
+     * Returns the static scope associated with this value. This value must be a
+     * {@linkplain #isMetaObject() meta-object}. A static scope is an object that exposes static
+     * members, members whose values or behavior are independent of any particular instance.
      * <p>
-     * The returned static receiver can be used to access static members using
+     * The returned static scope can be used to access static members using
      * {@link #getMember(String)}, {@link #getMemberKeys()}, or
      * {@link #invokeMember(String, Object...)}.
      * <p>
-     * The returned static receiver is always expected to provide {@link #hasMembers() members},
-     * representing the receiver's static context.
+     * The returned static scope is always expected to provide {@link #hasMembers() members},
+     * representing the static context.
      * <p>
      * <b>Examples:</b>
+     * </p>
      * <ul>
-     * <li>For a Java class instance, the static receiver exposes the class's static fields and
-     * methods.</li>
-     * <li>For a Python object, the static receiver exposes class-level attributes and methods,
-     * effectively corresponding to the members provided by the Python metaobject.</li>
+     * <li>In Java, the static scope exposes static fields and methods of a class.</li>
+     * <li>In Python, the static scope exposes class-level attributes and methods, effectively
+     * corresponding to the members provided by the Python metaobject.</li>
      * </ul>
      *
      * @throws UnsupportedOperationException if and only if this value does not
-     *             {@linkplain #hasStaticReceiver() have a static receiver}
+     *             {@linkplain #hasStaticScope() have a static scope}
      * @throws IllegalStateException if the context is already {@linkplain Context#close() closed}
      * @throws PolyglotException if a guest language error occurs during execution
-     * @see #hasStaticReceiver()
-     * @see #getMemberKeys()
+     * @see #hasStaticScope()
+     * @see #isMetaObject()
+     * @see #hasMembers()
      * @since 25.1
      */
-    public Value getStaticReceiver() {
-        return (Value) dispatch.getStaticReceiver(this.context, receiver);
+    public Value getStaticScope() {
+        return (Value) dispatch.getStaticScope(this.context, receiver);
     }
 
     // executable

sdk/src/org.graalvm.polyglot/src/org/graalvm/polyglot/impl/AbstractPolyglotImpl.java

@@ -1137,11 +1137,11 @@ public Set<String> getMemberKeys(Object context, Object receiver) {
 
         public abstract boolean removeMember(Object context, Object receiver, String key);
 
-        public boolean hasStaticReceiver(Object context, Object receiver) {
+        public boolean hasStaticScope(Object context, Object receiver) {
             return false;
         }
 
-        public abstract Object getStaticReceiver(Object context, Object receiver);
+        public abstract Object getStaticScope(Object context, Object receiver);
 
         public boolean canExecute(Object context, Object receiver) {
             return false;

truffle/CHANGELOG.md

@@ -61,7 +61,7 @@ This changelog summarizes major changes between Truffle versions relevant to lan
 * GR-71088 Added `CompilerDirectives.EarlyEscapeAnalysis` annotation that runs partial escape analysis early before partial evaluation enabling partial-evaluation-constant scalar replacements. 
 * GR-71402: Added `InteropLibrary#hasHostObject` and `InteropLibrary#getHostObject` for accessing the Java host-object representation of a Truffle guest object. Deprecated `Env#isHostObject`, `Env#isHostException`, `Env#isHostFunction`, `Env#isHostSymbol`, `Env#asHostObject`, and `Env#asHostException` in favor of the new InteropLibrary messages.
 * GR-71402: Added `InteropLibrary#isHostObject` and `InteropLibrary#asHostObject` for accessing the Java host-object representation of a Truffle guest object. Deprecated `Env#isHostObject`, `Env#isHostException`, `Env#isHostFunction`, `Env#isHostSymbol`, `Env#asHostObject`, and `Env#asHostException` in favor of the new InteropLibrary messages.
-* GR-71402: Added `InteropLibrary#hasStaticReceiver` and `InteropLibrary#getStaticReceiver` returning the static receiver for given object.
+* GR-71402: Added `InteropLibrary#hasStaticScope` and `InteropLibrary#getStaticScope` returning the static scope representing static or class-level members associated with the given meta object.
 
 
 ## Version 25.0

truffle/src/com.oracle.truffle.api.debug/snapshot.sigtest

@@ -212,7 +212,7 @@ meth public final boolean isNull()
 meth public final com.oracle.truffle.api.debug.DebugValue asInLanguage(com.oracle.truffle.api.nodes.LanguageInfo)
 meth public final com.oracle.truffle.api.debug.DebugValue getMetaObject()
 meth public final com.oracle.truffle.api.debug.DebugValue getProperty(java.lang.String)
-meth public final com.oracle.truffle.api.debug.DebugValue getStaticReceiver()
+meth public final com.oracle.truffle.api.debug.DebugValue getStaticScope()
 meth public final com.oracle.truffle.api.nodes.LanguageInfo getOriginalLanguage()
 meth public final com.oracle.truffle.api.source.SourceSection getSourceLocation()
 meth public final java.lang.String asString()

truffle/src/com.oracle.truffle.api.debug/src/com/oracle/truffle/api/debug/DebugValue.java

@@ -1033,19 +1033,19 @@ public void accept(Breakpoint b) {
 
     /**
      * Returns a value that provides static members whose value is independent on a specific
-     * instance. Returns {@code null} when no static receiver is available.
+     * instance. Returns {@code null} when no static scope is available.
      *
      * @throws DebugException when guest language code throws an exception
      * @since 25.1
      */
-    public final DebugValue getStaticReceiver() {
+    public final DebugValue getStaticScope() {
         if (!isReadable()) {
             return null;
         }
         Object view = getLanguageView();
         try {
-            if (INTEROP.hasStaticReceiver(view)) {
-                return new HeapValue(getSession(), resolveLanguage(), null, INTEROP.getStaticReceiver(view));
+            if (INTEROP.hasStaticScope(view)) {
+                return new HeapValue(getSession(), resolveLanguage(), null, INTEROP.getStaticScope(view));
             }
         } catch (ThreadDeath td) {
             throw td;

truffle/src/com.oracle.truffle.api.interop/snapshot.sigtest

@@ -71,7 +71,7 @@ meth public boolean hasMetaObject(java.lang.Object)
 meth public boolean hasMetaParents(java.lang.Object)
 meth public boolean hasScopeParent(java.lang.Object)
 meth public boolean hasSourceLocation(java.lang.Object)
-meth public boolean hasStaticReceiver(java.lang.Object)
+meth public boolean hasStaticScope(java.lang.Object)
 meth public boolean isArrayElementInsertable(java.lang.Object,long)
 meth public boolean isArrayElementModifiable(java.lang.Object,long)
 meth public boolean isArrayElementReadable(java.lang.Object,long)
@@ -148,7 +148,7 @@ meth public java.lang.Object getMetaParents(java.lang.Object) throws com.oracle.
 meth public java.lang.Object getMetaQualifiedName(java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException
 meth public java.lang.Object getMetaSimpleName(java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException
 meth public java.lang.Object getScopeParent(java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException
-meth public java.lang.Object getStaticReceiver(java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException
+meth public java.lang.Object getStaticScope(java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException
 meth public java.lang.Object readArrayElement(java.lang.Object,long) throws com.oracle.truffle.api.interop.InvalidArrayIndexException,com.oracle.truffle.api.interop.UnsupportedMessageException
 meth public java.lang.Object readHashValue(java.lang.Object,java.lang.Object) throws com.oracle.truffle.api.interop.UnknownKeyException,com.oracle.truffle.api.interop.UnsupportedMessageException
 meth public java.lang.Object readHashValueOrDefault(java.lang.Object,java.lang.Object,java.lang.Object) throws com.oracle.truffle.api.interop.UnsupportedMessageException