https://github.com/mrsarm/spring-react-crud

React.js and Spring REST CRUD Admin
https://github.com/mrsarm/spring-react-crud

admin bootstrap4 crud hibernate java maven reactjs spring spring-boot spring-data-jpa webapp

Last synced: 18 days ago
JSON representation

React.js and Spring REST CRUD Admin

• Host: GitHub
• URL: https://github.com/mrsarm/spring-react-crud
• Owner: mrsarm
• Created: 2019-06-23T18:16:50.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-09-04T13:12:59.000Z (over 1 year ago)
• Last Synced: 2025-01-03T22:34:16.468Z (20 days ago)
• Topics: admin, bootstrap4, crud, hibernate, java, maven, reactjs, spring, spring-boot, spring-data-jpa, webapp
• Language: JavaScript
• Homepage:
• Size: 573 KB
• Stars: 12
• Watchers: 3
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
React.js and Spring Data REST - CRUD

====================================

![React Spring CRUD](docs/img/spring-react-crud.png)

CRUD application with security enabled: a PoC with

ReactJS in the frontend and Spring Data REST in the backend.

## 🚀 Stack

- **Backend**: Java 17 LTS, Spring Boot 3 (web, security, JPA),

  Postgres / H2 (or whatever DB is compatible with JPA).

- **Frontend**: ReactJS, React Router, Bootstrap,

  Axios, Reactstrap, Node 18 / Npm / Webpack (build).

### ⚙️ Requirements

- **JDK 17+**

- **Maven 3+**, or you can use the script `./mvnw` instead that it will install

  Maven 3.9 in the user space automatically if the required version isn't there

To build the web assets the project uses **Node.js**, **Webpack**, ...

but all of them are installed and triggered by Maven automatically

in the user space.

## 🎮 Usage

Launch the application with:

    $ mvn spring-boot:run

Or use `./mvnw` instead of `mvn` (`mvnw.cmd` for Window platforms).

Then access the application with http://localhost:8080/, or access

to the API with http://localhost:8080/api/.

One of the users to access the app with privileged permissions is `frodo@local`,

and the password `admin`. Check and edit the initial dataset in

the [DatabaseLoader.java](src/main/java/ar/com/mrdev/app/user/DatabaseLoader.java#L46-L50)

file.

If you access the API through the HAL browser, it will require to sign-in

like with the dash panel using a web page provided by Spring Security,

but if you are going to consume the API with a 3rd party tool

you will need to authenticate using

[HTTP Basic Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication),

eg. with `curl` the `Authorization: Basic ...` header can be generated using

the `-u user:pass` argument:

    $ curl -u gf@local:admin http://localhost:8080/api/users

#### 🌶 Hot reloading

To edit Javascript or CSS resources and see the changes in the

browser without the need to re-launch the application, execute within

a command line:

    $ npm run watch

And leave it running (if it doesn't work, try with `target/node/npm run watch`).

#### 📦 Packaging

Pack the application in a single .jar with all the dependencies

and the web server with:

    $ mvn package

Add the argument `-Dmaven.test.skip` if you don't want to run the tests before packaging.

Then you can run the .jar with:

    $ java -jar target/app-0.0.1-SNAPSHOT.jar

### ⏯ Tests

For now only a test that checks that the spring context

can be loaded is in the source code. Execute with:

    $ mvn test

A _GitHub Action_ workflow is configured as well

as **CI** environment, check out [maven.yml](.github/workflows/maven.yml).

Versions

--------

For now there are two versions, each one with its own branch:

- `master`: main version with an in-memory database (H2) to quickly

  launch the application without the need of a database installed (local tests).

- `postgres`: modified version with PostgreSQL configured,

  ready for "production" usage.

About

-----

**Source code**: https://github.com/mrsarm/spring-react-crud

**Authors**:

* Mariano Ruiz 

The goal was to learn React and using Spring as backend, so I started

following this [guide](https://spring.io/guides/tutorials/react-and-spring-data-rest)

from _Spring.io_ (Greg Turnquist and other authors from _Pivotal_), but I ended up

rewriting  almost all from scratch and adding a lot of features, like Bootstrap,

client side validations, routing, updating dependencies to major versions ...

2015-2023  |  Apache-2.0