Guestbook sample Java web-application
Java HTML JavaScript CSS
Switch branches/tags
Nothing to show
Clone or download
olivergierke #48 - Polished readme.
Updated console output with more recent versions. Fixed link to current Spring Boot reference documentation.
Latest commit ceabea0 Oct 9, 2017
Permalink
Failed to load latest commit information.
src
.gitignore #1 - Initial commit. Aug 1, 2014
.travis.yml #12 - Setup Travis build. Oct 13, 2014
pom.xml #44 - Upgraded thin launcher to 1.0.7. Sep 27, 2017
readme.adoc

readme.adoc

A Sample Java Web-Application

Build Status

Purpose of this sample project is to make students familiar with basic technologies they’re going to use during the Software Engineering Lab at Technical University of Dresden.

Quickstart

Note
The Quickstart requires Java 8, Maven 3 and a recent Git (2.2.x preferred) to be available on your machine. If you miss any of those go through the steps described in Prerequisites
$ git clone https://github.com/st-tu-dresden/guestbook
$ cd guestbook
$ mvn clean package
$ mvn spring-boot:run

After that point your browser to http://localhost:8080.

Prerequisites

Java 8

Download the binaries, install. Make sure the console shows something like this:

$ java -version
java version "1.8.0_144"
Java(TM) SE Runtime Environment (build 1.8.0_144-b01)
Java HotSpot(TM) 64-Bit Server VM (build 25.144-b01, mixed mode)

Maven 3.x

Download the binaries, unzip to an arbitrary location and make sure the bin folder of the unzipped result is in your path:

$ mvn --version
Apache Maven 3.5.0 (ff8f5e7444045639af65f6095c62210b5713f426; 2017-04-03T21:39:06+02:00)
Maven home: /usr/local/Cellar/maven/3.5.0/libexec
Java version: 1.8.0_144, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_144.jdk/Contents/Home/jre
Default locale: de_DE, platform encoding: UTF-8
OS name: "mac os x", version: "10.12.6", arch: "x86_64", family: "mac"

Git

Download the binaries, run the installer. Verify the command line shows something like this after install:

$ git --version
git version 2.14.1

IDE Setup

Grab the latest STS (Spring Tool Suite, plain Eclipse Luna or IntelliJ should work as well), run installer or unzip and run it.

Select File  Import, select Maven  Existing Maven Projects, select the folder you checked the project out into and hit Finish. This will import the project into your workspace.

In the Console view you might wanna click the Open Console button and select Maven Console to see that Maven is downloading dependencies, sources and Javadocs.

Technology stack

This sample application is build on top of the following technologies:

Spring Boot

Rapid application development framework based on Spring (see below).

Spring 4

The de-facto standard Java application framework.

Spring Data JPA

Spring module to easily build data acess layers using JPA 2.1 (Java Persistence API).

Thymeleaf

Library to build HTML web views using natural templating.