Annotation instance
- * and the values of its elements.
- * The "elements" we're talking about are the annotation attributes,
- * not its targets (the term "element" is used ambiguously
- * in Java's annotations documentation).
- *
- * @author Paolo Perrotta
- * @author Davide Marchignoli
- */
-public class AnnotationDescriptor {
-
- private final Class type;
-
- private final MapAnnotationProxies) from AnnotationDescriptors.
- *
- * @author Paolo Perrotta
- * @author Davide Marchignoli
- * @see AnnotationProxy
- */
-public class AnnotationFactory {
-
- @SuppressWarnings("unchecked")
- public static Annotation that pretends it is a
- * "real" source code annotation. It's also an InvocationHandler.
- *
- * When you create an AnnotationProxy, you must initialize it
- * with an AnnotationDescriptor.
- * The adapter checks that the provided elements are the same elements defined
- * in the annotation interface. However, it does not check that their
- * values are the right type. If you omit an element, the adapter will use the
- * default value for that element from the annotation interface, if it exists.
- * If no default exists, it will throw an exception.
- *
- * Warning: this class does not implement hashCode() and
- * equals() - it just uses the ones it inherits from Object.
- * This means that an AnnotationProxy does not follow the
- * recommendations of the Annotation javadoc about these two
- * methods. That's why you should never mix AnnotationProxies
- * with "real" annotations. For example, don't put them into the same
- * Collection.
- *
- * @author Paolo Perrotta
- * @author Davide Marchignoli
- * @see java.lang.annotation.Annotation
- */
-public class AnnotationProxy implements Annotation, InvocationHandler {
-
- private final Class annotationType;
- //FIXME it's probably better to use String as a key rather than Method
- // to speed up and avoid any fancy permsize/GC issue
- // I'd better check the litterature on the subject
- private final MapType.
- *
- * @author Emmanuel Bernard
- * @author Paolo Perrotta
- */
-abstract class JavaXType {
-
- private final TypeEnvironment context;
- private final JavaReflectionManager factory;
- private final Type approximatedType;
- private final Type boundType;
-
- protected JavaXType(Type unboundType, TypeEnvironment context, JavaReflectionManager factory) {
- this.context = context;
- this.factory = factory;
- this.boundType = context.bind( unboundType );
- this.approximatedType = factory.toApproximatingEnvironment( context ).bind( unboundType );
- }
-
- abstract public boolean isArray();
-
- abstract public boolean isCollection();
-
- abstract public XClass getElementClass();
-
- abstract public XClass getClassOrElementClass();
-
- abstract public Class getCollectionClass();
-
- abstract public XClass getMapKey();
-
- abstract public XClass getType();
-
- public boolean isResolved() {
- return TypeUtils.isResolved( boundType );
- }
-
- protected Type approximate() {
- return approximatedType;
- }
-
- protected XClass toXClass(Type type) {
- return factory.toXClass( type, context );
- }
-}
diff --git a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/Pair.java b/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/Pair.java
deleted file mode 100644
index 97c3519cb7..0000000000
--- a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/Pair.java
+++ /dev/null
@@ -1,81 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
- * indicated by the @author tags or express copyright attribution
- * statements applied by the authors. All third-party contributions are
- * distributed under license by Red Hat Middleware LLC.
- *
- * This copyrighted material is made available to anyone wishing to use, modify,
- * copy, or redistribute it subject to the terms and conditions of the GNU
- * Lesser General Public License, as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
- * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
- * for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this distribution; if not, write to:
- * Free Software Foundation, Inc.
- * 51 Franklin Street, Fifth Floor
- * Boston, MA 02110-1301 USA
- */
-package org.hibernate.annotations.common.reflection.java;
-
-/**
- * A pair of objects that can be used as a key in a Map.
- *
- * @author Paolo Perrotta
- * @author Davide Marchignoli
- */
-abstract class PairTypeEnvironment that approximates the unresolved components of a generic simple
- * type or collection to their nearest upper binding. The returned type is always fully resolved.
- *
- * The concept of "type approximation" is not really sound in general. This class just does what we need
- * within the Hibernate Annotations environment. It's more or less a hack. The idea is that certain
- * types can provide useful information even if they're not fully resolved in the environment. This class
- * tries to turn those types into the nearest fully resolved type that still carries that information.
- *
- * For example:T becomes Object.T extends Foo becomes Foo.List<T> becomes List<Object>.List<T extends Foo> becomes List<Foo>.T extends Foo becomes an array of Foo.- *
- * If a type variable has multiple upper bounds, it will be approximated toObject.
- * Lower bounds are ignored.- *
- * Wildcards are generally not approximated.Class<?> stays Class<?>.
- * A wildcard within a generic collection is approximated to its upper binding. List<?> becomes
- * List<Object>- *
- * Note thatClass<T> is Class<Object>.
- * That would be wrong in any situation. All parametric types that are not type variables, collections or
- * arrays are coarsely approximated to Object.class.
- *
- * @author Paolo Perrotta
- * @return a type where the generic arguments have been replaced by raw classes.
- */
-class ApproximatingTypeEnvironment implements TypeEnvironment {
-
- public Type bind(final Type type) {
- Type result = fineApproximation( type );
- assert TypeUtils.isResolved( result );
- return result;
- }
-
- private Type fineApproximation(final Type type) {
- return new TypeSwitchTypeEnvironment functions.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-public class CompoundTypeEnvironment implements TypeEnvironment {
-
- private final TypeEnvironment f;
-
- private final TypeEnvironment g;
-
- private final int hashCode;
-
- public static TypeEnvironment create(TypeEnvironment f, TypeEnvironment g) {
- if ( g == IdentityTypeEnvironment.INSTANCE )
- return f;
- if ( f == IdentityTypeEnvironment.INSTANCE )
- return g;
- return new CompoundTypeEnvironment( f, g );
- }
-
- private CompoundTypeEnvironment(TypeEnvironment f, TypeEnvironment g) {
- this.f = f;
- this.g = g;
- hashCode = doHashCode();
- }
-
- public Type bind(Type type) {
- return f.bind( g.bind( type ) );
- }
-
- public boolean equals(Object o) {
- if ( this == o ) return true;
- if ( ! ( o instanceof CompoundTypeEnvironment ) ) return false;
-
- final CompoundTypeEnvironment that = (CompoundTypeEnvironment) o;
-
- if ( differentHashCode( that ) ) return false;
-
- if ( !f.equals( that.f ) ) return false;
- return g.equals( that.g );
-
- }
-
- private boolean differentHashCode(CompoundTypeEnvironment that) {
- return hashCode != that.hashCode;
- }
-
- private int doHashCode() {
- int result;
- result = f.hashCode();
- result = 29 * result + g.hashCode();
- return result;
- }
-
- public int hashCode() {
- //cached because the inheritance can be big
- return hashCode;
- }
-
- @Override
- public String toString() {
- return f.toString() + "(" + g.toString() + ")";
- }
-}
diff --git a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/IdentityTypeEnvironment.java b/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/IdentityTypeEnvironment.java
deleted file mode 100644
index b4a826e4ff..0000000000
--- a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/IdentityTypeEnvironment.java
+++ /dev/null
@@ -1,48 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
- * indicated by the @author tags or express copyright attribution
- * statements applied by the authors. All third-party contributions are
- * distributed under license by Red Hat Middleware LLC.
- *
- * This copyrighted material is made available to anyone wishing to use, modify,
- * copy, or redistribute it subject to the terms and conditions of the GNU
- * Lesser General Public License, as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
- * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
- * for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this distribution; if not, write to:
- * Free Software Foundation, Inc.
- * 51 Franklin Street, Fifth Floor
- * Boston, MA 02110-1301 USA
- */
-package org.hibernate.annotations.common.reflection.java.generics;
-
-import java.lang.reflect.Type;
-
-/**
- * Substitutes a Type for itself.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-public class IdentityTypeEnvironment implements TypeEnvironment {
-
- public static final TypeEnvironment INSTANCE = new IdentityTypeEnvironment();
-
- private IdentityTypeEnvironment() {
- }
-
- public Type bind(Type type) {
- return type;
- }
-
- public String toString() {
- return "{}";
- }
-}
diff --git a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/SimpleTypeEnvironment.java b/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/SimpleTypeEnvironment.java
deleted file mode 100644
index 3a4ed1af93..0000000000
--- a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/SimpleTypeEnvironment.java
+++ /dev/null
@@ -1,116 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
- * indicated by the @author tags or express copyright attribution
- * statements applied by the authors. All third-party contributions are
- * distributed under license by Red Hat Middleware LLC.
- *
- * This copyrighted material is made available to anyone wishing to use, modify,
- * copy, or redistribute it subject to the terms and conditions of the GNU
- * Lesser General Public License, as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
- * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
- * for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this distribution; if not, write to:
- * Free Software Foundation, Inc.
- * 51 Franklin Street, Fifth Floor
- * Boston, MA 02110-1301 USA
- */
-package org.hibernate.annotations.common.reflection.java.generics;
-
-import java.lang.reflect.GenericArrayType;
-import java.lang.reflect.ParameterizedType;
-import java.lang.reflect.Type;
-import java.lang.reflect.TypeVariable;
-import java.lang.reflect.WildcardType;
-import java.util.HashMap;
-
-/**
- * Binds formal type arguments (typically T, E, etc.) to actual types.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-class SimpleTypeEnvironment extends HashMapType.
- *
- * For example:
- *
- *
- *
- *
- *
- * class Shop<T>{
- * List<T> getCatalog() { ... }
- * }
- *
- * class Bakery extends Shop<Bread>{}
- *
- *
- *
- *
- * Consider the type returned by method getCatalog(). There are
- * two possible contexts here. In the context of Shop, the type
- * is List<T>. In the context of Bakery, the
- * type is List<Bread>. Each of these contexts can be
- * represented by a TypeEnvironment.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-public interface TypeEnvironment {
-
- /**
- * Binds as many generic components of the given type as possible in this
- * context.
- *
- * Warning: if the returned Type is a Class,
- * then it's guaranteed to be a regular Java Class. In all
- * other cases, this method might return a custom implementation of some
- * interface that extends Type. Be sure not to mix these
- * objects with Java's implementations of Type to avoid
- * potential identity problems.
- *
- * This class does not support bindings involving inner classes or
- * upper/lower bounds.
- *
- * @return a type where the generic arguments have been replaced by raw
- * classes whenever this is possible.
- */
- public Type bind(Type type);
-}
\ No newline at end of file
diff --git a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeEnvironmentFactory.java b/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeEnvironmentFactory.java
deleted file mode 100644
index 2aafd1914f..0000000000
--- a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeEnvironmentFactory.java
+++ /dev/null
@@ -1,118 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
- * indicated by the @author tags or express copyright attribution
- * statements applied by the authors. All third-party contributions are
- * distributed under license by Red Hat Middleware LLC.
- *
- * This copyrighted material is made available to anyone wishing to use, modify,
- * copy, or redistribute it subject to the terms and conditions of the GNU
- * Lesser General Public License, as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
- * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
- * for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this distribution; if not, write to:
- * Free Software Foundation, Inc.
- * 51 Franklin Street, Fifth Floor
- * Boston, MA 02110-1301 USA
- */
-package org.hibernate.annotations.common.reflection.java.generics;
-
-import java.lang.reflect.ParameterizedType;
-import java.lang.reflect.Type;
-import java.lang.reflect.TypeVariable;
-
-/**
- * Returns the type context for a given Class or ParameterizedType.
- *
- * Does not support bindings involving inner classes, nor upper/lower bounds.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-public class TypeEnvironmentFactory {
-
- /**
- * @return Returns a type environment suitable for resolving types occurring
- * in subclasses of the context class.
- */
- public TypeEnvironment getEnvironment(Class context) {
- if ( context == null ) {
- return IdentityTypeEnvironment.INSTANCE;
- }
- return createEnvironment( context );
- }
-
- public TypeEnvironment getEnvironment(Type context) {
- if ( context == null ) {
- return IdentityTypeEnvironment.INSTANCE;
- }
- return createEnvironment( context );
- }
-
- public TypeEnvironment getEnvironment(Type t, TypeEnvironment context) {
- return CompoundTypeEnvironment.create( getEnvironment(t), context );
- }
-
- public TypeEnvironment toApproximatingEnvironment(TypeEnvironment context) {
- return CompoundTypeEnvironment.create( new ApproximatingTypeEnvironment(), context );
- }
-
- private TypeEnvironment createEnvironment(Type context) {
- return new TypeSwitchParameterizedTypes and GenericArrayTypes.
- * These are not supposed to be mixed with Java's implementations - beware of
- * equality/identity problems.
- *
- * @author Paolo Perrotta
- */
-class TypeFactory {
-
- static ParameterizedType createParameterizedType(
- final Type rawType, final Type[] substTypeArgs,
- final Type ownerType
- ) {
- return new ParameterizedType() {
-
- public Type[] getActualTypeArguments() {
- return substTypeArgs;
- }
-
- public Type getRawType() {
- return rawType;
- }
-
- public Type getOwnerType() {
- return ownerType;
- }
-
- @Override
- public boolean equals(Object obj) {
- if ( !( obj instanceof ParameterizedType ) ) {
- return false;
- }
- ParameterizedType other = (ParameterizedType) obj;
- return Arrays.equals( getActualTypeArguments(), other.getActualTypeArguments() )
- && safeEquals( getRawType(), other.getRawType() ) && safeEquals(
- getOwnerType(), other.getOwnerType()
- );
- }
-
- @Override
- public int hashCode() {
- return safeHashCode( getActualTypeArguments() ) ^ safeHashCode( getRawType() ) ^ safeHashCode(
- getOwnerType()
- );
- }
- };
- }
-
- static Type createArrayType(Type componentType) {
- if ( componentType instanceof Class ) {
- return Array.newInstance( (Class) componentType, 0 ).getClass();
- }
- return TypeFactory.createGenericArrayType( componentType );
- }
-
- private static GenericArrayType createGenericArrayType(final Type componentType) {
- return new GenericArrayType() {
-
- public Type getGenericComponentType() {
- return componentType;
- }
-
- @Override
- public boolean equals(Object obj) {
- if ( !( obj instanceof GenericArrayType ) ) {
- return false;
- }
- GenericArrayType other = (GenericArrayType) obj;
- return safeEquals( getGenericComponentType(), other.getGenericComponentType() );
- }
-
- @Override
- public int hashCode() {
- return safeHashCode( getGenericComponentType() );
- }
- };
- }
-
- private static boolean safeEquals(Type t1, Type t2) {
- if ( t1 == null ) {
- return t2 == null;
- }
- return t1.equals( t2 );
- }
-
- private static int safeHashCode(Object o) {
- if ( o == null ) {
- return 1;
- }
- return o.hashCode();
- }
-}
\ No newline at end of file
diff --git a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeSwitch.java b/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeSwitch.java
deleted file mode 100644
index ca9cd76694..0000000000
--- a/commons-annotations/src/main/java/org/hibernate/annotations/common/reflection/java/generics/TypeSwitch.java
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * Hibernate, Relational Persistence for Idiomatic Java
- *
- * Copyright (c) 2008, Red Hat Middleware LLC or third-party contributors as
- * indicated by the @author tags or express copyright attribution
- * statements applied by the authors. All third-party contributions are
- * distributed under license by Red Hat Middleware LLC.
- *
- * This copyrighted material is made available to anyone wishing to use, modify,
- * copy, or redistribute it subject to the terms and conditions of the GNU
- * Lesser General Public License, as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
- * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
- * for more details.
- *
- * You should have received a copy of the GNU Lesser General Public License
- * along with this distribution; if not, write to:
- * Free Software Foundation, Inc.
- * 51 Franklin Street, Fifth Floor
- * Boston, MA 02110-1301 USA
- */
-package org.hibernate.annotations.common.reflection.java.generics;
-
-import java.lang.reflect.GenericArrayType;
-import java.lang.reflect.ParameterizedType;
-import java.lang.reflect.Type;
-import java.lang.reflect.TypeVariable;
-import java.lang.reflect.WildcardType;
-
-/**
- * A visitor for the java.lang.reflect.Type hierarchy.
- *
- * @author Davide Marchignoli
- * @author Paolo Perrotta
- */
-public class TypeSwitch