This directory contains example of using HTML+JavaScript with REST API.

Available Files:

-----------------

HTML and JavaScript files are available in: assignment7/src/main/webapp/

1) ajaxexample.html

Once you build and deploy the application in Eclipse, you can access

this file to study how a HTML+JavaScript code can interact with REST API

using the Asynchronous JavaScript (AJAX) technology.

You can access this file at:

http://localhost:<port>/<context-root>/ajaxexample.html

This html file contains JavaScript code which makes AJAX call to the REST API,

which is available at:

http://localhost:<port>/<context-root>/assignment7/helloworld/helloworld

where the <context-root> is "/"

2) ajaxexample-snapshot.html

This HTML file is similar to ajaxexample.html with the only difference that

the <context-root> for the REST API is "assignment7-0.0.1-SNAPSHOT".

The reason why the context root is different in this case is explained below.

Using mvn to build the project:

----------------------------------

You can use mvn commands to build the project.

- Compile: mvn clean compile

- Create war: mvn package war:war

For war file generated by using mvn commands the context root is:

<artifactId>-<version> from pom.xml

In our case:

- artifactId is "assignment7"

- version is "0.0.1-SNAPSHOT"

Therefore, the context root is: assignment7-0.0.1-SNAPSHOT

The reason you need to understand these steps is explained below.

Deploying webapp to Tomcat on Cloud VM:

----------------------------------------

Till now we have used an IDE (Eclipse, Intellij) for deploying our webapps.

But for assignment7 we will be deploying our webapp on Tomcat on a Cloud VM.

We won't have access to Eclipse on a Cloud VM, but we will have to build the '.war' file

using mvn commands outlined above.

Steps for deploying a webapp to Cloud VM:

-------------------------------------------

1) Sign up for a cloud provider

2) Create cloud server:

E.g.: <Ubuntu 14.04, Standard flavor> on Rackspace (https://developer.rackspace.com/signup/)

3) Login

4) Install required software and packages

- apt-get update

- Install Tomcat

- apt-get install tomcat7 (This will install tomcat in /var/lib/tomcat7)

- Start Tomcat

./var/lib/tomcat7/bin/startup.sh

- Find IP address of your VM

- Via control panel

- Via command line (ifconfig and eth0)

- Access tomcat

- curl <IP-address>:8080

5) Generate war file

- Install git: apt-get install git

- Use git to clone your code from bitbucket/github

- Install maven: apt-get install maven

- Install open-jdk-7: apt-get install openjdk-7-jdk

- Compile: mvn clean compile

- Create war: mvn package war:war

- Copy assignment7-0.0.1-SNAPSHOT.war to /var/lib/tomcat7/webapps/

6) Tomcat related:

- Logs are available at:

/var/lib/tomcat7/logs/catalina.out

- Check the logs using: tail –f catalina.out

- Tomcat server port can be modified as follows:

- In /var/lib/tomcat7/conf/server.xml

- change Connector element’s port attribute

- Stop Tomcat:

./var/lib/tomcat7/bin/shutdown.sh

- Start Tomcat:

./var/lib/tomcat7/bin/startup.sh

7) Access application at:

http://<IP-address>:8080/assignment7-0.0.1-SNAPSHOT/assignment7/helloworld/helloworld