View source

This is a short step by step ANT example to show how "sonify" your application. I<nowiki>''</nowiki>ll use BSD licensed Sun files from $JAVA_HOME/demo/jfc/Java2D/src folder (*). I like this example because it is multithread and is fun to play with. The live demo is also available as a '''[http://www.codesounding.org/java2demo.jnlp one-click Java Web Start application]'''.

===[http://codesounding.svn.sourceforge.net/viewvc/codesounding/CodeSounding/tags/REL-1.3/build_java2demo.xml?view=markup Here the complete ANT build file]===

Let:
<pre><property name="src"  value="${basedir}/java2Demo/src"/>
<property name="srcRewritten"  value="${basedir}/java2Demo/srcRewritten"/>
<property name="build"  value="${basedir}/java2Demo/bin"/>
<property name="lib"  value="${basedir}/dist"/>
<property name="manifest"  value="${basedir}/java2demo/manifest"/>
<property name="dist"  value="${basedir}/java2Demo/dist"/></pre>
Where 'cp.main' contains codesounding-embedded.jar:
<pre><path id="cp.main">
    <pathelement location="${lib}/codesounding-embedded.jar"/>
</path></pre>

* The first step is rewriting your source files, to add sonification instruction; all rewritten files go in ${srcRewritten} folder:
<pre><taskdef name="sonify" classpathref="cp.main" classname="codesounding.ant.TaskTemplateApplier"/>
<sonify destDir="${srcRewritten}">
   <fileset dir="${src}" includes="**/*.java" />
</sonify></pre>
* Second, compile your source files
<pre><javac
   srcdir="${srcRewritten}"
   destdir="${build}"
   classpathref="cp.main"
/></pre>
* Third, maybe you'd like to pakage all in a jar:
<pre>  <jar destfile="${dist}\java2demo.jar" manifest="${manifest}/MANIFEST.MF">
      <fileset dir="${build}"/>
      <fileset dir="${src}" >
          <include name="codesounding.properties"/>
      </fileset>
      <zipfileset src="${lib}/codesounding-embedded.jar"/>
  </jar></pre>
: Note I'm including also codesounding-embedded.jar content files.
: ==='''Important''': sonification configuration is into [http://codesounding.svn.sourceforge.net/viewvc/codesounding/CodeSounding/tags/REL-1.3/java2Demo/src/codesounding.properties?view=markup codesounding.properties] file (see the [http://www.codesounding.org/usageeng.html#config file format doc]). It must be either in the current running directory or into the classpath.===
* Finally, run the application and hear your code play; here three ways to start it:
<pre><target name="run.embedded" depends="sounding.java2demo" >
    <!-- this works only if java2demo.jar contains also codesounding.* classes -->
    <java fork="true" jar="${dist}\java2demo.jar"/>
</target>

<target name="run.jvmarg" depends="sounding.java2demo" >
    <!-- tricky way to inject a classpath to a 'java -jar' command -->
    <java fork="true" jar="${dist}\java2demo.jar">
        <jvmarg value="-Xbootclasspath/a:${lib}/codesounding-embedded.jar"/>
    </java>
</target>

<target name="run.class" depends="sounding.java2demo" >
    <!-- 'java classname' standard way -->
    <java
        fork="true"
        classpath="${dist}/java2demo.jar:${lib}/codesounding-embedded.jar"
        classname="java2d.Java2Demo">
    </java>
</target></pre>

----

(*) Since I'm publishing the demo also as a Java Web Start application and to avoid a ClassCastException on the classloader (JWS uses com.sun.jnlp.JNLPClassLoader class), I made two changes to Sun original sources; they are on file [http://codesounding.svn.sourceforge.net/viewvc/codesounding/CodeSounding/tags/REL-1.3/java2Demo/src/java2d/DemoImages.java?view=markup DemoImages.java], where in the following lines I use a generic ClassLoader (and its method 'getResource') instead of a URLClassLoader ('findResource' method):
<pre>ClassLoader urlLoader = cmp.getClass().getClassLoader();
URL fileLoc = urlLoader.getResource("images/" + name);</pre>