org.springframework.instrument.classloading.jboss

Class JBossLoadTimeWeaver

  • java.lang.Object
    • org.springframework.instrument.classloading.jboss.JBossLoadTimeWeaver
  • All Implemented Interfaces:
    LoadTimeWeaver


    public class JBossLoadTimeWeaver
    extends java.lang.Object
    implements LoadTimeWeaver
    LoadTimeWeaver implementation for JBoss's instrumentable ClassLoader. Thanks to Ales Justin and Marius Bogoevici for the initial prototype.

    As of Spring Framework 5.0, this weaver supports WildFly 8+.

    Since:
    3.0
    Author:
    Costin Leau, Juergen Hoeller
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method and Description
      void addTransformer(java.lang.instrument.ClassFileTransformer transformer)
      Add a ClassFileTransformer to be applied by this LoadTimeWeaver.
      java.lang.ClassLoader getInstrumentableClassLoader()
      Return a ClassLoader that supports instrumentation through AspectJ-style load-time weaving based on user-defined ClassFileTransformers.
      java.lang.ClassLoader getThrowawayClassLoader()
      Return a throwaway ClassLoader, enabling classes to be loaded and inspected without affecting the parent ClassLoader.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • JBossLoadTimeWeaver

        public JBossLoadTimeWeaver(@Nullable
                                   java.lang.ClassLoader classLoader)
        Create a new instance of the JBossLoadTimeWeaver class using the supplied ClassLoader.
        Parameters:
        classLoader - the ClassLoader to delegate to for weaving
    • Method Detail

      • addTransformer

        public void addTransformer(java.lang.instrument.ClassFileTransformer transformer)
        Description copied from interface: LoadTimeWeaver
        Add a ClassFileTransformer to be applied by this LoadTimeWeaver.
        Specified by:
        addTransformer in interface LoadTimeWeaver
        Parameters:
        transformer - the ClassFileTransformer to add
      • getInstrumentableClassLoader

        public java.lang.ClassLoader getInstrumentableClassLoader()
        Description copied from interface: LoadTimeWeaver
        Return a ClassLoader that supports instrumentation through AspectJ-style load-time weaving based on user-defined ClassFileTransformers.

        May be the current ClassLoader, or a ClassLoader created by this LoadTimeWeaver instance.

        Specified by:
        getInstrumentableClassLoader in interface LoadTimeWeaver
        Returns:
        the ClassLoader which will expose instrumented classes according to the registered transformers
      • getThrowawayClassLoader

        public java.lang.ClassLoader getThrowawayClassLoader()
        Description copied from interface: LoadTimeWeaver
        Return a throwaway ClassLoader, enabling classes to be loaded and inspected without affecting the parent ClassLoader.

        Should not return the same instance of the ClassLoader returned from an invocation of LoadTimeWeaver.getInstrumentableClassLoader().

        Specified by:
        getThrowawayClassLoader in interface LoadTimeWeaver
        Returns:
        a temporary throwaway ClassLoader; should return a new instance for each call, with no existing state