Angular4 Spring Boot Project

An Angular full stack starter kit featuring Angular 4, Router, Forms, Http, Services, Spring boot, JSON Web Token for an university project.

Deployment

Make sure you have Maven and Java 1.7 or greater Make sure you also have NPM 3.1, Node 6.9.5 and [email protected] globally installed

# clone our repo
# --depth 1 removes all but one .git commit history
git clone --depth 1 https://github.com/ghilesfeghoul/Springular.git

# change directory to the repo's frontend folder
cd Springular/frontend

# install the frontend dependencies with npm
# npm install @angular/[email protected] -g
npm install

# build frontend project to /server/src/main/resources/static folder
ng build

# change directory to the repo's backend folder
cd ../server

# install the server dependencies with mvn
mvn install

# start the server
mvn spring-boot:run

# the app will be running on port 8080

For more deployment related info checkout here: DEPLOYMENT DOC

For more detailed configuration/documentation, please check out the frontend and server folder.

There are two user accounts present to demonstrate the different levels of access to the endpoints in the API and the different authorization exceptions:

Admin - admin:123
User - user:123

JSON Web Token

JSON Web Tokens are an open, industry standard RFC 7519 method for representing claims securely between two parties. for more info, check out https://jwt.io/

Token authentication is a more modern approach and is designed solve problems session IDs stored server-side can’t. Using tokens in place of session IDs can lower your server load, streamline permission management, and provide better tools for supporting a distributed or cloud-based infrastructure.

-- Stormpath

Importing the Project in IntelliJ IDEA

1. Click "Import Project" on the launch screen
2. Select the projects root folder, then select "Import project from external model" and choose "Maven"
3. Tick the checkboxes "Import Maven projects automatically" and "Import projects recursively"
4. Continue the dialog until the IDE opens the project
5. Open the "Project Structure" dialog
6. On the left side, choose "Modules" and click the "Add" button
7. Choose "Import Module", then select the frontend folder
8. Choose "Create module from existing sources" and continue in the dialog until the module is added.
9. You should now see both (frontend and backend) modules in the Project view

Contributors

-Ghiles FEGHOUL -Juba TIDAF -Islam GUETTOUCHE

This project is inspired by

• Stormpath
• Cerberus
• jwt-spring-security-demo

---

License

MIT