HHH-3549 : import commons-annotations into core
git-svn-id: https://svn.jboss.org/repos/hibernate/core/trunk@15413 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
parent
1afe62250f
commit
354714caca
|
@ -0,0 +1,3 @@
|
||||||
|
common.dir=.
|
||||||
|
src.dir=src
|
||||||
|
test.dir=test
|
|
@ -0,0 +1,190 @@
|
||||||
|
<project name="Hibernate Commons Annotations" default="dist" basedir="."
|
||||||
|
xmlns:ivy="antlib:fr.jayasoft.ivy.ant">
|
||||||
|
|
||||||
|
<!-- Give user a chance to override without editing this file
|
||||||
|
(and without typing -D each time it compiles it) -->
|
||||||
|
<property file="build.properties"/>
|
||||||
|
<property file="${user.home}/.ant.properties"/>
|
||||||
|
|
||||||
|
<!-- Name of project and version, used to create filenames -->
|
||||||
|
<property name="Name" value="Hibernate Commons Annotations"/>
|
||||||
|
<property name="name" value="hibernate-commons-annotations"/>
|
||||||
|
<property name="version" value="3.1.0.GA"/>
|
||||||
|
<property name="javadoc.packagenames" value="org.hibernate.commons.annotations.*"/>
|
||||||
|
<property name="copy.test" value="true"/>
|
||||||
|
<property name="javac.source" value="1.5"/>
|
||||||
|
<property name="javac.target" value="1.5"/>
|
||||||
|
<property name="common.dir" value="${basedir}"/>
|
||||||
|
<property name="hibernate-core.jar.available" value="true"/>
|
||||||
|
<!-- property name="jpa-api.jar" value="${basedir}/../jpa-api/build/ejb3-persistence.jar"/ -->
|
||||||
|
<property name="ivy.dep.dir" value="${basedir}/build/lib" />
|
||||||
|
|
||||||
|
<import file="${common.dir}/common-build.xml"/>
|
||||||
|
|
||||||
|
<path id="lib.moduleclass.path">
|
||||||
|
<fileset dir="${ivy.dep.dir}/core">
|
||||||
|
<include name="*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</path>
|
||||||
|
|
||||||
|
<path id="junit.moduleclasspath">
|
||||||
|
<pathelement location="${src.dir}"/>
|
||||||
|
<pathelement location="${test.dir}"/>
|
||||||
|
<fileset dir="${ivy.dep.dir}/test">
|
||||||
|
<include name="*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</path>
|
||||||
|
|
||||||
|
<target name="init" description="Initialize the build">
|
||||||
|
<antcall target="common-build.init"/>
|
||||||
|
<tstamp>
|
||||||
|
<format property="now" pattern="yyyyMMddhhmmss"/>
|
||||||
|
</tstamp>
|
||||||
|
<echo message="Build ${Name}-${version} (${subversion})"/>
|
||||||
|
<mkdir dir="${classes.dir}"/>
|
||||||
|
<mkdir dir="${testclasses.dir}"/>
|
||||||
|
<copy todir="${classes.dir}">
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="support.files"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<copy todir="${build.dir}">
|
||||||
|
<fileset dir=".">
|
||||||
|
<include name="readme.txt"/>
|
||||||
|
<include name="lgpl.txt"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<mkdir dir="${ivy.dep.dir}/core"/>
|
||||||
|
<mkdir dir="${ivy.dep.dir}/test"/>
|
||||||
|
<ivy:configure file="${ivy.jar.dir}/ivyconf.xml" />
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="compile" depends="init,get.deps.core"
|
||||||
|
description="Compile the Java source code">
|
||||||
|
<available classname="org.eclipse.core.launcher.Main"
|
||||||
|
property="build.compiler"
|
||||||
|
value="org.eclipse.jdt.core.JDTCompilerAdapter"
|
||||||
|
classpath="${java.class.path}"/>
|
||||||
|
<javac target="${javac.target}" source="${javac.source}"
|
||||||
|
srcdir="${src.dir}" destdir="${classes.dir}"
|
||||||
|
classpathref="lib.class.path" debug="${javac.debug}"
|
||||||
|
optimize="${javac.optimize}" nowarn="on">
|
||||||
|
</javac>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="compiletest" depends="compile,get.deps.test" description="Compile the tests">
|
||||||
|
<available
|
||||||
|
classname="org.eclipse.core.launcher.Main"
|
||||||
|
property="build.compiler"
|
||||||
|
value="org.eclipse.jdt.core.JDTCompilerAdapter"
|
||||||
|
classpath="${java.class.path}"/>
|
||||||
|
<javac
|
||||||
|
target="${javac.target}"
|
||||||
|
source="${javac.source}"
|
||||||
|
destdir="${testclasses.dir}"
|
||||||
|
classpathref="junit.classpath"
|
||||||
|
debug="${javac.debug}"
|
||||||
|
optimize="${javac.optimize}"
|
||||||
|
nowarn="on">
|
||||||
|
<src refid="testsrc.path"/>
|
||||||
|
</javac>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="jar" depends="compile" description="Build the distribution .jar file">
|
||||||
|
<mkdir dir="${classes.dir}/META-INF"/>
|
||||||
|
<manifest file="${classes.dir}/META-INF/MANIFEST.MF">
|
||||||
|
<attribute name="Implementation-Title" value="${Name}"/>
|
||||||
|
<attribute name="Implementation-Version" value="${version}"/>
|
||||||
|
<attribute name="Implementation-Vendor" value="hibernate.org"/>
|
||||||
|
<attribute name="Implementation-Vendor-Id" value="hibernate.org"/>
|
||||||
|
<attribute name="Implementation-URL" value="http://annotations.hibernate.org"/>
|
||||||
|
</manifest>
|
||||||
|
<antcall target="common-build.jar"/>
|
||||||
|
<delete file="${dist.dir}/ivy.xml"/> <!-- delete last produced ivy file to be sure a new one will be generated -->
|
||||||
|
<ivy:resolve conf="default"/>
|
||||||
|
<ivy:publish artifactspattern="${dist.dir}/[artifact].[ext]"
|
||||||
|
resolver="local"
|
||||||
|
pubrevision="latest"
|
||||||
|
pubdate="${now}"
|
||||||
|
status="integration"
|
||||||
|
/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="junit" depends="compiletest">
|
||||||
|
<mkdir dir="${testreports.dir}"/>
|
||||||
|
<junit printsummary="yes" haltonfailure="yes" forkmode="once">
|
||||||
|
<classpath refid="junit.classpath"/>
|
||||||
|
<formatter type="plain"/>
|
||||||
|
<formatter type="xml"/>
|
||||||
|
<batchtest fork="yes" todir="${testreports.dir}" haltonfailure="no">
|
||||||
|
<fileset refid="junit.batchtestset"/>
|
||||||
|
</batchtest>
|
||||||
|
</junit>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<!-- Run a single unit test. -->
|
||||||
|
<target name="junitsingle" depends="compiletest" description="Run a single test suite (requires testname and jdbc.driver properties)">
|
||||||
|
<mkdir dir="${testreports.dir}"/>
|
||||||
|
<junit printsummary="yes" fork="yes" haltonfailure="yes">
|
||||||
|
<classpath refid="junit.classpath"/>
|
||||||
|
<formatter type="plain"/>
|
||||||
|
<formatter type="xml"/>
|
||||||
|
<test fork="yes" todir="${testreports.dir}" haltonfailure="no" name="${testname}"/>
|
||||||
|
</junit>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<!-- Some of this can probably be moved to common-build... -->
|
||||||
|
<target name="dist" depends="jar,get.deps.core,get.deps.test,javadoc,copysource,copytest,copylib,extras" description="Build everything">
|
||||||
|
|
||||||
|
<copy todir="${dist.dir}" failonerror="false">
|
||||||
|
<fileset dir="${common.dir}">
|
||||||
|
<include name="common-build.xml"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<copy file="${basedir}/build.properties.dist" tofile="${dist.dir}/build.properties" failonerror="false">
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<!-- copy dependencies -->
|
||||||
|
<copy todir="${dist.lib.dir}" failonerror="false">
|
||||||
|
<!-- fileset file="${jpa-api.jar}"/>
|
||||||
|
<fileset file="${commons-annotations.jar}"/ -->
|
||||||
|
<fileset dir="${ivy.dep.dir}/core">
|
||||||
|
<include name="*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<mkdir dir="${dist.lib.dir}/test"/>
|
||||||
|
<copy todir="${dist.lib.dir}/test" failonerror="false">
|
||||||
|
<fileset dir="${ivy.dep.dir}/test">
|
||||||
|
<include name="*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<mkdir dir="${dist.lib.dir}/build"/>
|
||||||
|
<copy todir="${dist.lib.dir}/build" failonerror="false">
|
||||||
|
<fileset file="${lib.dir}/build/*.jar"/>
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<copy todir="${dist.dir}/ivy" failonerror="false">
|
||||||
|
<fileset dir="${ivy.jar.dir}">
|
||||||
|
<include name="**/*.*"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<copy file="${basedir}/build.properties.dist" tofile="${dist.dir}/build.properties" failonerror="false">
|
||||||
|
</copy>
|
||||||
|
|
||||||
|
<antcall target="common-build.dist"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="zip-dist" description="zip the dist">
|
||||||
|
<zip zipfile="${dist.dir}-${version}.zip">
|
||||||
|
<zipfileset prefix="${name}-${version}" dir="${dist.dir}"/>
|
||||||
|
</zip>
|
||||||
|
<tar compression="gzip" tarfile="${dist.dir}-${version}.tar.gz">
|
||||||
|
<tarfileset prefix="${name}-${version}" dir="${dist.dir}"/>
|
||||||
|
</tar>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
|
||||||
|
</project>
|
|
@ -0,0 +1,25 @@
|
||||||
|
Hibernate Annotations Changelog
|
||||||
|
===============================
|
||||||
|
|
||||||
|
3.1.0.GA (20-08-2008)
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
3.1.0.CR2 (23-07-2008)
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
** Bug
|
||||||
|
* [HCANN-4] - NullPointerException in JavaXCollectionType
|
||||||
|
|
||||||
|
|
||||||
|
3.1.0.CR1 (27-05-2008)
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
** New Feature
|
||||||
|
* [HCANN-1] - Move to slf4j
|
||||||
|
* [HCANN-2] - Add POM
|
||||||
|
* [HCANN-3] - Make build independent of Hibernate Core structure
|
||||||
|
|
||||||
|
3.0.0.GA (19-03-2007)
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
Initial release as a standalone product (see Hibernate Annotations changelog for previous informations)
|
|
@ -0,0 +1,456 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project name="common-build" default="dist"
|
||||||
|
xmlns:artifact="urn:maven-artifact-ant" xmlns:ivy="antlib:fr.jayasoft.ivy.ant">
|
||||||
|
<description>Common properties and targets for the HibernateExt
|
||||||
|
project</description>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- my.basedir property can be used to refer to files/directories relatively to the common-build.xml file -->
|
||||||
|
<dirname property="common-build.basedir" file="${ant.file.common-build}"/>
|
||||||
|
|
||||||
|
<!-- Give user a chance to override without editing this file
|
||||||
|
(and without typing -D each time it compiles it) -->
|
||||||
|
<property file="${common-build.basedir}/build.properties"/>
|
||||||
|
<property file="${user.home}/.ant.properties"/>
|
||||||
|
|
||||||
|
<property name="src.dir" location="src/java"/>
|
||||||
|
<property name="test.dir" location="src/test"/>
|
||||||
|
<property name="test.resources.dir" location="src/test-resources"/>
|
||||||
|
<property name="filter.dir" location="src/filters"/>
|
||||||
|
<property name="lib.dir" location="lib"/>
|
||||||
|
<property name="build.dir" location="build"/>
|
||||||
|
<property name="classes.dir" location="${build.dir}/classes"/>
|
||||||
|
<property name="testclasses.dir" location="${build.dir}/testclasses"/>
|
||||||
|
<property name="testreports.dir" location="${build.dir}/test-reports"/>
|
||||||
|
<property name="dist.target.dir" location="target"/>
|
||||||
|
<property name="dist.dir" location="${dist.target.dir}/${name}"/>
|
||||||
|
<property name="instrumenttest.out.dir" value="${build.dir}/test-reports/instrument"/>
|
||||||
|
<property name="doc.dir" location="doc"/>
|
||||||
|
<property name="doc.api.dir" location="${doc.dir}/api"/>
|
||||||
|
<property name="doc.reference.dir" location="${doc.dir}/reference"/>
|
||||||
|
|
||||||
|
<property name="dist.doc.dir" location="${dist.dir}/doc"/>
|
||||||
|
<property name="dist.api.dir" location="${dist.dir}/doc/api"/>
|
||||||
|
|
||||||
|
<property name="dist.src.dir" location="${dist.dir}/src"/>
|
||||||
|
<property name="dist.test.dir" location="${dist.dir}/test"/>
|
||||||
|
<property name="dist.lib.dir" location="${dist.dir}/lib"/>
|
||||||
|
<property name="jar.name" value="${name}"/>
|
||||||
|
<property name="jar.file.name" value="${dist.dir}/${jar.name}.jar"/>
|
||||||
|
<property name="jartest.file.name" value="${dist.dir}/${jar.name}-tests.jar"/>
|
||||||
|
|
||||||
|
<property name="javadoc" value="http://java.sun.com/j2se/1.4/docs/api"/>
|
||||||
|
<property name="javac.debug" value="on"/>
|
||||||
|
<property name="javac.optimize" value="off"/>
|
||||||
|
<property name="javac.source" value="1.4"/>
|
||||||
|
<property name="javac.target" value="1.4"/>
|
||||||
|
|
||||||
|
<property name="pom.file" value="${build.dir}/pom.xml"/>
|
||||||
|
<property name="src.jar" value="${build.dir}/src.jar"/>
|
||||||
|
|
||||||
|
<taskdef name="junit"
|
||||||
|
classname="org.apache.tools.ant.taskdefs.optional.junit.JUnitTask">
|
||||||
|
<classpath>
|
||||||
|
<fileset dir="${common-build.basedir}/lib/build">
|
||||||
|
<!-- ${build.lib.dir} fails in reference doc build -->
|
||||||
|
<include name="junit-*.jar"/>
|
||||||
|
<include name="ant-junit-*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</classpath>
|
||||||
|
</taskdef>
|
||||||
|
|
||||||
|
<taskdef name="junitreport"
|
||||||
|
classname="org.apache.tools.ant.taskdefs.optional.junit.XMLResultAggregator">
|
||||||
|
<classpath>
|
||||||
|
<fileset dir="${common-build.basedir}/lib/build">
|
||||||
|
<!-- ${build.lib.dir} fails in reference doc build -->
|
||||||
|
<include name="junit-*.jar"/>
|
||||||
|
<include name="ant-junit-*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</classpath>
|
||||||
|
</taskdef>
|
||||||
|
|
||||||
|
<taskdef resource="net/sf/antcontrib/antlib.xml">
|
||||||
|
<classpath>
|
||||||
|
<fileset dir="${common-build.basedir}/lib/build">
|
||||||
|
<!-- ${build.lib.dir} fails in reference doc build -->
|
||||||
|
<include name="ant-contrib-*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</classpath>
|
||||||
|
</taskdef>
|
||||||
|
|
||||||
|
<!-- ivy load -->
|
||||||
|
<property name="ivy.jar.dir" value="${common-build.basedir}/ivy"/>
|
||||||
|
<property name="ivy.conf.dir" value="${common-build.basedir}"/>
|
||||||
|
<path id="ivy.lib.path">
|
||||||
|
<fileset dir="${ivy.jar.dir}" includes="*.jar"/>
|
||||||
|
</path>
|
||||||
|
<taskdef resource="fr/jayasoft/ivy/ant/antlib.xml"
|
||||||
|
uri="antlib:fr.jayasoft.ivy.ant" classpathref="ivy.lib.path"/>
|
||||||
|
|
||||||
|
<!-- maven task load -->
|
||||||
|
<path id="maven-ant-tasks.path" path="${ivy.jar.dir}/maven-ant-tasks.jar"/>
|
||||||
|
<typedef resource="org/apache/maven/artifact/ant/antlib.xml"
|
||||||
|
uri="urn:maven-artifact-ant" classpathref="maven-ant-tasks.path"/>
|
||||||
|
|
||||||
|
<artifact:remoteRepository id="offline.repository.jboss.org"
|
||||||
|
url="file://${offline.repository.jboss.org}"/>
|
||||||
|
|
||||||
|
<path id="lib.class.path">
|
||||||
|
<path refid="lib.moduleclass.path"/>
|
||||||
|
<pathelement path="${clover.jar}"/>
|
||||||
|
</path>
|
||||||
|
|
||||||
|
<!-- overridable in modules -->
|
||||||
|
<path id="lib.moduleclass.path"/>
|
||||||
|
|
||||||
|
<patternset id="support.files">
|
||||||
|
<include name="**/*.jpg"/>
|
||||||
|
<include name="**/*.gif"/>
|
||||||
|
<include name="**/*.dtd"/>
|
||||||
|
<include name="**/*.xsd"/>
|
||||||
|
<include name="**/*.xml"/>
|
||||||
|
<include name="**/*.xslt"/>
|
||||||
|
|
||||||
|
<!-- exclude everything we don't want in the jar -->
|
||||||
|
<exclude name="${build.dir}/**/*"/>
|
||||||
|
<exclude name="${doc.dir}/**/*"/>
|
||||||
|
<exclude name="classes/**/*"/>
|
||||||
|
<exclude name="build.xml"/>
|
||||||
|
<exclude name="**/*.properties"/>
|
||||||
|
<exclude name="**/*.ccf"/>
|
||||||
|
<exclude name="**/*.cfg.xml"/>
|
||||||
|
<exclude name="**/ehcache.xml"/>
|
||||||
|
</patternset>
|
||||||
|
|
||||||
|
<patternset id="source.files">
|
||||||
|
<include name="**/*.java"/>
|
||||||
|
<include name="**/*.properties"/>
|
||||||
|
</patternset>
|
||||||
|
|
||||||
|
<!-- junit paths/filesets -->
|
||||||
|
<fileset dir="${testclasses.dir}" id="junit.batchtestset">
|
||||||
|
<include name="**/*Test.class"/>
|
||||||
|
</fileset>
|
||||||
|
|
||||||
|
<path id="testsrc.path">
|
||||||
|
<pathelement location="${test.dir}"/>
|
||||||
|
</path>
|
||||||
|
|
||||||
|
<path id="junit.classpath">
|
||||||
|
<pathelement path="${classes.dir}"/>
|
||||||
|
<pathelement path="${testclasses.dir}"/>
|
||||||
|
<path refid="lib.class.path"/>
|
||||||
|
<path refid="junit.moduleclasspath"/>
|
||||||
|
<path location="${clover.jar}"/>
|
||||||
|
</path>
|
||||||
|
|
||||||
|
<!-- Determine the database against which to run tests-->
|
||||||
|
<if>
|
||||||
|
<equals arg1="${targetdb}" arg2="$${targetdb}"/>
|
||||||
|
<then>
|
||||||
|
<echo message="No target database specified using default HSQLDB"/>
|
||||||
|
<property name="targetdb" value="hsqldb"/>
|
||||||
|
</then>
|
||||||
|
</if>
|
||||||
|
|
||||||
|
<!-- Clover tasks -->
|
||||||
|
<target name="with.clover">
|
||||||
|
<clover-setup initString="clover_coverage.db"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="cloverreport.html" depends="with.clover"
|
||||||
|
description="Generate a clover report from the current clover database.">
|
||||||
|
<clover-report>
|
||||||
|
<current outfile="${clover.out.dir}">
|
||||||
|
<format type="html"/>
|
||||||
|
</current>
|
||||||
|
</clover-report>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="cloverreport"
|
||||||
|
depends="with.clover,junitreport,cloverreport.html"
|
||||||
|
description="Run the tests and generate a clover report">
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<!-- Tasks -->
|
||||||
|
<target name="clean" description="Cleans up build and dist directories">
|
||||||
|
<delete dir="${build.dir}"/>
|
||||||
|
<delete dir="${dist.target.dir}"/>
|
||||||
|
<delete dir="${clover.out.dir}"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="init" description="Initialize the build">
|
||||||
|
<tstamp>
|
||||||
|
<format property="subversion" pattern="yyyy-MM-dd hh:mm:ss"/>
|
||||||
|
</tstamp>
|
||||||
|
<tstamp>
|
||||||
|
<format property="releasedate" pattern="dd-MM-yyyy"/>
|
||||||
|
</tstamp>
|
||||||
|
<echo message="Build ${Name}-${version} (${subversion})"/>
|
||||||
|
<mkdir dir="${classes.dir}"/>
|
||||||
|
<mkdir dir="${testclasses.dir}"/>
|
||||||
|
<copy todir="${classes.dir}">
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="support.files"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<filter token="version" value="${version}"/>
|
||||||
|
<filter token="releasedate" value="${releasedate}"/>
|
||||||
|
<echo>filtering</echo>
|
||||||
|
<copy todir="${build.dir}" filtering="true">
|
||||||
|
<fileset dir=".">
|
||||||
|
<include name="readme.txt"/>
|
||||||
|
<include name="lgpl.txt"/>
|
||||||
|
<include name="pom.xml"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="get.deps.core" depends="init"
|
||||||
|
description="retrieve the core dependencies">
|
||||||
|
<ivy:resolve conf="default"/>
|
||||||
|
<ivy:retrieve pattern="${ivy.dep.dir}/core/[artifact].[ext]"
|
||||||
|
conf="default"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="get.deps.test" depends="init"
|
||||||
|
description="retrieve the test dependencies">
|
||||||
|
<ivy:resolve conf="test"/>
|
||||||
|
<ivy:retrieve pattern="${ivy.dep.dir}/test/[artifact].[ext]" conf="test"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="copytest" description="Copy tests to dist dir" if="copy.test">
|
||||||
|
<mkdir dir="${dist.test.dir}"/>
|
||||||
|
<copy todir="${dist.test.dir}">
|
||||||
|
<fileset dir="${test.dir}"/>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="copysource" depends="copytest"
|
||||||
|
description="Copy sources to dist dir">
|
||||||
|
<mkdir dir="${dist.src.dir}"/>
|
||||||
|
<copy todir="${dist.src.dir}">
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="source.files"/>
|
||||||
|
</fileset>
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="support.files"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<mkdir dir="${dist.src.dir}"/>
|
||||||
|
<copy todir="${dist.src.dir}">
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="source.files"/>
|
||||||
|
</fileset>
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<patternset refid="support.files"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="copylib" description="Copy jars to lib dir">
|
||||||
|
<mkdir dir="${dist.lib.dir}"/>
|
||||||
|
<copy todir="${dist.lib.dir}" verbose="true">
|
||||||
|
<fileset dir="${lib.dir}">
|
||||||
|
<include name="**/*.jar"/>
|
||||||
|
<exclude name="log4j.jar"/>
|
||||||
|
<exclude name="checkstyle*.jar"/>
|
||||||
|
<include name="*.txt"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="copydoc" description="Copy doc to dist dir" if="copy.doc">
|
||||||
|
<mkdir dir="${dist.doc.dir}"/>
|
||||||
|
<copy todir="${dist.doc.dir}">
|
||||||
|
<fileset dir="${doc.dir}">
|
||||||
|
<include name="**/*.html"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="jar" depends="compile"
|
||||||
|
description="Build the distribution .jar file">
|
||||||
|
<mkdir dir="${dist.dir}"/>
|
||||||
|
<jar filesetmanifest="merge" jarfile="${jar.file.name}"
|
||||||
|
basedir="${classes.dir}"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="jartest" depends="compiletest"
|
||||||
|
description="Build the distribution .jar file">
|
||||||
|
<mkdir dir="${dist.dir}"/>
|
||||||
|
<jar filesetmanifest="merge" jarfile="${jartest.file.name}"
|
||||||
|
basedir="${testclasses.dir}"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<!-- DOCUMENTATION -->
|
||||||
|
|
||||||
|
<target name="javadoc"
|
||||||
|
description="Compile the Javadoc API documentation to dist dir">
|
||||||
|
<mkdir dir="${dist.api.dir}"/>
|
||||||
|
<javadoc packagenames="${javadoc.packagenames}"
|
||||||
|
classpathref="lib.class.path" destdir="${dist.api.dir}" use="true"
|
||||||
|
protected="true" version="true"
|
||||||
|
windowtitle="${Name} API Documentation"
|
||||||
|
Overview="${doc.api.dir}/package.html"
|
||||||
|
doctitle="${Name} API Documentation"
|
||||||
|
stylesheetfile="${doc.api.dir}/jdstyle.css" link="${javadoc}">
|
||||||
|
<packageset dir="${src.dir}" defaultexcludes="yes">
|
||||||
|
<include name="**/*"/>
|
||||||
|
</packageset>
|
||||||
|
</javadoc>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="extras" description="Copies miscellaneous files to root dir">
|
||||||
|
<copy todir="${dist.dir}/bin" failonerror="false">
|
||||||
|
<fileset dir="bin">
|
||||||
|
<include name="*.bat"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
<copy file="${build.dir}/readme.txt" todir="${dist.dir}"/>
|
||||||
|
<copy file="lgpl.txt" todir="${dist.dir}"/>
|
||||||
|
<copy file="changelog.txt" todir="${dist.dir}"/>
|
||||||
|
<copy file="build.xml" todir="${dist.dir}"/>
|
||||||
|
<replace file="${dist.dir}/build.xml">
|
||||||
|
<replacetoken><![CDATA[../${name}-${version}]]>
|
||||||
|
</replacetoken>
|
||||||
|
<replacevalue><![CDATA[../${name}]]>
|
||||||
|
</replacevalue>
|
||||||
|
</replace>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="dist" depends="jar,javadoc,copysource,copydoc,extras"
|
||||||
|
description="Build everything">
|
||||||
|
<zip zipfile="${dist.dir}-${version}.zip">
|
||||||
|
<zipfileset prefix="${name}-${version}" dir="${dist.dir}"/>
|
||||||
|
</zip>
|
||||||
|
<tar compression="gzip" tarfile="${dist.dir}-${version}.tar.gz">
|
||||||
|
<tarfileset prefix="${name}-${version}" dir="${dist.dir}"/>
|
||||||
|
</tar>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="info" description="Echoes useful system properties">
|
||||||
|
<echo message="java.vm.info=${java.vm.info}"/>
|
||||||
|
<echo message="java.vm.name=${java.vm.name}"/>
|
||||||
|
<echo message="java.vm.vendor=${java.vm.vendor}"/>
|
||||||
|
<echo message="java.vm.version=${java.vm.version}"/>
|
||||||
|
<echo message="os.arch=${os.arch}"/>
|
||||||
|
<echo message="os.name=${os.name}"/>
|
||||||
|
<echo message="os.version=${os.version}"/>
|
||||||
|
<echo message="java.home = ${java.home}"/>
|
||||||
|
<echo message="java.class.path = ${java.class.path}"/>
|
||||||
|
<echo message="build.compiler = ${build.compiler}"/>
|
||||||
|
<echo message="file.encoding=${file.encoding}"/>
|
||||||
|
<echo message="user.home = ${user.home}"/>
|
||||||
|
<echo message="user.language=${user.language}"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="test-resources" description="Copies and filters test resources">
|
||||||
|
<filter filtersfile="${filter.dir}/${db}.filter"/>
|
||||||
|
<mkdir dir="${testclasses.dir}"/>
|
||||||
|
<copy todir="${testclasses.dir}" filtering="true" overwrite="true">
|
||||||
|
<fileset dir="${test.resources.dir}">
|
||||||
|
<include name="*.properties"/>
|
||||||
|
<include name="*.xml"/>
|
||||||
|
</fileset>
|
||||||
|
</copy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="instrument" depends="compiletest"
|
||||||
|
description="Instrument the persistent classes"> <!-- depends="jar" -->
|
||||||
|
|
||||||
|
<taskdef name="instrument"
|
||||||
|
classname="org.hibernate.tool.instrument.javassist.InstrumentTask">
|
||||||
|
<classpath refid="junit.classpath"/>
|
||||||
|
</taskdef>
|
||||||
|
|
||||||
|
<instrument verbose="true">
|
||||||
|
<fileset dir="${testclasses.dir}/org/hibernate/test">
|
||||||
|
<include name="**/*.class"/>
|
||||||
|
<exclude name="**/*Test$*.class"/>
|
||||||
|
<exclude name="**/*Test.class"/>
|
||||||
|
<exclude name="**/*Tests.class"/>
|
||||||
|
</fileset>
|
||||||
|
</instrument>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="junitinstrument" depends="compiletest,instrument"
|
||||||
|
description="Run the instrument test suite">
|
||||||
|
<for list="${targetdb}" param="db">
|
||||||
|
<sequential>
|
||||||
|
<antcall target="test-resources">
|
||||||
|
<param name="db" value="@{db}"/>
|
||||||
|
</antcall>
|
||||||
|
<mkdir dir="${instrumenttest.out.dir}/@{db}"/>
|
||||||
|
<echo>Running against db: @{db}</echo>
|
||||||
|
<junit printsummary="yes" haltonfailure="yes" dir="${basedir}"
|
||||||
|
maxmemory="256M" fork="yes" forkmode="perBatch">
|
||||||
|
<classpath refid="junit.classpath"/>
|
||||||
|
<formatter type="plain"/>
|
||||||
|
<formatter type="xml"/>
|
||||||
|
<batchtest todir="${instrumenttest.out.dir}/@{db}" haltonfailure="no">
|
||||||
|
<fileset refid="junit.batchtestset"/>
|
||||||
|
</batchtest>
|
||||||
|
</junit>
|
||||||
|
</sequential>
|
||||||
|
</for>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="junitreport" depends="">
|
||||||
|
<junitreport todir="${testreports.dir}">
|
||||||
|
<fileset dir="${testreports.dir}">
|
||||||
|
<include name="TEST-*.xml"/>
|
||||||
|
</fileset>
|
||||||
|
<report format="frames" todir="${testreports.dir}"/>
|
||||||
|
</junitreport>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="checkstyle" description="Check coding style">
|
||||||
|
<taskdef resource="checkstyletask.properties">
|
||||||
|
<classpath>
|
||||||
|
<path refid="lib.class.path"/>
|
||||||
|
<fileset dir="${common-build.basedir}/lib">
|
||||||
|
<include name="checkstyle*.jar"/>
|
||||||
|
</fileset>
|
||||||
|
</classpath>
|
||||||
|
</taskdef>
|
||||||
|
|
||||||
|
<checkstyle config="${common-build.basedir}/checkstyle_checks.xml">
|
||||||
|
<fileset dir="${src.dir}">
|
||||||
|
<include name="**/*.java"/>
|
||||||
|
</fileset>
|
||||||
|
<formatter type="plain"/>
|
||||||
|
</checkstyle>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<target name="patch" depends="checkstyle" description="Create a patch">
|
||||||
|
<cvs command="-q diff -u -N" output="patch.txt"/>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
<!-- maven deploy: to be used by the subbuild and delcare deps on jar -->
|
||||||
|
<target name="deploy" depends="jar">
|
||||||
|
<fail unless="offline.repository.jboss.org"
|
||||||
|
message="offline.repository.jboss.org must be defined"/>
|
||||||
|
<jar jarfile="${src.jar}" basedir="${src.dir}">
|
||||||
|
<include name="**/*.java"/>
|
||||||
|
<exclude name="**/test/*.java"/>
|
||||||
|
<!-- patternset refid="meta.files" / -->
|
||||||
|
</jar>
|
||||||
|
|
||||||
|
<artifact:pom id="maven.project" file="${pom.file}"/>
|
||||||
|
|
||||||
|
<artifact:install file="${jar.file.name}">
|
||||||
|
<pom refid="maven.project"/>
|
||||||
|
</artifact:install>
|
||||||
|
|
||||||
|
<artifact:deploy file="${jar.file.name}">
|
||||||
|
<pom refid="maven.project"/>
|
||||||
|
<remoteRepository refId="offline.repository.jboss.org">
|
||||||
|
</remoteRepository>
|
||||||
|
<attach file="${src.jar}" classifier="sources"/>
|
||||||
|
<attach file="${jar.file.name}" classifier=""/>
|
||||||
|
</artifact:deploy>
|
||||||
|
</target>
|
||||||
|
|
||||||
|
</project>
|
|
@ -0,0 +1,117 @@
|
||||||
|
/* Javadoc style sheet */
|
||||||
|
|
||||||
|
/* Define colors, fonts and other style attributes here to override the defaults */
|
||||||
|
|
||||||
|
/* Page background color */
|
||||||
|
body { font-family: Arial;
|
||||||
|
background-color: white;
|
||||||
|
font-size: 10pt;
|
||||||
|
}
|
||||||
|
td { font-family: Arial;
|
||||||
|
font-size: 10pt;
|
||||||
|
}
|
||||||
|
/* Table colors */
|
||||||
|
.TableHeadingColor { background: #F4F4F4 }
|
||||||
|
.TableSubHeadingColor { background: #F4F4F4 }
|
||||||
|
.TableRowColor { background: #FFFFFF }
|
||||||
|
|
||||||
|
/* Font used in left-hand frame lists */
|
||||||
|
.FrameTitleFont { font-size: normal; font-family: Arial }
|
||||||
|
.FrameHeadingFont { font-size: normal; font-family: Arial }
|
||||||
|
.FrameItemFont { font-size: normal; font-family: Arial }
|
||||||
|
|
||||||
|
/* Example of smaller, sans-serif font in frames */
|
||||||
|
/* .FrameItemFont { font-size: 10pt; font-family: Helvetica, Arial, sans-serif } */
|
||||||
|
|
||||||
|
/* Navigation bar fonts and colors */
|
||||||
|
.NavBarCell1 { background-color:#F4F4F4;}
|
||||||
|
.NavBarCell1Rev { background-color:silver;}
|
||||||
|
|
||||||
|
.NavBarFont1 { font-family: Arial, Helvetica, sans-serif; color:#000000;}
|
||||||
|
.NavBarFont1Rev { font-family: Arial, Helvetica, sans-serif; color:#FFFFFF;}
|
||||||
|
|
||||||
|
.NavBarCell2 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
|
||||||
|
.NavBarCell3 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
|
||||||
|
|
||||||
|
A {
|
||||||
|
color: #003399;
|
||||||
|
}
|
||||||
|
|
||||||
|
A:active {
|
||||||
|
color: #003399;
|
||||||
|
}
|
||||||
|
|
||||||
|
A:visited {
|
||||||
|
color: #888888;
|
||||||
|
}
|
||||||
|
|
||||||
|
P, OL, UL, LI, DL, DT, DD, BLOCKQUOTE {
|
||||||
|
color: #000000;
|
||||||
|
}
|
||||||
|
|
||||||
|
TD, TH, SPAN {
|
||||||
|
color: #000000;
|
||||||
|
}
|
||||||
|
|
||||||
|
BLOCKQUOTE {
|
||||||
|
margin-right: 0px;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/*H1, H2, H3, H4, H5, H6 {
|
||||||
|
color: #000000;
|
||||||
|
font-weight:500;
|
||||||
|
margin-top:10px;
|
||||||
|
padding-top:15px;
|
||||||
|
}
|
||||||
|
|
||||||
|
H1 { font-size: 150%; }
|
||||||
|
H2 { font-size: 140%; }
|
||||||
|
H3 { font-size: 110%; font-weight: bold; }
|
||||||
|
H4 { font-size: 110%; font-weight: bold;}
|
||||||
|
H5 { font-size: 100%; font-style: italic; }
|
||||||
|
H6 { font-size: 100%; font-style: italic; }*/
|
||||||
|
|
||||||
|
TT {
|
||||||
|
font-size: 90%;
|
||||||
|
font-family: "Courier New", Courier, monospace;
|
||||||
|
color: #000000;
|
||||||
|
}
|
||||||
|
|
||||||
|
PRE {
|
||||||
|
font-size: 90%;
|
||||||
|
padding: 5px;
|
||||||
|
border-style: solid;
|
||||||
|
border-width: 1px;
|
||||||
|
border-color: #CCCCCC;
|
||||||
|
background-color: #F4F4F4;
|
||||||
|
}
|
||||||
|
|
||||||
|
UL, OL, LI {
|
||||||
|
list-style: disc;
|
||||||
|
}
|
||||||
|
|
||||||
|
HR {
|
||||||
|
width: 100%;
|
||||||
|
height: 1px;
|
||||||
|
background-color: #CCCCCC;
|
||||||
|
border-width: 0px;
|
||||||
|
padding: 0px;
|
||||||
|
color: #CCCCCC;
|
||||||
|
}
|
||||||
|
|
||||||
|
.variablelist {
|
||||||
|
padding-top: 10;
|
||||||
|
padding-bottom:10;
|
||||||
|
margin:0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.itemizedlist, UL {
|
||||||
|
padding-top: 0;
|
||||||
|
padding-bottom:0;
|
||||||
|
margin:0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.term {
|
||||||
|
font-weight:bold;
|
||||||
|
}
|
|
@ -0,0 +1 @@
|
||||||
|
<body></body>
|
|
@ -0,0 +1,24 @@
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<ivy-module version="1.3"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:noNamespaceSchemaLocation=
|
||||||
|
"http://www.jayasoft.org/misc/ivy/ivy.xsd">
|
||||||
|
<info organisation="org.hibernate" module="commons-annotations"/>
|
||||||
|
<configurations>
|
||||||
|
<conf name="default" description="Core module dependencies"/>
|
||||||
|
<conf name="test" visibility="private" description="Dependencies needed for testing purposes"/>
|
||||||
|
</configurations>
|
||||||
|
<publications>
|
||||||
|
<artifact name="hibernate-commons-annotations" conf="default"/>
|
||||||
|
</publications>
|
||||||
|
<dependencies>
|
||||||
|
<!-- compile time dependencies -->
|
||||||
|
<dependency org="org.slf4j" name="slf4j-api" rev="1.4.2" conf="default->default"/>
|
||||||
|
|
||||||
|
<!-- test deps -->
|
||||||
|
<dependency name="ejb3-persistence" rev="1.0.2.GA" conf="test->default"/>
|
||||||
|
<dependency org="org.slf4j" name="slf4j-log4j12" rev="1.4.2" conf="test->default"/>
|
||||||
|
<dependency org="log4j" name="log4j" rev="1.2.14" conf="test->default"/>
|
||||||
|
<dependency org="junit" name="junit" rev="3.8.1" conf="test->default"/>
|
||||||
|
</dependencies>
|
||||||
|
</ivy-module>
|
Binary file not shown.
|
@ -0,0 +1,33 @@
|
||||||
|
<ivyconf>
|
||||||
|
<!-- conf defaultResolver="jboss-rep"/ -->
|
||||||
|
<conf defaultResolver="jboss-rep"/>
|
||||||
|
<resolvers>
|
||||||
|
<chain name="jboss-rep">
|
||||||
|
<url name="jboss-rep-regular" m2compatible="true">
|
||||||
|
<artifact pattern="http://repository.jboss.org/maven2/[organization]/[module]/[revision]/[artifact]-[revision].[ext]"/>
|
||||||
|
</url>
|
||||||
|
</chain>
|
||||||
|
<chain name="rep-hibernate" returnFirst="true" latest="latest-revision">
|
||||||
|
<filesystem name="local">
|
||||||
|
<ivy pattern="../[module]/target/[revision]/ivy.xml"/>
|
||||||
|
<artifact pattern="../[module]/target/[revision]/[artifact].[ext]"/>
|
||||||
|
</filesystem>
|
||||||
|
<filesystem name="hudson-local">
|
||||||
|
<ivy pattern="../../[module]/trunk/target/hibernate-[module]/ivy.xml"/>
|
||||||
|
<artifact pattern="../../[module]/trunk/target/hibernate-[module]/[artifact].[ext]"/>
|
||||||
|
</filesystem>
|
||||||
|
<filesystem name="maven-local" m2compatible="true">
|
||||||
|
<artifact pattern="${offline.repository.jboss.org}/[organization]/hibernate-[module]/[revision]/hibernate-[artifact]-[revision].[ext]"/>
|
||||||
|
</filesystem>
|
||||||
|
<url name="jboss-rep-maven-regular" m2compatible="true">
|
||||||
|
<artifact pattern="http://repository.jboss.org/maven2/[organization]/[module]/[revision]/[artifact]-[revision].[ext]"/>
|
||||||
|
</url>
|
||||||
|
<url name="jboss-rep-maven-regular" m2compatible="true">
|
||||||
|
<artifact pattern="http://repository.jboss.org/maven2/[organization]/hibernate-[module]/[revision]/hibernate-[artifact]-[revision].[ext]"/>
|
||||||
|
</url>
|
||||||
|
</chain>
|
||||||
|
</resolvers>
|
||||||
|
<modules>
|
||||||
|
<module organisation="org.hibernate" name="*" resolver="rep-hibernate"/>
|
||||||
|
</modules>
|
||||||
|
</ivyconf>
|
Binary file not shown.
|
@ -0,0 +1,504 @@
|
||||||
|
GNU LESSER GENERAL PUBLIC LICENSE
|
||||||
|
Version 2.1, February 1999
|
||||||
|
|
||||||
|
Copyright (C) 1991, 1999 Free Software Foundation, Inc.
|
||||||
|
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
[This is the first released version of the Lesser GPL. It also counts
|
||||||
|
as the successor of the GNU Library Public License, version 2, hence
|
||||||
|
the version number 2.1.]
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The licenses for most software are designed to take away your
|
||||||
|
freedom to share and change it. By contrast, the GNU General Public
|
||||||
|
Licenses are intended to guarantee your freedom to share and change
|
||||||
|
free software--to make sure the software is free for all its users.
|
||||||
|
|
||||||
|
This license, the Lesser General Public License, applies to some
|
||||||
|
specially designated software packages--typically libraries--of the
|
||||||
|
Free Software Foundation and other authors who decide to use it. You
|
||||||
|
can use it too, but we suggest you first think carefully about whether
|
||||||
|
this license or the ordinary General Public License is the better
|
||||||
|
strategy to use in any particular case, based on the explanations below.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom of use,
|
||||||
|
not price. Our General Public Licenses are designed to make sure that
|
||||||
|
you have the freedom to distribute copies of free software (and charge
|
||||||
|
for this service if you wish); that you receive source code or can get
|
||||||
|
it if you want it; that you can change the software and use pieces of
|
||||||
|
it in new free programs; and that you are informed that you can do
|
||||||
|
these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to make restrictions that forbid
|
||||||
|
distributors to deny you these rights or to ask you to surrender these
|
||||||
|
rights. These restrictions translate to certain responsibilities for
|
||||||
|
you if you distribute copies of the library or if you modify it.
|
||||||
|
|
||||||
|
For example, if you distribute copies of the library, whether gratis
|
||||||
|
or for a fee, you must give the recipients all the rights that we gave
|
||||||
|
you. You must make sure that they, too, receive or can get the source
|
||||||
|
code. If you link other code with the library, you must provide
|
||||||
|
complete object files to the recipients, so that they can relink them
|
||||||
|
with the library after making changes to the library and recompiling
|
||||||
|
it. And you must show them these terms so they know their rights.
|
||||||
|
|
||||||
|
We protect your rights with a two-step method: (1) we copyright the
|
||||||
|
library, and (2) we offer you this license, which gives you legal
|
||||||
|
permission to copy, distribute and/or modify the library.
|
||||||
|
|
||||||
|
To protect each distributor, we want to make it very clear that
|
||||||
|
there is no warranty for the free library. Also, if the library is
|
||||||
|
modified by someone else and passed on, the recipients should know
|
||||||
|
that what they have is not the original version, so that the original
|
||||||
|
author's reputation will not be affected by problems that might be
|
||||||
|
introduced by others.
|
||||||
|
|
||||||
|
Finally, software patents pose a constant threat to the existence of
|
||||||
|
any free program. We wish to make sure that a company cannot
|
||||||
|
effectively restrict the users of a free program by obtaining a
|
||||||
|
restrictive license from a patent holder. Therefore, we insist that
|
||||||
|
any patent license obtained for a version of the library must be
|
||||||
|
consistent with the full freedom of use specified in this license.
|
||||||
|
|
||||||
|
Most GNU software, including some libraries, is covered by the
|
||||||
|
ordinary GNU General Public License. This license, the GNU Lesser
|
||||||
|
General Public License, applies to certain designated libraries, and
|
||||||
|
is quite different from the ordinary General Public License. We use
|
||||||
|
this license for certain libraries in order to permit linking those
|
||||||
|
libraries into non-free programs.
|
||||||
|
|
||||||
|
When a program is linked with a library, whether statically or using
|
||||||
|
a shared library, the combination of the two is legally speaking a
|
||||||
|
combined work, a derivative of the original library. The ordinary
|
||||||
|
General Public License therefore permits such linking only if the
|
||||||
|
entire combination fits its criteria of freedom. The Lesser General
|
||||||
|
Public License permits more lax criteria for linking other code with
|
||||||
|
the library.
|
||||||
|
|
||||||
|
We call this license the "Lesser" General Public License because it
|
||||||
|
does Less to protect the user's freedom than the ordinary General
|
||||||
|
Public License. It also provides other free software developers Less
|
||||||
|
of an advantage over competing non-free programs. These disadvantages
|
||||||
|
are the reason we use the ordinary General Public License for many
|
||||||
|
libraries. However, the Lesser license provides advantages in certain
|
||||||
|
special circumstances.
|
||||||
|
|
||||||
|
For example, on rare occasions, there may be a special need to
|
||||||
|
encourage the widest possible use of a certain library, so that it becomes
|
||||||
|
a de-facto standard. To achieve this, non-free programs must be
|
||||||
|
allowed to use the library. A more frequent case is that a free
|
||||||
|
library does the same job as widely used non-free libraries. In this
|
||||||
|
case, there is little to gain by limiting the free library to free
|
||||||
|
software only, so we use the Lesser General Public License.
|
||||||
|
|
||||||
|
In other cases, permission to use a particular library in non-free
|
||||||
|
programs enables a greater number of people to use a large body of
|
||||||
|
free software. For example, permission to use the GNU C Library in
|
||||||
|
non-free programs enables many more people to use the whole GNU
|
||||||
|
operating system, as well as its variant, the GNU/Linux operating
|
||||||
|
system.
|
||||||
|
|
||||||
|
Although the Lesser General Public License is Less protective of the
|
||||||
|
users' freedom, it does ensure that the user of a program that is
|
||||||
|
linked with the Library has the freedom and the wherewithal to run
|
||||||
|
that program using a modified version of the Library.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow. Pay close attention to the difference between a
|
||||||
|
"work based on the library" and a "work that uses the library". The
|
||||||
|
former contains code derived from the library, whereas the latter must
|
||||||
|
be combined with the library in order to run.
|
||||||
|
|
||||||
|
GNU LESSER GENERAL PUBLIC LICENSE
|
||||||
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||||
|
|
||||||
|
0. This License Agreement applies to any software library or other
|
||||||
|
program which contains a notice placed by the copyright holder or
|
||||||
|
other authorized party saying it may be distributed under the terms of
|
||||||
|
this Lesser General Public License (also called "this License").
|
||||||
|
Each licensee is addressed as "you".
|
||||||
|
|
||||||
|
A "library" means a collection of software functions and/or data
|
||||||
|
prepared so as to be conveniently linked with application programs
|
||||||
|
(which use some of those functions and data) to form executables.
|
||||||
|
|
||||||
|
The "Library", below, refers to any such software library or work
|
||||||
|
which has been distributed under these terms. A "work based on the
|
||||||
|
Library" means either the Library or any derivative work under
|
||||||
|
copyright law: that is to say, a work containing the Library or a
|
||||||
|
portion of it, either verbatim or with modifications and/or translated
|
||||||
|
straightforwardly into another language. (Hereinafter, translation is
|
||||||
|
included without limitation in the term "modification".)
|
||||||
|
|
||||||
|
"Source code" for a work means the preferred form of the work for
|
||||||
|
making modifications to it. For a library, complete source code means
|
||||||
|
all the source code for all modules it contains, plus any associated
|
||||||
|
interface definition files, plus the scripts used to control compilation
|
||||||
|
and installation of the library.
|
||||||
|
|
||||||
|
Activities other than copying, distribution and modification are not
|
||||||
|
covered by this License; they are outside its scope. The act of
|
||||||
|
running a program using the Library is not restricted, and output from
|
||||||
|
such a program is covered only if its contents constitute a work based
|
||||||
|
on the Library (independent of the use of the Library in a tool for
|
||||||
|
writing it). Whether that is true depends on what the Library does
|
||||||
|
and what the program that uses the Library does.
|
||||||
|
|
||||||
|
1. You may copy and distribute verbatim copies of the Library's
|
||||||
|
complete source code as you receive it, in any medium, provided that
|
||||||
|
you conspicuously and appropriately publish on each copy an
|
||||||
|
appropriate copyright notice and disclaimer of warranty; keep intact
|
||||||
|
all the notices that refer to this License and to the absence of any
|
||||||
|
warranty; and distribute a copy of this License along with the
|
||||||
|
Library.
|
||||||
|
|
||||||
|
You may charge a fee for the physical act of transferring a copy,
|
||||||
|
and you may at your option offer warranty protection in exchange for a
|
||||||
|
fee.
|
||||||
|
|
||||||
|
2. You may modify your copy or copies of the Library or any portion
|
||||||
|
of it, thus forming a work based on the Library, and copy and
|
||||||
|
distribute such modifications or work under the terms of Section 1
|
||||||
|
above, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) The modified work must itself be a software library.
|
||||||
|
|
||||||
|
b) You must cause the files modified to carry prominent notices
|
||||||
|
stating that you changed the files and the date of any change.
|
||||||
|
|
||||||
|
c) You must cause the whole of the work to be licensed at no
|
||||||
|
charge to all third parties under the terms of this License.
|
||||||
|
|
||||||
|
d) If a facility in the modified Library refers to a function or a
|
||||||
|
table of data to be supplied by an application program that uses
|
||||||
|
the facility, other than as an argument passed when the facility
|
||||||
|
is invoked, then you must make a good faith effort to ensure that,
|
||||||
|
in the event an application does not supply such function or
|
||||||
|
table, the facility still operates, and performs whatever part of
|
||||||
|
its purpose remains meaningful.
|
||||||
|
|
||||||
|
(For example, a function in a library to compute square roots has
|
||||||
|
a purpose that is entirely well-defined independent of the
|
||||||
|
application. Therefore, Subsection 2d requires that any
|
||||||
|
application-supplied function or table used by this function must
|
||||||
|
be optional: if the application does not supply it, the square
|
||||||
|
root function must still compute square roots.)
|
||||||
|
|
||||||
|
These requirements apply to the modified work as a whole. If
|
||||||
|
identifiable sections of that work are not derived from the Library,
|
||||||
|
and can be reasonably considered independent and separate works in
|
||||||
|
themselves, then this License, and its terms, do not apply to those
|
||||||
|
sections when you distribute them as separate works. But when you
|
||||||
|
distribute the same sections as part of a whole which is a work based
|
||||||
|
on the Library, the distribution of the whole must be on the terms of
|
||||||
|
this License, whose permissions for other licensees extend to the
|
||||||
|
entire whole, and thus to each and every part regardless of who wrote
|
||||||
|
it.
|
||||||
|
|
||||||
|
Thus, it is not the intent of this section to claim rights or contest
|
||||||
|
your rights to work written entirely by you; rather, the intent is to
|
||||||
|
exercise the right to control the distribution of derivative or
|
||||||
|
collective works based on the Library.
|
||||||
|
|
||||||
|
In addition, mere aggregation of another work not based on the Library
|
||||||
|
with the Library (or with a work based on the Library) on a volume of
|
||||||
|
a storage or distribution medium does not bring the other work under
|
||||||
|
the scope of this License.
|
||||||
|
|
||||||
|
3. You may opt to apply the terms of the ordinary GNU General Public
|
||||||
|
License instead of this License to a given copy of the Library. To do
|
||||||
|
this, you must alter all the notices that refer to this License, so
|
||||||
|
that they refer to the ordinary GNU General Public License, version 2,
|
||||||
|
instead of to this License. (If a newer version than version 2 of the
|
||||||
|
ordinary GNU General Public License has appeared, then you can specify
|
||||||
|
that version instead if you wish.) Do not make any other change in
|
||||||
|
these notices.
|
||||||
|
|
||||||
|
Once this change is made in a given copy, it is irreversible for
|
||||||
|
that copy, so the ordinary GNU General Public License applies to all
|
||||||
|
subsequent copies and derivative works made from that copy.
|
||||||
|
|
||||||
|
This option is useful when you wish to copy part of the code of
|
||||||
|
the Library into a program that is not a library.
|
||||||
|
|
||||||
|
4. You may copy and distribute the Library (or a portion or
|
||||||
|
derivative of it, under Section 2) in object code or executable form
|
||||||
|
under the terms of Sections 1 and 2 above provided that you accompany
|
||||||
|
it with the complete corresponding machine-readable source code, which
|
||||||
|
must be distributed under the terms of Sections 1 and 2 above on a
|
||||||
|
medium customarily used for software interchange.
|
||||||
|
|
||||||
|
If distribution of object code is made by offering access to copy
|
||||||
|
from a designated place, then offering equivalent access to copy the
|
||||||
|
source code from the same place satisfies the requirement to
|
||||||
|
distribute the source code, even though third parties are not
|
||||||
|
compelled to copy the source along with the object code.
|
||||||
|
|
||||||
|
5. A program that contains no derivative of any portion of the
|
||||||
|
Library, but is designed to work with the Library by being compiled or
|
||||||
|
linked with it, is called a "work that uses the Library". Such a
|
||||||
|
work, in isolation, is not a derivative work of the Library, and
|
||||||
|
therefore falls outside the scope of this License.
|
||||||
|
|
||||||
|
However, linking a "work that uses the Library" with the Library
|
||||||
|
creates an executable that is a derivative of the Library (because it
|
||||||
|
contains portions of the Library), rather than a "work that uses the
|
||||||
|
library". The executable is therefore covered by this License.
|
||||||
|
Section 6 states terms for distribution of such executables.
|
||||||
|
|
||||||
|
When a "work that uses the Library" uses material from a header file
|
||||||
|
that is part of the Library, the object code for the work may be a
|
||||||
|
derivative work of the Library even though the source code is not.
|
||||||
|
Whether this is true is especially significant if the work can be
|
||||||
|
linked without the Library, or if the work is itself a library. The
|
||||||
|
threshold for this to be true is not precisely defined by law.
|
||||||
|
|
||||||
|
If such an object file uses only numerical parameters, data
|
||||||
|
structure layouts and accessors, and small macros and small inline
|
||||||
|
functions (ten lines or less in length), then the use of the object
|
||||||
|
file is unrestricted, regardless of whether it is legally a derivative
|
||||||
|
work. (Executables containing this object code plus portions of the
|
||||||
|
Library will still fall under Section 6.)
|
||||||
|
|
||||||
|
Otherwise, if the work is a derivative of the Library, you may
|
||||||
|
distribute the object code for the work under the terms of Section 6.
|
||||||
|
Any executables containing that work also fall under Section 6,
|
||||||
|
whether or not they are linked directly with the Library itself.
|
||||||
|
|
||||||
|
6. As an exception to the Sections above, you may also combine or
|
||||||
|
link a "work that uses the Library" with the Library to produce a
|
||||||
|
work containing portions of the Library, and distribute that work
|
||||||
|
under terms of your choice, provided that the terms permit
|
||||||
|
modification of the work for the customer's own use and reverse
|
||||||
|
engineering for debugging such modifications.
|
||||||
|
|
||||||
|
You must give prominent notice with each copy of the work that the
|
||||||
|
Library is used in it and that the Library and its use are covered by
|
||||||
|
this License. You must supply a copy of this License. If the work
|
||||||
|
during execution displays copyright notices, you must include the
|
||||||
|
copyright notice for the Library among them, as well as a reference
|
||||||
|
directing the user to the copy of this License. Also, you must do one
|
||||||
|
of these things:
|
||||||
|
|
||||||
|
a) Accompany the work with the complete corresponding
|
||||||
|
machine-readable source code for the Library including whatever
|
||||||
|
changes were used in the work (which must be distributed under
|
||||||
|
Sections 1 and 2 above); and, if the work is an executable linked
|
||||||
|
with the Library, with the complete machine-readable "work that
|
||||||
|
uses the Library", as object code and/or source code, so that the
|
||||||
|
user can modify the Library and then relink to produce a modified
|
||||||
|
executable containing the modified Library. (It is understood
|
||||||
|
that the user who changes the contents of definitions files in the
|
||||||
|
Library will not necessarily be able to recompile the application
|
||||||
|
to use the modified definitions.)
|
||||||
|
|
||||||
|
b) Use a suitable shared library mechanism for linking with the
|
||||||
|
Library. A suitable mechanism is one that (1) uses at run time a
|
||||||
|
copy of the library already present on the user's computer system,
|
||||||
|
rather than copying library functions into the executable, and (2)
|
||||||
|
will operate properly with a modified version of the library, if
|
||||||
|
the user installs one, as long as the modified version is
|
||||||
|
interface-compatible with the version that the work was made with.
|
||||||
|
|
||||||
|
c) Accompany the work with a written offer, valid for at
|
||||||
|
least three years, to give the same user the materials
|
||||||
|
specified in Subsection 6a, above, for a charge no more
|
||||||
|
than the cost of performing this distribution.
|
||||||
|
|
||||||
|
d) If distribution of the work is made by offering access to copy
|
||||||
|
from a designated place, offer equivalent access to copy the above
|
||||||
|
specified materials from the same place.
|
||||||
|
|
||||||
|
e) Verify that the user has already received a copy of these
|
||||||
|
materials or that you have already sent this user a copy.
|
||||||
|
|
||||||
|
For an executable, the required form of the "work that uses the
|
||||||
|
Library" must include any data and utility programs needed for
|
||||||
|
reproducing the executable from it. However, as a special exception,
|
||||||
|
the materials to be distributed need not include anything that is
|
||||||
|
normally distributed (in either source or binary form) with the major
|
||||||
|
components (compiler, kernel, and so on) of the operating system on
|
||||||
|
which the executable runs, unless that component itself accompanies
|
||||||
|
the executable.
|
||||||
|
|
||||||
|
It may happen that this requirement contradicts the license
|
||||||
|
restrictions of other proprietary libraries that do not normally
|
||||||
|
accompany the operating system. Such a contradiction means you cannot
|
||||||
|
use both them and the Library together in an executable that you
|
||||||
|
distribute.
|
||||||
|
|
||||||
|
7. You may place library facilities that are a work based on the
|
||||||
|
Library side-by-side in a single library together with other library
|
||||||
|
facilities not covered by this License, and distribute such a combined
|
||||||
|
library, provided that the separate distribution of the work based on
|
||||||
|
the Library and of the other library facilities is otherwise
|
||||||
|
permitted, and provided that you do these two things:
|
||||||
|
|
||||||
|
a) Accompany the combined library with a copy of the same work
|
||||||
|
based on the Library, uncombined with any other library
|
||||||
|
facilities. This must be distributed under the terms of the
|
||||||
|
Sections above.
|
||||||
|
|
||||||
|
b) Give prominent notice with the combined library of the fact
|
||||||
|
that part of it is a work based on the Library, and explaining
|
||||||
|
where to find the accompanying uncombined form of the same work.
|
||||||
|
|
||||||
|
8. You may not copy, modify, sublicense, link with, or distribute
|
||||||
|
the Library except as expressly provided under this License. Any
|
||||||
|
attempt otherwise to copy, modify, sublicense, link with, or
|
||||||
|
distribute the Library is void, and will automatically terminate your
|
||||||
|
rights under this License. However, parties who have received copies,
|
||||||
|
or rights, from you under this License will not have their licenses
|
||||||
|
terminated so long as such parties remain in full compliance.
|
||||||
|
|
||||||
|
9. You are not required to accept this License, since you have not
|
||||||
|
signed it. However, nothing else grants you permission to modify or
|
||||||
|
distribute the Library or its derivative works. These actions are
|
||||||
|
prohibited by law if you do not accept this License. Therefore, by
|
||||||
|
modifying or distributing the Library (or any work based on the
|
||||||
|
Library), you indicate your acceptance of this License to do so, and
|
||||||
|
all its terms and conditions for copying, distributing or modifying
|
||||||
|
the Library or works based on it.
|
||||||
|
|
||||||
|
10. Each time you redistribute the Library (or any work based on the
|
||||||
|
Library), the recipient automatically receives a license from the
|
||||||
|
original licensor to copy, distribute, link with or modify the Library
|
||||||
|
subject to these terms and conditions. You may not impose any further
|
||||||
|
restrictions on the recipients' exercise of the rights granted herein.
|
||||||
|
You are not responsible for enforcing compliance by third parties with
|
||||||
|
this License.
|
||||||
|
|
||||||
|
11. If, as a consequence of a court judgment or allegation of patent
|
||||||
|
infringement or for any other reason (not limited to patent issues),
|
||||||
|
conditions are imposed on you (whether by court order, agreement or
|
||||||
|
otherwise) that contradict the conditions of this License, they do not
|
||||||
|
excuse you from the conditions of this License. If you cannot
|
||||||
|
distribute so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you
|
||||||
|
may not distribute the Library at all. For example, if a patent
|
||||||
|
license would not permit royalty-free redistribution of the Library by
|
||||||
|
all those who receive copies directly or indirectly through you, then
|
||||||
|
the only way you could satisfy both it and this License would be to
|
||||||
|
refrain entirely from distribution of the Library.
|
||||||
|
|
||||||
|
If any portion of this section is held invalid or unenforceable under any
|
||||||
|
particular circumstance, the balance of the section is intended to apply,
|
||||||
|
and the section as a whole is intended to apply in other circumstances.
|
||||||
|
|
||||||
|
It is not the purpose of this section to induce you to infringe any
|
||||||
|
patents or other property right claims or to contest validity of any
|
||||||
|
such claims; this section has the sole purpose of protecting the
|
||||||
|
integrity of the free software distribution system which is
|
||||||
|
implemented by public license practices. Many people have made
|
||||||
|
generous contributions to the wide range of software distributed
|
||||||
|
through that system in reliance on consistent application of that
|
||||||
|
system; it is up to the author/donor to decide if he or she is willing
|
||||||
|
to distribute software through any other system and a licensee cannot
|
||||||
|
impose that choice.
|
||||||
|
|
||||||
|
This section is intended to make thoroughly clear what is believed to
|
||||||
|
be a consequence of the rest of this License.
|
||||||
|
|
||||||
|
12. If the distribution and/or use of the Library is restricted in
|
||||||
|
certain countries either by patents or by copyrighted interfaces, the
|
||||||
|
original copyright holder who places the Library under this License may add
|
||||||
|
an explicit geographical distribution limitation excluding those countries,
|
||||||
|
so that distribution is permitted only in or among countries not thus
|
||||||
|
excluded. In such case, this License incorporates the limitation as if
|
||||||
|
written in the body of this License.
|
||||||
|
|
||||||
|
13. The Free Software Foundation may publish revised and/or new
|
||||||
|
versions of the Lesser General Public License from time to time.
|
||||||
|
Such new versions will be similar in spirit to the present version,
|
||||||
|
but may differ in detail to address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the Library
|
||||||
|
specifies a version number of this License which applies to it and
|
||||||
|
"any later version", you have the option of following the terms and
|
||||||
|
conditions either of that version or of any later version published by
|
||||||
|
the Free Software Foundation. If the Library does not specify a
|
||||||
|
license version number, you may choose any version ever published by
|
||||||
|
the Free Software Foundation.
|
||||||
|
|
||||||
|
14. If you wish to incorporate parts of the Library into other free
|
||||||
|
programs whose distribution conditions are incompatible with these,
|
||||||
|
write to the author to ask for permission. For software which is
|
||||||
|
copyrighted by the Free Software Foundation, write to the Free
|
||||||
|
Software Foundation; we sometimes make exceptions for this. Our
|
||||||
|
decision will be guided by the two goals of preserving the free status
|
||||||
|
of all derivatives of our free software and of promoting the sharing
|
||||||
|
and reuse of software generally.
|
||||||
|
|
||||||
|
NO WARRANTY
|
||||||
|
|
||||||
|
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
|
||||||
|
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
|
||||||
|
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
|
||||||
|
OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
|
||||||
|
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
|
||||||
|
LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
|
||||||
|
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
|
||||||
|
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
|
||||||
|
AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
|
||||||
|
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
|
||||||
|
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
|
||||||
|
LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
|
||||||
|
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
|
||||||
|
FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
|
||||||
|
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
|
||||||
|
DAMAGES.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
How to Apply These Terms to Your New Libraries
|
||||||
|
|
||||||
|
If you develop a new library, and you want it to be of the greatest
|
||||||
|
possible use to the public, we recommend making it free software that
|
||||||
|
everyone can redistribute and change. You can do so by permitting
|
||||||
|
redistribution under these terms (or, alternatively, under the terms of the
|
||||||
|
ordinary General Public License).
|
||||||
|
|
||||||
|
To apply these terms, attach the following notices to the library. It is
|
||||||
|
safest to attach them to the start of each source file to most effectively
|
||||||
|
convey the exclusion of warranty; and each file should have at least the
|
||||||
|
"copyright" line and a pointer to where the full notice is found.
|
||||||
|
|
||||||
|
<one line to give the library's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) <year> <name of author>
|
||||||
|
|
||||||
|
This library is free software; you can redistribute it and/or
|
||||||
|
modify it under the terms of the GNU Lesser General Public
|
||||||
|
License as published by the Free Software Foundation; either
|
||||||
|
version 2.1 of the License, or (at your option) any later version.
|
||||||
|
|
||||||
|
This library 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 library; if not, write to the Free Software
|
||||||
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or your
|
||||||
|
school, if any, to sign a "copyright disclaimer" for the library, if
|
||||||
|
necessary. Here is a sample; alter the names:
|
||||||
|
|
||||||
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the
|
||||||
|
library `Frob' (a library for tweaking knobs) written by James Random Hacker.
|
||||||
|
|
||||||
|
<signature of Ty Coon>, 1 April 1990
|
||||||
|
Ty Coon, President of Vice
|
||||||
|
|
||||||
|
That's all there is to it!
|
||||||
|
|
||||||
|
|
|
@ -0,0 +1,12 @@
|
||||||
|
Hibernate Commons Annotations dependencies
|
||||||
|
==========================================
|
||||||
|
|
||||||
|
Core
|
||||||
|
====
|
||||||
|
slf4j-api.jar (see Hibernate Core version): required
|
||||||
|
slf4j-*.jar (eg. slf4j-log4j12): required
|
||||||
|
Your favorite logging framework: required
|
||||||
|
|
||||||
|
Test
|
||||||
|
====
|
||||||
|
ejb3-persistence.jar (1.0.2): required
|
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
@ -0,0 +1,28 @@
|
||||||
|
<?xml version="1.0"?>
|
||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
<groupId>org.hibernate</groupId>
|
||||||
|
<artifactId>hibernate-commons-annotations</artifactId>
|
||||||
|
<packaging>jar</packaging>
|
||||||
|
<name>Hibernate Commons Annotations</name>
|
||||||
|
<version>@version@</version>
|
||||||
|
<licenses>
|
||||||
|
<license>
|
||||||
|
<name>GNU LESSER GENERAL PUBLIC LICENSE</name>
|
||||||
|
<url>http://www.gnu.org/licenses/lgpl.txt</url>
|
||||||
|
</license>
|
||||||
|
</licenses>
|
||||||
|
<description>Hibernate Commons Annotations is a utility project used by annotations based Hibernate sub-projects.</description>
|
||||||
|
<scm>
|
||||||
|
<url>scm:svn:http://anonsvn.jboss.org/repos/hibernate/commons-annotations</url>
|
||||||
|
</scm>
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.slf4j</groupId>
|
||||||
|
<artifactId>slf4j-api</artifactId>
|
||||||
|
<version>1.4.2</version>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
</project>
|
|
@ -0,0 +1,45 @@
|
||||||
|
Hibernate Commons Annotations
|
||||||
|
==================================================
|
||||||
|
Version: @version@, @releasedate@
|
||||||
|
|
||||||
|
Description
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Hibernate Commons Annotations is a utility project used by annotations based
|
||||||
|
Hibernate sub-projects.
|
||||||
|
It's first scope is to support Java Generics type discovery.
|
||||||
|
It's second scope is to support Java Annotations overriding through XML files
|
||||||
|
(mainly but not conceptually limited to)
|
||||||
|
|
||||||
|
|
||||||
|
Instructions
|
||||||
|
------------
|
||||||
|
|
||||||
|
TODO: Do something here
|
||||||
|
|
||||||
|
|
||||||
|
Contact
|
||||||
|
------------
|
||||||
|
|
||||||
|
Latest Documentation:
|
||||||
|
|
||||||
|
This project has no documentation per se, because of it's internal use focus.
|
||||||
|
Please ask questions to the technical support forum.
|
||||||
|
|
||||||
|
Bug Reports:
|
||||||
|
|
||||||
|
Hibernate JIRA (preferred)
|
||||||
|
hibernate-devel@lists.sourceforge.net
|
||||||
|
|
||||||
|
Free Technical Support:
|
||||||
|
|
||||||
|
http://forum.hibernate.org (http://forum.hibernate.org/viewforum.php?f=9)
|
||||||
|
|
||||||
|
|
||||||
|
Notes
|
||||||
|
-----------
|
||||||
|
|
||||||
|
If you want to contribute, go to http://www.hibernate.org/
|
||||||
|
|
||||||
|
This software and its documentation are distributed under the terms of the
|
||||||
|
FSF Lesser Gnu Public License (see lgpl.txt).
|
|
@ -0,0 +1,31 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common;
|
||||||
|
|
||||||
|
import org.slf4j.LoggerFactory;
|
||||||
|
import org.slf4j.Logger;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Indicates failure of an assertion: a possible bug in Hibernate.
|
||||||
|
*
|
||||||
|
* @author Gavin King
|
||||||
|
* @auhor Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
//TODO Copy from Hibernate Core, do some mutualization here?
|
||||||
|
public class AssertionFailure extends RuntimeException {
|
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(AssertionFailure.class);
|
||||||
|
|
||||||
|
private static final String MESSAGE = "an assertion failure occured (this may indicate a bug in Hibernate)";
|
||||||
|
|
||||||
|
public AssertionFailure(String s) {
|
||||||
|
super(s);
|
||||||
|
log.error(MESSAGE, this);
|
||||||
|
}
|
||||||
|
|
||||||
|
public AssertionFailure(String s, Throwable t) {
|
||||||
|
super(s, t);
|
||||||
|
log.error(MESSAGE, t);
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
|
@ -0,0 +1,19 @@
|
||||||
|
package org.hibernate.annotations.common;
|
||||||
|
|
||||||
|
import org.slf4j.Logger;
|
||||||
|
import org.slf4j.LoggerFactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public class Version {
|
||||||
|
public static final String VERSION = "3.1.0.GA";
|
||||||
|
private static Logger log = LoggerFactory.getLogger( Version.class );
|
||||||
|
|
||||||
|
static {
|
||||||
|
log.info( "Hibernate Commons Annotations {}", VERSION );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static void touch() {
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,47 @@
|
||||||
|
package org.hibernate.annotations.common.annotationfactory;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Encapsulates the data you need to create an annotation. In
|
||||||
|
* particular, it stores the type of an <code>Annotation</code> 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<? extends Annotation> type;
|
||||||
|
|
||||||
|
private final Map<String, Object> elements = new HashMap<String, Object>();
|
||||||
|
|
||||||
|
public AnnotationDescriptor(Class<? extends Annotation> annotationType) {
|
||||||
|
type = annotationType;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setValue(String elementName, Object value) {
|
||||||
|
elements.put( elementName, value );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Object valueOf(String elementName) {
|
||||||
|
return elements.get( elementName );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean containsElement(String elementName) {
|
||||||
|
return elements.containsKey( elementName );
|
||||||
|
}
|
||||||
|
|
||||||
|
public int numberOfElements() {
|
||||||
|
return elements.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Annotation> type() {
|
||||||
|
return type;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,42 @@
|
||||||
|
package org.hibernate.annotations.common.annotationfactory;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
import java.lang.reflect.Constructor;
|
||||||
|
import java.lang.reflect.InvocationHandler;
|
||||||
|
import java.lang.reflect.InvocationTargetException;
|
||||||
|
import java.lang.reflect.Proxy;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Creates live annotations (actually <code>AnnotationProxies</code>) from <code>AnnotationDescriptors</code>.
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @see AnnotationProxy
|
||||||
|
*/
|
||||||
|
public class AnnotationFactory {
|
||||||
|
|
||||||
|
@SuppressWarnings("unchecked")
|
||||||
|
public static <T extends Annotation> T create(AnnotationDescriptor descriptor) {
|
||||||
|
ClassLoader classLoader = Thread.currentThread().getContextClassLoader();
|
||||||
|
//TODO round 34ms to generate the proxy, hug! is Javassist Faster?
|
||||||
|
//TODO prebuild the javax.persistence and org.hibernate.annotations classes?
|
||||||
|
Class<T> proxyClass = (Class<T>) Proxy.getProxyClass( classLoader, descriptor.type() );
|
||||||
|
InvocationHandler handler = new AnnotationProxy( descriptor );
|
||||||
|
try {
|
||||||
|
return getProxyInstance( proxyClass, handler );
|
||||||
|
}
|
||||||
|
catch (RuntimeException e) {
|
||||||
|
throw e;
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
throw new RuntimeException( e );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static <T extends Annotation> T getProxyInstance(Class<T> proxyClass, InvocationHandler handler) throws
|
||||||
|
SecurityException, NoSuchMethodException, IllegalArgumentException, InstantiationException,
|
||||||
|
IllegalAccessException, InvocationTargetException {
|
||||||
|
Constructor<T> constructor = proxyClass.getConstructor( new Class[]{InvocationHandler.class} );
|
||||||
|
return constructor.newInstance( new Object[]{handler} );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,111 @@
|
||||||
|
package org.hibernate.annotations.common.annotationfactory;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
import java.lang.reflect.InvocationHandler;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.util.Comparator;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.SortedSet;
|
||||||
|
import java.util.TreeSet;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A concrete implementation of <code>Annotation</code> that pretends it is a
|
||||||
|
* "real" source code annotation. It's also an <code>InvocationHandler</code>.
|
||||||
|
* <p/>
|
||||||
|
* When you create an <code>AnnotationProxy</code>, you must initialize it
|
||||||
|
* with an <code>AnnotationDescriptor</code>.
|
||||||
|
* The adapter checks that the provided elements are the same elements defined
|
||||||
|
* in the annotation interface. However, it does <i>not</i> 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.
|
||||||
|
* <p/>
|
||||||
|
* Warning: this class does not implement <code>hashCode()</code> and
|
||||||
|
* <code>equals()</code> - it just uses the ones it inherits from <code>Object</code>.
|
||||||
|
* This means that an <code>AnnotationProxy</code> does <i>not</i> follow the
|
||||||
|
* recommendations of the <code>Annotation</code> javadoc about these two
|
||||||
|
* methods. That's why you should never mix <code>AnnotationProxies</code>
|
||||||
|
* with "real" annotations. For example, don't put them into the same
|
||||||
|
* <code>Collection</code>.
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @see java.lang.annotation.Annotation
|
||||||
|
*/
|
||||||
|
public class AnnotationProxy implements Annotation, InvocationHandler {
|
||||||
|
|
||||||
|
private final Class<? extends Annotation> 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 Map<Method, Object> values;
|
||||||
|
|
||||||
|
public AnnotationProxy(AnnotationDescriptor descriptor) {
|
||||||
|
this.annotationType = descriptor.type();
|
||||||
|
values = getAnnotationValues( descriptor );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Map<Method, Object> getAnnotationValues(AnnotationDescriptor descriptor) {
|
||||||
|
Map<Method, Object> result = new HashMap<Method, Object>();
|
||||||
|
int processedValuesFromDescriptor = 0;
|
||||||
|
for ( Method m : annotationType.getDeclaredMethods() ) {
|
||||||
|
if ( descriptor.containsElement( m.getName() ) ) {
|
||||||
|
result.put( m, descriptor.valueOf( m.getName() ) );
|
||||||
|
processedValuesFromDescriptor++;
|
||||||
|
}
|
||||||
|
else if ( m.getDefaultValue() != null ) {
|
||||||
|
result.put( m, m.getDefaultValue() );
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
throw new IllegalArgumentException( "No value provided for " + m.getName() );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if ( processedValuesFromDescriptor != descriptor.numberOfElements() ) {
|
||||||
|
throw new RuntimeException( "Trying to instanciate " + annotationType + " with unknown elements" );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
|
||||||
|
if ( values.containsKey( method ) ) {
|
||||||
|
return values.get( method );
|
||||||
|
}
|
||||||
|
return method.invoke( this, args );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Annotation> annotationType() {
|
||||||
|
return annotationType;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String toString() {
|
||||||
|
StringBuilder result = new StringBuilder();
|
||||||
|
result.append( '@' ).append( annotationType().getName() ).append( '(' );
|
||||||
|
for ( Method m : getRegisteredMethodsInAlphabeticalOrder() ) {
|
||||||
|
result.append( m.getName() ).append( '=' ).append( values.get( m ) ).append( ", " );
|
||||||
|
}
|
||||||
|
// remove last separator:
|
||||||
|
if ( values.size() > 0 ) {
|
||||||
|
result.delete( result.length() - 2, result.length() );
|
||||||
|
result.append( ")" );
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
result.delete( result.length() - 1, result.length() );
|
||||||
|
}
|
||||||
|
|
||||||
|
return result.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
private SortedSet<Method> getRegisteredMethodsInAlphabeticalOrder() {
|
||||||
|
SortedSet<Method> result = new TreeSet<Method>(
|
||||||
|
new Comparator<Method>() {
|
||||||
|
public int compare(Method o1, Method o2) {
|
||||||
|
return o1.getName().compareTo( o2.getName() );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
);
|
||||||
|
//List<Method> result = new LinkedList<Method>();
|
||||||
|
result.addAll( values.keySet() );
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,15 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public interface AnnotationReader {
|
||||||
|
|
||||||
|
public <T extends Annotation> T getAnnotation(Class<T> annotationType);
|
||||||
|
|
||||||
|
public <T extends Annotation> boolean isAnnotationPresent(Class<T> annotationType);
|
||||||
|
|
||||||
|
public Annotation[] getAnnotations();
|
||||||
|
}
|
|
@ -0,0 +1,13 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Filter properties
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public interface Filter {
|
||||||
|
boolean returnStatic();
|
||||||
|
|
||||||
|
boolean returnTransient();
|
||||||
|
}
|
|
@ -0,0 +1,30 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.lang.reflect.AnnotatedElement;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The entry point to the reflection layer (a.k.a. the X* layer).
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public interface ReflectionManager {
|
||||||
|
|
||||||
|
public <T> XClass toXClass(Class<T> clazz);
|
||||||
|
|
||||||
|
public Class toClass(XClass xClazz);
|
||||||
|
|
||||||
|
public Method toMethod(XMethod method);
|
||||||
|
|
||||||
|
public <T> XClass classForName(String name, Class<T> caller) throws ClassNotFoundException;
|
||||||
|
|
||||||
|
public XPackage packageForName(String packageName) throws ClassNotFoundException;
|
||||||
|
|
||||||
|
public <T> boolean equals(XClass class1, Class<T> class2);
|
||||||
|
|
||||||
|
public AnnotationReader buildAnnotationReader(AnnotatedElement annotatedElement);
|
||||||
|
|
||||||
|
public Map getDefaults();
|
||||||
|
}
|
|
@ -0,0 +1,36 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Modifier;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeUtils;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class ReflectionUtil {
|
||||||
|
|
||||||
|
public static boolean isProperty(Method m, Type boundType, Filter filter) {
|
||||||
|
return ReflectionUtil.isPropertyType( boundType )
|
||||||
|
&& !m.isSynthetic()
|
||||||
|
&& !m.isBridge()
|
||||||
|
&& ( filter.returnStatic() || !Modifier.isStatic( m.getModifiers() ) )
|
||||||
|
&& m.getParameterTypes().length == 0
|
||||||
|
&& ( m.getName().startsWith( "get" ) || m.getName().startsWith( "is" ) );
|
||||||
|
// TODO should we use stronger checking on the naming of getters/setters, or just leave this to the validator?
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isProperty(Field f, Type boundType, Filter filter) {
|
||||||
|
return ( filter.returnStatic() || ! Modifier.isStatic( f.getModifiers() ) )
|
||||||
|
&& ( filter.returnTransient() || ! Modifier.isTransient( f.getModifiers() ) )
|
||||||
|
&& !f.isSynthetic()
|
||||||
|
&& ReflectionUtil.isPropertyType( boundType );
|
||||||
|
}
|
||||||
|
|
||||||
|
private static boolean isPropertyType(Type type) {
|
||||||
|
// return TypeUtils.isArray( type ) || TypeUtils.isCollection( type ) || ( TypeUtils.isBase( type ) && ! TypeUtils.isVoid( type ) );
|
||||||
|
return !TypeUtils.isVoid( type );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,22 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public interface XAnnotatedElement {
|
||||||
|
|
||||||
|
<T extends Annotation> T getAnnotation(Class<T> annotationType);
|
||||||
|
|
||||||
|
<T extends Annotation> boolean isAnnotationPresent(Class<T> annotationType);
|
||||||
|
|
||||||
|
Annotation[] getAnnotations();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns true if the underlying artefact
|
||||||
|
* is the same
|
||||||
|
*/
|
||||||
|
boolean equals(Object x);
|
||||||
|
}
|
|
@ -0,0 +1,58 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public interface XClass extends XAnnotatedElement {
|
||||||
|
|
||||||
|
public static final String ACCESS_PROPERTY = "property";
|
||||||
|
public static final String ACCESS_FIELD = "field";
|
||||||
|
|
||||||
|
static final Filter DEFAULT_FILTER = new Filter() {
|
||||||
|
|
||||||
|
public boolean returnStatic() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean returnTransient() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
String getName();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Class#getSuperclass()
|
||||||
|
*/
|
||||||
|
XClass getSuperclass();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Class#getInterfaces()
|
||||||
|
*/
|
||||||
|
XClass[] getInterfaces();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* see Class#isInterface()
|
||||||
|
*/
|
||||||
|
boolean isInterface();
|
||||||
|
|
||||||
|
boolean isAbstract();
|
||||||
|
|
||||||
|
boolean isPrimitive();
|
||||||
|
|
||||||
|
boolean isEnum();
|
||||||
|
|
||||||
|
boolean isAssignableFrom(XClass c);
|
||||||
|
|
||||||
|
List<XProperty> getDeclaredProperties(String accessType);
|
||||||
|
|
||||||
|
List<XProperty> getDeclaredProperties(String accessType, Filter filter);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the <tt>Method</tt>s defined by this class.
|
||||||
|
*/
|
||||||
|
List<XMethod> getDeclaredMethods();
|
||||||
|
}
|
|
@ -0,0 +1,56 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public abstract interface XMember extends XAnnotatedElement {
|
||||||
|
|
||||||
|
String getName();
|
||||||
|
|
||||||
|
boolean isCollection();
|
||||||
|
|
||||||
|
boolean isArray();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The collection class for collections, null for others.
|
||||||
|
*/
|
||||||
|
Class<? extends Collection> getCollectionClass();
|
||||||
|
|
||||||
|
// TODO We should probably try to reduce the following three methods to two.
|
||||||
|
// the last one is particularly offensive
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This property's XClass.
|
||||||
|
*/
|
||||||
|
XClass getType();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This property's type for simple properties, the type of its elements for arrays and collections.
|
||||||
|
*/
|
||||||
|
XClass getElementClass();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The type of this property's elements for arrays, the type of the property itself for everything else.
|
||||||
|
*/
|
||||||
|
XClass getClassOrElementClass();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The type of this map's key, or null for anything that is not a map.
|
||||||
|
*/
|
||||||
|
XClass getMapKey();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Same modifiers as java.lang.Member#getModifiers()
|
||||||
|
*/
|
||||||
|
int getModifiers();
|
||||||
|
|
||||||
|
//this breaks the Java reflect hierarchy, since accessible belongs to AccessibleObject
|
||||||
|
void setAccessible(boolean accessible);
|
||||||
|
|
||||||
|
public Object invoke(Object target, Object... parameters);
|
||||||
|
|
||||||
|
boolean isTypeResolved();
|
||||||
|
}
|
|
@ -0,0 +1,14 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Represent an invokable method
|
||||||
|
* <p/>
|
||||||
|
* The underlying layer does not guaranty that xProperty == xMethod
|
||||||
|
* if the underlying artefact is the same
|
||||||
|
* However xProperty.equals(xMethod) is supposed to return true
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public interface XMethod extends XMember {
|
||||||
|
}
|
|
@ -0,0 +1,10 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public interface XPackage extends XAnnotatedElement {
|
||||||
|
|
||||||
|
String getName();
|
||||||
|
}
|
|
@ -0,0 +1,21 @@
|
||||||
|
package org.hibernate.annotations.common.reflection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A member which actually is a property (as per the JavaBean spec)
|
||||||
|
* Note that the same underlying artefact can be represented as both
|
||||||
|
* XProperty and XMethod
|
||||||
|
* The underlying layer does not guaranty that xProperty == xMethod
|
||||||
|
* if the underlying artefact is the same
|
||||||
|
* However xProperty.equals(xMethod) is supposed to return true
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public interface XProperty extends XMember {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Unqualify the getter name
|
||||||
|
*/
|
||||||
|
String getName();
|
||||||
|
}
|
|
@ -0,0 +1,33 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
import java.lang.reflect.AnnotatedElement;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.AnnotationReader;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Reads standard Java annotations.
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
class JavaAnnotationReader implements AnnotationReader {
|
||||||
|
|
||||||
|
protected final AnnotatedElement element;
|
||||||
|
|
||||||
|
public JavaAnnotationReader(AnnotatedElement el) {
|
||||||
|
this.element = el;
|
||||||
|
}
|
||||||
|
|
||||||
|
public <T extends Annotation> T getAnnotation(Class<T> annotationType) {
|
||||||
|
return element.getAnnotation( annotationType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public <T extends Annotation> boolean isAnnotationPresent(Class<T> annotationType) {
|
||||||
|
return element.isAnnotationPresent( annotationType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Annotation[] getAnnotations() {
|
||||||
|
return element.getAnnotations();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,190 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.AnnotatedElement;
|
||||||
|
import java.lang.reflect.Member;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.ParameterizedType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.AnnotationReader;
|
||||||
|
import org.hibernate.annotations.common.reflection.ReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XMethod;
|
||||||
|
import org.hibernate.annotations.common.reflection.XPackage;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.IdentityTypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironmentFactory;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeSwitch;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeUtils;
|
||||||
|
import org.hibernate.annotations.common.util.ReflectHelper;
|
||||||
|
import org.hibernate.annotations.common.Version;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The factory for all the objects in this package.
|
||||||
|
*
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public class JavaReflectionManager implements ReflectionManager {
|
||||||
|
|
||||||
|
static {
|
||||||
|
Version.touch();
|
||||||
|
}
|
||||||
|
|
||||||
|
private static class TypeKey extends Pair<Type, TypeEnvironment> {
|
||||||
|
TypeKey(Type t, TypeEnvironment context) {
|
||||||
|
super( t, context );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static class MemberKey extends Pair<Member, TypeEnvironment> {
|
||||||
|
MemberKey(Member member, TypeEnvironment context) {
|
||||||
|
super( member, context );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private final Map<TypeKey, JavaXClass> xClasses = new HashMap<TypeKey, JavaXClass>();
|
||||||
|
|
||||||
|
private final Map<Package, JavaXPackage> packagesToXPackages = new HashMap<Package, JavaXPackage>();
|
||||||
|
|
||||||
|
private final Map<MemberKey, JavaXProperty> xProperties = new HashMap<MemberKey, JavaXProperty>();
|
||||||
|
|
||||||
|
private final Map<MemberKey, JavaXMethod> xMethods = new HashMap<MemberKey, JavaXMethod>();
|
||||||
|
|
||||||
|
private final TypeEnvironmentFactory typeEnvs = new TypeEnvironmentFactory();
|
||||||
|
|
||||||
|
public XClass toXClass(Class clazz) {
|
||||||
|
return toXClass( clazz, IdentityTypeEnvironment.INSTANCE );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class toClass(XClass xClazz) {
|
||||||
|
if ( ! ( xClazz instanceof JavaXClass ) ) {
|
||||||
|
throw new IllegalArgumentException( "XClass not coming from this ReflectionManager implementation" );
|
||||||
|
}
|
||||||
|
return (Class) ( (JavaXClass) xClazz ).toAnnotatedElement();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Method toMethod(XMethod xMethod) {
|
||||||
|
if ( ! ( xMethod instanceof JavaXMethod ) ) {
|
||||||
|
throw new IllegalArgumentException( "XMethod not coming from this ReflectionManager implementation" );
|
||||||
|
}
|
||||||
|
return (Method) ( (JavaXAnnotatedElement) xMethod ).toAnnotatedElement();
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass classForName(String name, Class caller) throws ClassNotFoundException {
|
||||||
|
return toXClass( ReflectHelper.classForName( name, caller ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XPackage packageForName(String packageName) throws ClassNotFoundException {
|
||||||
|
return getXAnnotatedElement( ReflectHelper.classForName( packageName + ".package-info" ).getPackage() );
|
||||||
|
}
|
||||||
|
|
||||||
|
XClass toXClass(Type t, final TypeEnvironment context) {
|
||||||
|
return new TypeSwitch<XClass>() {
|
||||||
|
@Override
|
||||||
|
public XClass caseClass(Class classType) {
|
||||||
|
TypeKey key = new TypeKey( classType, context );
|
||||||
|
JavaXClass result = xClasses.get( key );
|
||||||
|
if ( result == null ) {
|
||||||
|
result = new JavaXClass( classType, context, JavaReflectionManager.this );
|
||||||
|
xClasses.put( key, result );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public XClass caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return toXClass( parameterizedType.getRawType(),
|
||||||
|
typeEnvs.getEnvironment( parameterizedType, context )
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}.doSwitch( context.bind( t ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
XPackage getXAnnotatedElement(Package pkg) {
|
||||||
|
JavaXPackage xPackage = packagesToXPackages.get( pkg );
|
||||||
|
if ( xPackage == null ) {
|
||||||
|
xPackage = new JavaXPackage( pkg, this );
|
||||||
|
packagesToXPackages.put( pkg, xPackage );
|
||||||
|
}
|
||||||
|
return xPackage;
|
||||||
|
}
|
||||||
|
|
||||||
|
XProperty getXProperty(Member member, TypeEnvironment context) {
|
||||||
|
MemberKey key = new MemberKey( member, context );
|
||||||
|
//FIXME get is as expensive as create most time spent in hashCode and equals
|
||||||
|
JavaXProperty xProperty = xProperties.get( key );
|
||||||
|
if ( xProperty == null ) {
|
||||||
|
xProperty = JavaXProperty.create( member, context, this );
|
||||||
|
xProperties.put( key, xProperty );
|
||||||
|
}
|
||||||
|
return xProperty;
|
||||||
|
}
|
||||||
|
|
||||||
|
XMethod getXMethod(Member member, TypeEnvironment context) {
|
||||||
|
MemberKey key = new MemberKey( member, context );
|
||||||
|
//FIXME get is as expensive as create most time spent in hashCode and equals
|
||||||
|
JavaXMethod xMethod = xMethods.get( key );
|
||||||
|
if ( xMethod == null ) {
|
||||||
|
xMethod = JavaXMethod.create( member, context, this );
|
||||||
|
xMethods.put( key, xMethod );
|
||||||
|
}
|
||||||
|
return xMethod;
|
||||||
|
}
|
||||||
|
|
||||||
|
TypeEnvironment getTypeEnvironment(final Type t) {
|
||||||
|
return new TypeSwitch<TypeEnvironment>() {
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment caseClass(Class classType) {
|
||||||
|
return typeEnvs.getEnvironment( classType );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return typeEnvs.getEnvironment( parameterizedType );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment defaultCase(Type type) {
|
||||||
|
return IdentityTypeEnvironment.INSTANCE;
|
||||||
|
}
|
||||||
|
}.doSwitch( t );
|
||||||
|
}
|
||||||
|
|
||||||
|
public JavaXType toXType(TypeEnvironment context, Type propType) {
|
||||||
|
Type boundType = toApproximatingEnvironment( context ).bind( propType );
|
||||||
|
if ( TypeUtils.isArray( boundType ) ) {
|
||||||
|
return new JavaXArrayType( propType, context, this );
|
||||||
|
}
|
||||||
|
if ( TypeUtils.isCollection( boundType ) ) {
|
||||||
|
return new JavaXCollectionType( propType, context, this );
|
||||||
|
}
|
||||||
|
if ( TypeUtils.isSimple( boundType ) ) {
|
||||||
|
return new JavaXSimpleType( propType, context, this );
|
||||||
|
}
|
||||||
|
throw new IllegalArgumentException( "No PropertyTypeExtractor available for type void " );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean equals(XClass class1, Class class2) {
|
||||||
|
if ( class1 == null ) {
|
||||||
|
return class2 == null;
|
||||||
|
}
|
||||||
|
return ( (JavaXClass) class1 ).toClass().equals( class2 );
|
||||||
|
}
|
||||||
|
|
||||||
|
public TypeEnvironment toApproximatingEnvironment(TypeEnvironment context) {
|
||||||
|
return typeEnvs.toApproximatingEnvironment( context );
|
||||||
|
}
|
||||||
|
|
||||||
|
public AnnotationReader buildAnnotationReader(AnnotatedElement annotatedElement) {
|
||||||
|
return new JavaAnnotationReader(annotatedElement);
|
||||||
|
}
|
||||||
|
|
||||||
|
public Map getDefaults() {
|
||||||
|
return new HashMap();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,71 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.annotation.Annotation;
|
||||||
|
import java.lang.reflect.AnnotatedElement;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.AnnotationReader;
|
||||||
|
import org.hibernate.annotations.common.reflection.XAnnotatedElement;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
abstract class JavaXAnnotatedElement implements XAnnotatedElement {
|
||||||
|
|
||||||
|
// responsible for extracting annotations
|
||||||
|
private AnnotationReader annotationReader;
|
||||||
|
|
||||||
|
private final JavaReflectionManager factory;
|
||||||
|
|
||||||
|
private final AnnotatedElement annotatedElement;
|
||||||
|
|
||||||
|
public JavaXAnnotatedElement(AnnotatedElement annotatedElement, JavaReflectionManager factory) {
|
||||||
|
this.factory = factory;
|
||||||
|
this.annotatedElement = annotatedElement;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected JavaReflectionManager getFactory() {
|
||||||
|
return factory;
|
||||||
|
}
|
||||||
|
|
||||||
|
private AnnotationReader getAnnotationReader() {
|
||||||
|
if (annotationReader == null) {
|
||||||
|
annotationReader = factory.buildAnnotationReader(annotatedElement);
|
||||||
|
}
|
||||||
|
return annotationReader;
|
||||||
|
}
|
||||||
|
|
||||||
|
public <T extends Annotation> T getAnnotation(Class<T> annotationType) {
|
||||||
|
return getAnnotationReader().getAnnotation( annotationType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public <T extends Annotation> boolean isAnnotationPresent(Class<T> annotationType) {
|
||||||
|
return getAnnotationReader().isAnnotationPresent( annotationType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Annotation[] getAnnotations() {
|
||||||
|
return getAnnotationReader().getAnnotations();
|
||||||
|
}
|
||||||
|
|
||||||
|
AnnotatedElement toAnnotatedElement() {
|
||||||
|
return annotatedElement;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean equals(Object obj) {
|
||||||
|
if ( ! ( obj instanceof JavaXAnnotatedElement ) ) return false;
|
||||||
|
JavaXAnnotatedElement other = (JavaXAnnotatedElement) obj;
|
||||||
|
//FIXME yuk this defeat the type environment
|
||||||
|
return annotatedElement.equals( other.toAnnotatedElement() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public int hashCode() {
|
||||||
|
return annotatedElement.hashCode();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toString() {
|
||||||
|
return annotatedElement.toString();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,77 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.Array;
|
||||||
|
import java.lang.reflect.GenericArrayType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeSwitch;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
class JavaXArrayType extends JavaXType {
|
||||||
|
|
||||||
|
public JavaXArrayType(Type type, TypeEnvironment context, JavaReflectionManager factory) {
|
||||||
|
super( type, context, factory );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isArray() {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isCollection() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getElementClass() {
|
||||||
|
return toXClass( getElementType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Type getElementType() {
|
||||||
|
//TODO make it a static class for faster performance?
|
||||||
|
return new TypeSwitch<Type>() {
|
||||||
|
@Override
|
||||||
|
public Type caseClass(Class classType) {
|
||||||
|
return classType.getComponentType();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
return genericArrayType.getGenericComponentType();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type defaultCase(Type t) {
|
||||||
|
throw new IllegalArgumentException( t + " is not an array type" );
|
||||||
|
}
|
||||||
|
}.doSwitch( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getClassOrElementClass() {
|
||||||
|
return getElementClass();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Collection> getCollectionClass() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getMapKey() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getType() {
|
||||||
|
Type boundType = getElementType();
|
||||||
|
if ( boundType instanceof Class ) {
|
||||||
|
boundType = arrayTypeOf( (Class) boundType );
|
||||||
|
}
|
||||||
|
return toXClass( boundType );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Class<? extends Object> arrayTypeOf(Class componentType) {
|
||||||
|
return Array.newInstance( componentType, 0 ).getClass();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,139 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Modifier;
|
||||||
|
import java.util.LinkedList;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.Filter;
|
||||||
|
import org.hibernate.annotations.common.reflection.ReflectionUtil;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XMethod;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.CompoundTypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
class JavaXClass extends JavaXAnnotatedElement implements XClass {
|
||||||
|
|
||||||
|
private final TypeEnvironment context;
|
||||||
|
private final Class clazz;
|
||||||
|
|
||||||
|
public JavaXClass(Class clazz, TypeEnvironment env, JavaReflectionManager factory) {
|
||||||
|
super( clazz, factory );
|
||||||
|
this.clazz = clazz; //optimization
|
||||||
|
this.context = env;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
return toClass().getName();
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getSuperclass() {
|
||||||
|
return getFactory().toXClass( toClass().getSuperclass(),
|
||||||
|
CompoundTypeEnvironment.create(
|
||||||
|
getTypeEnvironment(),
|
||||||
|
getFactory().getTypeEnvironment( toClass() )
|
||||||
|
)
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass[] getInterfaces() {
|
||||||
|
Class[] classes = toClass().getInterfaces();
|
||||||
|
int length = classes.length;
|
||||||
|
XClass[] xClasses = new XClass[length];
|
||||||
|
if (length != 0) {
|
||||||
|
TypeEnvironment environment = CompoundTypeEnvironment.create(
|
||||||
|
getTypeEnvironment(),
|
||||||
|
getFactory().getTypeEnvironment( toClass() )
|
||||||
|
);
|
||||||
|
for ( int index = 0; index < length ; index++ ) {
|
||||||
|
xClasses[index] = getFactory().toXClass( classes[index], environment );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return xClasses;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isInterface() {
|
||||||
|
return toClass().isInterface();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isAbstract() {
|
||||||
|
return Modifier.isAbstract( toClass().getModifiers() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isPrimitive() {
|
||||||
|
return toClass().isPrimitive();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isEnum() {
|
||||||
|
return toClass().isEnum();
|
||||||
|
}
|
||||||
|
|
||||||
|
private List<XProperty> getDeclaredFieldProperties(Filter filter) {
|
||||||
|
List<XProperty> result = new LinkedList<XProperty>();
|
||||||
|
for ( Field f : toClass().getDeclaredFields() ) {
|
||||||
|
if ( ReflectionUtil.isProperty( f, getTypeEnvironment().bind( f.getGenericType() ), filter ) ) {
|
||||||
|
result.add( getFactory().getXProperty( f, getTypeEnvironment() ) );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
private List<XProperty> getDeclaredMethodProperties(Filter filter) {
|
||||||
|
List<XProperty> result = new LinkedList<XProperty>();
|
||||||
|
for ( Method m : toClass().getDeclaredMethods() ) {
|
||||||
|
if ( ReflectionUtil.isProperty( m, getTypeEnvironment().bind( m.getGenericReturnType() ), filter ) ) {
|
||||||
|
result.add( getFactory().getXProperty( m, getTypeEnvironment() ) );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<XProperty> getDeclaredProperties(String accessType) {
|
||||||
|
return getDeclaredProperties( accessType, XClass.DEFAULT_FILTER );
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<XProperty> getDeclaredProperties(String accessType, Filter filter) {
|
||||||
|
if ( accessType.equals( ACCESS_FIELD ) ) {
|
||||||
|
return getDeclaredFieldProperties( filter );
|
||||||
|
}
|
||||||
|
if ( accessType.equals( ACCESS_PROPERTY ) ) {
|
||||||
|
return getDeclaredMethodProperties( filter );
|
||||||
|
}
|
||||||
|
throw new IllegalArgumentException( "Unknown access type " + accessType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<XMethod> getDeclaredMethods() {
|
||||||
|
List<XMethod> result = new LinkedList<XMethod>();
|
||||||
|
for ( Method m : toClass().getDeclaredMethods() ) {
|
||||||
|
result.add( getFactory().getXMethod( m, getTypeEnvironment() ) );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<?> toClass() {
|
||||||
|
return clazz;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isAssignableFrom(XClass c) {
|
||||||
|
return toClass().isAssignableFrom( ( (JavaXClass) c ).toClass() );
|
||||||
|
}
|
||||||
|
|
||||||
|
boolean isArray() {
|
||||||
|
return toClass().isArray();
|
||||||
|
}
|
||||||
|
|
||||||
|
TypeEnvironment getTypeEnvironment() {
|
||||||
|
return context;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toString() {
|
||||||
|
return getName();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,76 @@
|
||||||
|
// $Id:$
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.ParameterizedType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.SortedMap;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeSwitch;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeUtils;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
@SuppressWarnings("unchecked")
|
||||||
|
class JavaXCollectionType extends JavaXType {
|
||||||
|
|
||||||
|
public JavaXCollectionType(Type type, TypeEnvironment context, JavaReflectionManager factory) {
|
||||||
|
super( type, context, factory );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isArray() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isCollection() {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getElementClass() {
|
||||||
|
return new TypeSwitch<XClass>() {
|
||||||
|
@Override
|
||||||
|
public XClass caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
Type[] args = parameterizedType.getActualTypeArguments();
|
||||||
|
Type componentType;
|
||||||
|
Class<? extends Collection> collectionClass = getCollectionClass();
|
||||||
|
if ( Map.class.isAssignableFrom( collectionClass )
|
||||||
|
|| SortedMap.class.isAssignableFrom( collectionClass ) ) {
|
||||||
|
componentType = args[1];
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
componentType = args[0];
|
||||||
|
}
|
||||||
|
return toXClass( componentType );
|
||||||
|
}
|
||||||
|
}.doSwitch( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getMapKey() {
|
||||||
|
return new TypeSwitch<XClass>() {
|
||||||
|
@Override
|
||||||
|
public XClass caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
if ( Map.class.isAssignableFrom( getCollectionClass() ) ) {
|
||||||
|
return toXClass( parameterizedType.getActualTypeArguments()[0] );
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}.doSwitch( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getClassOrElementClass() {
|
||||||
|
return toXClass( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Collection> getCollectionClass() {
|
||||||
|
return TypeUtils.getCollectionClass( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getType() {
|
||||||
|
return toXClass( approximate() );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,94 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.AccessibleObject;
|
||||||
|
import java.lang.reflect.AnnotatedElement;
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.lang.reflect.Member;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XMember;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public abstract class JavaXMember extends JavaXAnnotatedElement implements XMember {
|
||||||
|
private final Type type;
|
||||||
|
private final TypeEnvironment env;
|
||||||
|
private final JavaXType xType;
|
||||||
|
|
||||||
|
protected static Type typeOf(Member member, TypeEnvironment env) {
|
||||||
|
if ( member instanceof Field ) {
|
||||||
|
return env.bind( ( (Field) member ).getGenericType() );
|
||||||
|
}
|
||||||
|
if ( member instanceof Method ) {
|
||||||
|
return env.bind( ( (Method) member ).getGenericReturnType() );
|
||||||
|
}
|
||||||
|
throw new IllegalArgumentException( "Member " + member + " is neither a field nor a method" );
|
||||||
|
}
|
||||||
|
|
||||||
|
protected JavaXMember(Member member, Type type, TypeEnvironment env, JavaReflectionManager factory, JavaXType xType) {
|
||||||
|
super( (AnnotatedElement) member, factory );
|
||||||
|
this.type = type;
|
||||||
|
this.env = env;
|
||||||
|
this.xType = xType;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getType() {
|
||||||
|
return xType.getType();
|
||||||
|
}
|
||||||
|
|
||||||
|
public abstract String getName();
|
||||||
|
|
||||||
|
protected Type getJavaType() {
|
||||||
|
return env.bind( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TypeEnvironment getTypeEnvironment() {
|
||||||
|
return env;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected Member getMember() {
|
||||||
|
return (Member) toAnnotatedElement();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Collection> getCollectionClass() {
|
||||||
|
return xType.getCollectionClass();
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getClassOrElementClass() {
|
||||||
|
return xType.getClassOrElementClass();
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getElementClass() {
|
||||||
|
return xType.getElementClass();
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getMapKey() {
|
||||||
|
return xType.getMapKey();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isArray() {
|
||||||
|
return xType.isArray();
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isCollection() {
|
||||||
|
return xType.isCollection();
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getModifiers() {
|
||||||
|
return getMember().getModifiers();
|
||||||
|
}
|
||||||
|
|
||||||
|
public final boolean isTypeResolved() {
|
||||||
|
return xType.isResolved();
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setAccessible(boolean accessible) {
|
||||||
|
( (AccessibleObject) getMember() ).setAccessible( accessible );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,45 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.Member;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XMethod;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public class JavaXMethod extends JavaXMember implements XMethod {
|
||||||
|
|
||||||
|
static JavaXMethod create(Member member, TypeEnvironment context, JavaReflectionManager factory) {
|
||||||
|
final Type propType = typeOf( member, context );
|
||||||
|
JavaXType xType = factory.toXType( context, propType );
|
||||||
|
return new JavaXMethod( member, propType, context, factory, xType );
|
||||||
|
}
|
||||||
|
|
||||||
|
private JavaXMethod(Member member, Type type, TypeEnvironment env, JavaReflectionManager factory, JavaXType xType) {
|
||||||
|
super( member, type, env, factory, xType );
|
||||||
|
assert member instanceof Method;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
return getMember().getName();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Object invoke(Object target, Object... parameters) {
|
||||||
|
try {
|
||||||
|
return ( (Method) getMember() ).invoke( target, parameters );
|
||||||
|
}
|
||||||
|
catch (NullPointerException e) {
|
||||||
|
throw new IllegalArgumentException( "Invoking " + getName() + " on a null object", e );
|
||||||
|
}
|
||||||
|
catch (IllegalArgumentException e) {
|
||||||
|
throw new IllegalArgumentException( "Invoking " + getName() + " with wrong parameters", e );
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
throw new IllegalStateException( "Unable to invoke " + getName(), e );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,18 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XPackage;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
class JavaXPackage extends JavaXAnnotatedElement implements XPackage {
|
||||||
|
|
||||||
|
public JavaXPackage(Package pkg, JavaReflectionManager factory) {
|
||||||
|
super( pkg, factory );
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
return ( (Package) toAnnotatedElement() ).getName();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,72 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.beans.Introspector;
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.lang.reflect.Member;
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
class JavaXProperty extends JavaXMember implements XProperty {
|
||||||
|
|
||||||
|
static JavaXProperty create(Member member, final TypeEnvironment context, final JavaReflectionManager factory) {
|
||||||
|
final Type propType = typeOf( member, context );
|
||||||
|
JavaXType xType = factory.toXType( context, propType );
|
||||||
|
return new JavaXProperty( member, propType, context, factory, xType );
|
||||||
|
}
|
||||||
|
|
||||||
|
private JavaXProperty(Member member, Type type, TypeEnvironment env, JavaReflectionManager factory, JavaXType xType) {
|
||||||
|
super( member, type, env, factory, xType );
|
||||||
|
assert member instanceof Field || member instanceof Method;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
String fullName = getMember().getName();
|
||||||
|
if ( getMember() instanceof Method ) {
|
||||||
|
if ( fullName.startsWith( "get" ) ) {
|
||||||
|
return Introspector.decapitalize( fullName.substring( "get".length() ) );
|
||||||
|
}
|
||||||
|
if ( fullName.startsWith( "is" ) ) {
|
||||||
|
return Introspector.decapitalize( fullName.substring( "is".length() ) );
|
||||||
|
}
|
||||||
|
throw new RuntimeException( "Method " + fullName + " is not a property getter" );
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return fullName;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Object invoke(Object target, Object... parameters) {
|
||||||
|
if ( parameters.length != 0 ) {
|
||||||
|
throw new IllegalArgumentException( "An XProperty cannot have invoke parameters" );
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
if ( getMember() instanceof Method ) {
|
||||||
|
return ( (Method) getMember() ).invoke( target );
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return ( (Field) getMember() ).get( target );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch (NullPointerException e) {
|
||||||
|
throw new IllegalArgumentException( "Invoking " + getName() + " on a null object", e );
|
||||||
|
}
|
||||||
|
catch (IllegalArgumentException e) {
|
||||||
|
throw new IllegalArgumentException( "Invoking " + getName() + " with wrong parameters", e );
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
throw new IllegalStateException( "Unable to invoke " + getName(), e );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toString() {
|
||||||
|
return getName();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,46 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
class JavaXSimpleType extends JavaXType {
|
||||||
|
|
||||||
|
public JavaXSimpleType(Type type, TypeEnvironment context, JavaReflectionManager factory) {
|
||||||
|
super( type, context, factory );
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isArray() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isCollection() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getElementClass() {
|
||||||
|
return toXClass( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getClassOrElementClass() {
|
||||||
|
return getElementClass();
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<? extends Collection> getCollectionClass() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getType() {
|
||||||
|
return toXClass( approximate() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public XClass getMapKey() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,56 @@
|
||||||
|
//$Id: PropertyTypeExtractor.java 9316 2006-02-22 20:47:31Z epbernard $
|
||||||
|
package org.hibernate.annotations.common.reflection.java;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeUtils;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The Java X-layer equivalent to a Java <code>Type</code>.
|
||||||
|
*
|
||||||
|
* @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<? extends Collection> 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 );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,58 @@
|
||||||
|
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 Pair<T, U> {
|
||||||
|
|
||||||
|
private final T o1;
|
||||||
|
|
||||||
|
private final U o2;
|
||||||
|
private final int hashCode;
|
||||||
|
|
||||||
|
Pair(T o1, U o2) {
|
||||||
|
this.o1 = o1;
|
||||||
|
this.o2 = o2;
|
||||||
|
this.hashCode = doHashCode();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean equals(Object obj) {
|
||||||
|
if ( ! (obj instanceof Pair) ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
Pair other = (Pair) obj;
|
||||||
|
return !differentHashCode( other ) && safeEquals( o1, other.o1 ) && safeEquals( o2, other.o2 );
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean differentHashCode(Pair other) {
|
||||||
|
return hashCode != other.hashCode;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public int hashCode() {
|
||||||
|
//cached because the inheritance can be big
|
||||||
|
return hashCode;
|
||||||
|
}
|
||||||
|
|
||||||
|
private int doHashCode() {
|
||||||
|
return safeHashCode( o1 ) ^ safeHashCode( o2 );
|
||||||
|
}
|
||||||
|
|
||||||
|
private int safeHashCode(Object o) {
|
||||||
|
if ( o == null ) {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
return o.hashCode();
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean safeEquals(Object obj1, Object obj2) {
|
||||||
|
if ( obj1 == null ) {
|
||||||
|
return obj2 == null;
|
||||||
|
}
|
||||||
|
return obj1.equals( obj2 );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,151 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Array;
|
||||||
|
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 <code>TypeEnvironment</code> that approximates the unresolved components of a generic simple
|
||||||
|
* type or collection to their nearest upper binding. The returned type is always fully resolved.
|
||||||
|
* <p/>
|
||||||
|
* 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.
|
||||||
|
* <p/>
|
||||||
|
* For example:<br>
|
||||||
|
* <code>T</code> becomes <code>Object</code>.<br>
|
||||||
|
* <code>T extends Foo</code> becomes <code>Foo</code>.<br>
|
||||||
|
* <code>List<T></code> becomes <code>List<Object></code>.<br>
|
||||||
|
* <code>List<T extends Foo></code> becomes <code>List<Foo></code>.<br>
|
||||||
|
* An array of <code>T extends Foo</code> becomes an array of <code>Foo</code>.<p>
|
||||||
|
* <p/>
|
||||||
|
* If a type variable has multiple upper bounds, it will be approximated to <code>Object</code>.
|
||||||
|
* Lower bounds are ignored.<p>
|
||||||
|
* <p/>
|
||||||
|
* Wildcards are generally not approximated. <code>Class<?></code> stays <code>Class<?></code>.
|
||||||
|
* A wildcard within a generic collection is approximated to its upper binding. <code>List<?></code> becomes
|
||||||
|
* <code>List<Object></code><p>
|
||||||
|
* <p/>
|
||||||
|
* Note that <code>Class<T></code> is <emp>not</emp> approximated <code>Class<Object></code>.
|
||||||
|
* That would be wrong in any situation. All parametric types that are not type variables, collections or
|
||||||
|
* arrays are coarsely approximated to <code>Object.class</code>.
|
||||||
|
*
|
||||||
|
* @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 TypeSwitch<Type>() {
|
||||||
|
public Type caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return wildcardType;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseClass(Class classType) {
|
||||||
|
return classType;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
if ( TypeUtils.isResolved( genericArrayType ) ) {
|
||||||
|
return genericArrayType;
|
||||||
|
}
|
||||||
|
Type componentType = genericArrayType.getGenericComponentType();
|
||||||
|
Type boundComponentType = bind( componentType );
|
||||||
|
if ( boundComponentType instanceof Class ) {
|
||||||
|
return Array.newInstance( (Class) boundComponentType, 0 ).getClass();
|
||||||
|
}
|
||||||
|
// fall back to coarse approximation, because I found no standard way
|
||||||
|
// to instance arrays of a generic type
|
||||||
|
return Object[].class;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
if ( TypeUtils.isResolved( parameterizedType ) ) {
|
||||||
|
return parameterizedType;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ( !TypeUtils.isCollection( parameterizedType ) ) {
|
||||||
|
return Object.class; // fall back to coarse approximation
|
||||||
|
}
|
||||||
|
|
||||||
|
Type[] typeArguments = parameterizedType.getActualTypeArguments();
|
||||||
|
Type[] approximatedTypeArguments = new Type[typeArguments.length];
|
||||||
|
for ( int i = 0; i < typeArguments.length ; i++ ) {
|
||||||
|
approximatedTypeArguments[i] = coarseApproximation( typeArguments[i] );
|
||||||
|
}
|
||||||
|
|
||||||
|
return TypeFactory.createParameterizedType(
|
||||||
|
bind( parameterizedType.getRawType() ),
|
||||||
|
approximatedTypeArguments,
|
||||||
|
parameterizedType.getOwnerType()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type defaultCase(Type t) {
|
||||||
|
return coarseApproximation( t );
|
||||||
|
}
|
||||||
|
}.doSwitch( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Type coarseApproximation(final Type type) {
|
||||||
|
Type result = new TypeSwitch<Type>() {
|
||||||
|
public Type caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return approximateTo( wildcardType.getUpperBounds() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
if ( TypeUtils.isResolved( genericArrayType ) ) {
|
||||||
|
return genericArrayType;
|
||||||
|
}
|
||||||
|
return Object[].class;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
if ( TypeUtils.isResolved( parameterizedType ) ) {
|
||||||
|
return parameterizedType;
|
||||||
|
}
|
||||||
|
return Object.class;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseTypeVariable(TypeVariable typeVariable) {
|
||||||
|
return approximateTo( typeVariable.getBounds() );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Type approximateTo(Type[] bounds) {
|
||||||
|
if ( bounds.length != 1 ) {
|
||||||
|
return Object.class;
|
||||||
|
}
|
||||||
|
return coarseApproximation( bounds[0] );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type defaultCase(Type t) {
|
||||||
|
return t;
|
||||||
|
}
|
||||||
|
}.doSwitch( type );
|
||||||
|
assert TypeUtils.isResolved( result );
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String toString() {
|
||||||
|
return "approximated_types";
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,70 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A composition of two <code>TypeEnvironment</code> 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() + ")";
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,25 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Substitutes a <code>Type</code> 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 "{}";
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,93 @@
|
||||||
|
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 HashMap<Type, Type> implements TypeEnvironment {
|
||||||
|
|
||||||
|
private static final long serialVersionUID = 1L;
|
||||||
|
|
||||||
|
private final TypeSwitch<Type> substitute = new TypeSwitch<Type>() {
|
||||||
|
@Override
|
||||||
|
public Type caseClass(Class classType) {
|
||||||
|
return classType;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
Type originalComponentType = genericArrayType.getGenericComponentType();
|
||||||
|
Type boundComponentType = bind( originalComponentType );
|
||||||
|
// try to keep the original type if possible
|
||||||
|
if ( originalComponentType == boundComponentType ) {
|
||||||
|
return genericArrayType;
|
||||||
|
}
|
||||||
|
return TypeFactory.createArrayType( boundComponentType );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
Type[] originalArguments = parameterizedType.getActualTypeArguments();
|
||||||
|
Type[] boundArguments = substitute( originalArguments );
|
||||||
|
// try to keep the original type if possible
|
||||||
|
if ( areSame( originalArguments, boundArguments ) ) {
|
||||||
|
return parameterizedType;
|
||||||
|
}
|
||||||
|
return TypeFactory.createParameterizedType(
|
||||||
|
parameterizedType.getRawType(), boundArguments, parameterizedType.getOwnerType()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean areSame(Object[] array1, Object[] array2) {
|
||||||
|
if ( array1.length != array2.length ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
for ( int i = 0; i < array1.length ; i++ ) {
|
||||||
|
if ( array1[i] != array2[i] ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseTypeVariable(TypeVariable typeVariable) {
|
||||||
|
if ( !containsKey( typeVariable )) {
|
||||||
|
return typeVariable;
|
||||||
|
}
|
||||||
|
return get( typeVariable );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Type caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return wildcardType;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
public SimpleTypeEnvironment(Type[] formalTypeArgs, Type[] actualTypeArgs) {
|
||||||
|
for (int i = 0; i < formalTypeArgs.length; i++) {
|
||||||
|
put( formalTypeArgs[i], actualTypeArgs[i] );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Type bind(Type type) {
|
||||||
|
return substitute.doSwitch( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Type[] substitute(Type[] types) {
|
||||||
|
Type[] substTypes = new Type[types.length];
|
||||||
|
for ( int i = 0; i < substTypes.length ; i++ ) {
|
||||||
|
substTypes[i] = bind( types[i] );
|
||||||
|
}
|
||||||
|
return substTypes;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,53 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A typing context that knows how to "resolve" the generic parameters of a
|
||||||
|
* <code>Type</code>.
|
||||||
|
* <p/>
|
||||||
|
* For example:
|
||||||
|
* <p/>
|
||||||
|
* <p/>
|
||||||
|
* <blockquote>
|
||||||
|
* <p/>
|
||||||
|
* <pre>
|
||||||
|
* class Shop<T>{
|
||||||
|
* List<T> getCatalog() { ... }
|
||||||
|
* }
|
||||||
|
* <p/>
|
||||||
|
* class Bakery extends Shop<Bread>{}
|
||||||
|
* </pre>
|
||||||
|
* <p/>
|
||||||
|
* </blockquote>
|
||||||
|
* <p/>
|
||||||
|
* Consider the type returned by method <code>getCatalog()</code>. There are
|
||||||
|
* two possible contexts here. In the context of <code>Shop</code>, the type
|
||||||
|
* is <code>List<T></code>. In the context of <code>Bakery</code>, the
|
||||||
|
* type is <code>List<Bread></code>. Each of these contexts can be
|
||||||
|
* represented by a <code>TypeEnvironment</code>.
|
||||||
|
*
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public interface TypeEnvironment {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Binds as many generic components of the given type as possible in this
|
||||||
|
* context.
|
||||||
|
* <p/>
|
||||||
|
* Warning: if the returned <code>Type</code> is a <code>Class</code>,
|
||||||
|
* then it's guaranteed to be a regular Java <code>Class</code>. In all
|
||||||
|
* other cases, this method might return a custom implementation of some
|
||||||
|
* interface that extends <code>Type</code>. Be sure not to mix these
|
||||||
|
* objects with Java's implementations of <code>Type</code> to avoid
|
||||||
|
* potential identity problems.
|
||||||
|
* <p/>
|
||||||
|
* 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);
|
||||||
|
}
|
|
@ -0,0 +1,95 @@
|
||||||
|
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 <code>Class</code> or <code>ParameterizedType</code>.
|
||||||
|
* <p/>
|
||||||
|
* 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 TypeSwitch<TypeEnvironment>() {
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment caseClass(Class classType) {
|
||||||
|
return CompoundTypeEnvironment.create(
|
||||||
|
createSuperTypeEnvironment( classType ),
|
||||||
|
getEnvironment( classType.getSuperclass() )
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return createEnvironment( parameterizedType );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public TypeEnvironment defaultCase(Type t) {
|
||||||
|
throw new IllegalArgumentException( "Invalid type for generating environment: " + t );
|
||||||
|
}
|
||||||
|
}.doSwitch( context );
|
||||||
|
}
|
||||||
|
|
||||||
|
private TypeEnvironment createSuperTypeEnvironment(Class clazz) {
|
||||||
|
Class superclass = clazz.getSuperclass();
|
||||||
|
if ( superclass == null ) {
|
||||||
|
return IdentityTypeEnvironment.INSTANCE;
|
||||||
|
}
|
||||||
|
|
||||||
|
Type[] formalArgs = superclass.getTypeParameters();
|
||||||
|
Type genericSuperclass = clazz.getGenericSuperclass();
|
||||||
|
|
||||||
|
if ( genericSuperclass instanceof Class ) {
|
||||||
|
return IdentityTypeEnvironment.INSTANCE;
|
||||||
|
}
|
||||||
|
|
||||||
|
if ( genericSuperclass instanceof ParameterizedType ) {
|
||||||
|
Type[] actualArgs = ( (ParameterizedType) genericSuperclass ).getActualTypeArguments();
|
||||||
|
return new SimpleTypeEnvironment( formalArgs, actualArgs );
|
||||||
|
}
|
||||||
|
|
||||||
|
throw new AssertionError( "Should be unreachable" );
|
||||||
|
}
|
||||||
|
|
||||||
|
private TypeEnvironment createEnvironment(ParameterizedType t) {
|
||||||
|
Type[] tactuals = t.getActualTypeArguments();
|
||||||
|
Type rawType = t.getRawType();
|
||||||
|
if ( rawType instanceof Class ) {
|
||||||
|
TypeVariable[] tparms = ( (Class) rawType ).getTypeParameters();
|
||||||
|
return new SimpleTypeEnvironment( tparms, tactuals );
|
||||||
|
}
|
||||||
|
return IdentityTypeEnvironment.INSTANCE;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,100 @@
|
||||||
|
package org.hibernate.annotations.common.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Array;
|
||||||
|
import java.lang.reflect.GenericArrayType;
|
||||||
|
import java.lang.reflect.ParameterizedType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Arrays;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* This class instances our own <code>ParameterizedTypes</code> and <code>GenericArrayTypes</code>.
|
||||||
|
* 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();
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,59 @@
|
||||||
|
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 <code>java.lang.reflect.Type</code> hierarchy.
|
||||||
|
*
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class TypeSwitch<T> {
|
||||||
|
|
||||||
|
public final T doSwitch(Type type) {
|
||||||
|
if ( type instanceof Class ) {
|
||||||
|
return caseClass( (Class) type );
|
||||||
|
}
|
||||||
|
if ( type instanceof GenericArrayType ) {
|
||||||
|
return caseGenericArrayType( (GenericArrayType) type );
|
||||||
|
}
|
||||||
|
if ( type instanceof ParameterizedType ) {
|
||||||
|
return caseParameterizedType( (ParameterizedType) type );
|
||||||
|
}
|
||||||
|
if ( type instanceof TypeVariable ) {
|
||||||
|
return caseTypeVariable( (TypeVariable) type );
|
||||||
|
}
|
||||||
|
if ( type instanceof WildcardType ) {
|
||||||
|
return caseWildcardType( (WildcardType) type );
|
||||||
|
}
|
||||||
|
return defaultCase( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return defaultCase( wildcardType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T caseTypeVariable(TypeVariable typeVariable) {
|
||||||
|
return defaultCase( typeVariable );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T caseClass(Class classType) {
|
||||||
|
return defaultCase( classType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
return defaultCase( genericArrayType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return defaultCase( parameterizedType );
|
||||||
|
}
|
||||||
|
|
||||||
|
public T defaultCase(Type t) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,155 @@
|
||||||
|
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.Collection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class TypeUtils {
|
||||||
|
|
||||||
|
public static boolean isResolved(Type t) {
|
||||||
|
return new TypeSwitch<Boolean>() {
|
||||||
|
@Override
|
||||||
|
public Boolean caseClass(Class classType) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
return isResolved( genericArrayType.getGenericComponentType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
Type[] typeArgs = parameterizedType.getActualTypeArguments();
|
||||||
|
for ( Type arg : typeArgs ) {
|
||||||
|
if ( !isResolved( arg ) ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return isResolved( parameterizedType.getRawType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseTypeVariable(TypeVariable typeVariable) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return areResolved( wildcardType.getUpperBounds() ) && areResolved( wildcardType.getLowerBounds() );
|
||||||
|
}
|
||||||
|
}.doSwitch( t );
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Boolean areResolved(Type[] types) {
|
||||||
|
for ( Type t : types ) {
|
||||||
|
if ( !isResolved( t ) ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Class<? extends Collection> getCollectionClass(Type type) {
|
||||||
|
return new TypeSwitch<Class<? extends Collection>>() {
|
||||||
|
@Override
|
||||||
|
public Class<? extends Collection> caseClass(Class clazz) {
|
||||||
|
return isCollectionClass( clazz ) ? (Class<? extends Collection>) clazz : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Class<? extends Collection> caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return getCollectionClass( parameterizedType.getRawType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Class<? extends Collection> caseWildcardType(WildcardType wildcardType) {
|
||||||
|
Type[] upperBounds = wildcardType.getUpperBounds();
|
||||||
|
if ( upperBounds.length == 0 ) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return getCollectionClass( upperBounds[0] );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Class<? extends Collection> defaultCase(Type t) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}.doSwitch( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
private static boolean isCollectionClass(Class<?> clazz) {
|
||||||
|
return clazz == Collection.class
|
||||||
|
|| clazz == java.util.List.class
|
||||||
|
|| clazz == java.util.Set.class
|
||||||
|
|| clazz == java.util.Map.class
|
||||||
|
|| clazz == java.util.SortedSet.class // extension to the specs
|
||||||
|
|| clazz == java.util.SortedMap.class; // extension to the specs
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isSimple(Type type) {
|
||||||
|
return new TypeSwitch<Boolean>() {
|
||||||
|
@Override
|
||||||
|
public Boolean caseClass(Class clazz) {
|
||||||
|
return !clazz.isArray() && !isCollectionClass( clazz ); // probably not fully accurate
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseParameterizedType(ParameterizedType parameterizedType) {
|
||||||
|
return isSimple( parameterizedType.getRawType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseWildcardType(WildcardType wildcardType) {
|
||||||
|
return areSimple( wildcardType.getUpperBounds() ) && areSimple( wildcardType.getLowerBounds() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean defaultCase(Type t) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}.doSwitch( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
private static Boolean areSimple(Type[] types) {
|
||||||
|
for ( Type t : types ) {
|
||||||
|
if ( !isSimple( t ) ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isVoid(Type type) {
|
||||||
|
return void.class.equals( type );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isArray(Type t) {
|
||||||
|
return new TypeSwitch<Boolean>() {
|
||||||
|
@Override
|
||||||
|
public Boolean caseClass(Class clazz) {
|
||||||
|
return clazz.isArray();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean caseGenericArrayType(GenericArrayType genericArrayType) {
|
||||||
|
return isSimple( genericArrayType.getGenericComponentType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public Boolean defaultCase(Type type) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}.doSwitch( t );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isCollection(Type t) {
|
||||||
|
return getCollectionClass( t ) != null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,122 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.util;
|
||||||
|
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
import java.lang.reflect.Member;
|
||||||
|
import java.lang.reflect.Modifier;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.AssertionFailure;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
|
||||||
|
public final class ReflectHelper {
|
||||||
|
|
||||||
|
private static final Class[] OBJECT = new Class[] { Object.class };
|
||||||
|
private static final Method OBJECT_EQUALS;
|
||||||
|
private static final Class[] NO_PARAM = new Class[] { };
|
||||||
|
|
||||||
|
private static final Method OBJECT_HASHCODE;
|
||||||
|
static {
|
||||||
|
Method eq;
|
||||||
|
Method hash;
|
||||||
|
try {
|
||||||
|
eq = Object.class.getMethod("equals", OBJECT);
|
||||||
|
hash = Object.class.getMethod("hashCode", NO_PARAM);
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
throw new AssertionFailure("Could not find Object.equals() or Object.hashCode()", e);
|
||||||
|
}
|
||||||
|
OBJECT_EQUALS = eq;
|
||||||
|
OBJECT_HASHCODE = hash;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean overridesEquals(Class clazz) {
|
||||||
|
Method equals;
|
||||||
|
try {
|
||||||
|
equals = clazz.getMethod("equals", OBJECT);
|
||||||
|
}
|
||||||
|
catch (NoSuchMethodException nsme) {
|
||||||
|
return false; //its an interface so we can't really tell anything...
|
||||||
|
}
|
||||||
|
return !OBJECT_EQUALS.equals(equals);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean overridesHashCode(Class clazz) {
|
||||||
|
Method hashCode;
|
||||||
|
try {
|
||||||
|
hashCode = clazz.getMethod("hashCode", NO_PARAM);
|
||||||
|
}
|
||||||
|
catch (NoSuchMethodException nsme) {
|
||||||
|
return false; //its an interface so we can't really tell anything...
|
||||||
|
}
|
||||||
|
return !OBJECT_HASHCODE.equals(hashCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Class classForName(String name) throws ClassNotFoundException {
|
||||||
|
try {
|
||||||
|
ClassLoader contextClassLoader = Thread.currentThread().getContextClassLoader();
|
||||||
|
if ( contextClassLoader != null ) {
|
||||||
|
return contextClassLoader.loadClass(name);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch ( Throwable t ) {
|
||||||
|
}
|
||||||
|
return Class.forName( name );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Class classForName(String name, Class caller) throws ClassNotFoundException {
|
||||||
|
try {
|
||||||
|
ClassLoader contextClassLoader = Thread.currentThread().getContextClassLoader();
|
||||||
|
if ( contextClassLoader != null ) {
|
||||||
|
return contextClassLoader.loadClass( name );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch ( Throwable e ) {
|
||||||
|
}
|
||||||
|
return Class.forName( name, true, caller.getClassLoader() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isPublic(Class clazz, Member member) {
|
||||||
|
return Modifier.isPublic( member.getModifiers() ) && Modifier.isPublic( clazz.getModifiers() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Object getConstantValue(String name) {
|
||||||
|
Class clazz;
|
||||||
|
try {
|
||||||
|
clazz = classForName( StringHelper.qualifier( name ) );
|
||||||
|
}
|
||||||
|
catch ( Throwable t ) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
return clazz.getField( StringHelper.unqualify( name ) ).get(null);
|
||||||
|
}
|
||||||
|
catch ( Throwable t ) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isAbstractClass(Class clazz) {
|
||||||
|
int modifier = clazz.getModifiers();
|
||||||
|
return Modifier.isAbstract(modifier) || Modifier.isInterface(modifier);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isFinalClass(Class clazz) {
|
||||||
|
return Modifier.isFinal( clazz.getModifiers() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Method getMethod(Class clazz, Method method) {
|
||||||
|
try {
|
||||||
|
return clazz.getMethod( method.getName(), method.getParameterTypes() );
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private ReflectHelper() {}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
|
@ -0,0 +1,421 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.util;
|
||||||
|
|
||||||
|
import java.util.Iterator;
|
||||||
|
import java.util.StringTokenizer;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
//TODO copy from Hibernate Core, mutualization?
|
||||||
|
public final class StringHelper {
|
||||||
|
|
||||||
|
private static final int ALIAS_TRUNCATE_LENGTH = 10;
|
||||||
|
public static final String WHITESPACE = " \n\r\f\t";
|
||||||
|
|
||||||
|
private StringHelper() { /* static methods only - hide constructor */
|
||||||
|
}
|
||||||
|
|
||||||
|
public static int lastIndexOfLetter(String string) {
|
||||||
|
for ( int i=0; i<string.length(); i++ ) {
|
||||||
|
char character = string.charAt(i);
|
||||||
|
if ( !Character.isLetter(character) ) return i-1;
|
||||||
|
}
|
||||||
|
return string.length()-1;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String join(String seperator, String[] strings) {
|
||||||
|
int length = strings.length;
|
||||||
|
if ( length == 0 ) return "";
|
||||||
|
StringBuffer buf = new StringBuffer( length * strings[0].length() )
|
||||||
|
.append( strings[0] );
|
||||||
|
for ( int i = 1; i < length; i++ ) {
|
||||||
|
buf.append( seperator ).append( strings[i] );
|
||||||
|
}
|
||||||
|
return buf.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String join(String seperator, Iterator objects) {
|
||||||
|
StringBuffer buf = new StringBuffer();
|
||||||
|
if ( objects.hasNext() ) buf.append( objects.next() );
|
||||||
|
while ( objects.hasNext() ) {
|
||||||
|
buf.append( seperator ).append( objects.next() );
|
||||||
|
}
|
||||||
|
return buf.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] add(String[] x, String sep, String[] y) {
|
||||||
|
String[] result = new String[x.length];
|
||||||
|
for ( int i = 0; i < x.length; i++ ) {
|
||||||
|
result[i] = x[i] + sep + y[i];
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String repeat(String string, int times) {
|
||||||
|
StringBuffer buf = new StringBuffer( string.length() * times );
|
||||||
|
for ( int i = 0; i < times; i++ ) buf.append( string );
|
||||||
|
return buf.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String replace(String template, String placeholder, String replacement) {
|
||||||
|
return replace( template, placeholder, replacement, false );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] replace(String templates[], String placeholder, String replacement) {
|
||||||
|
String[] result = new String[templates.length];
|
||||||
|
for ( int i =0; i<templates.length; i++ ) {
|
||||||
|
result[i] = replace( templates[i], placeholder, replacement );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String replace(String template, String placeholder, String replacement, boolean wholeWords) {
|
||||||
|
int loc = template == null ? -1 : template.indexOf( placeholder );
|
||||||
|
if ( loc < 0 ) {
|
||||||
|
return template;
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
final boolean actuallyReplace = !wholeWords ||
|
||||||
|
loc + placeholder.length() == template.length() ||
|
||||||
|
!Character.isJavaIdentifierPart( template.charAt( loc + placeholder.length() ) );
|
||||||
|
String actualReplacement = actuallyReplace ? replacement : placeholder;
|
||||||
|
return new StringBuffer( template.substring( 0, loc ) )
|
||||||
|
.append( actualReplacement )
|
||||||
|
.append( replace( template.substring( loc + placeholder.length() ),
|
||||||
|
placeholder,
|
||||||
|
replacement,
|
||||||
|
wholeWords ) ).toString();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
public static String replaceOnce(String template, String placeholder, String replacement) {
|
||||||
|
int loc = template == null ? -1 : template.indexOf( placeholder );
|
||||||
|
if ( loc < 0 ) {
|
||||||
|
return template;
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return new StringBuffer( template.substring( 0, loc ) )
|
||||||
|
.append( replacement )
|
||||||
|
.append( template.substring( loc + placeholder.length() ) )
|
||||||
|
.toString();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] split(String seperators, String list) {
|
||||||
|
return split( seperators, list, false );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] split(String seperators, String list, boolean include) {
|
||||||
|
StringTokenizer tokens = new StringTokenizer( list, seperators, include );
|
||||||
|
String[] result = new String[ tokens.countTokens() ];
|
||||||
|
int i = 0;
|
||||||
|
while ( tokens.hasMoreTokens() ) {
|
||||||
|
result[i++] = tokens.nextToken();
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String unqualify(String qualifiedName) {
|
||||||
|
int loc = qualifiedName.lastIndexOf(".");
|
||||||
|
return ( loc < 0 ) ? qualifiedName : qualifiedName.substring( qualifiedName.lastIndexOf(".") + 1 );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String qualifier(String qualifiedName) {
|
||||||
|
int loc = qualifiedName.lastIndexOf(".");
|
||||||
|
return ( loc < 0 ) ? "" : qualifiedName.substring( 0, loc );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] suffix(String[] columns, String suffix) {
|
||||||
|
if ( suffix == null ) return columns;
|
||||||
|
String[] qualified = new String[columns.length];
|
||||||
|
for ( int i = 0; i < columns.length; i++ ) {
|
||||||
|
qualified[i] = suffix( columns[i], suffix );
|
||||||
|
}
|
||||||
|
return qualified;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static String suffix(String name, String suffix) {
|
||||||
|
return ( suffix == null ) ? name : name + suffix;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String root(String qualifiedName) {
|
||||||
|
int loc = qualifiedName.indexOf( "." );
|
||||||
|
return ( loc < 0 ) ? qualifiedName : qualifiedName.substring( 0, loc );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String unroot(String qualifiedName) {
|
||||||
|
int loc = qualifiedName.indexOf( "." );
|
||||||
|
return ( loc < 0 ) ? qualifiedName : qualifiedName.substring( loc+1, qualifiedName.length() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean booleanValue(String tfString) {
|
||||||
|
String trimmed = tfString.trim().toLowerCase();
|
||||||
|
return trimmed.equals( "true" ) || trimmed.equals( "t" );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String toString(Object[] array) {
|
||||||
|
int len = array.length;
|
||||||
|
if ( len == 0 ) return "";
|
||||||
|
StringBuffer buf = new StringBuffer( len * 12 );
|
||||||
|
for ( int i = 0; i < len - 1; i++ ) {
|
||||||
|
buf.append( array[i] ).append(", ");
|
||||||
|
}
|
||||||
|
return buf.append( array[len - 1] ).toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] multiply(String string, Iterator placeholders, Iterator replacements) {
|
||||||
|
String[] result = new String[]{string};
|
||||||
|
while ( placeholders.hasNext() ) {
|
||||||
|
result = multiply( result, ( String ) placeholders.next(), ( String[] ) replacements.next() );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static String[] multiply(String[] strings, String placeholder, String[] replacements) {
|
||||||
|
String[] results = new String[replacements.length * strings.length];
|
||||||
|
int n = 0;
|
||||||
|
for ( int i = 0; i < replacements.length; i++ ) {
|
||||||
|
for ( int j = 0; j < strings.length; j++ ) {
|
||||||
|
results[n++] = replaceOnce( strings[j], placeholder, replacements[i] );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return results;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static int countUnquoted(String string, char character) {
|
||||||
|
if ( '\'' == character ) {
|
||||||
|
throw new IllegalArgumentException( "Unquoted count of quotes is invalid" );
|
||||||
|
}
|
||||||
|
if (string == null)
|
||||||
|
return 0;
|
||||||
|
// Impl note: takes advantage of the fact that an escpaed single quote
|
||||||
|
// embedded within a quote-block can really be handled as two seperate
|
||||||
|
// quote-blocks for the purposes of this method...
|
||||||
|
int count = 0;
|
||||||
|
int stringLength = string.length();
|
||||||
|
boolean inQuote = false;
|
||||||
|
for ( int indx = 0; indx < stringLength; indx++ ) {
|
||||||
|
char c = string.charAt( indx );
|
||||||
|
if ( inQuote ) {
|
||||||
|
if ( '\'' == c ) {
|
||||||
|
inQuote = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if ( '\'' == c ) {
|
||||||
|
inQuote = true;
|
||||||
|
}
|
||||||
|
else if ( c == character ) {
|
||||||
|
count++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return count;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static int[] locateUnquoted(String string, char character) {
|
||||||
|
if ( '\'' == character ) {
|
||||||
|
throw new IllegalArgumentException( "Unquoted count of quotes is invalid" );
|
||||||
|
}
|
||||||
|
if (string == null) {
|
||||||
|
return new int[0];
|
||||||
|
}
|
||||||
|
|
||||||
|
ArrayList locations = new ArrayList( 20 );
|
||||||
|
|
||||||
|
// Impl note: takes advantage of the fact that an escaped single quote
|
||||||
|
// embedded within a quote-block can really be handled as two separate
|
||||||
|
// quote-blocks for the purposes of this method...
|
||||||
|
int stringLength = string.length();
|
||||||
|
boolean inQuote = false;
|
||||||
|
for ( int indx = 0; indx < stringLength; indx++ ) {
|
||||||
|
char c = string.charAt( indx );
|
||||||
|
if ( inQuote ) {
|
||||||
|
if ( '\'' == c ) {
|
||||||
|
inQuote = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if ( '\'' == c ) {
|
||||||
|
inQuote = true;
|
||||||
|
}
|
||||||
|
else if ( c == character ) {
|
||||||
|
locations.add( new Integer( indx ) );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return toIntArray( locations );
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isNotEmpty(String string) {
|
||||||
|
return string != null && string.length() > 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isEmpty(String string) {
|
||||||
|
return string == null || string.length() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String qualify(String prefix, String name) {
|
||||||
|
if ( name == null || prefix == null ) {
|
||||||
|
throw new NullPointerException();
|
||||||
|
}
|
||||||
|
return new StringBuffer( prefix.length() + name.length() + 1 )
|
||||||
|
.append(prefix)
|
||||||
|
.append('.')
|
||||||
|
.append(name)
|
||||||
|
.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String[] qualify(String prefix, String[] names) {
|
||||||
|
if ( prefix == null ) return names;
|
||||||
|
int len = names.length;
|
||||||
|
String[] qualified = new String[len];
|
||||||
|
for ( int i = 0; i < len; i++ ) {
|
||||||
|
qualified[i] = qualify( prefix, names[i] );
|
||||||
|
}
|
||||||
|
return qualified;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static int firstIndexOfChar(String sqlString, String string, int startindex) {
|
||||||
|
int matchAt = -1;
|
||||||
|
for ( int i = 0; i < string.length(); i++ ) {
|
||||||
|
int curMatch = sqlString.indexOf( string.charAt( i ), startindex );
|
||||||
|
if ( curMatch >= 0 ) {
|
||||||
|
if ( matchAt == -1 ) { // first time we find match!
|
||||||
|
matchAt = curMatch;
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
matchAt = Math.min( matchAt, curMatch );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return matchAt;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String truncate(String string, int length) {
|
||||||
|
if ( string.length() <= length ) {
|
||||||
|
return string;
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return string.substring( 0, length );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String generateAlias(String description) {
|
||||||
|
return generateAliasRoot(description) + '_';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Generate a nice alias for the given class name or collection role
|
||||||
|
* name and unique integer. Subclasses of Loader do <em>not</em> have
|
||||||
|
* to use aliases of this form.
|
||||||
|
* @return an alias of the form <tt>foo1_</tt>
|
||||||
|
*/
|
||||||
|
public static String generateAlias(String description, int unique) {
|
||||||
|
return generateAliasRoot(description) +
|
||||||
|
Integer.toString(unique) +
|
||||||
|
'_';
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Generates a root alias by truncating the "root name" defined by
|
||||||
|
* the incoming description and removing/modifying any non-valid
|
||||||
|
* alias characters.
|
||||||
|
*
|
||||||
|
* @param description The root name from which to generate a root alias.
|
||||||
|
* @return The generated root alias.
|
||||||
|
*/
|
||||||
|
private static String generateAliasRoot(String description) {
|
||||||
|
String result = truncate( unqualifyEntityName(description), ALIAS_TRUNCATE_LENGTH )
|
||||||
|
.toLowerCase()
|
||||||
|
.replace( '/', '_' ) // entityNames may now include slashes for the representations
|
||||||
|
.replace( '$', '_' ); //classname may be an inner class
|
||||||
|
result = cleanAlias( result );
|
||||||
|
if ( Character.isDigit( result.charAt(result.length()-1) ) ) {
|
||||||
|
return result + "x"; //ick!
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Clean the generated alias by removing any non-alpha characters from the
|
||||||
|
* beginning.
|
||||||
|
*
|
||||||
|
* @param alias The generated alias to be cleaned.
|
||||||
|
* @return The cleaned alias, stripped of any leading non-alpha characters.
|
||||||
|
*/
|
||||||
|
private static String cleanAlias(String alias) {
|
||||||
|
char[] chars = alias.toCharArray();
|
||||||
|
// short cut check...
|
||||||
|
if ( !Character.isLetter( chars[0] ) ) {
|
||||||
|
for ( int i = 1; i < chars.length; i++ ) {
|
||||||
|
// as soon as we encounter our first letter, return the substring
|
||||||
|
// from that position
|
||||||
|
if ( Character.isLetter( chars[i] ) ) {
|
||||||
|
return alias.substring( i );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return alias;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String unqualifyEntityName(String entityName) {
|
||||||
|
String result = unqualify(entityName);
|
||||||
|
int slashPos = result.indexOf( '/' );
|
||||||
|
if ( slashPos > 0 ) {
|
||||||
|
result = result.substring( 0, slashPos - 1 );
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String toUpperCase(String str) {
|
||||||
|
return str==null ? null : str.toUpperCase();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String toLowerCase(String str) {
|
||||||
|
return str==null ? null : str.toLowerCase();
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String moveAndToBeginning(String filter) {
|
||||||
|
if ( filter.trim().length()>0 ){
|
||||||
|
filter += " and ";
|
||||||
|
if ( filter.startsWith(" and ") ) filter = filter.substring(4);
|
||||||
|
}
|
||||||
|
return filter;
|
||||||
|
}
|
||||||
|
|
||||||
|
//TODO Copy from ArrayHelper in Hibernate Core
|
||||||
|
public static int[] toIntArray(Collection coll) {
|
||||||
|
Iterator iter = coll.iterator();
|
||||||
|
int[] arr = new int[ coll.size() ];
|
||||||
|
int i=0;
|
||||||
|
while( iter.hasNext() ) {
|
||||||
|
arr[i++] = ( (Integer) iter.next() ).intValue();
|
||||||
|
}
|
||||||
|
return arr;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static boolean isQuoted(String name) {
|
||||||
|
return name != null && name.length() != 0 && name.charAt( 0 ) == '`';
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String quote(String name) {
|
||||||
|
if ( name == null || name.length() == 0 || isQuoted( name ) ) {
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return new StringBuilder( name.length() + 2 ).append('`').append( name ).append( '`' ).toString();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public static String unquote(String name) {
|
||||||
|
if ( isQuoted( name ) ) {
|
||||||
|
return name.substring( 1, name.length() - 1 );
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,38 @@
|
||||||
|
package org.hibernate.annotations.common.test.annotationfactory;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.annotationfactory.AnnotationDescriptor;
|
||||||
|
import org.hibernate.annotations.common.annotationfactory.AnnotationFactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public class AnnotationFactoryTest extends TestCase {
|
||||||
|
|
||||||
|
public void testCreatesProxyInstancesOfAnnotations() {
|
||||||
|
// Step 1: define the annotation descriptor.
|
||||||
|
//
|
||||||
|
// What you can/must do:
|
||||||
|
// - You can assign values with the wrong type to the annotation
|
||||||
|
// elements. The code won't check that the values are the same
|
||||||
|
// types as required by the Annotation interface. You will
|
||||||
|
// end up receiving an exception when you access the value, though.
|
||||||
|
// - You must assign a value in the descriptor to all the elements
|
||||||
|
// defined in the Annotation interface that do not have a default
|
||||||
|
// value.
|
||||||
|
// - You can ignore in the descriptor those Annotation elements that
|
||||||
|
// have default values, or you can set them to override their
|
||||||
|
// default values.
|
||||||
|
AnnotationDescriptor descriptor = new AnnotationDescriptor( TestAnnotation.class );
|
||||||
|
descriptor.setValue( "booleanElement", false );
|
||||||
|
descriptor.setValue( "stringElement", "abc" );
|
||||||
|
descriptor.setValue( "someOtherElement", "xyz" );
|
||||||
|
|
||||||
|
// Step 2: create the annotation from its descriptor.
|
||||||
|
TestAnnotation ann = AnnotationFactory.create( descriptor );
|
||||||
|
|
||||||
|
assertFalse( ann.booleanElement() );
|
||||||
|
assertEquals( "abc", ann.stringElement() );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,108 @@
|
||||||
|
package org.hibernate.annotations.common.test.annotationfactory;
|
||||||
|
|
||||||
|
import java.lang.reflect.Method;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.annotationfactory.AnnotationDescriptor;
|
||||||
|
import org.hibernate.annotations.common.annotationfactory.AnnotationProxy;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
public class AnnotationProxyTest extends TestCase {
|
||||||
|
|
||||||
|
private AnnotationProxy ann;
|
||||||
|
private AnnotationDescriptor descriptor;
|
||||||
|
|
||||||
|
public void setUp() {
|
||||||
|
descriptor = new AnnotationDescriptor( TestAnnotation.class );
|
||||||
|
descriptor.setValue( "stringElement", "x" );
|
||||||
|
descriptor.setValue( "booleanElement", false );
|
||||||
|
descriptor.setValue( "someOtherElement", "y" );
|
||||||
|
ann = new AnnotationProxy( descriptor );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testConstructionFailsIfYouDoNotAssignValuesToAllTheElementsWithoutADefault() {
|
||||||
|
try {
|
||||||
|
AnnotationDescriptor desc = new AnnotationDescriptor( TestAnnotation.class );
|
||||||
|
desc.setValue( "stringElement", "x" );
|
||||||
|
desc.setValue( "booleanElement", false );
|
||||||
|
new AnnotationProxy( desc );
|
||||||
|
fail();
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
assertEquals( "No value provided for someOtherElement", e.getMessage() );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testConstructionFailsIfYouDefineElementsThatAreNotInTheAnnotationInterface() {
|
||||||
|
try {
|
||||||
|
AnnotationDescriptor desc = new AnnotationDescriptor( Deprecated.class );
|
||||||
|
desc.setValue( "wrongElement", "xxx" );
|
||||||
|
new AnnotationProxy( desc );
|
||||||
|
fail();
|
||||||
|
}
|
||||||
|
catch (Exception e) {
|
||||||
|
assertTrue( e.getMessage().contains( "unknown elements" ) );
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSupportsGenericCallsToAllElements() throws Throwable {
|
||||||
|
assertEquals( "x", invoke( ann, "stringElement" ) );
|
||||||
|
assertFalse( (Boolean) invoke( ann, "booleanElement" ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testPretendsThatItHasTheGivenType() {
|
||||||
|
assertSame( TestAnnotation.class, ann.annotationType() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testItsToStringConformsToTheJavaAnnotationDocumentation() throws Throwable {
|
||||||
|
String expectedString = "@org.hibernate.annotations.common.test.annotationfactory.TestAnnotation(booleanElement=false, elementWithDefault=abc, someOtherElement=y, stringElement=x)";
|
||||||
|
assertEquals( expectedString, invoke( ann, "toString" ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSupportsGenericCallsToMethods() throws Throwable {
|
||||||
|
assertEquals( ann.annotationType(), invoke( ann, "annotationType" ) );
|
||||||
|
assertEquals( ann.toString(), invoke( ann, "toString" ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testThrowsARuntimeExceptionIfYouUseAnElementWhichIsNotInTheAnnotationInterface() {
|
||||||
|
AnnotationDescriptor elements = new AnnotationDescriptor( TestAnnotation.class );
|
||||||
|
elements.setValue( "anOddElement", "x" );
|
||||||
|
try {
|
||||||
|
new AnnotationProxy( elements );
|
||||||
|
fail();
|
||||||
|
}
|
||||||
|
catch (RuntimeException e) {
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testUsesTheDefaultValueForUndefinedElementsWhenAvailable() throws Throwable {
|
||||||
|
assertEquals( "abc", invoke( ann, "elementWithDefault" ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testThrowsANoSuchMethodExceptionWhenAccessingAnUndefinedMethod() throws Throwable {
|
||||||
|
try {
|
||||||
|
invoke( ann, "anElementThatDoesNotExist" );
|
||||||
|
fail();
|
||||||
|
}
|
||||||
|
catch (NoSuchMethodException e) {
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
invoke( ann, "anOddElement", "arg1", "arg2" );
|
||||||
|
fail();
|
||||||
|
}
|
||||||
|
catch (NoSuchMethodException e) {
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private Object invoke(AnnotationProxy proxy, String methodName, Object... args) throws Throwable {
|
||||||
|
Class[] parameterTypes = new Class[args.length];
|
||||||
|
for ( int i = 0; i < args.length ; i++ ) {
|
||||||
|
parameterTypes[i] = args[i].getClass();
|
||||||
|
}
|
||||||
|
Method method = TestAnnotation.class.getMethod( methodName, parameterTypes );
|
||||||
|
return proxy.invoke( proxy, method, parameterTypes );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,18 @@
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package org.hibernate.annotations.common.test.annotationfactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
*/
|
||||||
|
@interface TestAnnotation {
|
||||||
|
String stringElement();
|
||||||
|
|
||||||
|
String elementWithDefault() default "abc";
|
||||||
|
|
||||||
|
boolean booleanElement();
|
||||||
|
|
||||||
|
String someOtherElement();
|
||||||
|
}
|
|
@ -0,0 +1,31 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
@TestAnnotation(name = "xyz")
|
||||||
|
public class Foo extends FooFather {
|
||||||
|
|
||||||
|
public static Integer staticField;
|
||||||
|
|
||||||
|
Integer fieldProperty;
|
||||||
|
|
||||||
|
public List<String> getCollectionProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestAnnotation(name = "xyz")
|
||||||
|
public Integer getMethodProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getPrimitiveProperty() {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Integer getStaticThing() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,23 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public abstract class FooFather<T> {
|
||||||
|
|
||||||
|
public Integer fatherField;
|
||||||
|
|
||||||
|
public Boolean isFatherMethod() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public T getParameterizedProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<T> getParameterizedCollectionProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,42 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import com.sun.org.apache.xpath.internal.operations.Number;
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.reflection.ReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class JavaReflectionManagerTest extends TestCase {
|
||||||
|
|
||||||
|
private ReflectionManager rm = new JavaReflectionManager();
|
||||||
|
|
||||||
|
public void testReturnsAnXClassThatWrapsTheGivenClass() {
|
||||||
|
XClass xc = rm.toXClass( Integer.class );
|
||||||
|
assertEquals( "java.lang.Integer", xc.getName() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testReturnsSameXClassForSameClass() {
|
||||||
|
XClass xc1 = rm.toXClass( void.class );
|
||||||
|
XClass xc2 = rm.toXClass( void.class );
|
||||||
|
assertSame( xc2, xc1 );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testReturnsNullForANullClass() {
|
||||||
|
assertNull( rm.toXClass( null ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testComparesXClassesWithClasses() {
|
||||||
|
XClass xc = rm.toXClass( Integer.class );
|
||||||
|
assertTrue( rm.equals( xc, Integer.class ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSupportsNullsInComparisons() {
|
||||||
|
XClass xc = rm.toXClass( Integer.class );
|
||||||
|
assertFalse( rm.equals( null, Number.class ) );
|
||||||
|
assertFalse( rm.equals( xc, null ) );
|
||||||
|
assertTrue( rm.equals( null, null ) );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,90 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.ReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.reflection.XAnnotatedElement;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Dad;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Grandpa;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Language;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Son;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class JavaXClassTest extends XAnnotatedElementTestCase {
|
||||||
|
ReflectionManager factory = new JavaReflectionManager();
|
||||||
|
|
||||||
|
XClass fatherAsSeenFromSon = factory.toXClass( Son.class ).getSuperclass();
|
||||||
|
XClass grandpa = factory.toXClass( Grandpa.class );
|
||||||
|
|
||||||
|
public void testHasAPointOfViewClass() {
|
||||||
|
// Since Dad is an Entity, getting it through Son.getSuperclass() gives
|
||||||
|
// us a view of properties from Dad with Son as a point of view.
|
||||||
|
XClass sameView = factory.toXClass( Son.class ).getSuperclass();
|
||||||
|
XClass differentView = factory.toXClass( Dad.class );
|
||||||
|
assertSame( "Should be the same instance: same owner", sameView, fatherAsSeenFromSon );
|
||||||
|
assertNotSame( "Should be a different instance: different owner", differentView, fatherAsSeenFromSon );
|
||||||
|
assertEquals( ".equals() should show equality", sameView, differentView );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testHasAName() {
|
||||||
|
assertSame( "org.hibernate.annotations.common.test.reflection.java.generics.Dad", fatherAsSeenFromSon.getName() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testHasASuperclass() {
|
||||||
|
assertEquals( grandpa, fatherAsSeenFromSon.getSuperclass() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSuperSuperClass() {
|
||||||
|
assertEquals( factory.toXClass( Object.class ), grandpa.getSuperclass() );
|
||||||
|
assertEquals( null, grandpa.getSuperclass().getSuperclass() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testHasInterfaces() {
|
||||||
|
XClass[] interfaces = fatherAsSeenFromSon.getSuperclass().getInterfaces();
|
||||||
|
assertEquals( 2, interfaces.length );
|
||||||
|
assertTrue( factory.equals( interfaces[0], Serializable.class ) );
|
||||||
|
assertTrue( factory.equals( interfaces[1], Language.class ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAssignableFromAnotherXClass() {
|
||||||
|
assertFalse( fatherAsSeenFromSon.isAssignableFrom( grandpa ) );
|
||||||
|
assertTrue( grandpa.isAssignableFrom( fatherAsSeenFromSon ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testExtractsPublicFieldsAsProperties() {
|
||||||
|
List<XProperty> fieldProperties = fatherAsSeenFromSon.getDeclaredProperties( "field" );
|
||||||
|
assertEquals( 1, fieldProperties.size() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testExtractsPublicMethodsAsProperties() {
|
||||||
|
List<XProperty> methodProperties = fatherAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
assertEquals( 9, methodProperties.size() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAbstract() {
|
||||||
|
assertFalse( fatherAsSeenFromSon.isAbstract() );
|
||||||
|
assertTrue( factory.toXClass( Grandpa.class ).isAbstract() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAPrimitive() {
|
||||||
|
assertFalse( fatherAsSeenFromSon.isPrimitive() );
|
||||||
|
assertTrue( factory.toXClass( int.class ).isPrimitive() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAnEnum() {
|
||||||
|
assertFalse( fatherAsSeenFromSon.isEnum() );
|
||||||
|
assertTrue( factory.toXClass( Sex.class ).isEnum() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected XAnnotatedElement getConcreteInstance() {
|
||||||
|
return factory.toXClass( Dad.class );
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
|
@ -0,0 +1,166 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import java.util.LinkedList;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import junit.framework.AssertionFailedError;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.Filter;
|
||||||
|
import org.hibernate.annotations.common.reflection.ReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Dad;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.Son;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class JavaXPropertyTest extends XAnnotatedElementTestCase {
|
||||||
|
|
||||||
|
private ReflectionManager factory = new JavaReflectionManager();
|
||||||
|
|
||||||
|
private XClass dadAsSeenFromItself = factory.toXClass( Dad.class );
|
||||||
|
|
||||||
|
private XClass dadAsSeenFromSon = factory.toXClass( Son.class ).getSuperclass();
|
||||||
|
|
||||||
|
public void testFollowsJavaBeansConventionsForPropertyNames() throws Exception {
|
||||||
|
List<String> properties = new LinkedList<String>();
|
||||||
|
properties.add( "collectionProperty" );
|
||||||
|
properties.add( "methodProperty" );
|
||||||
|
properties.add( "primitiveProperty" );
|
||||||
|
properties.add( "primitiveArrayProperty" );
|
||||||
|
properties.add( "arrayProperty" );
|
||||||
|
properties.add( "genericCollectionProperty" );
|
||||||
|
properties.add( "nongenericCollectionProperty" );
|
||||||
|
properties.add( "propertyStartingWithIs" );
|
||||||
|
properties.add( "language" );
|
||||||
|
List<XProperty> methodProperties = dadAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
assertEquals( properties.size(), methodProperties.size() );
|
||||||
|
for ( XProperty member : methodProperties ) {
|
||||||
|
assertTrue( properties.contains( member.getName() ) );
|
||||||
|
}
|
||||||
|
List<XProperty> fieldProperties = dadAsSeenFromSon.getDeclaredProperties( "field" );
|
||||||
|
XProperty field = fieldProperties.get( 0 );
|
||||||
|
assertEquals( "fieldProperty", field.getName() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testReturnsPropertiesWithUnresolvedParametricTypes() {
|
||||||
|
assertEquals( 9, dadAsSeenFromItself.getDeclaredProperties( "property" ).size() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testKnowsWhetherItsTypeIsFullyResolved() {
|
||||||
|
XProperty notFullyResolvedProperty = getPropertyNamed_from(
|
||||||
|
"collectionProperty", dadAsSeenFromItself
|
||||||
|
.getDeclaredProperties( "property" )
|
||||||
|
);
|
||||||
|
assertFalse( notFullyResolvedProperty.isTypeResolved() );
|
||||||
|
XProperty fullyResolvedProperty = getPropertyNamed_from(
|
||||||
|
"collectionProperty", dadAsSeenFromSon
|
||||||
|
.getDeclaredProperties( "property" )
|
||||||
|
);
|
||||||
|
assertTrue( fullyResolvedProperty.isTypeResolved() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeFiltered() {
|
||||||
|
assertEquals(
|
||||||
|
10, dadAsSeenFromSon.getDeclaredProperties(
|
||||||
|
"property", new Filter() {
|
||||||
|
|
||||||
|
public boolean returnStatic() {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean returnTransient() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
).size()
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeASimpleType() {
|
||||||
|
List<XProperty> declaredProperties = dadAsSeenFromSon.getDeclaredProperties( "field" );
|
||||||
|
XProperty p = getPropertyNamed_from( "fieldProperty", declaredProperties );
|
||||||
|
assertTrue( factory.equals( p.getType(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getElementClass(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getClassOrElementClass(), String.class ) );
|
||||||
|
assertNull( p.getCollectionClass() );
|
||||||
|
assertFalse( p.isArray() );
|
||||||
|
assertFalse( p.isCollection() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testResolveInterfaceType() {
|
||||||
|
List<XProperty> declaredProperties = dadAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
XProperty p = getPropertyNamed_from( "language", declaredProperties );
|
||||||
|
assertTrue( factory.equals( p.getType(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getElementClass(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getClassOrElementClass(), String.class ) );
|
||||||
|
assertNull( p.getCollectionClass() );
|
||||||
|
assertNull( p.getMapKey() );
|
||||||
|
assertFalse( p.isArray() );
|
||||||
|
assertFalse( p.isCollection() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAnArray() {
|
||||||
|
List<XProperty> declaredProperties = dadAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
XProperty p = getPropertyNamed_from( "arrayProperty", declaredProperties );
|
||||||
|
assertTrue( factory.equals( p.getType(), String[].class ) );
|
||||||
|
assertTrue( factory.equals( p.getElementClass(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getClassOrElementClass(), String.class ) );
|
||||||
|
assertNull( p.getCollectionClass() );
|
||||||
|
assertNull( p.getMapKey() );
|
||||||
|
assertTrue( p.isArray() );
|
||||||
|
assertFalse( p.isCollection() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeAnArrayOfPrimitives() {
|
||||||
|
List<XProperty> declaredProperties = dadAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
XProperty p = getPropertyNamed_from( "primitiveArrayProperty", declaredProperties );
|
||||||
|
assertTrue( factory.equals( p.getType(), int[].class ) );
|
||||||
|
assertTrue( factory.equals( p.getElementClass(), int.class ) );
|
||||||
|
assertTrue( factory.equals( p.getClassOrElementClass(), int.class ) );
|
||||||
|
assertNull( p.getCollectionClass() );
|
||||||
|
assertNull( p.getMapKey() );
|
||||||
|
assertTrue( p.isArray() );
|
||||||
|
assertFalse( p.isCollection() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testCanBeACollection() {
|
||||||
|
List<XProperty> declaredProperties = dadAsSeenFromSon.getDeclaredProperties( "property" );
|
||||||
|
XProperty p = getPropertyNamed_from( "collectionProperty", declaredProperties );
|
||||||
|
assertTrue( factory.equals( p.getType(), Map.class ) );
|
||||||
|
assertTrue( factory.equals( p.getElementClass(), String.class ) );
|
||||||
|
assertTrue( factory.equals( p.getClassOrElementClass(), Map.class ) );
|
||||||
|
assertTrue( factory.equals( p.getMapKey(), Double.class ) );
|
||||||
|
assertEquals( Map.class, p.getCollectionClass() );
|
||||||
|
assertFalse( p.isArray() );
|
||||||
|
assertTrue( p.isCollection() );
|
||||||
|
}
|
||||||
|
|
||||||
|
private XProperty getPropertyNamed_from(String name, List<XProperty> properties) {
|
||||||
|
for ( XProperty p : properties ) {
|
||||||
|
if ( p.getName().equals( name ) ) {
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw new AssertionFailedError( "No property '" + name + "' found" );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testSupportsMethodsStartingWithIs() throws Exception {
|
||||||
|
assertEquals( "methodProperty", getConcreteInstance().getName() );
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected XProperty getConcreteInstance() {
|
||||||
|
XClass xClass = factory.toXClass( Dad.class );
|
||||||
|
List<XProperty> properties = xClass.getDeclaredProperties( "property" );
|
||||||
|
for ( XProperty p : properties ) {
|
||||||
|
if ( p.getName().equals( "methodProperty" ) ) {
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
throw new AssertionFailedError( "Cannot find Foo.getMethodProperty()" );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,10 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public enum Sex {
|
||||||
|
MALE,
|
||||||
|
FEMALE
|
||||||
|
}
|
|
@ -0,0 +1,12 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import static java.lang.annotation.ElementType.*;
|
||||||
|
import java.lang.annotation.Retention;
|
||||||
|
import static java.lang.annotation.RetentionPolicy.RUNTIME;
|
||||||
|
import java.lang.annotation.Target;
|
||||||
|
|
||||||
|
@Target({TYPE, METHOD, FIELD})
|
||||||
|
@Retention(RUNTIME)
|
||||||
|
public @interface TestAnnotation {
|
||||||
|
String name() default "abc";
|
||||||
|
}
|
|
@ -0,0 +1,23 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.reflection.XAnnotatedElement;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.TestAnnotation;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public abstract class XAnnotatedElementTestCase extends TestCase {
|
||||||
|
|
||||||
|
public void testKnowsWhetherAnAnnotationIsPresent() {
|
||||||
|
assertTrue( getConcreteInstance().isAnnotationPresent( TestAnnotation.class ) );
|
||||||
|
assertFalse( getConcreteInstance().isAnnotationPresent( Override.class ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testReturnsSpecificAnnotations() {
|
||||||
|
TestAnnotation ent = getConcreteInstance().getAnnotation( TestAnnotation.class );
|
||||||
|
assertEquals( "xyz", ent.name() );
|
||||||
|
}
|
||||||
|
|
||||||
|
protected abstract XAnnotatedElement getConcreteInstance();
|
||||||
|
}
|
|
@ -0,0 +1,70 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.ParameterizedType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironmentFactory;
|
||||||
|
|
||||||
|
public class ApproximatingTypeEnvironmentTest extends TestCase {
|
||||||
|
|
||||||
|
TypeEnvironmentFactory teFactory = new TypeEnvironmentFactory();
|
||||||
|
TypeEnvironment unboundContext = teFactory.getEnvironment( BigBlob.class );
|
||||||
|
TypeEnvironment approximatingUnboundContext = teFactory.toApproximatingEnvironment( unboundContext );
|
||||||
|
|
||||||
|
TypeEnvironment boundContext = teFactory.getEnvironment( SonOfBlob.class );
|
||||||
|
TypeEnvironment approximatingBoundContext = teFactory.toApproximatingEnvironment( boundContext );
|
||||||
|
|
||||||
|
public void testDoesNothingOnClasses() throws SecurityException {
|
||||||
|
assertEquals( String[].class, approximatingUnboundContext.bind( String[].class ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testDoesNothingOnWildcards() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "genericClass", new Class[0] ).getGenericReturnType();
|
||||||
|
Type approxType = approximatingBoundContext.bind( type );
|
||||||
|
assertEquals( "java.lang.Class<?>", approxType.toString() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testDoesNothingOnParameterizedTypesThatAreAlreadyFullyBound() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "simpleGenericType", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( boundContext.bind( type ), approximatingBoundContext.bind( type ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testDoesNothingOnComplexParameterizedTypesThatAreNotCollections() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "genericType", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( boundContext.bind( type ), approximatingBoundContext.bind( type ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testDoesNothingOnGenericArraysThatAreAlreadyFullyBound() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "array", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( boundContext.bind( type ), approximatingBoundContext.bind( type ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testApproximatesSimpleGenericTypesToTheirUpperBound() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "simpleGenericType", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( "java.util.List<java.lang.String>", approximatingBoundContext.bind( type ).toString() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testApproximatesGenericsInArraysToTheirUpperBounds() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "array", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( Collection[].class, approximatingUnboundContext.bind( type ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testApproximatesArraysOfComplexTypesToArraysOfObjects() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "complexGenericArray", new Class[0] ).getGenericReturnType();
|
||||||
|
assertEquals( Object[].class, approximatingUnboundContext.bind( type ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testApproximatesGenericsAndWildcardsInCollectionsToTheirUpperBounds() throws Exception {
|
||||||
|
Type type = BigBlob.class.getMethod( "genericCollection", new Class[0] ).getGenericReturnType();
|
||||||
|
ParameterizedType approxType = (ParameterizedType) approximatingUnboundContext.bind( type );
|
||||||
|
assertEquals( Map.class, approxType.getRawType() );
|
||||||
|
assertNull( approxType.getOwnerType() );
|
||||||
|
assertEquals( 2, approxType.getActualTypeArguments().length );
|
||||||
|
assertEquals( Object.class, approxType.getActualTypeArguments()[0] );
|
||||||
|
assertEquals( Collection.class, approxType.getActualTypeArguments()[1] );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,32 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public class BigBlob<T, E extends Collection> {
|
||||||
|
|
||||||
|
public E simpleGenericType() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<?> genericClass() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Class<T> genericType() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public Map<T, ? extends E> genericCollection() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public E[] array() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<? extends T>[] complexGenericArray() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,57 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
@TestAnnotation(name = "xyz")
|
||||||
|
public class Dad<T> extends Grandpa<List<T>, Integer> {
|
||||||
|
|
||||||
|
static Integer staticField;
|
||||||
|
|
||||||
|
T fieldProperty;
|
||||||
|
|
||||||
|
public Map<Double, T> getCollectionProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
@TestAnnotation(name = "xyz")
|
||||||
|
public Integer getMethodProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int getPrimitiveProperty() {
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
public boolean isPropertyStartingWithIs() {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int[] getPrimitiveArrayProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public T[] getArrayProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<T> getGenericCollectionProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public List<String> getNongenericCollectionProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static Integer getStaticThing() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getLanguage() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,21 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.io.Serializable;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public abstract class Grandpa<T, U> implements Serializable, Language<String> {
|
||||||
|
|
||||||
|
Integer grandpaField;
|
||||||
|
|
||||||
|
public T returnsGeneric() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
// generic embedded value
|
||||||
|
public Neighbour<U> getFriend() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,9 @@
|
||||||
|
//$Id$
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public interface Language<T> {
|
||||||
|
T getLanguage();
|
||||||
|
}
|
|
@ -0,0 +1,14 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class Neighbour<T> {
|
||||||
|
|
||||||
|
public Set<T> embeddedProperty() {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,8 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class Son extends Dad<String> {
|
||||||
|
}
|
|
@ -0,0 +1,8 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
|
||||||
|
public class SonOfBlob extends BigBlob<String, List<String>> {
|
||||||
|
|
||||||
|
}
|
|
@ -0,0 +1,16 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import static java.lang.annotation.ElementType.*;
|
||||||
|
import java.lang.annotation.Retention;
|
||||||
|
import static java.lang.annotation.RetentionPolicy.RUNTIME;
|
||||||
|
import java.lang.annotation.Target;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
@Target({TYPE, METHOD, FIELD})
|
||||||
|
@Retention(RUNTIME)
|
||||||
|
public @interface TestAnnotation {
|
||||||
|
String name() default "abc";
|
||||||
|
}
|
|
@ -0,0 +1,59 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.ParameterizedType;
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
import java.lang.reflect.TypeVariable;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironmentFactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Davide Marchignoli
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class TypeEnvironmentFactoryTest extends TestCase {
|
||||||
|
|
||||||
|
public void testBindsGenericsToSuperclassEnvironment() throws SecurityException, NoSuchMethodException {
|
||||||
|
TypeEnvironmentFactory env = new TypeEnvironmentFactory();
|
||||||
|
Type type = Grandpa.class.getMethod( "returnsGeneric", new Class[0] ).getGenericReturnType();
|
||||||
|
|
||||||
|
Type asSeenFromGrandpa = env.getEnvironment( Grandpa.class ).bind( type );
|
||||||
|
assertTrue( asSeenFromGrandpa instanceof TypeVariable );
|
||||||
|
assertEquals( "T", asSeenFromGrandpa.toString() );
|
||||||
|
|
||||||
|
Type asSeenFromDad = env.getEnvironment( Dad.class ).bind( type );
|
||||||
|
assertTrue( asSeenFromDad instanceof ParameterizedType );
|
||||||
|
assertEquals( "java.util.List<T>", asSeenFromDad.toString() );
|
||||||
|
|
||||||
|
ParameterizedType asSeenFromSon = (ParameterizedType) env.getEnvironment( Son.class ).bind( type );
|
||||||
|
assertType_isCollectionOfClass_withElementsOfClass( asSeenFromSon, List.class, String.class );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testBindsGenericsToOwnerEnvironment() throws SecurityException, NoSuchMethodException {
|
||||||
|
TypeEnvironmentFactory env = new TypeEnvironmentFactory();
|
||||||
|
|
||||||
|
Type friendType = Dad.class.getMethod( "getFriend", new Class[0] ).getGenericReturnType();
|
||||||
|
ParameterizedType friendTypeAsSeenFromDad = (ParameterizedType) env.getEnvironment( Dad.class ).bind(
|
||||||
|
friendType
|
||||||
|
);
|
||||||
|
|
||||||
|
Class friendClass = (Class) friendTypeAsSeenFromDad.getRawType();
|
||||||
|
Type returnType = friendClass.getMethod( "embeddedProperty", new Class[0] ).getGenericReturnType();
|
||||||
|
|
||||||
|
ParameterizedType boundType = (ParameterizedType) env.getEnvironment( friendTypeAsSeenFromDad ).bind(
|
||||||
|
returnType
|
||||||
|
);
|
||||||
|
assertType_isCollectionOfClass_withElementsOfClass( boundType, Set.class, Integer.class );
|
||||||
|
}
|
||||||
|
|
||||||
|
private void assertType_isCollectionOfClass_withElementsOfClass(
|
||||||
|
ParameterizedType t, Class collectionClass,
|
||||||
|
Class elementClass
|
||||||
|
) {
|
||||||
|
assertEquals( collectionClass, t.getRawType() );
|
||||||
|
assertEquals( 1, t.getActualTypeArguments().length );
|
||||||
|
assertEquals( elementClass, t.getActualTypeArguments()[0] );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,43 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics;
|
||||||
|
|
||||||
|
import java.lang.reflect.Type;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironment;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeEnvironmentFactory;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.generics.TypeUtils;
|
||||||
|
|
||||||
|
public class TypeUtilsTest extends TestCase {
|
||||||
|
|
||||||
|
TypeEnvironmentFactory env = new TypeEnvironmentFactory();
|
||||||
|
TypeEnvironment dadContext = env.getEnvironment( Dad.class );
|
||||||
|
TypeEnvironment sonContext = env.getEnvironment( Son.class );
|
||||||
|
|
||||||
|
public void testAClassIsAlwaysFullyResolved() throws Exception {
|
||||||
|
assertTrue( TypeUtils.isResolved( Dad.class ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
private Type getPropertyFromDad(String propertyName) throws NoSuchMethodException {
|
||||||
|
return Dad.class.getMethod( propertyName, new Class[0] ).getGenericReturnType();
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testKnowsWhetherAParametricTypeIsFullyResolved() throws Exception {
|
||||||
|
Type simpleType = getPropertyFromDad( "returnsGeneric" );
|
||||||
|
assertFalse( TypeUtils.isResolved( dadContext.bind( simpleType ) ) );
|
||||||
|
assertTrue( TypeUtils.isResolved( sonContext.bind( simpleType ) ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testKnowsWhetherAnArrayTypeIsFullyResolved() throws Exception {
|
||||||
|
Type arrayType = getPropertyFromDad( "getArrayProperty" );
|
||||||
|
assertFalse( TypeUtils.isResolved( dadContext.bind( arrayType ) ) );
|
||||||
|
assertTrue( TypeUtils.isResolved( sonContext.bind( arrayType ) ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testKnowsWhetherATypeIsSimple() throws Exception {
|
||||||
|
assertTrue( TypeUtils.isSimple( String.class ) );
|
||||||
|
assertFalse( TypeUtils.isSimple( new String[1].getClass() ) );
|
||||||
|
assertFalse( TypeUtils.isSimple( getPropertyFromDad( "getNongenericCollectionProperty" ) ) );
|
||||||
|
assertFalse( TypeUtils.isSimple( getPropertyFromDad( "getGenericCollectionProperty" ) ) );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,33 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class ANN612IssueTest extends TestCase {
|
||||||
|
|
||||||
|
|
||||||
|
public static class J<T> {}
|
||||||
|
|
||||||
|
public static class C {
|
||||||
|
public J<Object> thisOneAlwaysWorkedFine;
|
||||||
|
public J<Object[]> thisOneUsedToCauseProblems;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void testANN612IssueIsFixed() throws Exception {
|
||||||
|
JavaReflectionManager factory = new JavaReflectionManager();
|
||||||
|
XClass clazz = factory.toXClass( C.class );
|
||||||
|
List<XProperty> properties = clazz.getDeclaredProperties( XClass.ACCESS_FIELD );
|
||||||
|
for( XProperty property : properties )
|
||||||
|
assertTrue( property.isTypeResolved() );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,48 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
import org.hibernate.annotations.common.reflection.XProperty;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Paolo Perrotta
|
||||||
|
*/
|
||||||
|
public class DeepGenericsContainment extends TestCase {
|
||||||
|
|
||||||
|
public static class Contained<T> {
|
||||||
|
T generic;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static class Container {
|
||||||
|
Contained<String> contained;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static class ContainerWithCollection {
|
||||||
|
List<Contained<String>> contained;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void test2StepsGenerics() throws Exception {
|
||||||
|
JavaReflectionManager factory = new JavaReflectionManager();
|
||||||
|
XClass container = factory.toXClass( Container.class );
|
||||||
|
XProperty contained = container.getDeclaredProperties( XClass.ACCESS_FIELD ).get( 0 );
|
||||||
|
assertTrue( contained.isTypeResolved() );
|
||||||
|
XProperty generic = contained.getType().getDeclaredProperties( XClass.ACCESS_FIELD ).get( 0 );
|
||||||
|
assertTrue( generic.isTypeResolved() );
|
||||||
|
}
|
||||||
|
|
||||||
|
public void test2StepsGenericsCollection() throws Exception {
|
||||||
|
JavaReflectionManager factory = new JavaReflectionManager();
|
||||||
|
XClass container = factory.toXClass( ContainerWithCollection.class );
|
||||||
|
XProperty collection = container.getDeclaredProperties( XClass.ACCESS_FIELD ).get( 0 );
|
||||||
|
assertTrue( collection.isTypeResolved() );
|
||||||
|
XClass elementClass = collection.getElementClass();
|
||||||
|
XProperty generic = elementClass.getDeclaredProperties( XClass.ACCESS_FIELD ).get( 0 );
|
||||||
|
assertTrue( generic.isTypeResolved() );
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,23 @@
|
||||||
|
//$Id: $
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import junit.framework.TestCase;
|
||||||
|
import org.hibernate.annotations.common.reflection.java.JavaReflectionManager;
|
||||||
|
import org.hibernate.annotations.common.reflection.XClass;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bernard
|
||||||
|
*/
|
||||||
|
public class DeepGenericsInheritance extends TestCase {
|
||||||
|
public void test2StepsGenerics() throws Exception {
|
||||||
|
JavaReflectionManager factory = new JavaReflectionManager();
|
||||||
|
XClass subclass2 = factory.toXClass( Subclass2.class );
|
||||||
|
XClass dummySubclass = factory.toXClass( DummySubclass.class );
|
||||||
|
XClass superclass = subclass2.getSuperclass();
|
||||||
|
XClass supersuperclass = superclass.getSuperclass();
|
||||||
|
assertTrue( supersuperclass.getDeclaredProperties( "field" ).get( 1 ).isTypeResolved() );
|
||||||
|
assertEquals( dummySubclass, supersuperclass.getDeclaredProperties( "field" ).get( 1 ).getType() );
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,20 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
public class Dummy {
|
||||||
|
protected Long id;
|
||||||
|
|
||||||
|
private String name;
|
||||||
|
|
||||||
|
|
||||||
|
public Long getId() {
|
||||||
|
return id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getName() {
|
||||||
|
return name;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void setName(String name) {
|
||||||
|
this.name = name;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,6 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.Dummy;
|
||||||
|
|
||||||
|
public class DummySubclass extends Dummy {
|
||||||
|
}
|
|
@ -0,0 +1,18 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.Dummy;
|
||||||
|
|
||||||
|
public class GenericSuperclass1<T extends Dummy> {
|
||||||
|
protected Long id;
|
||||||
|
|
||||||
|
protected T dummy;
|
||||||
|
|
||||||
|
|
||||||
|
public Long getId() {
|
||||||
|
return id;
|
||||||
|
}
|
||||||
|
|
||||||
|
public T getDummy() {
|
||||||
|
return dummy;
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,7 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.Dummy;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.GenericSuperclass1;
|
||||||
|
|
||||||
|
public class GenericSuperclass2<T extends Dummy> extends GenericSuperclass1<T> {
|
||||||
|
}
|
|
@ -0,0 +1,7 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.DummySubclass;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.GenericSuperclass1;
|
||||||
|
|
||||||
|
public class Subclass1 extends GenericSuperclass1<DummySubclass> {
|
||||||
|
}
|
|
@ -0,0 +1,7 @@
|
||||||
|
package org.hibernate.annotations.common.test.reflection.java.generics.deep;
|
||||||
|
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.DummySubclass;
|
||||||
|
import org.hibernate.annotations.common.test.reflection.java.generics.deep.GenericSuperclass2;
|
||||||
|
|
||||||
|
public class Subclass2 extends GenericSuperclass2<DummySubclass> {
|
||||||
|
}
|
Loading…
Reference in New Issue