Class DefaultInternalObjectFilter

java.lang.Object
jdk.dynalink.linker.support.DefaultInternalObjectFilter
All Implemented Interfaces:
MethodHandleTransformer

public class DefaultInternalObjectFilter extends Object implements MethodHandleTransformer
Default implementation for a DynamicLinkerFactory.setInternalObjectsFilter(MethodHandleTransformer) that delegates to a pair of filtering method handles. It takes a method handle of Object(Object) type for filtering parameter values and another one of the same type for filtering return values. It applies them as parameter and return value filters on method handles passed to its transform(MethodHandle) method, on those parameters and return values that are declared to have type Object. Also handles method handles that support variable arity calls with a last Object[] parameter. You can broadly think of the parameter filter as being a wrapping method for exposing internal runtime objects wrapped into an adapter with some public interface, and the return value filter as being its inverse unwrapping method.
Since:
9
  • Constructor Summary

    Constructors
    Constructor
    Description
    DefaultInternalObjectFilter(MethodHandle parameterFilter, MethodHandle returnFilter)
    Creates a new filter.
  • Method Summary

    Modifier and Type
    Method
    Description
    Transforms a method handle.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    Answers an integer hash code for the receiver.
    final void
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    Causes all threads which are waiting on the receiver to be made ready to run.
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
  • Constructor Details

    • DefaultInternalObjectFilter

      public DefaultInternalObjectFilter(MethodHandle parameterFilter, MethodHandle returnFilter)
      Creates a new filter.
      Parameters:
      parameterFilter - the filter for method parameters. Must be of type Object(Object), or null.
      returnFilter - the filter for return values. Must be of type Object(Object), or null.
      Throws:
      IllegalArgumentException - if one or both filters are not of the expected type.
  • Method Details