LAPPS

The Layers App Store (LAPPS) is a web-based application showcasing all apps and services that are developed and/or promoted by the Layers project.

##Environment##

• Java SDK 7
• Eclipse (Luna) Java EE (https://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr1)
• Maven 3.2.3 (if you want to use maven from command line; http://maven.apache.org/download.cgi)
• Git 2.1.3 (http://git-scm.com/)
• Node.js 0.10.33 (http://nodejs.org/)

Newer versions should also work fine.

##Configuration## Configure Eclipse:

• Import https://google-styleguide.googlecode.com/svn/trunk/eclipse-java-google-style.xml as Eclipse Java format (Preferences -> Java -> Code Style -> Formatter)
• Configure the Java -> Code Style (rest is Eclipse default):
  • Enable "Format source code"
  • Enable "Remove unused imports"
• Configure the Java -> Editor -> Save Actions (rest is Eclipse default):
  • Enable "Perform the selected actions on save"
  • Enable "Format source code"
  • Enable "Organize imports"
• Import https://raw.githubusercontent.com/jokeyrhyme/eclipse-formatter-profiles/master/google-style-guide-javascript-eclipse.xml as Eclipse JavaScript format (Preferences -> JavasSript -> Code Style -> Formatter)
• Configure the JavaScript -> Editor -> Save Actions (rest is Eclipse default):
  • Enable "Perform the selected actions on save"
  • Enable "Format source code"

##Build## LAPPS Backend (run these commands from your project folder):

• mvn clean --- clean
• mvn test --- test backend
• mvn exec:java --- compile and start on Jetty (port 8080, execute in LAPPS-backend folder)
• mvn javadoc:javadoc --- generates JavaDoc documentation
• mvn package --- generate a servlet that can be deployed to an application server
• mvn test -Dtest=DataGenerator --- generates mockup data in the database
  These commands also work inside Eclipse, then leave away the mvn prefix. =======
• mvn clean --- clean
• mvn test --- test backend
• mvn exec:java --- compile and start on jetty server (port 8080, please execute in LAPPS-backend folder)
• mvn javadoc:javadoc --- generates JavaDoc documentation
• These commands also work inside Eclipse (Run -> Maven build..), then leave out the mvn prefix.

LAPPS Frontend (run these commands from your project folder):

• npm install --- install dependencies (will be done automatically when running the start command)
• npm test --- test frontend
• npm start --- start on node server (port 8000)
• npm run protractor --- start e2e tests (start the server with npm start first in another console)
• npm run doc --- create jsdoc documentation in out/
• npm run deploy --- create a deployable containing minified files in deploy/
• npm run api --- fetches the up to date Swagger api from the deploy server for frontend usage
• npm run apilocal --- fetches the up to date Swagger api from the local server for frontend usage

##Links## Nightly Builds:

• 
• Current Version of "develop" Branch
• Swagger API Documentation
• Jenkins Home Directory
• Backend Documentation
• Frontend Documentation
• Backend War Files in Archiva

Learning Room (authentication required):

• Shared Documents

Technology:

• https://jersey.java.net/documentation/latest/index.html
• https://docs.angularjs.org/tutorial/
• http://getbootstrap.com/getting-started/
• http://nodejs.org/documentation/
• http://git-scm.com/docs

Code Style:

• http://google-styleguide.googlecode.com/svn/trunk/javaguide.html
• http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml
• http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml
• http://google-styleguide.googlecode.com/svn/trunk/angularjs-google-style.html