Util (JSimpleDB Main Classes 2.1.2 API)

java.lang.Object
- org.jsimpledb.Util

```
public final class Util
extends Object
```
Various utility routines.

Method Summary

Methods
Modifier and Type	Method and Description
`static TypeToken<?>`	`findLowestCommonAncestor(Iterable<TypeToken<?>> types)` Find the narrowest type that is a supertype of all of the given types.
`static TypeToken<?>`	`findLowestCommonAncestorOfClasses(Iterable<Class<?>> types)` Find the narrowest type that is a supertype of all of the given types.
`static Type`	`getTypeParameter(Type type, int index)` Get the n'th generic type parameter.
`static <T> TypeToken<? extends T>`	`getWildcardedType(Class<T> type)` Parameterize the raw type with wildcards.
`static boolean`	`hasDefaultValidationAnnotation(AnnotatedElement obj)` Determine whether the given object has any JSR 303 annotation(s) defining validation constraints in the default group.
`static AnnotatedElement`	`hasValidation(Class<?> type)` Determine if any JSR 303 validation annotations are present on the given type itself or any of its methods (public methods only).
`static boolean`	`hasValidationAnnotation(AnnotatedElement obj)` Determine whether the given object has any JSR 303 annotation(s).
`static Object`	`invoke(Method method, Object target, Object... params)` Invoke method via reflection and re-throw any checked exception wrapped in an `JSimpleDBException`.
`static boolean`	`isAnyGroupBeingValidated(Class<?>[] constraintGroups, Class<?>[] validationGroups)` Determine if a constraint whose `groups()` contain the given constraint groups should be applied when validating with the given validation groups.
`static boolean`	`isGroupBeingValidated(Class<?> constraintGroup, Class<?>[] validationGroups)` Determine if a constraint whose `groups()` contain the given constraint group should be applied when validating with the given validation groups.
`static <T> TypeToken<? extends T>`	`newParameterizedType(Class<T> target, Type[] params)` Convert a raw class back into its generic type using caller-supplied type parameters.
`static boolean`	`requiresDefaultValidation(Class<?> type)` Determine if instances of the given type require any validation under the default validation group.
`static boolean`	`requiresDefaultValidation(Method method)` Determine if the given getter method, or any method it overrides, has a JSR 303 validation constraint applicable under the default validation group.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - hasValidation
```
public static AnnotatedElement hasValidation(Class<?> type)
```
    Determine if any JSR 303 validation annotations are present on the given type itself or any of its methods (public methods only).
    
    Parameters:
    type - object type
    
    Returns:
    a non-null object with JSR 303 validation requirements, or null if none found
    
    Throws:
    
    IllegalArgumentException - if type is null
  - requiresDefaultValidation
```
public static boolean requiresDefaultValidation(Class<?> type)
```
    Determine if instances of the given type require any validation under the default validation group.
    This will be true if type or any of its declared methods has a JSR 303 (public methods only) or @OnValidate annotation, or if any of its super-types requires validation.
    
    Parameters:
    type - object type
    
    Returns:
    true if type has any validation requirements
    
    Throws:
    
    IllegalArgumentException - if type is null
    See Also:
    ValidationMode
  - requiresDefaultValidation
```
public static boolean requiresDefaultValidation(Method method)
```
    Determine if the given getter method, or any method it overrides, has a JSR 303 validation constraint applicable under the default validation group.
    
    Parameters:
    method - annotated method
    
    Returns:
    true if obj has one or more JSR 303 annotations
    
    Throws:
    
    IllegalArgumentException - if method is null
  - hasDefaultValidationAnnotation
```
public static boolean hasDefaultValidationAnnotation(AnnotatedElement obj)
```
    Determine whether the given object has any JSR 303 annotation(s) defining validation constraints in the default group.
    
    Parameters:
    obj - annotated element
    
    Returns:
    true if obj has one or more JSR 303 default validation constraint annotations
    
    Throws:
    
    IllegalArgumentException - if obj is null
  - hasValidationAnnotation
```
public static boolean hasValidationAnnotation(AnnotatedElement obj)
```
    Determine whether the given object has any JSR 303 annotation(s).
    
    Parameters:
    obj - annotated element
    
    Returns:
    true if obj has one or more JSR 303 validation constraint annotations
    
    Throws:
    
    IllegalArgumentException - if obj is null
  - isGroupBeingValidated
```
public static boolean isGroupBeingValidated(Class<?> constraintGroup,
                            Class<?>[] validationGroups)
```
    Determine if a constraint whose groups() contain the given constraint group should be applied when validating with the given validation groups.
    
    Parameters:
    constraintGroup - validation group associated with a validation constraint
    validationGroups - groups for which validation is being performed
    
    Returns:
    whether to apply the validation constraint
    
    Throws:
    
    IllegalArgumentException - if any null values are encountered
  - isAnyGroupBeingValidated
```
public static boolean isAnyGroupBeingValidated(Class<?>[] constraintGroups,
                               Class<?>[] validationGroups)
```
    Determine if a constraint whose groups() contain the given constraint groups should be applied when validating with the given validation groups.
    
    Parameters:
    constraintGroups - validation groups associated with a validation constraint
    validationGroups - groups for which validation is being performed
    
    Returns:
    whether to apply the validation constraint
    
    Throws:
    
    IllegalArgumentException - if any null values are encountered
  - findLowestCommonAncestorOfClasses
```
public static TypeToken<?> findLowestCommonAncestorOfClasses(Iterable<Class<?>> types)
```
    Find the narrowest type that is a supertype of all of the given types.
    This method delegates to findLowestCommonAncestor() after converting the Class instances to TypeTokens.
    
    Parameters:
    types - sub-types
    
    Returns:
    narrowest common super-type
    See Also:
    findLowestCommonAncestor()
  - findLowestCommonAncestor
```
public static TypeToken<?> findLowestCommonAncestor(Iterable<TypeToken<?>> types)
```
    Find the narrowest type that is a supertype of all of the given types.
    When there is more than one choice, heuristics are used. For example, we prefer non-interface types, and JObject over other interface types.
    
    Parameters:
    types - sub-types
    
    Returns:
    narrowest common super-type
  - getWildcardedType
```
public static <T> TypeToken<? extends T> getWildcardedType(Class<T> type)
```
    Parameterize the raw type with wildcards.
    
    Type Parameters:
    T - raw type
    Parameters:
    type - raw type
    
    Returns:
    type genericized with wildcards
  - getTypeParameter
```
public static Type getTypeParameter(Type type,
                    int index)
```
    Get the n'th generic type parameter.
    
    Parameters:
    type - parameterized generic type
    index - type parameter index (zero based)
    
    Returns:
    type parameter at index
    
    Throws:
    
    IllegalArgumentException - if type is not a parameterized type with more than index type variables
  - invoke
```
public static Object invoke(Method method,
            Object target,
            Object... params)
```
    Invoke method via reflection and re-throw any checked exception wrapped in an JSimpleDBException.
    
    Parameters:
    method - method to invoke
    target - instance, or null if method is static
    params - method parameters
    
    Returns:
    method return value
  - newParameterizedType
```
public static <T> TypeToken<? extends T> newParameterizedType(Class<T> target,
                                              Type[] params)
```
    Convert a raw class back into its generic type using caller-supplied type parameters.
    
    Type Parameters:
    T - raw class type
    Parameters:
    target - raw class
    params - type parameters
    
    Returns:
    generic TypeToken for target
    See Also:
    Guava Issue #1645

Class Util

Method Summary

Methods inherited from class java.lang.Object

Method Detail

hasValidation

requiresDefaultValidation

requiresDefaultValidation

hasDefaultValidationAnnotation

hasValidationAnnotation

isGroupBeingValidated

isAnyGroupBeingValidated

findLowestCommonAncestorOfClasses

findLowestCommonAncestor

getWildcardedType

getTypeParameter

invoke

newParameterizedType