Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/ingogriebsch/sample-spring-data-jpa-testcontainers-utilization

This sample shows you how to utilize the Testcontainers usage with Spring Data JPA (and Spring Boot)
https://github.com/ingogriebsch/sample-spring-data-jpa-testcontainers-utilization

example java sample spring spring-boot spring-data spring-data-jpa testcontainers

Last synced: 6 days ago
JSON representation

This sample shows you how to utilize the Testcontainers usage with Spring Data JPA (and Spring Boot)

Host: GitHub
URL: https://github.com/ingogriebsch/sample-spring-data-jpa-testcontainers-utilization
Owner: ingogriebsch
License: apache-2.0
Created: 2018-10-17T11:59:46.000Z (about 6 years ago)
Default Branch: main
Last Pushed: 2023-06-14T22:43:58.000Z (over 1 year ago)
Last Synced: 2024-10-12T16:12:18.583Z (about 1 month ago)
Topics: example, java, sample, spring, spring-boot, spring-data, spring-data-jpa, testcontainers
Language: Java
Size: 119 KB
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Spring Data JPA Testcontainers utilization sample

[![Actions Status](https://github.com/ingogriebsch/sample-spring-data-jpa-testcontainers-utilization/workflows/build/badge.svg)](https://github.com/ingogriebsch/sample-spring-data-jpa-testcontainers-utilization/actions)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization&metric=alert_status)](https://sonarcloud.io/dashboard?id=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization&metric=coverage)](https://sonarcloud.io/dashboard?id=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization&metric=security_rating)](https://sonarcloud.io/dashboard?id=de.ingogriebsch.samples%3Asample-spring-data-jpa-testcontainers-utilization)

[![License](http://img.shields.io/:license-apache-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)

This sample shows how to utilize the Testcontainers usage with Spring Data JPA (and Spring Boot).

## How to build and run

If you want to see the implementation in action, simply follow these steps:

*   First, make sure that you have Java 8 or later installed and an established Internet connection.

*   Then, make sure that you have a Postgresql database up and running and configured in a way that the properties in the application.yml match (or change the properties to match against your environment).

*   Then, clone this Git repository an `cd` into the project folder.

*   Now invoke `./mvnw spring-boot:run` and wait a moment.

After the project is built and the Spring Boot service is running you have the following possibilities to act with the service:

*   [http://localhost:8080](http://localhost:8080) allows to access this site.

*   Access the administration tool of your database to realize the things that happened there.

## Most important annotations and classes

A collection of the most important annotations and classes that are necessary to implement this use case. 

*   [@GeneratedValue](https://javaee.github.io/javaee-spec/javadocs/javax/persistence/GeneratedValue.html)

*   [@Id](https://javaee.github.io/javaee-spec/javadocs/javax/persistence/Id.html)

*   [@Repository](https://docs.spring.io/spring-data/commons/docs/2.4.2/api/org/springframework/data/repository/Repository.html)

*   [@Transactional](https://docs.spring.io/spring-framework/docs/5.3.2/javadoc-api/org/springframework/transaction/annotation/Transactional.html)

*   [@DataJpaTest](https://docs.spring.io/spring-boot/docs/2.4.1/api/org/springframework/boot/test/autoconfigure/orm/jpa/DataJpaTest.html)

*   [@AutoConfigureTestDatabase](https://docs.spring.io/spring-boot/docs/2.4.1/api/org/springframework/boot/test/autoconfigure/jdbc/AutoConfigureTestDatabase.html)

*   [@ActiveProfiles](https://docs.spring.io/spring-framework/docs/5.3.2/javadoc-api/org/springframework/test/context/ActiveProfiles.html)

## Used frameworks

A collection of the mainly used frameworks in this project. 

There are more, but they are not that present inside the main use case, therefore they are not listed here.

*   [Testcontainers](https://www.testcontainers.org/modules/databases/)

*   [Spring Data JPA](https://docs.spring.io/spring-data/jpa/docs/2.4.2/reference/html/)

*   [Spring Boot](https://docs.spring.io/spring-boot/docs/2.4.1/reference/htmlsingle/)

## Additional guides

The following guides illustrate how to implement this and related use cases.

*   [How to obtain a temporary database](https://www.testcontainers.org/modules/databases/jdbc/)

*   [Accessing Data with JPA](https://spring.io/guides/gs/accessing-data-jpa/)

## License

This code is open source software licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0.html).