Method Detail

• public static long bulkInvalidationCount()

  Non-category process-wide bulk event count (invalidateBulk() / invalidateUnscoped()).

  Returns:

  bulk invalidation count

• public static long categoryInvalidationCount()

  Category-style bulk invalidation count (invalidateCategory()).

  Returns:

  category invalidation count

• public static long classInvalidationCount()

  Exact-class invalidation event count (invalidateClass(Class)).

  Returns:

  class invalidation count

• public static SwitchPoint classSwitchPointFor(Object receiver)

  Returns the class-level MetaClass SwitchPoint for the given receiver.

  Parameters:

  receiver - the call receiver (may be null)

  Returns:

  the MetaClass-domain switch point

• public static SwitchPoint classSwitchPointFor(Class<?> type)

  Returns the SwitchPoint for the given class at link time. Prefers the installed class-level MetaClass domain; if none is installed yet, uses the ClassInfo pending domain (defineClass-safe).

  Parameters:

  type - the class (must not be null)

  Returns:

  the SwitchPoint for monomorphic MOP guards

• public static void collectLiveForClass(Class<?> type, List<SwitchPoint> out)

  Collects live SwitchPoint(s) for type: installed MetaClass domain and ClassInfo pending domain. Does not create a MetaClass.

  Parameters:

  type - class to inspect (must not be null)

  out - destination list

• public static void collectLiveForMetaClass(MetaClass mc, List<SwitchPoint> out)

  Detaches the live SwitchPoint for mc's domain (if any) into out. Does not allocate a domain when none exists yet.

  Parameters:

  mc - MetaClass (may be null)

  out - destination list (must not be null)

• public static MethodHandle guardWithMopSwitchPoints(MethodHandle handle, MethodHandle fallback, Object receiver)

  Installs a MetaClass SwitchPoint guard on handle. Public entry for tests; production uses IndyInterface.applyMopSwitchPoints.

  Parameters:

  handle - the fast-path handle

  fallback - the re-link / fallback handle

  receiver - the receiver used to select the MetaClass-domain switch point

  Returns:

  the guarded handle

• public static MethodHandle guardWithMopSwitchPoints(MethodHandle handle, MethodHandle fallback, Class<?> receiverClass)

  Installs a MetaClass SwitchPoint guard on handle.

  Parameters:

  handle - the fast-path handle

  fallback - the re-link / fallback handle

  receiverClass - the class whose class-level MetaClass domain guards this site

  Returns:

  the guarded handle

• public static void invalidateBulk()

  Process-wide bulk retirement for non-stock (custom) MetaClass registry events — correctness-first when selection may consult state outside the stock miss walk. Rare.

• public static void invalidateCategory()

  Category enter/leave and VMPlugin.invalidateCallSites(). Retires every loaded class-level domain so sites re-link under the new category state. No separate category SwitchPoint on the hot path.

• public static void invalidateClass(Class<?> type)

  Retires only type's MetaClass SwitchPoint domain (exact class; no subtype fan-out). No-op when type is null. Does not bump ClassInfo.getVersion.

  Used by ClassInfo.incVersion, stock registry MetaClass changes, and per-instance MetaClass changes. Non-stock MetaClass kinds use invalidateBulk() instead.

  Parameters:

  type - the class whose MetaClass changed

• public static void invalidateForMetaClassChange(MetaClassRegistryChangeEvent event)

  Registry-driven invalidation: exact class for stock MetaClass kinds and per-instance changes; process-wide bulk for custom MetaClass kinds or unattributed events. See class javadoc.

  Parameters:

  event - the registry change event (must not be null)

• public static void invalidateMetaClass(MetaClass mc)

  Retires the SwitchPoint domain for mc (if one was allocated). Does not bump counters (local domain retire; width policy is separate).

  Parameters:

  mc - MetaClass (may be null)

• public static void invalidateUnscoped()

  Process-wide bulk retirement when a MetaClass registry event carries no Class attribution.

• public static boolean isStockMetaClass(MetaClass mc)

  Whether mc is a stock MOP MetaClass for which exact-class invalidation is sufficient: null, or unwrapped MetaClassImpl (includes EMC and subclasses). Any other kind is non-stock and triggers bulk invalidation on registry replace.

  Parameters:

  mc - MetaClass to classify (may be null)

  Returns:

  true if exact-class invalidation is sufficient

• public static boolean needsBulkInvalidation(MetaClass oldMc, MetaClass newMc)

  Whether a class-level MetaClass change involving oldMc/newMc requires process-wide bulk invalidation.

  Bulk is reserved for non-stock MetaClass kinds: not MetaClassImpl after adapter unwrap. Stock pairs stay exact-class.

  Parameters:

  oldMc - previous MetaClass (may be null)

  newMc - new MetaClass (may be null on remove)

  Returns:

  true if bulk invalidation is required

• public static SwitchPointInvalidator newPendingInvalidator()

  Creates a SwitchPoint invalidator for a ClassInfo pending domain (pre-MetaClass link only).

  Returns:

  a new invalidator

• public static void resetCountersForTesting()

  Resets process-wide counters (tests only). Does not reset live switch points.

• public static Class<?> switchPointClassFor(Object receiver)

  Resolves the class used for the MetaClass SwitchPoint domain of a receiver. null maps to NullObject; a Class receiver uses itself.

  Parameters:

  receiver - the call receiver (may be null)

  Returns:

  the class whose class-level MetaClass SwitchPoint guards this site

• public static SwitchPoint switchPointForMetaClass(MetaClass mc)

  Returns the SwitchPoint domain for a MetaClass instance (unwraps adapters).

  Parameters:

  mc - MetaClass (must not be null)

  Returns:

  the MetaClass-domain SwitchPoint