{"id":28243971,"url":"https://github.com/ololx/restful-test-instances","last_synced_at":"2026-04-10T00:33:04.601Z","repository":{"id":44765475,"uuid":"256679558","full_name":"ololx/restful-test-instances","owner":"ololx","description":"This is a multimodule java projects with simple samples of the testing the restful service","archived":false,"fork":false,"pushed_at":"2023-07-07T21:56:57.000Z","size":205,"stargazers_count":1,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-19T07:08:15.264Z","etag":null,"topics":["docker","docker-compose","h2-database","hibernate","jpa-repository","junit","junit4","maven","maven-surefire-plugin","mock-mvc","mockito","postgresql","spring","spring-boot","spring-boot-2","spring-data-jpa","test-containers","unit-testing"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ololx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-18T05:48:49.000Z","updated_at":"2024-12-09T09:55:45.000Z","dependencies_parsed_at":"2022-09-03T03:01:56.908Z","dependency_job_id":null,"html_url":"https://github.com/ololx/restful-test-instances","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Frestful-test-instances","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Frestful-test-instances/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Frestful-test-instances/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Frestful-test-instances/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ololx","download_url":"https://codeload.github.com/ololx/restful-test-instances/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ololx%2Frestful-test-instances/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259124191,"owners_count":22808887,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","h2-database","hibernate","jpa-repository","junit","junit4","maven","maven-surefire-plugin","mock-mvc","mockito","postgresql","spring","spring-boot","spring-boot-2","spring-data-jpa","test-containers","unit-testing"],"created_at":"2025-05-19T07:08:13.588Z","updated_at":"2025-12-30T20:18:16.688Z","avatar_url":"https://github.com/ololx.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# restful-test-instances\n\nThis project presents a several examples of the tests usage in relation to a spring rest service grouped by modules. Each module presents a small simple test instance of the rest service layer.\n\n[![status](https://img.shields.io/badge/status-active-active?style=flat-square)](BADGES_GUIDE.md#status) [![last commit](https://img.shields.io/badge/last_commit-March_20,_2021-informational?style=flat-square)](BADGES_GUIDE.md#commit-date)\n\n[![license](https://img.shields.io/badge/license-MIT-informational?style=flat-square)](LICENSE)\n\n---\n\n## 📇 Table of Contents\n\n- [About](#about)\n- [Features](#feature)\n- [Getting Started](#getting-started)\n- [Built With](#built-with)\n- [Authors](#authors)\n- [Licensing](#licensing)\n\n##  📖 About\n\nThis is a collection of small and focused instances - each covering a single and well defined approach in the area of the java application development grouped by modules. Each module is supposed to provide a separate simple instance.\nIn this project each module presents a small simple instance of the unit test for the one java technology.\nFor instance, configuration files, db layer tests, service layer tests, controller layser tests and integration tests.\nA strong focus of these is, of course, the different test approaches of the `spring-boot` RESTful API.\n\n### Modules\n\nThis project includes the follows modules:\n\n- [restful-test-instances-organisations](organisations/README.md) - this module is a simple `spring-boot` RESTful API which provides the create/read/update/delete operations for the manipulating `organization` entities;\n- [restful-test-instances-db-local-test](db-local-test/README.md) - this module presents unit tests of the API model layer. For this tests is used the local database;\n- [restful-test-instances-db-embedded-test](db-embedded-test/README.md) - this module presents unit tests of the API model layer. For this tests is used the embedded H2 database;\n- [restful-test-instances-db-testcontainers-test](db-testcontainers-test/README.md) - this module presents unit tests of the API model layer. For this tests is used the postgreSQL  database on the docker container;\n- [restful-test-instances-service-test](service-test/README.md) - this module presents unit tests of the API service layer;\n\n## 🎚 Features\n\n- The simple RESTful API which provides to create/read/update/delete operations. \n- A tests for the RESTful API part grouped by modules.\n\n### To Do\n\n- For more information on an upcoming development, please read the [todo](TODO.md) list.\n\n### Changelog\n\n- For more information on a releases, a features and a changes, please read the [changelog](CHANGELOG.md) notes.\n\n## 🚦 Getting Started\n\nThese instructions allow to get a copy of this project and run it on a local machine. \n\n### Prerequisites\n\nBefore using it, make sure that follows software are installed on the local machine:\n\n- **[Oracle JDK 8+](https://www.oracle.com/java/technologies/javase-downloads.html)** -  java development kit;\n- **[Maven 3+](https://maven.apache.org/)** - dependency management;\n- **[Docker Compose](https://docs.docker.com/compose/)** - tool for defining and running multi-container `Docker` applications.\n\nIf any of the listed software is not installed, then it can be installed by instruction as described below.\n\n1. #### Oracle JDK 8+\n\n   - Install Oracle JDK 8+ according to instructions from an [official](https://www.oracle.com/java/technologies/javase-downloads.html) instruction.\n\n2. #### Maven 3+\n\n   - Install Maven 3+ according to instructions from an [official](https://maven.apache.org/) source.\n\n4. #### Docker Compose\n\n   - Install PostgreSQL 9+ according to instructions from an [official](https://docs.docker.com/compose/install/) source.\n\n### Installing\n\nIn order to install it is quite simple to clone or download this repository.\n\n### Cloning\n\nFor the cloning this repository to a local machine, just use the follows link:\n\n```http\nhttps://github.com/ololx/restful-test-instances\n```\n\n### Using\n\nTo use it is necessary to:\n1 - To deploy the additional software.\n2 - To build the project.\n3 - To launch the instances.\n\n### Deploy the additional software\n\n1 - To do the deployment of the additional software, execute docker compose in the root directory by the following command:\n\n```bash\ndocker-compose up\n```\n\n2 - Wait for all software deployment to complete.\n\n### Building the project\n\nTo do the full build, execute maven goal `install` in the root directory by the following command:\n\n```bash\nmvn clean install\n```\n\n### Building a single module\n\nTo do the full build, execute maven goal `install` in the module directory by the following command:\n\n```bash\nmvn clean install\n```\n\n### Launching in command line\n\nTo do the full tests examples, execute maven goal `test` in the module directory by the following command:\n\n```bash\nmvn test\n```\n\n### Launching in IDE\n\nThis is a multi-module project. Each model is supposed to provide a separate example. \nThat's why when  you're working with an individual module, there's no need to import all of them (or build all of them) - you can simply import that particular module in either Eclipse, NetBeanse or IntelliJ IDEA and run each example  in IDE.\n\n## 🛠 Built With\n\n- **[Oracle JDK](https://www.oracle.com/java/technologies/javase-downloads.html)** -  java development kit;\n- **[Maven](https://maven.apache.org/)** - dependency management;\n- **[PostgreSQL 9+](https://www.postgresql.org/download/)** - database management system;\n- **[Docker Compose](https://docs.docker.com/compose/)** - tool for defining and running multi-container `Docker` applications.\n\n## ©️ Authors\n\n* **Alexander A. Kropotin** - *project work* - [ololx](https://github.com/ololx).\n\n## 🔏 Licensing\n\nThis project is licensed under the MIT license - see the [lisence](LICENSE) document for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fololx%2Frestful-test-instances","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fololx%2Frestful-test-instances","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fololx%2Frestful-test-instances/lists"}