feat: add swagger annotation in api

Author: junseokkim

src/main/java/com/cloudcomputing/ohhanahana/controller/PersonController.java

@@ -2,8 +2,9 @@
 
 import com.cloudcomputing.ohhanahana.entity.Person;
 import com.cloudcomputing.ohhanahana.repository.PersonRepository;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import java.util.List;
-import lombok.RequiredArgsConstructor;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -14,35 +15,41 @@
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(name = "Person API", description = "Person 관련 API")
 @RestController
 @RequestMapping("/persons")
 public class PersonController {
 
     @Autowired
     private PersonRepository personRepository;
 
+    @Operation(summary = "Person 저장 API", description = "Person을 저장하는 API입니다.")
     @PostMapping
     public Person save(@RequestBody Person person) {
 
         return personRepository.save(person);
     }
 
+    @Operation(summary = "Person 조회 API", description = "Person을 조회하는 API입니다.")
     @GetMapping("/{id}")
     public Person findById(@PathVariable(value = "id") String id) {
         return personRepository.findById(id);
     }
 
+    @Operation(summary = "Person 전체 조회 API", description = "Person 전체를 조회하는 API입니다.")
     @GetMapping("/all")
     public List<Person> findAll() {
         return personRepository.findAll();
     }
 
+    @Operation(summary = "Person 수정 API", description = "Person을 수정하는 API입니다.")
     @PutMapping("/{id}")
     public String update(@PathVariable(value="id") String id,
     @RequestBody Person person) {
         return personRepository.update(id, person);
     }
 
+    @Operation(summary = "Person 삭제 API", description = "Person을 삭제하는 API입니다.")
     @DeleteMapping("/{id}")
     public String delete(@PathVariable(value="id") String id) {
         return personRepository.delete(id);

src/main/java/com/cloudcomputing/ohhanahana/controller/SensorDataController.java

@@ -2,25 +2,30 @@
 
 import com.cloudcomputing.ohhanahana.dto.response.SensorDataResponse;
 import com.cloudcomputing.ohhanahana.service.SensorDataService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.xml.bind.JAXBException;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+@Tag(name = "혼잡도 API", description = "혼잡도 관련 API")
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/congestion")
 public class SensorDataController {
 
     private final SensorDataService sensorDataService;
 
+    @Operation(summary = "혼잡도 조회 API", description = "혼잡도를 조회하는 API입니다.")
     @GetMapping("/")
     public ResponseEntity<Object> findTest() throws JAXBException {
         return ResponseEntity.ok(sensorDataService.findLatestSensorData());
     }
 
+    @Operation(summary = "혼잡도 랜덤 조회 API", description = "혼잡도를 랜덤으로 조회하는 API입니다.")
     @GetMapping("/random")
     public ResponseEntity<Object> findRandomSensorData() throws JAXBException {
         return ResponseEntity.ok(sensorDataService.generateRandomSensorData());