Skip to content

ceevee87/webdev-demo-vegas-ipsum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

webdev-demo-vegas-ipsum

Overview

This project is an Ipsum Lorem generator with a Las Vegas twist.

Technologies

This project demonstrates the following technologies:

  • RESTful JSON API implemented in Java with Jersey
  • Web service deployment using Apache Tomcat
  • Source code compilation and dependency management using Maven
  • Automated unit testing (Java) using JUnit
  • Manual validation using Postman
  • Front end web development using HTML/JS/CSS
    • styling with Bootstrap and other popular 3rd party packages

Task List & Progress

  • implement java class interface that defines basic features of a lorem ipsum generator.
  • implement the VegasIpsum generator
  • add JUnit testing for VegasIpsum (java) generator.
  • create a WebApi that implements GET operations using the VegasIpsum backend engine.
  • write a basic HTML/JS/CSS front-end that interacts with the deployed (Tomcat) Web application
    • add in options in web page to set min/max paragraphs
      • enhance java side GET code to handle @queryparam parameters.
    • add in ability to start first paragraph, optionally, with 'vegas ipsum dolor ...'
  • update Maven to deploy VegasIpsum WebApi onto an Apache Tomcat server
  • validate WebApi interface to the VegasIpsum generator with Postman.
  • improve initial styling of web page (reduce area used by min/max paragraph size inputs).

Build

IMPORTANT: Automatically deploying and undeploying applications to an Apache Tomcat server requires modification of the tomcat-users.xml file. I do not include instructions for doing that here.

This application is run as a WAR deployed on Apached Tomcat. To build & deploy to Tomcat make sure you first have Tomcat up and running. Then do:

   mvn tomcat7:undeploy clean package tomcat7:deploy

Running the application

The default landing page for the application is http://localhost:8080/VegasIpsum/.

IDE

The java portion of this project was developed in NetBeans. The Web portion was developed using VS Code on top of FireFox 53.0.

The operating system is Ubuntu 16.04 LTS.

No testing was done on Windows based machines or alternate browsers.