Notejam: Spring

Notejam application implemented using Spring framework.

Spring version: 4.2.3

The full stack is:

• Spring Boot (Spring configuration)
• Thymeleaf (View)
• Spring Security (Security framework)
• Spring (DI and MVC framework)
• Spring Data (Persistence abstraction)
• JPA (Persistence API)
• Hibernate (JPA implementation)

The application is maintained by @malkusch.

Installation and launching

Clone

Clone the repo:

$ git clone https://github.com/komarserjio/notejam YOUR_PROJECT_DIR/

Install

Install a JDK and Maven.

Configuration

The application has a password recovery process which involves sending an email. If you want to enable that, you have to create a local application.properties file and set there the property spring.mail.host to your SMTP server (e.g. spring.mail.host = smtp.example.net).

$ cd YOUR_PROJECT_DIR/spring/
$ vi application.properties

See MailProperties for more mail properties.

Launch

Compile and launch the application:

$ cd YOUR_PROJECT_DIR/spring/
$ mvn spring-boot:run

Go to http://localhost:8080/ in your browser.

Localization

This application comes with support for the languages German and English. The locale is determined by the Accept-Language request header. If the header is not present the content will be served with the default locale of the JVM. The application will not start if the default locale is non of the supported languages.

Run tests

Run functional and unit tests:

$ cd YOUR_PROJECT_DIR/spring/
$ mvn test

Contribution

Do you have Java/Spring experience? Help the application to follow Java and Spring best practices.

Please send your pull requests in the master branch. Always prepend your commits with framework name:

Spring: Implement sign in functionality

Read contribution guide for details.