← All projects

Part 6 of this project

Registration

Validate customer accounts and store password hashes.

Goal

This snapshot advances Gearcart Market by teaching you to validate customer accounts and store password hashes.

Every numbered folder is a complete app. Run this stage independently, then compare it with the previous folder.

Prerequisites

Use JDK 17+, Maven, and Docker for MySQL stages.

Port 8084 must be free. Copy .env.example before database stages.

  • JDK 17+
  • Maven
  • Docker from part 4 onward

Concepts

Registration normalizes email, enforces uniqueness, hashes passwords, signs the user in, and regenerates the session.

Thymeleaf renders server HTML; Spring Security owns the session; JPA repositories persist catalog and orders.

Walkthrough

Build a registration form with CSRF-safe posts and validation errors.

Read the example, then open the matching snapshot. The repository includes validation, CSRF, and the surrounding structure.

user.setPassword(encoder.encode(raw));
userRepo.save(user);
return "redirect:/";

Run and verify

Enter 06-Registration, copy .env.example, start Docker MySQL, and run ./mvnw spring-boot:run on port 8084.

Open http://127.0.0.1:8084. From data lessons onward, Ada and Grace use password123.

docker compose up -d
git clone https://github.com/michaeldunga1/fcc-spring-ecommerce.git
cd fcc-spring-ecommerce/06-Registration
cp .env.example .env
./mvnw spring-boot:run

Troubleshooting

Duplicate email and password confirmation failures should redisplay field errors.

For database failures, confirm Docker and the gear_NN name. Never commit .env, target/, or secrets.

  • Read the first exception first
  • Rebuild assets after Tailwind class changes
  • Never commit secrets

Try this

Try a short password, mismatched confirmation, and a duplicate email.

Test a happy path and one invalid or unauthorized request.

  • Make one small change
  • Test it in the browser
  • Compare with the next snapshot only after it works

Related tutorials