From f5ad4be2c133d2b2165d3d4c258dee663869dd2e Mon Sep 17 00:00:00 2001
From: Dave Syer <dsyer@gopivotal.com>
Date: Mon, 23 Dec 2013 11:14:15 +0000
Subject: [PATCH] Add basic build.xml to actuator sample

    $ ant -lib ivy-2.2.jar

(substitute the location of your actual ivy jar)

    $ java -jar target/*.jar

Fixes gh-140
---
 .gitignore                                    |  1 +
 docs/howto.md                                 | 44 +++++++++++++++++
 .../spring-boot-sample-actuator/build.xml     | 48 +++++++++++++++++++
 .../spring-boot-sample-actuator/ivy.xml       | 13 +++++
 .../ivysettings.xml                           | 16 +++++++
 5 files changed, 122 insertions(+)
 create mode 100644 spring-boot-samples/spring-boot-sample-actuator/build.xml
 create mode 100644 spring-boot-samples/spring-boot-sample-actuator/ivy.xml
 create mode 100644 spring-boot-samples/spring-boot-sample-actuator/ivysettings.xml

diff --git a/.gitignore b/.gitignore
index 29b287eb60..dc9fe73105 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,6 +10,7 @@
 .settings
 bin
 build
+lib/
 target
 .springBeans
 dependency-reduced-pom.xml
diff --git a/docs/howto.md b/docs/howto.md
index a230a18f7c..3f4a1424fe 100644
--- a/docs/howto.md
+++ b/docs/howto.md
@@ -843,3 +843,47 @@ To do the same thing with properties files you can use
 `application-${profile}.properties` to specify profile-specific
 values.
 
+## Build An Executable Archive with Ant
+
+To build with Ant you need to grab dependencies and compile and then
+create a JAR or WAR archive as normal.  To make it executable:
+
+1. Use the appropriate launcher as a `Main-Class`,
+e.g. `org.springframework.boot.loader.JarLauncher` for a JAR file, and
+specify the other stuff it needs as manifest entries, principally a
+`Start-Class`.
+
+2. Add the runtime dependencies in a nested "lib" directory (for a
+JAR) and the "provided" (embedded container) dependencies in a nested
+"lib-provided" directory. Remember *not* to compress the entries in
+the archive.
+
+3. Add the `spring-boot-loader` classes at the root of the archive (so
+the `Main-Class` is available).
+
+Example
+
+	<target name="build" depends="compile">
+		<copy todir="target/classes/lib">
+			<fileset dir="lib/runtime" />
+		</copy>
+		<jar destfile="target/spring-boot-sample-actuator-${spring-boot.version}.jar" compress="false">
+			<fileset dir="target/classes" />
+			<fileset dir="src/main/resources" />
+			<zipfileset src="lib/loader/spring-boot-loader-jar-${spring-boot.version}.jar" />
+			<manifest>
+				<attribute name="Main-Class" value="org.springframework.boot.loader.JarLauncher" />
+				<attribute name="Start-Class" value="${start-class}" />
+			</manifest>
+		</jar>
+	</target>
+
+The [Actuator Sample]() has a `build.xml` that should work if you run
+it with
+
+    $ ant -lib <path_to>/ivy-2.2.jar
+
+after which you can run the application with
+
+    $ java -jar target/*.jar
+ 
diff --git a/spring-boot-samples/spring-boot-sample-actuator/build.xml b/spring-boot-samples/spring-boot-sample-actuator/build.xml
new file mode 100644
index 0000000000..cac3fb1078
--- /dev/null
+++ b/spring-boot-samples/spring-boot-sample-actuator/build.xml
@@ -0,0 +1,48 @@
+<project xmlns:ivy="antlib:org.apache.ivy.ant" name="spring-boot-sample-actuator" default="build">
+
+	<description>
+		Sample ANT build script for a Spring Boot executable JAR project. Uses ivy for dependency management so run with
+		'$ ant -lib ivy-2.2.jar' (substitute the location of your actual ivy jar). Run with '$ java -jar target/*.jar'. 
+	</description>
+
+	<property name="spring-boot.version" value="0.5.0.BUILD-SNAPSHOT" />
+	<property name="start-class" value="org.springframework.boot.sample.actuator.SampleActuatorApplication" />
+
+	<target name="resolve" description="--> retrieve dependencies with ivy">
+		<ivy:retrieve pattern="lib/[conf]/[artifact]-[type]-[revision].[ext]" />
+	</target>
+
+	<target name="classpaths" depends="resolve">
+		<path id="compile.classpath">
+			<fileset dir="lib/compile" includes="*.jar" />
+		</path>
+	</target>
+
+	<target name="init" depends="classpaths">
+		<mkdir dir="target/classes" />
+	</target>
+
+	<target name="compile" depends="init" description="compile">
+		<javac srcdir="src/main/java" destdir="target/classes" classpathref="compile.classpath" />
+	</target>
+
+	<target name="clean" description="cleans all class files">
+		<delete dir="target/classes" />
+	</target>
+
+	<target name="build" depends="compile">
+		<copy todir="target/classes/lib">
+			<fileset dir="lib/runtime" />
+		</copy>
+		<jar destfile="target/spring-boot-sample-actuator-${spring-boot.version}.jar" compress="false">
+			<fileset dir="target/classes" />
+			<fileset dir="src/main/resources" />
+			<zipfileset src="lib/loader/spring-boot-loader-jar-${spring-boot.version}.jar" />
+			<manifest>
+				<attribute name="Main-Class" value="org.springframework.boot.loader.JarLauncher" />
+				<attribute name="Start-Class" value="${start-class}" />
+			</manifest>
+		</jar>
+	</target>
+
+</project>
\ No newline at end of file
diff --git a/spring-boot-samples/spring-boot-sample-actuator/ivy.xml b/spring-boot-samples/spring-boot-sample-actuator/ivy.xml
new file mode 100644
index 0000000000..e60dfcbd96
--- /dev/null
+++ b/spring-boot-samples/spring-boot-sample-actuator/ivy.xml
@@ -0,0 +1,13 @@
+<ivy-module version="2.0">
+    <info organisation="org.springframework.boot" module="spring-boot-sample-actuator"/>
+    <configurations>
+      <conf name="loader" description="helpers added to final jar" />
+      <conf name="compile" description="everything needed to compile this module" />
+      <conf name="runtime" extends="compile" description="everything needed to run this module" />
+    </configurations>
+    <dependencies>
+        <dependency org="org.springframework.boot" name="spring-boot-loader" rev="0.5.0.BUILD-SNAPSHOT" conf="loader->default"/>
+        <dependency org="org.springframework.boot" name="spring-boot-starter-web" rev="0.5.0.BUILD-SNAPSHOT" conf="compile"/>
+        <dependency org="org.springframework.boot" name="spring-boot-starter-actuator" rev="0.5.0.BUILD-SNAPSHOT" conf="runtime"/>
+    </dependencies>
+</ivy-module>
\ No newline at end of file
diff --git a/spring-boot-samples/spring-boot-sample-actuator/ivysettings.xml b/spring-boot-samples/spring-boot-sample-actuator/ivysettings.xml
new file mode 100644
index 0000000000..864f970126
--- /dev/null
+++ b/spring-boot-samples/spring-boot-sample-actuator/ivysettings.xml
@@ -0,0 +1,16 @@
+<ivysettings>
+  <settings defaultResolver="chain"/>
+  <resolvers>
+    <chain name="chain">
+      <filesystem name="local" local="true" m2compatible="true">
+         <artifact
+                pattern="${user.home}/.m2/[organisation]/[module]/[revision]/[module]-[revision].[ext]" />
+            <ivy
+                pattern="${user.home}/.m2/[organisation]/[module]/[revision]/[module]-[revision].pom" />
+      </filesystem>
+      <ibiblio name="ibiblio" m2compatible="true" />
+      <ibiblio name="spring-milestones" m2compatible="true" root="http://repo.spring.io/libs-milestone"/>
+      <ibiblio name="spring-snapshots" m2compatible="true" root="http://repo.spring.io/libs-snapshot"/>
+    </chain>
+  </resolvers>
+</ivysettings>
\ No newline at end of file