Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/crespo/locus-tryout

Tryout for Locus Custom Software
https://github.com/crespo/locus-tryout

Last synced: about 2 months ago
JSON representation

Tryout for Locus Custom Software

Awesome Lists containing this project

README

        

# Tryout for Locus Custom Software
This is a REST API with all the CRUD methods for the tables City and State.

Stack: Java, Spring Boot, JPA, Criteria API.
## Installation

### Requirements
- Java 11
- MySQL

### Creating database
Create an empty database named `tryout`
### Running the application
First clone the project to your machine using the following command on a terminal:
#### ```git clone https://github.com/crespo/locus-tryout.git```
Then you want to open the root folder:
#### ```cd locus-tryout/```
And finally run the API using the Maven Wrapper:
#### ```./mvnw spring-boot:run```
## Useful testing resources
##### Swagger UI link: http://localhost:9292/swagger-ui/index.html
##### Postman predefined requests: https://www.getpostman.com/collections/3d484a115ac63c1799dd
## Common issues
When executing the Maven Wrapper you can receive the following error:
#### ```Error: JAVA_HOME is not defined correctly.```
Make sure your JAVA_HOME is set one level above the bin/ folder of your Java installation, otherwise, this error will continue to happen.