Human Echolocation WebApp

h1. Overview of MATLAB Builder JA Java integration

h1. MatlabBuilderJA

Need to add the javabuilder.jar Library to the Apache Tomcat folder of global JARs:

* javabuilder.jar location: @$(MATLAB_HOME)/toolbox/javabuilder/jar/@

* Tomcat lib dir: @$(TOMCAT_HOME)/lib@

h2. Creating a dummy Java webapp: End to End Example

* See page 119 from the "Matlab Javabuilder Example Guide":http://www.mathworks.co.uk/help/pdf_doc/javabuilder/example_guide.pdf

# Download the code from "MATLAB Central":http://www.mathworks.com/matlabcentral/fileexchange/22476-java-web-example-guide-end-to-end-chapter

# Make sure the path for MATLAB's libraries is correctly set:

<pre>

export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/Applications/MATLAB_R2013b.app/sys/os/maci64/:/Applications/MATLAB_R2013b.app/runtime/maci64/:/Applications/MATLAB_R2013b.app/bin/maci64/

</pre> 

# Copy your web servers servlet-api.jar file into this directory;

# Copy the javabuilder.jar file from your MATLAB or MCR install root in the directory /toolbox/javabuilder/jar/javabuilder.jar to the web applications lib folder ./webapp/WEB-INF/lib

# Recompile the MATLAB component by running the following MCC command:

<pre>

/Applications/MATLAB_R2013b.app/bin/mcc -W "java:examples,MagicCalc" -d ./scratch -T "link:lib" -v "class{MagicCalc:./webapp/WEB-INF/mcode/getMagic.m,./webapp/WEB-INF/mcode/getMagicWebFigure.m}"

</pre>

#* this will generate the contents of scratch

# Copy the deployed component from the scratch folder to the web applications lib folder .\webapp\WEB-INF\lib

<pre>

cp ./scratch/examples.jar ./webapp/WEB-INF/lib 

</pre>

# Compile the web application making sure to reference the servlet-api.jar, the deployed component jar, and the javabuilder.jar

<pre>

javac -cp servlet-api.jar:./webapp/WEB-INF/lib/javabuilder.jar:./webapp/WEB-INF/lib/examples.jar: -d ./webapp/WEB-INF/classes ./webapp/WEB-INF/src/MagicSquareServlet.java

</pre>

# Navigate to the web applications directory and create the war file.

<pre>

cd webapp

jar -cvf ../JavaEndToEnd.war .

cd ..

</pre>

# Copy this JavaEndToEnd.war file into your web servers webapps directory

# Start the web server and navigate in a browser to the following url:

<pre>

http://localhost:8080/JavaEndToEnd/ExamplesPage.jsp

</pre>

h3. Folder Structure 

<pre>

JavaEndToEnd/

├── scratch

│   ├── classes

│   │   └── examples

│   ├── doc

│   │   └── html

│   │       ├── examples

│   │       └── resources

│   └── examples

└── webapp

    └── WEB-INF

        ├── classes

        ├── lib

        ├── mcode

        └── src

</pre>

* "Using Ant to create a WAR ":https://ant.apache.org/manual/Tasks/war.html

* "Very simple webapp - JAVA, Ant":http://static.springsource.com/projects/tc-server/6.0/getstart/tgsdevtut.html