{"id":20365078,"url":"https://github.com/h3ar7b3a7/contactmanagerbackend","last_synced_at":"2026-04-22T05:33:38.919Z","repository":{"id":136744262,"uuid":"376148604","full_name":"H3AR7B3A7/ContactManagerBackend","owner":"H3AR7B3A7","description":"The back-end for a contact manager application, with Spring security.","archived":false,"fork":false,"pushed_at":"2021-07-25T11:54:26.000Z","size":102,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-25T17:51:16.229Z","etag":null,"topics":["mapstruct","postgres","rest-api","spring-security-jwt","swagger-ui"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/H3AR7B3A7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-11T21:45:12.000Z","updated_at":"2021-07-25T11:54:29.000Z","dependencies_parsed_at":"2023-07-14T12:47:20.601Z","dependency_job_id":null,"html_url":"https://github.com/H3AR7B3A7/ContactManagerBackend","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H3AR7B3A7%2FContactManagerBackend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H3AR7B3A7%2FContactManagerBackend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H3AR7B3A7%2FContactManagerBackend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/H3AR7B3A7%2FContactManagerBackend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/H3AR7B3A7","download_url":"https://codeload.github.com/H3AR7B3A7/ContactManagerBackend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241904719,"owners_count":20040021,"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":["mapstruct","postgres","rest-api","spring-security-jwt","swagger-ui"],"created_at":"2024-11-15T00:15:35.160Z","updated_at":"2026-04-22T05:33:33.869Z","avatar_url":"https://github.com/H3AR7B3A7.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Contact Manager\n\nThis is the backend for a simple contact manager application, with JWT authentication. The front-end can be\nfound [here](https://github.com/H3AR7B3A7/EarlyAngularProjects/tree/master/contacts).\n\n## JWT\n\nWe can decode our tokens at the [JWT Official Website](https://jwt.io/).\n\n## REST\n\nRepresentational state transfer ([REST](https://en.wikipedia.org/wiki/Representational_state_transfer)) is a style of\nsoftware architecture. As described in a dissertation by Roy Fielding, REST is an \"architectural style\" that basically\nexploits the existing technology and protocols of the Web.\n\n## RESTful\n\nOur service is RESTful when it adheres to the following principles:\n\n- It should be stateless\n- It should access all the resources from the server using only URI\n- It does not have inbuilt encryption\n- It does not have session\n- It uses one and only one protocol - HTTP\n- For performing CRUD operations, it should use HTTP verbs such as GET, POST, PUT, DELETE\n- It should return the result only in the form of JSON or XML, atom, OData etc. (lightweight data )\n\nWe can find an interesting post on RESTful design on stackoverflow\n[here](https://stackoverflow.com/questions/21863326/delete-multiple-records-using-rest).\n\n## Swagger\n\nWe can now just add the **springdoc-openapi-ui** dependency:\n\n```\n\u003cdependency\u003e\n     \u003cgroupId\u003eorg.springdoc\u003c/groupId\u003e\n     \u003cartifactId\u003espringdoc-openapi-ui\u003c/artifactId\u003e\n     \u003cversion\u003e1.5.9\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nAnd then for the UI just go to:\n\n- http://localhost:8080/swagger-ui.html\n\nFor the Json go to:\n\n- http://localhost:8080/v3/api-docs\n\nFor yaml:\n\n- http://localhost:8080/v3/api-docs.yaml\n\nThat's really all there is to it... No annotations / configuration needed.\n\nIf you are using **spring security**, make sure you can reach these paths for it to work:\n\n- /swagger-ui.html\n- /swagger-ui/**\n- /v3/api-docs/**\n\nWe can find more information [here](https://www.baeldung.com/spring-rest-openapi-documentation).\n\nWe can also create our own yaml. For that we can find an example [here](https://editor.swagger.io/).\n\n---\n*Work in progress ...*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh3ar7b3a7%2Fcontactmanagerbackend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh3ar7b3a7%2Fcontactmanagerbackend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh3ar7b3a7%2Fcontactmanagerbackend/lists"}