mindaugasjasiunas / multimodulewebapplication Goto Github PK

Multi module e-commerce non-boot Spring web application.

Java 32.61% HTML 13.80% CSS 53.59%

spring spring-mvc java-mail hibernate maven spring-security thymeleaf hibernate-validator junit mockito mockmvc lombok hikaricp spring-data java-money postgresql webjars

multimodulewebapplication's Introduction

E-shop example project

This project is an example created using various java tools and libraries. This project is not yet completed but working.

Description

Multi-module approach used to separate web layer from database layer.

Maven dependency management tool used to manage this multi-module project.

Lombok used to reduce boilerplate code making it cleaner.

PostgreSQL JDBC driver with Hikari connection pooling used for database $ Hibernate for object-relational mapping.

Spring Security used to protect web page URL's by roles & authorities. Thymeleaf Spring Security Extras used to show information and buttons based on user authentication status (ex. in navigation) . Cart checkout button available only for fully authenticated(remember-me token doesn't count) user.

Persistent remember-me token used for better protection. It expires and is created new every time user logs in from certain device.

Thymeleaf used as templating engine for its flexibility. Header, navigation and footer split into fragments. There can even be used thymeleaf's decoupled template logic to separate HTML templates from thymeleaf attributes.

Hibernate validator used to validate entities when new user registers. There is even custom UniqueEmail validator created that checks if email doesn't exist in database already.

Bootstrap js, bootstrap css, jQuery webjars used for adding & managing client side dependencies.

Spring JPA used in database module for easier work with data in DB. No-code repositories, reduced boilerplate code, auto-generated queries. PagingAndSorting repository used for items to get elements by page(used in main application view).

For items Rest GET endpoint created. JQuery with AJAX used in main page to call application REST endpoint and get items list by page. Then popolate view elements. To use REST and to convert POJO's to JSON and vice versa, Jackson Databind dependency(libraries) is used.

Vanilla JS used in main page DOM to provide full functionality for pagination buttons. Works from 1 to n pages. If there is not a full page of elements - not used HTML elements (cards) is hidden to prevent product info from last page.

Moneta(JSR 354 reference implementation) used for Item entity price field & 'numeric' type in postgreSQL.

Java Mail is used when sending emails for password reset & new registration confirmation. Tested with "MailDev" locally.

Internationalization(I18N) configured and used in main page.

##Database tables UML Diagram

Not implemented yet

item sorting by category, size, gender
item images
cart items sorting
discount functionality
admin functionality (view, disable users)
employee functionality (add new items, edit existing)
Unit + Integration tests

multimodulewebapplication's People

Contributors

Watchers

multimodulewebapplication's Issues

Add Spring Security to the project

Add WebJars to the project

jQuery, Bootstrap CSS, Bootstrap JS

Custom validation UniqueEmail

Add Java Mail & functionality for registration activation/password reset

Optimize - password encoding needs to be in UserEntity Service

Create united HTML pages <head> tag using Thymeleaf Fragments

head.html

< !DOCTYPE html>
< html lang="en" xmlns:th="http://www.thymeleaf.org">
< head th:fragment="headFragment">
< meta charset="utf-8">
< title>Page title
< /head>
< /html>

home.html

< !DOCTYPE html>
< html lang="en" xmlns:th="http://www.thymeleaf.org">
< head th:replace="~{fragments/head::headFragment}"> // ~{package/fileName::fragmentName}
< meta charset="utf-8">
< title>Page title
< /head>
< /html>

upload UML of tables

Migrate to Thymeleaf templating engine

Add Spring JDBC library for use in DAO classes

Change simple hash-based token remember me to persistent token

On login via Remember Me values are fetched from DB.
If matched, user is authenticated, and new token is created for series id(browser/device).
If username & series match, but token does not- theft is assumed - delete all tokens for user.

Shortens attack window until real user logs in (vs expiration time).

Create Item Image entity

Create product HTML page

Update Item & Category entities to prevent circular dependency in toString

Create register HTML page

Create shopping cart HTML page

We could use single base entity holding id for entities to extend in the project.

@Setter
@Getter

@MappedSuperclass
public class BaseEntity implements Serializable{
    private static final long serialVersionUID=1L;
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id", unique = true)
    private long id;
    @Column(length = 36, columnDefinition = "varchar", updatable = false, nullable = false, unique = true)
    private UUID publicId= UUID.randomUUID();
    @CreationTimestamp
    @Column(updatable = false)
    private Timestamp createdAt;
    @UpdateTimestamp
    private Timestamp lastModifiedAt;

    public boolean isNew(){
        return this.id==null;
    }
}

Implement Spring Security logout, change navigation + add Thymeleaf Spring Security 5 Extras & configure

Add reset password new password form, new password entity(not in DB), reset password functionality & generate UUID's for user activation after reset password or registration.

Create checkout HTML page

Add javamoney to the project +Item entity with JPA converter class & PagingAndSorting repository

Add javamoney dependency.
Create Item entity.
Create JPA2 converter class for converting MonetaryAmount to/from BigDecimal(for storing in Postgres DB (column numeric(19,2)).
All money values will use 2 decimal precision & EURO currency.
Create Item PagingAndSorting repository.