This project is an example of using JavaFX and Spring-boot together. Originally created for my university module assignment and has been made public to help others who would like to use both JavaFX and Spring-boot. This repository will not receive any code changes and will be left in the same state that it was submitted. The application allows users to loan out items, from books to a toys and can manage the items they have loaned out.
The application uses the following software and frameworks:
If you would like to continue developing this application on your local machine, please ensure you have the above installed and configured.
In order to run the application locally, you will first need to have the database running:
- Navigate to the directory that 'javafx-springboot-loan-application' is stored,
- Type
docker-compose -up -din the root directory to start the postgres container.
This should start up the database and populate the 'library-system-db' with initial data for local usage.
After the database has been started, you can then start the application, for IntelliJ users you can perform the following:
- Right-click the 'LibrarySystemApplication' and click on 'Run LibrarySystemApplication...main()',
- The first attempt may fail due to:
Error: JavaFX runtime components are missing, and are required to run this application - Right click and Edit the 'LibrarySystemApplication' configuration in IntelliJ and add the following VM options:
--module-path /your/path/to/javafx-sdk-18/lib --add-modules=javafx.controls,javafx.fxml - Run the 'LibrarySystemApplication' configuration again via IntelliJ.
Note: You can use the following user to access the application: ben.tennyson, the other user dexter.lab is disabled
and will not be able to access the application.
| Username | Password | Role | Enabled |
|---|---|---|---|
| ben.tennyson | Pa55Word1! | standard | true |
| dexter.lab | Pa55Word1! | administrator | false |
Application throws JDBCConnectionException / PSQLException on start-up?
Ensure that the database is up and running, the application will attempt to connect to hostname: localhost on port: 5432.
Using the username: postgres and password: password on the 'library-system-db' database. If you're running on a different
port or the user 'postgres' does not exist. Please update the application.properties to reflect any of these changes.
You can either use environment variables to change the values or update the file itself.
Unable to start application due to: 'JavaFX runtime components are missing ...'
If you get this error, double check you have provided the correct path to your javafx-sdk files in your VM arguments for 'LibrarySystemApplication' configuration in IntelliJ.