vitro/webapp/build.xml

<?xml version="1.0" encoding="UTF-8"?>

<!-- $This file is distributed under the terms of the license in /doc/license.txt$ -->

<!-- ====================================================================== 
     Build script for the Vitro core webapp.
     
     This can be used on its own, or invoked from a Product build script.
     ====================================================================== -->

<project name="vitroCore" default="describe">

	<!-- - - - - - - - - - - - - - - - - - 
          properties                      
         - - - - - - - - - - - - - - - - - -->
	<property name="build.dir" location=".build" />
	<property name="webapp.dir" location="." />

	<property name="war.dir" location="${build.dir}/war" />
	<property name="war-webinf.dir" location="${war.dir}/WEB-INF" />
	<property name="war-classes.dir" location="${war-webinf.dir}/classes" />
	<property name="war-resources.dir" location="${war-webinf.dir}/resources" />
	<property name="war-lib.dir" location="${war-webinf.dir}/lib" />

	<property name="test-classes.dir" location="${build.dir}/testclasses" />

	<property name="servletjars.dir" location="${build.dir}/servletjars" />

	<property name="javac.deprecation" value="true" />

	<!-- - - - - - - - - - - - - - - - - - 
          paths: for compiling and running                      
         - - - - - - - - - - - - - - - - - -->
	<path id="compile.classpath">
		<fileset dir="${war-lib.dir}">
			<include name="**/*.jar" />
		</fileset>
		<fileset dir="${servletjars.dir}">
			<include name="**/*.jar" />
		</fileset>
	</path>

	<path id="test.compile.classpath">
		<pathelement location="${war-classes.dir}" />
		<path refid="compile.classpath" />
	</path>

	<path id="test.run.classpath">
		<!-- This holds data files and a special log4j.properties -->
		<pathelement location="${webapp.dir}/test" />

		<pathelement location="${test-classes.dir}" />
		<path refid="test.compile.classpath" />
	</path>


	<!-- ================================= 
          target: describe              
         ================================= -->
	<target name="describe" description="--> Describe the targets (this is the default).">
		<echo>
all      - Runs "clean", then "deploy".
clean    - Delete all artifacts so the next build will be from scratch.
compile  - Compile the Java source files.
test     - Compile and run the JUnit tests.
war      - Create a WAR file to be deployed in a servlet container.
deploy   - Deploy the application directly into the Tomcat webapps directory.
	    </echo>
	</target>

	<!-- ================================= 
          target: all              
         ================================= -->
	<target name="all" depends="clean, deploy" description="--> Run 'clean', then 'deploy'" />

	<!-- - - - - - - - - - - - - - - - - - 
          target: properties                      
         - - - - - - - - - - - - - - - - - -->
	<target name="properties">
		<!--
			If calling from a Product build script, then this property
			already points to the deploy.properties file of the Product. 
		-->
		<property name="deploy.properties.file" location="config/deploy.properties" />

		<fail message="You must create a &quot;${deploy.properties.file}&quot; file.">
			<condition>
				<not>
					<available file="${deploy.properties.file}" />
				</not>
			</condition>
		</fail>

		<property file="${deploy.properties.file}" />

		<fail unless="tomcat.home"
		      message="${deploy.properties.file} must contain a value for tomcat.home" />
		<fail unless="webapp.name"
		      message="${deploy.properties.file} must contain a value for webapp.name" />
		<fail unless="vitro.home.directory"
		      message="${deploy.properties.file} must contain a value for vitro.home.directory" />
		<fail unless="Vitro.defaultNamespace"
		      message="${deploy.properties.file} must contain a value for Vitro.defaultNamespace" />
		<fail unless="VitroConnection.DataSource.url"
		      message="${deploy.properties.file} must contain a value for VitroConnection.DataSource.url" />
		<fail unless="VitroConnection.DataSource.username"
		      message="${deploy.properties.file} must contain a value for VitroConnection.DataSource.username" />
		<fail unless="VitroConnection.DataSource.password"
		      message="${deploy.properties.file} must contain a value for VitroConnection.DataSource.password" />
		<fail unless="rootUser.emailAddress"
		      message="${deploy.properties.file} must contain a value for rootUser.emailAddress" />

		<fail message="The vitro.home.directory &quot;${vitro.home.directory}&quot; does not exist.">
			<condition>
				<not>
					<available file="${vitro.home.directory}" />
				</not>
			</condition>
		</fail>
		
		<property name="solr.home" location="${vitro.home.directory}/solr" />
	</target>

	<!-- ================================= 
          target: clean              
         ================================= -->
	<target name="clean" depends="properties" description="--> Delete all artifacts.">
		<delete dir="${build.dir}" />
		<delete dir="${solr.home}" excludes="data/**/*" includeemptydirs="true" />
	</target>

	<!-- - - - - - - - - - - - - - - - - - 
          target: prepare                      
         - - - - - - - - - - - - - - - - - -->
	<target name="prepare" depends="properties">
		<mkdir dir="${build.dir}" />
		<mkdir dir="${war-classes.dir}" />
		<mkdir dir="${war-resources.dir}" />
		<mkdir dir="${test-classes.dir}" />

		<!-- copy the themes into the war directory. -->
		<copy todir="${war.dir}">
			<fileset dir="${webapp.dir}/web">
				<!--
					If a product doesn't want the core themes, it can
					set this property and they will be skipped. 
				-->
				<exclude name="themes/**/*" if="skip.core.themes" />
			</fileset>
		</copy>

		<!-- copy the config files into the war directory. -->
		<copy todir="${war-webinf.dir}">
			<fileset file="${webapp.dir}/config/web.xml" />
			<fileset file="${webapp.dir}/config/dwr.xml" />
		</copy>

		<!-- copy the ontologies and the filegraphs into the war directory. -->
		<copy todir="${war-webinf.dir}">
			<fileset dir="${webapp.dir}" includes="ontologies" />
			<fileset dir="${webapp.dir}" includes="ontologies/**/*" />
			<fileset dir="${webapp.dir}" includes="filegraph" />
			<fileset dir="${webapp.dir}" includes="filegraph/**/*" />
		</copy>

		<!-- use the production Log4J properties, unless a debug version exists. -->
		<available file="${webapp.dir}/config/debug.log4j.properties"
		           property="debug.log4j.exists" />
		<copy tofile="${war-classes.dir}/log4j.properties" filtering="true" overwrite="true">
			<fileset dir="${webapp.dir}/config">
				<include name="default.log4j.properties" unless="debug.log4j.exists" />
				<include name="debug.log4j.properties" if="debug.log4j.exists" />
			</fileset>
			<filterchain>
				<expandproperties />
			</filterchain>
		</copy>

		<!-- copy the deploy.properties into the war directory -->
		<copy todir="${war-classes.dir}">
			<fileset file="${deploy.properties.file}" />
		</copy>

		<!-- copy the custom tag libraries into the war directory -->
		<copy todir="${war-webinf.dir}/tlds">
			<fileset dir="${webapp.dir}/config/tlds" includes="**/*" excludes="*.LCK" />
		</copy>

		<!-- copy any xml files from source tree to the war directory -->
		<copy todir="${build.dir}/war/WEB-INF/classes">
			<fileset dir="${webapp.dir}/src" includes="**/*.xml" />
		</copy>

		<!-- copy the JARs into the war directory -->
		<copy todir="${war-lib.dir}">
			<fileset dir="${webapp.dir}/lib">
				<!-- these are already in Tomcat: we mustn't conflict. -->
				<exclude name="jsp-api.jar" />
				<exclude name="servlet-api.jar" />
			</fileset>
		</copy>

		<!-- copy the servlet JARs into their own directory, to compile against. -->
		<copy todir="${servletjars.dir}">
			<fileset dir="${webapp.dir}/lib">
				<include name="jsp-api.jar" />
				<include name="servlet-api.jar" />
			</fileset>
		</copy>

		<!-- copy the context file into the war directory -->
		<copy file="${webapp.dir}/context.xml" tofile="${war.dir}/META-INF/context.xml" />
	</target>

	<!-- ================================= 
          target: compile              
         ================================= -->
	<target name="compile" depends="prepare" description="--> Compile Java sources">
		<!-- deletes all files that depend on changed .java files -->
		<depend srcdir="${webapp.dir}/src"
		        destdir="${war-classes.dir}"
		        closure="false"
		        cache="${build.dir}/.depcache">
			<classpath refid="compile.classpath" />
		</depend>

		<javac srcdir="${webapp.dir}/src"
		       destdir="${war-classes.dir}"
		       debug="true"
		       deprecation="${javac.deprecation}"
		       encoding="UTF8"
		       includeantruntime="false"
		       optimize="true"
		       source="1.6">
			<classpath refid="compile.classpath" />
		</javac>
	</target>

	<!-- ================================= 
          target: test              
         ================================= -->
	<target name="test" depends="compile" unless="skiptests" description="--> Run JUnit tests">
		<javac srcdir="${webapp.dir}/test"
		       destdir="${test-classes.dir}"
		       debug="true"
		       deprecation="${javac.deprecation}"
		       encoding="UTF8"
		       includeantruntime="false"
		       optimize="false"
		       source="1.6">
			<classpath refid="test.compile.classpath" />
		</javac>

		<java classname="edu.cornell.mannlib.vitro.testing.VitroTestRunner"
		      fork="yes"
		      failonerror="true">
			<classpath refid="test.run.classpath" />
			<arg file="${webapp.dir}/test" />
			<arg value="${testlevel}" />
		</java>
	</target>

	<!-- ================================= 
          target: revisionInfo              
         ================================= -->
	<target name="revisionInfo"
	        depends="test"
	        unless="skipinfo"
	        description="--> Store revision info in build">
		<property name="revisionInfo.product.dir" location="${ant.file.vitroCore}/.." />
		<property name="revisionInfo.build.file" location="${war-resources.dir}/revisionInfo.txt" />

		<delete file="${revisionInfo.build.file}" />

		<tstamp>
			<format property="revisionInfo.timestamp" pattern="yyyy-MM-dd HH:mm:ss" />
		</tstamp>
		<echo file="${revisionInfo.build.file}">${revisionInfo.timestamp}
</echo>

		<javac srcdir="${webapp.dir}/../utilities/buildutils/revisioninfo"
		       destdir="${test-classes.dir}"
		       debug="true"
		       deprecation="${javac.deprecation}"
		       encoding="UTF8"
		       includeantruntime="false"
		       optimize="false"
		       source="1.6">
		</javac>

		<java classname="edu.cornell.mannlib.vitro.utilities.revisioninfo.RevisionInfoBuilder"
		      fork="no"
		      failonerror="true">
			<classpath refid="test.run.classpath" />
			<arg value="${ant.project.name}" />
			<arg file="${revisionInfo.product.dir}" />
			<arg file="${revisionInfo.build.file}" />
		</java>
	</target>

	<!-- - - - - - - - - - - - - - - - - - 
          target: prepareSolr                      
         - - - - - - - - - - - - - - - - - -->
	<target name="prepareSolr" depends="properties">
		<property name="solr.distrib.dir" location="${webapp.dir}/../solr" />
		<property name="solr.example.dir" location="${solr.distrib.dir}/exampleSolr" />
		<property name="solr.context.config.example"
		          location="${solr.distrib.dir}/exampleSolrContext.xml" />
		<property name="solr.war" location="${solr.distrib.dir}/apache-solr-3.1.0.war" />

		<property name="solr.docbase" location="${solr.home}/solr.war" />
		<property name="solr.context.name" value="${webapp.name}solr" />
		<property name="solr.context.config" location="${solr.home}/${solr.context.name}.xml" />

		<!-- Create and copy the example directory to the solr.home directory. -->
		<mkdir dir="${solr.home}" />
		<copy todir="${solr.home}">
			<fileset dir="${solr.example.dir}" includes="**/*" />
		</copy>

		<!-- Add the war file. -->
		<copy tofile="${solr.docbase}">
			<fileset file="${solr.war}" />
		</copy>
		<war destfile="${solr.docbase}" update="true">
			<classes dir="${webapp.dir}/config/solr/" />
		</war>

		<!-- if no mask is define, go with an unsecured installation. -->
		<property name="vitro.local.solr.ipaddress.mask" value=".*" />
		
		<!-- Create the context configuration XML with expanded properties. -->
		<copy tofile="${solr.context.config}" filtering="true">
			<fileset file="${solr.context.config.example}" />
			<filterchain>
				<expandproperties />
			</filterchain>
		</copy>
	</target>

	<!-- - - - - - - - - - - - - - - - - - 
          target: deploySolr                      
         - - - - - - - - - - - - - - - - - -->
	<target name="deploySolr" depends="prepareSolr" unless="noSolrDeploy">
		<unwar src="${solr.docbase}" dest="${tomcat.home}/webapps/${solr.context.name}" />
		<copy todir="${tomcat.home}/conf/Catalina/localhost" overwrite="true" >
			<fileset file="${solr.context.config}" />
		</copy>
	</target>

	<!-- ================================= 
          target: deploy              
         ================================= -->
	<target name="deploy"
	        depends="revisionInfo, deploySolr"
	        description="--> Build the app and install in Tomcat">
		<property name="webapp.deploy.home" value="${tomcat.home}/webapps/${webapp.name}" />

		<mkdir dir="${webapp.deploy.home}" />

		<sync todir="${webapp.deploy.home}" includeemptydirs="true">
			<fileset dir="${build.dir}/war" />
		</sync>
	</target>

	<!-- ================================= 
          target: war              
         ================================= -->
	<target name="war" depends="revisionInfo" description="--> Build the app and create a WAR file">
		<jar basedir="${build.dir}/war" destfile="${build.dir}/${webapp.name}.war" />
	</target>

	<!-- ================================= 
          target: licenser             
          
          In regular use, checks that all appropriate source files have license tags.
          At release time, applies license text to source files.
         ================================= -->
	<target name="licenser" description="--> Check source files for licensing tags">
		<property name="licenser.properties.file"
		          location="${webapp.dir}/config/licenser/licenser.properties" />
		<property name="licenser.label" value="Vitro core" />

		<echo message="Checking license tags on ${licenser.label}" />

		<exec executable="ruby" dir="${webapp.dir}/../utilities/licenser" failonerror="true">
			<arg value="licenser.rb" />
			<arg value="${licenser.properties.file}" />
			<redirector outputproperty="licenser.test.output" alwayslog="true" />
		</exec>
	</target>

</project>