Package net.bytebuddy.asm
Class ClassVisitorFactory<T>
java.lang.Object
net.bytebuddy.asm.ClassVisitorFactory<T>
- Type Parameters:
T
- The type of the mapped class visitor.
A factory for wrapping a
ClassVisitor
in Byte Buddy's package namespace to a
ClassVisitor
in any other namespace. Note that this API does not allow for the
passing of Attribute
s. which must be filtered or propagated past this translation.
If the supplied visitors do not declare a method that Byte Buddy's version of ASM is aware
of, an UnsupportedOperationException
is thrown.-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected static class
A method to wrap anAttribute
.protected static class
A method to translate an array of constants from one namespace to another.protected static class
A method to translate aConstantDynamic
from one namespace to another.protected static class
A method to translate a constant value from one namespace to another.protected static class
A factory for creating a wrapper for aClassVisitor
.protected static class
A method to translate a stack map frame array from one namespace to another.protected static class
A method to translate aHandle
from one namespace to another.protected static class
A method to translate an array ofLabel
s from one namespace to another.protected static class
A method to translate aLabel
from one namespace to another.protected static class
An appender that performs anull
-checked construction.protected static class
A method to translate aTypePath
type from one namespace to another. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final String
The name of the delegate field containing an equivalent visitor.private static final String
The name of a map with labels that have been translated previously.private final Class
<?> The type of the represented class visitor wrapper.private static final String
The name of the method that wraps a translated visitor, including anull
check. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
ClassVisitorFactory
(Class<?> type) Creates a new factory. -
Method Summary
Modifier and TypeMethodDescriptionprivate static <T> T
doPrivileged
(PrivilegedAction<T> action) A proxy forjava.security.AccessController#doPrivileged
that is activated if available.Class
<?> getType()
Returns theClassVisitor
type that this factory represents.static <S> ClassVisitorFactory
<S> Returns a class visitor factory for the suppliedClassVisitor
type.static <S> ClassVisitorFactory
<S> Returns a class visitor factory for the suppliedClassVisitor
type.private static DynamicType
toAttributeWrapper
(DynamicType.Builder<?> builder, Class<?> source, Class<?> target, TypeDescription sourceWrapper, TypeDescription targetWrapper) Creates a wrapper type for anAttribute
to pass attribues along a visitor chain.private static MethodCall.ArgumentLoader.Factory
toConvertedParameter
(TypeDescription source, Class<?> target, String method, int offset, boolean virtual) Creates an argument loader for a method parameter that requires conversion.private static DynamicType.Builder
<?> toMethodVisitorBuilder
(ByteBuddy byteBuddy, Class<?> sourceVisitor, Class<?> targetVisitor, Class<?> sourceTypePath, Class<?> targetTypePath, Class<?> sourceLabel, Class<?> targetLabel, Class<?> sourceType, Class<?> targetType, Class<?> sourceHandle, Class<?> targetHandle, Class<?> sourceConstantDynamic, Class<?> targetConstantDynamic) Creates a builder for a method visitor type.private static DynamicType.Builder
<?> toVisitorBuilder
(ByteBuddy byteBuddy, Class<?> sourceVisitor, Class<?> targetVisitor, Class<?> sourceTypePath, Class<?> targetTypePath, Implementation appendix) Creates a builder for a visitor type.abstract org.objectweb.asm.ClassVisitor
Unwraps an instance of the supplied class visitor as aClassVisitor
.abstract T
wrap
(org.objectweb.asm.ClassVisitor classVisitor) Wraps aClassVisitor
within an instance of the supplied class visitor type.
-
Field Details
-
DELEGATE
The name of the delegate field containing an equivalent visitor.- See Also:
-
LABELS
The name of a map with labels that have been translated previously.- See Also:
-
WRAP
The name of the method that wraps a translated visitor, including anull
check.- See Also:
-
type
The type of the represented class visitor wrapper.
-
-
Constructor Details
-
ClassVisitorFactory
Creates a new factory.- Parameters:
type
- The type of the represented class visitor wrapper.
-
-
Method Details
-
getType
Returns theClassVisitor
type that this factory represents.- Returns:
- The
ClassVisitor
type that this factory represents.
-
of
Returns a class visitor factory for the suppliedClassVisitor
type.- Type Parameters:
S
- The type of the class visitor to map to.- Parameters:
classVisitor
- The type of the translated class visitor.- Returns:
- A factory for wrapping
ClassVisitor
s in Byte Buddy's and the supplied package namespace.
-
of
Returns a class visitor factory for the suppliedClassVisitor
type.- Type Parameters:
S
- The type of the class visitor to map to.- Parameters:
classVisitor
- The type of the translatedClassVisitor
.byteBuddy
- The Byte Buddy instance to use.- Returns:
- A factory for wrapping
ClassVisitor
s in Byte Buddy's and the supplied package namespace.
-
doPrivileged
A proxy forjava.security.AccessController#doPrivileged
that is activated if available.- Type Parameters:
T
- The type of the action's resolved value.- Parameters:
action
- The action to execute from a privileged context.- Returns:
- The action's resolved value.
-
toVisitorBuilder
private static DynamicType.Builder<?> toVisitorBuilder(ByteBuddy byteBuddy, Class<?> sourceVisitor, Class<?> targetVisitor, @MaybeNull Class<?> sourceTypePath, @MaybeNull Class<?> targetTypePath, Implementation appendix) throws Exception Creates a builder for a visitor type.- Parameters:
byteBuddy
- The Byte Buddy instance to use.sourceVisitor
- The visitor type to map from.targetVisitor
- The visitor type to map to.sourceTypePath
- TheTypePath
source type.targetTypePath
- TheTypePath
target type.appendix
- The implementation to append to the constructor.- Returns:
- The created builder.
- Throws:
Exception
- If an exception occurs.
-
toMethodVisitorBuilder
private static DynamicType.Builder<?> toMethodVisitorBuilder(ByteBuddy byteBuddy, Class<?> sourceVisitor, Class<?> targetVisitor, @MaybeNull Class<?> sourceTypePath, @MaybeNull Class<?> targetTypePath, @MaybeNull Class<?> sourceLabel, @MaybeNull Class<?> targetLabel, @MaybeNull Class<?> sourceType, @MaybeNull Class<?> targetType, @MaybeNull Class<?> sourceHandle, @MaybeNull Class<?> targetHandle, @MaybeNull Class<?> sourceConstantDynamic, @MaybeNull Class<?> targetConstantDynamic) throws Exception Creates a builder for a method visitor type.- Parameters:
byteBuddy
- The Byte Buddy instance to use.sourceVisitor
- The visitor type to map from.targetVisitor
- The visitor type to map to.sourceTypePath
- TheTypePath
source type.targetTypePath
- TheTypePath
target type.sourceLabel
- TheLabel
source type.targetLabel
- TheLabel
target type.sourceType
- TheType
source type.targetType
- TheType
target type.sourceHandle
- TheHandle
source type.targetHandle
- TheHandle
target type.sourceConstantDynamic
- TheConstantDynamic
source type.targetConstantDynamic
- TheConstantDynamic
target type.- Returns:
- The created builder.
- Throws:
Exception
- If an exception occurs.
-
toConvertedParameter
private static MethodCall.ArgumentLoader.Factory toConvertedParameter(TypeDescription source, Class<?> target, String method, int offset, boolean virtual) Creates an argument loader for a method parameter that requires conversion.- Parameters:
source
- The source type.target
- The target type.method
- The name of the method.offset
- The parameter offsetvirtual
-true
if the invoked method is virtual.- Returns:
- An appropriate argument loader factory.
-
toAttributeWrapper
private static DynamicType toAttributeWrapper(DynamicType.Builder<?> builder, Class<?> source, Class<?> target, TypeDescription sourceWrapper, TypeDescription targetWrapper) throws Exception Creates a wrapper type for anAttribute
to pass attribues along a visitor chain.- Parameters:
builder
- The builder to use for the wrapper type.source
- TheAttribute
type in the original namespace.target
- TheAttribute
type in the targeted namespace.sourceWrapper
- The wrapper type for theAttribute
type in the original namespace.targetWrapper
- The wrapper type for theAttribute
type in the targeted namespace.- Returns:
- The created dynamic type.
- Throws:
Exception
- If the dynamic type cannot be built.
-
wrap
Wraps aClassVisitor
within an instance of the supplied class visitor type.- Parameters:
classVisitor
- The class visitor to wrap.- Returns:
- A class visitor that wraps the supplied class visitor.
-
unwrap
Unwraps an instance of the supplied class visitor as aClassVisitor
.- Parameters:
classVisitor
- The class visitor to unwrap.- Returns:
- A class visitor that unwraps the supplied class visitor.
-