Merge pull request 'Developer 역할 Spring 골격 smoke' (#4) from forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b into main

.forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b.md

@@ -0,0 +1,3 @@
+# role-developer-live-1522-001-attempt-1-run-6a48084c658b
+
+Forge 이슈 작업 브랜치 `forge/role-developer-live-1522-001-attempt-1-run-6a48084c658b`.

pom.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.5</version>
+        <relativePath/>
+    </parent>
+    <groupId>com.example</groupId>
+    <artifactId>demo</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>demo</name>
+    <description>Developer Role Spring Skeleton Application</description>
+    <properties>
+        <java.version>17</java.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+</project>

src/main/java/com/example/demo/DemoApplication.java

@@ -0,0 +1,12 @@
+package com.example.demo;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class DemoApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(DemoApplication.class, args);
+    }
+}

src/main/java/com/example/demo/controller/HelloController.java

@@ -0,0 +1,29 @@
+package com.example.demo.controller;
+
+import com.example.demo.service.HelloService;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/api/hello")
+public class HelloController {
+
+    private final HelloService helloService;
+
+    public HelloController(HelloService helloService) {
+        this.helloService = helloService;
+    }
+
+    @GetMapping
+    public ResponseEntity<String> greet() {
+        return ResponseEntity.ok(helloService.getGreeting());
+    }
+
+    @GetMapping("/{name}")
+    public ResponseEntity<String> greetWithName(@PathVariable String name) {
+        return ResponseEntity.ok(helloService.getGreetingFor(name));
+    }
+}

src/main/java/com/example/demo/service/HelloService.java

@@ -0,0 +1,21 @@
+package com.example.demo.service;
+
+import org.springframework.stereotype.Service;
+
+@Service
+public class HelloService {
+
+    private static final String GREETING_TEMPLATE = "Hello, %s!";
+    private static final String DEFAULT_GREETING = "Hello, World!";
+
+    public String getGreeting() {
+        return DEFAULT_GREETING;
+    }
+
+    public String getGreetingFor(String name) {
+        if (name == null || name.isBlank()) {
+            return DEFAULT_GREETING;
+        }
+        return String.format(GREETING_TEMPLATE, name);
+    }
+}

src/main/resources/application.properties

@@ -0,0 +1,2 @@
+spring.application.name=demo
+server.port=8080

src/test/java/com/example/demo/DemoApplicationTests.java

@@ -0,0 +1,15 @@
+package com.example.demo;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.TestPropertySource;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+@TestPropertySource(properties = {"spring.main.allow-bean-definition-overriding=true"})
+class DemoApplicationTests {
+
+    @Test
+    void contextLoads() {
+        // Smoke test: verify Spring context loads successfully
+    }
+}

src/test/java/com/example/demo/controller/HelloControllerTest.java

@@ -0,0 +1,48 @@
+package com.example.demo.controller;
+
+import com.example.demo.service.HelloService;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.mock.mockito.MockBean;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+@WebMvcTest(HelloController.class)
+@DisplayName("HelloController Unit Tests")
+class HelloControllerTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @MockBean
+    private HelloService helloService;
+
+    @Test
+    @DisplayName("GET /api/hello returns default greeting")
+    void greet_ReturnsDefaultGreeting() throws Exception {
+        when(helloService.getGreeting()).thenReturn("Hello, World!");
+
+        mockMvc.perform(get("/api/hello")
+                        .accept(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(content().string("Hello, World!"));
+    }
+
+    @Test
+    @DisplayName("GET /api/hello/{name} returns personalized greeting")
+    void greetWithName_ReturnsPersonalizedGreeting() throws Exception {
+        when(helloService.getGreetingFor("Developer")).thenReturn("Hello, Developer!");
+
+        mockMvc.perform(get("/api/hello/Developer")
+                        .accept(MediaType.APPLICATION_JSON))
+                .andExpect(status().isOk())
+                .andExpect(content().string("Hello, Developer!"));
+    }
+}

src/test/java/com/example/demo/service/HelloServiceTest.java

@@ -0,0 +1,55 @@
+package com.example.demo.service;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+@DisplayName("HelloService Unit Tests")
+class HelloServiceTest {
+
+    private HelloService helloService;
+
+    @BeforeEach
+    void setUp() {
+        helloService = new HelloService();
+    }
+
+    @Test
+    @DisplayName("getGreeting returns default greeting")
+    void getGreeting_ReturnsDefaultGreeting() {
+        String result = helloService.getGreeting();
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor returns personalized greeting")
+    void getGreetingFor_ReturnsPersonalizedGreeting() {
+        String result = helloService.getGreetingFor("Developer");
+        
+        assertNotNull(result);
+        assertEquals("Hello, Developer!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor with null returns default greeting")
+    void getGreetingFor_WithNull_ReturnsDefaultGreeting() {
+        String result = helloService.getGreetingFor(null);
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+
+    @Test
+    @DisplayName("getGreetingFor with blank string returns default greeting")
+    void getGreetingFor_WithBlankString_ReturnsDefaultGreeting() {
+        String result = helloService.getGreetingFor("   ");
+        
+        assertNotNull(result);
+        assertEquals("Hello, World!", result);
+    }
+}