Cloudinary Java/Spring MVC Sample Project
A simple web application that allows you to uploads photos, maintain a database with references to them, list them with their metadata, and display them using various cloud-based transformations.
Run the following commands from your shell.
Clone the Cloudinary Java project:
git clone git://github.com/cloudinary/cloudinary_java.git
Compile the sample project and create a WAR file (package):
cd samples/photo_album mvn compile && mvn package
A WAR file should have been created in:
You need to deploy this war file into your J2EE container of choice. The following instructions assume a *nix with Tomcat 7 on
mv target/photo_album.war $CATALINA_HOME/webapps/
If you would like to deploy the sample application in the root server path do this instead:
mv target/photo_album.war $CATALINA_HOME/webapps/ROOT.war
Next you need to pass your Cloudinary account's Cloud Name, API Key, and API Secret. This sample application assumes these values exists in the form
CLOUDINARY_URL settings either as an environment variable or as system property. The
CLOUDINARY_URL value is available in the dashboard of your Cloudinary account.
If you don't have a Cloudinary account yet, click here to create one for free.
The specific method with which you pass that information to Tomcat (or any other Servlet container) is not important but we present 2 alternatives here.
Start Tomcat with
CLOUDINARY_URLas a process bound environment variable
TOMCAT_OPTSenvironment variable either globally (
/etc/profile) or for the user running Tomcat (
If you chose the second option you will need to now start Tomcat:
and point your browser to http://localhost:8080/photo_album/ or http://localhost:8080/ if you opted to put the WAR file in root. Note: you might need to give Tomcat a while to pick the deployed WAR file explode it, and deploy it.
This sample uses an in memory HSQLDB database so you should expect all data to be lost when the servlet process ends.