{"id":22863515,"url":"https://github.com/lahcenezzara/spring-boot-explorer","last_synced_at":"2026-05-07T06:37:40.254Z","repository":{"id":267898486,"uuid":"894744127","full_name":"LahcenEzzara/spring-boot-explorer","owner":"LahcenEzzara","description":"A simple Spring Boot project showcasing a \"Hello World\" endpoint with a friendly response. The project demonstrates the foundational structure of a Spring Boot web application, which can be expanded further.","archived":false,"fork":false,"pushed_at":"2024-12-13T04:50:13.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-13T05:24:43.136Z","etag":null,"topics":["api-development","backend-development","beginner-friendly","hello-world","java","java-17","maven","microservices","openjdk","rest-api","rest-controller","spring-boot","spring-boot-example","spring-boot-guide","spring-boot-project","spring-boot-starter","spring-framework","spring-tutorial","spring-web","web-application"],"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/LahcenEzzara.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":"2024-11-26T22:56:47.000Z","updated_at":"2024-12-13T04:50:17.000Z","dependencies_parsed_at":"2024-12-13T05:24:49.667Z","dependency_job_id":"974f2405-cd35-4c7a-9135-b80094c50ee6","html_url":"https://github.com/LahcenEzzara/spring-boot-explorer","commit_stats":null,"previous_names":["lahcenezzara/spring-boot-explorer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LahcenEzzara%2Fspring-boot-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LahcenEzzara%2Fspring-boot-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LahcenEzzara%2Fspring-boot-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LahcenEzzara%2Fspring-boot-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LahcenEzzara","download_url":"https://codeload.github.com/LahcenEzzara/spring-boot-explorer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237482200,"owners_count":19317282,"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":["api-development","backend-development","beginner-friendly","hello-world","java","java-17","maven","microservices","openjdk","rest-api","rest-controller","spring-boot","spring-boot-example","spring-boot-guide","spring-boot-project","spring-boot-starter","spring-framework","spring-tutorial","spring-web","web-application"],"created_at":"2024-12-13T11:16:05.269Z","updated_at":"2026-05-07T06:37:40.221Z","avatar_url":"https://github.com/LahcenEzzara.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spring Boot Explorer\n\nA simple Spring Boot application that demonstrates a \"Hello World\" endpoint with a customizable message. This project is designed to be beginner-friendly and serves as a foundation for exploring Spring Boot features.\n\n---\n\n## 🚀 **Features**\n- A RESTful `/hello` endpoint.\n- Returns a friendly greeting message.\n- Option to customize the greeting using a query parameter.\n\n---\n\n## 🛠️ **Technologies Used**\n- **Java 17** (OpenJDK)\n- **Spring Boot** (Latest version)\n- **Maven** (Build tool)\n- **IntelliJ IDEA** (Development environment)\n\n---\n\n## 📂 **Project Structure**\n```plaintext\nsrc/main/java/com/lahcencodes/springbootexplorer/\n├── SpringBootExplorerApplication.java  # Main application file\n```\n\n---\n\n## 🌐 **Endpoints**\n\n### **Hello Endpoint**\n- **URL:** `http://localhost:8080/hello`\n- **Method:** `GET`\n- **Description:** Returns a greeting message.\n- **Query Parameter:**\n    - `name` (optional): Customize the name in the greeting message.\n\n#### Example Requests:\n1. Default greeting:\n   ```bash\n   curl http://localhost:8080/hello\n   ```\n   **Response:**\n   ```json\n   Hello World!\n   ```\n\n2. Custom greeting:\n   ```bash\n   curl http://localhost:8080/hello?name=Lahcen\n   ```\n   **Response:**\n   ```json\n   Hello Lahcen!\n   ```\n\n---\n\n## ⚡ **Getting Started**\n\n### Prerequisites\nEnsure you have the following installed:\n1. **Java 17** (OpenJDK 17)\n2. **Maven** (for building the project)\n3. **Git** (for cloning the repository)\n\n---\n\n### **Steps to Run**\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/LahcenEzzara/spring-boot-explorer.git\n   cd spring-boot-explorer\n   ```\n\n2. **Build the Application**\n   ```bash\n   ./mvnw clean install\n   ```\n\n3. **Run the Application**\n   ```bash\n   ./mvnw spring-boot:run\n   ```\n\n4. Open your browser or API testing tool and navigate to:\n    - [http://localhost:8080/hello](http://localhost:8080/hello)\n\n---\n\n## 🧪 **Testing the Application**\n\n### Using `curl`\n1. Default greeting:\n   ```bash\n   curl http://localhost:8080/hello\n   ```\n\n2. Custom greeting:\n   ```bash\n   curl http://localhost:8080/hello?name=LahcenCodes\n   ```\n\n### Using Postman\n1. Create a new GET request.\n2. Enter the URL: `http://localhost:8080/hello`.\n3. Add a query parameter (optional): `name=LahcenCodes`.\n4. Send the request.\n\n---\n\n## 🔧 **Stopping the Server**\n\n1. **If running in the foreground**:\n   Press **`Ctrl + C`** to terminate the application.\n\n2. **If running in the background**:\n   Find the process:\n   ```bash\n   ps aux | grep java\n   ```\n   Kill the process:\n   ```bash\n   kill \u003cPID\u003e\n   ```\n\n---\n\n## 📜 **License**\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🛡️ **Support**\nIf you have any questions or need help, feel free to contact me via [GitHub](https://github.com/LahcenEzzara).\n\nHappy coding! 🎉","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flahcenezzara%2Fspring-boot-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flahcenezzara%2Fspring-boot-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flahcenezzara%2Fspring-boot-explorer/lists"}