VideoShop - A Salespoint example project

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 11 and a recent Git (2.20 or newer preferred) to be available on your machine. If you miss any of those go through the steps described in Prerequisites. Also, note that you have to run `mvnw.cmd` instead of `./mvnw` if you run Windows by accident.

$ git clone https://github.com/st-tu-dresden/videoshop
$ cd videoshop
$ ./mvnw clean package
$ ./mvnw spring-boot:run

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

Note that the standard admin user is named boss and has the password 123.

Prerequisites

Java 11

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

$ java -version
openjdk version "11.0.4" 2019-07-16
OpenJDK Runtime Environment AdoptOpenJDK (build 11.0.4+11)
OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.4+11, mixed mode)

Make sure that Maven picks up the same JDK version:

$ ./mvnw --version
Apache Maven 3.6.1 (d66c9c0b3152b2e69ee9bac180bb8fcc8e6af555; 2019-04-04T21:00:29+02:00)
Maven home: /Users/JavaJoe/.m2/wrapper/dists/apache-maven-3.6.1-bin/38pn40mp89t5c94bjdbeod370m/apache-maven-3.6.1
Java version: 11.0.4, vendor: AdoptOpenJDK, runtime: /Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home
Default locale: de_DE, platform encoding: UTF-8
OS name: "mac os x", version: "10.14.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.23.0

IDE Setup

Eclipse

Grab the latest Spring Tool Suite (plain Eclipse 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.

IntelliJ

Grab the latest IntelliJ IDEA IDE (both Community Edition and Ultimate Edition will work), install it according to the instructions on their website and run it.

From the Welcome Screen, select Import Project. Otherwise, if you’ve already opened another project, you’ll need to select File › New › Project from existing sources. Now, navigate to the folder you checked the project out into, select the pom.xml file and hit Open.

In the opened wizard, additionally select the checkboxes Import Maven projects automatically, as well as the Sources and Documentation checkboxes next to Automically download and hit Next. On the next page, do not select any profile and hit Next. Now, ensure the Maven project is selected for import and hit Next. On the following page, ensure you’ve selected a 1.8 or higher JDK and hit Next. On the final page, leave the suggested project name as is and hit Finish.

Now you have to wait a bit while IntelliJ and Maven work on importing the project, which includes downloading all required dependencies from the internet. All IDE activities are displayed in the status bar.

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 5

The de-facto standard Java application framework.

Spring Data JPA

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

Thymeleaf

Library to build HTML web views using natural templating.

KyoungYounLee/videoshop