Util (JSimpleDB Main Classes 3.0.0 API)

java.lang.Object
- org.jsimpledb.Util

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

Method Summary

All Methods Static Methods Concrete 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 Set<TypeToken<?>>`	`findLowestCommonAncestors(Iterable<TypeToken<?>> types)` Find the narrowest type(s) each of which is a supertype of all of the given types.
`static Set<TypeToken<?>>`	`findLowestCommonAncestorsOfClasses(Iterable<Class<?>> types)` Find the narrowest type(s) each of which 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
    
    Throws:
    
    IllegalArgumentException - if any type in types is null
    
    See Also:
    
    findLowestCommonAncestor()
  - findLowestCommonAncestorsOfClasses
```
public static Set<TypeToken<?>> findLowestCommonAncestorsOfClasses(Iterable<Class<?>> types)
```
    Find the narrowest type(s) each of which is a supertype of all of the given types.
    This method delegates to findLowestCommonAncestors() after converting the Class instances to TypeTokens.
    
    Parameters:
    
    types - sub-types
    
    Returns:
    
    maximally narrow common supertype(s)
    
    Throws:
    
    IllegalArgumentException - if any type in types is null
    
    See Also:
    
    findLowestCommonAncestors()
  - findLowestCommonAncestor
```
public static TypeToken<?> findLowestCommonAncestor(Iterable<TypeToken<?>> types)
```
    Find the narrowest type that is a supertype of all of the given types.
    Note that there may be more than one such type. The returned type will always be as narrow as possible, but it's possible there for there to be multiple such types for which none is a sub-type of any other.
    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
  - findLowestCommonAncestors
```
public static Set<TypeToken<?>> findLowestCommonAncestors(Iterable<TypeToken<?>> types)
```
    Find the narrowest type(s) each of which is a supertype of all of the given types.
    
    Parameters:
    
    types - sub-types
    
    Returns:
    
    maximally narrow common supertype(s)
  - 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

findLowestCommonAncestorsOfClasses

findLowestCommonAncestor

findLowestCommonAncestors

getWildcardedType

getTypeParameter

invoke

newParameterizedType