In this post, we would like to suggest a free open-source project that is Spring Petclinic developed using Spring Boot for learning purposes. So go ahead, check out the source code, and have a hands-on experience on real-time project.
Spring Petclinic project is an open-source and available on GitHub repository - https://github.com/RameshMF/spring-petclinic
Spring Boot Project - Spring Pet clinic
Running petclinic locally
Petclinic is a https://spring.io/guides/gs/spring-boot[Spring Boot] application built using https://spring.io/guides/gs/maven/[Maven]. You can build a jar file and run it from the command line:
git clone https://github.com/spring-projects/spring-petclinic.git
cd spring-petclinic
./mvnw package
java -jar target/*.jar
You can then access petclinic here: http://localhost:8080/
Database configuration
In its default configuration, Petclinic uses an in-memory database (HSQLDB) which gets populated at startup with data. A similar setup is provided for MySql in case a persistent database configuration is needed. Note that whenever the database type is changed, the app needs to be run with a different profile: spring.profiles.active=mysql
for MySql.
You could start MySql locally with whatever installer works for your OS, or with docker:
docker run -e MYSQL_ROOT_PASSWORD=petclinic -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:5.7.8
Working with Petclinic in your IDE
rerequisites
The following items should be installed in your system:
- Java 8 or newer.
- git command-line tool (https://help.github.com/articles/set-up-git)
- Your preferred IDE
- Eclipse with the m2e plugin. Note: when m2e is available, there is an m2 icon in Help -> About dialog. If m2e is not there, just follow the install process here: http://www.eclipse.org/m2e/
- Spring Tools Suite (STS)
- IntelliJ IDEA
Steps:
- On the command line
git clone https://github.com/spring-projects/spring-petclinic.git
- Inside Eclipse or STS
File -> Import -> Maven -> Existing Maven project
Then either build on the command line ./mvnw generate-resources
or using the Eclipse launcher (right-click on project and Run As -> Maven install
) to generate the css. Run the application main method by right-clicking on it and choosing Run As -> Java Application
.
- Inside IntelliJ IDEA
In the main menu, choose File -> Open
and select the Petclinic pom.xml. Click on the Open
button.
CSS files are generated from the Maven build. You can either build them on the command line ./mvnw generate-resources
or right-click on the spring-petclinic
project then Maven -> Generates sources and Update Folders
.
A run configuration named PetClinicApplication
should have been created for you if you're using a recent Ultimate version. Otherwise, run the application by right-clicking on the PetClinicApplication
main class and choosing Run 'PetClinicApplication'
.
- Navigate to Petclinic
Visit http://localhost:8080 in your browser.
Comments
Post a Comment