de.uni_hildesheim.sse.monitoring.runtime.utils

Class AnnotationInvocationHandler

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.utils.AnnotationInvocationHandler

All Implemented Interfaces:

java.io.Serializable, java.lang.reflect.InvocationHandler

class AnnotationInvocationHandler
extends java.lang.Object
implements java.lang.reflect.InvocationHandler, java.io.Serializable

Class that handles the method calls for a java.lang.reflect.Proxy that implements an annotation. The generated handler takes a Map<String,Object> as a constructor argument with the keys equal to the annotation method names. For Annotation, array and Enum types the values must exactly match the return type or a ClassCastException will result. For character types the the value must be an instance of java.lang.Character or String. Numeric types do not have to match exactly, as they are converted using java.lang.Number's xxxValue methods.

Author:

Stuart Douglas (taken from JBoss WELD SVN rev 5138)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	AnnotationInvocationHandler.SerializationProxy Defines a serialization proxy used to replace instances of AnnotationInvocationHandler in a serialized stream.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Class<? extends java.lang.annotation.Annotation>	annotationType Stores the annotation type to emulate.
private java.lang.reflect.Method[]	members Stores the members declared by annotationType.
private static long	serialVersionUID Defines the serialization id.
private HashMap<java.lang.String,java.lang.Object>	valueMap Stores the values corresponding to the annotation values.

Constructor Summary

Constructors

Constructor and Description
AnnotationInvocationHandler(HashMap<java.lang.String,java.lang.Object> valueMap, java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Creates a new invocation handler taking over the annotation type and the values to return for the annotation (instance).

Method Summary

Modifier and Type	Method and Description
private void	appendInBraces(java.lang.StringBuilder buf, java.lang.String text) Appends the given string in braces to buf.
boolean	equals(java.lang.Object other)
int	hashCode()
private static java.lang.Object	invoke(java.lang.reflect.Method method, java.lang.Object instance) Calls a method without parameters (getter) on the given instance.
java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
private void	readObject(java.io.ObjectInputStream in) Disables typical serialization input as this should be done by AnnotationInvocationHandler.SerializationProxy.
java.lang.String	toString()
private java.lang.Object	writeReplace() Defines a replacement object for this in a serialized stream (AnnotationInvocationHandler.SerializationProxy).

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

Defines the serialization id.

See Also:

Constant Field Values

valueMap

private final HashMap<java.lang.String,java.lang.Object> valueMap

Stores the values corresponding to the annotation values.

annotationType

private final java.lang.Class<? extends java.lang.annotation.Annotation> annotationType

Stores the annotation type to emulate.

members

private final java.lang.reflect.Method[] members

Stores the members declared by annotationType.

Constructor Detail

AnnotationInvocationHandler

AnnotationInvocationHandler(HashMap<java.lang.String,java.lang.Object> valueMap,
                            java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Creates a new invocation handler taking over the annotation type and the values to return for the annotation (instance).

Parameters:

valueMap - the concrete values for the individual annotation attributes

annotationType - the annotation type to emulate

Since:

1.00

Method Detail

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:

invoke in interface java.lang.reflect.InvocationHandler

Throws:

java.lang.Throwable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

appendInBraces

private void appendInBraces(java.lang.StringBuilder buf,
                            java.lang.String text)

Appends the given string in braces to buf.

Parameters:

buf - the buffer to append to

text - the string to append

Since:

1.00

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

writeReplace

private java.lang.Object writeReplace()
                               throws java.io.ObjectStreamException

Defines a replacement object for this in a serialized stream (AnnotationInvocationHandler.SerializationProxy).

Returns:

the serialization proxy to be used instead of this instance

Throws:

java.io.ObjectStreamException - in case of any problem during serialization

Since:

1.00

readObject

private void readObject(java.io.ObjectInputStream in)
                 throws java.io.IOException,
                        java.lang.ClassNotFoundException

Disables typical serialization input as this should be done by AnnotationInvocationHandler.SerializationProxy.

Parameters:

in - the input stream

Throws:

java.io.IOException - in case of any I/O problem

java.lang.ClassNotFoundException - in case that the current object cannot be casted appropriately

Since:

1.00

invoke

private static java.lang.Object invoke(java.lang.reflect.Method method,
                                       java.lang.Object instance)

Calls a method without parameters (getter) on the given instance.

Parameters:

method - the method to be called

instance - the instance on which to call the method

Returns:

the result of the execution

Since:

1.00