c10n.share.utils

Class ReflectionUtils

java.lang.Object

c10n.share.utils.ReflectionUtils

public final class ReflectionUtils
extends Object

Constructor Summary

Constructors

Constructor and Description
ReflectionUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static String	getC10NKey(String keyPrefix, Method method) Work out method's bundle key.
static String	getDefaultKey(Method method) Works out the non-C10NKey bundle key for method, based on its class FQDN and method name (plus argument types), e.g.
static void	getDefaultKey(Method method, StringBuilder sb)
static String	getFQNString(Class<?> clazz)
static void	getFQNString(Class<?> clazz, StringBuilder sb)
static String	getKeyAnnotationBasedKey(Method method)
static String	getKeyAnnotationValue(Method method) Get the value provided with the C10NKey annotation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReflectionUtils

public ReflectionUtils()

Method Detail

getC10NKey

public static String getC10NKey(String keyPrefix,
                Method method)

Work out method's bundle key.

Bundle key resolution

Bundle key is generated as follows:

• If there are no C10NKey annotations, key is the Class FQDN '.' Method Name. If method has arguments, method name is post-fixed with argument types delimited with '_', e.g. myMethod_String_int
• If declaring interface or any of the super-interfaces contain C10NKey annotation C then
  • For methods without C10NKey annotation, key becomes C '.' Method Name
  • For methods with C10NKey annotation M, key is C '.' M
  • For methods with C10NKey annotation M, value for which starts with a '.', the key is just M (i.e. key is assumed to be absolute)
• If no declaring interfaces have C10NKey annotation, but a method contains annotation M, then key is just M.
• Lastly, if global key prefix is specified, it is always prepended to the final key, delimited by '.'

Looking for c10n key in parent interfaces

The lookup of c10n key in parent interfaces is done breadth-first, starting from the declaring class. That is, if the declaring class does not have c10n key, all interfaces it extends are checked in declaration order first. If no key is found, this check is repeated for each of the super interfaces in the same order.

Parameters:

keyPrefix - global key prefix

method - method to extract the key from

Returns:

method c10n bundle key (not null)

getKeyAnnotationBasedKey

public static String getKeyAnnotationBasedKey(Method method)

getKeyAnnotationValue

public static String getKeyAnnotationValue(Method method)

Get the value provided with the C10NKey annotation. If annotation is not declared returns null

Parameters:

method - method for which to retrieve the value C10NKey annotation

Returns:

value of the declared annotation. null if not present.

getDefaultKey

public static String getDefaultKey(Method method)

Works out the non-C10NKey bundle key for method, based on its class FQDN and method name (plus argument types), e.g. com.myCompany.MyClass.myMethod_String_boolean

Parameters:

method - the method for which to work out the key(not null)

Returns:

method's default bundle key(not null)

getDefaultKey

public static void getDefaultKey(Method method,
                 StringBuilder sb)

getFQNString

public static String getFQNString(Class<?> clazz)

getFQNString

public static void getFQNString(Class<?> clazz,
                StringBuilder sb)