Response

/** * 🟢🟡🔴 @RestController * : JSON 또는 XML과 같은 데이터를 반환하는 컨트롤러를 지정하는 어노테이션 * 🔵 RESTful 웹 서비스를 생성하는 데 사용 * 🔵 @Controller 와 @ResponseBody를 합한 역할을 하는 어노테이션 * ✔ @Controller ➡ View를 반환 * ✔ @RestController ➡ 응답 데이터(메시지[상태코드,응답헤더,응답본문(body)])를 반환 */ @Slf4j @RestController public class ResponseController { }

/** * 🚀 void * - 어떤 작업을 수행하고 응답이 필요 없는 경우 * ✅ 상태코드 : 200 OK * ✅ body : ❌ */ @GetMapping("/void") public void voidResponse() { log.info("[GET] - /void"); }

/** * 🚀 String * - 반환하는 문자열로, HTTP 응답의 본문(body)에 지정한다. * ✅ 상태코드 : 200 OK * ✅ body : "문자열 데이터를 응답합니다." */ @GetMapping("/string") public String stringResponse() { log.info("[GET] - /string"); return "문자열 데이터를 응답합니다."; }

/** * 🚀 객체 * - 객체를 JSON 형식으로 변환하고, 이를 HTTP 응답 본문에 지정한다. * ✅ 상태코드 : 200 OK * ✅ body : {"boardNo":0,"title":"제목1","writer":"작성자1","content":"내용1","regDate":null,"updDate":null,"views":0} * @return */ @GetMapping("/object") public Board objectResponse() { log.info("[GET] - /object"); Board board = new Board("제목1", "작성자1", "내용1"); return board; }

/** * 🚀 컬렉션 * - 컬렉션을 JSON 배열 형식으로 변환하고, 이를 HTTP 응답 본문에 지정한다. * ✅ 상태코드 : 200 OK * ✅ body : [{"boardNo":0,"title":"제목1","writer":"작성자1","content":"내용1","regDate":null,"updDate":null,"views":0},{"boardNo":0,"title":"제목2","writer":"작성자2","content":"내용2","regDate":null,"updDate":null,"views":0},{"boardNo":0,"title":"제목3","writer":"작성자3","content":"내용3","regDate":null,"updDate":null,"views":0}] * @return */ @GetMapping("/collection") public List<Board> collectionResponse() { log.info("[GET] - /collection"); List<Board> boardList = new ArrayList<>(); boardList.add(new Board("제목1", "작성자1", "내용1")); boardList.add(new Board("제목2", "작성자2", "내용2")); boardList.add(new Board("제목3", "작성자3", "내용3")); return boardList; }

/** * 🚀 Map<String, ?> * - Map 컬렉션을 JSON 형식으로 변환하여, * key 에 대한 value 로 다양한 객체들을 계층적인 구조로 HTTP 응답 본문에 지정한다. * ✅ 상태코드 : 200 OK * ✅ body : {"student":{"name":"김조은","age":20,"studentId":1001,"grade":"1"},"person":{"name":"김조은","age":20},"board":{"boardNo":0,"title":"제목","writer":"작성자","content":"내용","regDate":null,"updDate":null,"views":0}} * @return */ @GetMapping("/map") public Map<String, ?> mapResponse() { log.info("[GET] - /map"); Map<String, Object> map = new HashMap<>(); map.put("board", new Board("제목", "작성자", "내용")); map.put("person", new Person()); map.put("student", new Student()); return map; }

/** * 🚀 ResponseEntity<⚡> * : ResponseEntity 객체를 사용하면, "상태코드/헤더/본문"을 지정하여 응답할 수 있다. * ✅ <⚡> 타입 매개변수에 응답할 데이터의 타입을 지정할 수 있다. * - String, Object, Collection 등 지정 가능 * - ? 와일드 카드로 지정하면, 특정하지 않고 상황에 따라 동적으로 처리 가능 * * 1️⃣ 상태코드 : ok(), badRequest(), created(URI), status() * ✔ HttpStatus 응답 상태 코드를 가지고 있는 enum (열거타입) * * 2️⃣ 헤더 : ResponseEntity.1️⃣.header("헤더 명", "헤더 값") * * 3️⃣ 본문⭕ : ResponseEntity.1️⃣.body( data ) * ResponseEntity.1️⃣.2️⃣.body( data ) * * 4️⃣ 본문❌ : ResponseEntity.1️⃣.build( data ) * ResponseEntity.1️⃣.2️⃣.build( data ) * @return */ @GetMapping("/responseString") public ResponseEntity<String> responseEntityResponse() { log.info("[GET] - /responseString"); // 🟢 요청 성공 // - 상태코드: 200 // - body :"200 OK - 요청 성공" // return ResponseEntity.ok("200 OK - 요청 성공"); // 🟠 잘못된 요청 - 상태코드 // - 상태코드: 400 // - body :"400 Bad Request - 잘못된 요청" // return ResponseEntity.badRequest().body("400 Bad Request - 잘못된 요청"); // 🔴 서버 에러 // - 상태코드: 500 // - body :"500 Internal Server Error - 서버 내부 에러" // return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("500 Internal Server Error - 서버 내부 에러"); return ResponseEntity.ok("200 OK - 요청 성공"); }

/** * 🚀 ResponseEntity<byte[]> * @return * @throws IOException */ @GetMapping("/img") public ResponseEntity<byte[]> thumbnailImg() throws IOException { log.info("[GET] - /img"); // 이미지 파일을 읽어옴 ClassPathResource imgFile = new ClassPathResource("sample.png"); byte[] bytes = Files.readAllBytes(imgFile.getFile().toPath()); // 이미지 파일을 읽어서 응답 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.IMAGE_PNG); return new ResponseEntity<>(bytes, headers, HttpStatus.OK); }

/** * 🚀 ResponseEntity<byte[]> * @return * @throws IOException */ @GetMapping("/download") public ResponseEntity<byte[]> download() throws IOException { log.info("[GET] - /download"); // 이미지 파일을 읽어옴 ClassPathResource imgFile = new ClassPathResource("sample.png"); byte[] bytes = Files.readAllBytes(imgFile.getFile().toPath()); // 파일을 다운로드 받도록 응답 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_OCTET_STREAM); headers.setContentDispositionFormData("attachment", "sample.png"); return new ResponseEntity<>(bytes, headers, HttpStatus.OK); }

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

@GetMapping("/200") public ResponseEntity<String> ok() { log.info("[GET] - /200 - 서버가 클라이언트의 요청을 성공적으로 처리했을 때 응답하는 상태코드 입니다."); return ResponseEntity.ok("서버가 클라이언트의 요청을 성공적으로 처리했을 때 응답하는 상태코드 입니다."); }

@GetMapping("/201") public ResponseEntity<String> created() { log.info("[GET] - /200 - 서버가 새로운 리소스를 성공적으로 생성 했을 때 응답하는 상태코드입니다."); return ResponseEntity.status(HttpStatus.CREATED).body("서버가 새로운 리소스를 성공적으로 생성 했을 때 응답하는 상태코드입니다."); }

@GetMapping("/400") public ResponseEntity<String> badRequest() { log.info("[GET] - /400 - 클라이언트 요청이 잘못됨을 알려주는 상태코드입니다."); return ResponseEntity.badRequest().body("클라이언트 요청이 잘못됨을 알려주는 상태코드입니다."); }

@GetMapping("/403") public ResponseEntity<String> forbidden() { log.info("[GET] - /403 - 클라이언트가 자원 접근에 거부되었음을 알려주는 상태코드입니다. (주로 권한이 없을 때, 응답하는 상태코드입니다.)"); return ResponseEntity.status(HttpStatus.FORBIDDEN).body("클라이언트가 자원 접근에 거부되었음을 알려주는 상태코드입니다. (주로 권한이 없을 때, 응답하는 상태코드입니다.)"); }

@GetMapping("/404") public ResponseEntity<String> notFound() { log.info("[GET] - /404 - 클라이언트가 요청한 리소스가 서버에 없거나, 요청한 경로가 존재하지 않을 때 응답하는 상태코드 입니다."); return ResponseEntity.status(HttpStatus.NOT_FOUND).body("클라이언트가 요청한 리소스가 서버에 없거나, 요청한 경로가 존재하지 않을 때 응답하는 상태코드 입니다."); }

@GetMapping("/500") public ResponseEntity<String> internalServerError() { log.info("[GET] - /500 - 서버 측에서 에러나 예외가 발생했을 때 응답하는 상태코드 입니다."); return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("서버 측에서 에러나 예외가 발생했을 때 응답하는 상태코드 입니다."); }

/** * 게시글 쓰기 처리 * [POST] * /board/insert * model : ❌ * @param board * @return * @throws Exception */ @PostMapping(value="/insert") public String insertPro(@ModelAttribute Board board) throws Exception { // @ModelAttribute : 모델에 자동으로 등록해주는 어노테이션 // 데이터 처리 int result = new Random().nextInt(2); // 게시글 쓰기 실패 ➡ 게시글 쓰기 화면 if( result == 0 ) return "redirect:/board/insert"; // 뷰 페이지 지정 return "redirect:/board/list"; }

/** * 게시글 수정 처리 * [POST] * /board/update * model : board * @param board * @return * @throws Exception */ @PostMapping(value="/update") public String updatePro(Board board) throws Exception { // 데이터 처리 int result = new Random().nextInt(2); int boardNo = board.getBoardNo(); // 게시글 수정 실패 ➡ 게시글 수정 화면 if( result == 0 ) return "redirect:/board/update?boardNo=" + boardNo; // 뷰 페이지 지정 return "redirect:/board/list"; }

/** * 게시글 삭제 처리 * [POST] * /board/delete * model : ❌ * @param boardNo * @return * @throws Exception */ @PostMapping(value="/delete") public String deletePro(int boardNo) throws Exception { // 데이터 처리 int result = new Random().nextInt(2); // 게시글 삭제 실패 ➡ 게시글 수정 화면 if( result == 0 ) return "redirect:/board/update?boardNo=" + boardNo; // 뷰 페이지 지정 return "redirect:/board/list"; }

/** * 🚀 ResponseEntity<byte[]> * @return * @throws IOException */ @GetMapping("/img") public ResponseEntity<byte[]> thumbnailImg() throws IOException { log.info("[GET] - /img"); // 이미지 파일을 읽어옴 ClassPathResource imgFile = new ClassPathResource("sample.png"); byte[] bytes = Files.readAllBytes(imgFile.getFile().toPath()); // 이미지 파일을 읽어서 응답 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.IMAGE_PNG); return new ResponseEntity<>(bytes, headers, HttpStatus.OK); }

/** * 이미지 썸네일 * @param filePath * @param response * @throws Exception */ @GetMapping("/img") public void showImg(String filePath ,HttpServletResponse response ) throws Exception { log.info("filePath : " + filePath); File file = new File(filePath); FileInputStream fis = new FileInputStream(file); ServletOutputStream sos = response.getOutputStream(); FileCopyUtils.copy(fis, sos); // filePath : C:/KHM/upload/[UID]_강아지.png // 이미지 컨텐트 타입 확인 ( .jpg, .png, .gif, ... ) String ext = filePath.substring( filePath.lastIndexOf(".") + 1 ); // 확장자 MediaType mType = MediaUtil.getMediaType(ext); // 이미지 타입이 아닐 경우 if( mType == null ) { return; } log.info("mType : " + mType); response.setContentType( mType.toString() ); }

/** * 확장자로 컨텐트타입 매핑 * @author h * */ public class MediaUtil { private static Map<String, MediaType> mediaType; static { mediaType = new HashMap<String, MediaType>(); mediaType.put("JPG", MediaType.IMAGE_JPEG); mediaType.put("JPEG", MediaType.IMAGE_JPEG); mediaType.put("GIF", MediaType.IMAGE_GIF); mediaType.put("PNG", MediaType.IMAGE_PNG); mediaType.put("WEBP", MediaType.parseMediaType("img/webp") ); // MediaType.IMAGE_WEBP 상수는 존재하지 않음 } // 확장자로 컨텐트타입을 확인하는 메소드 public static MediaType getMediaType(String ext) { return mediaType.get(ext.toUpperCase()); } }

/** * 🚀 ResponseEntity<byte[]> * @return * @throws IOException */ @GetMapping("/img") public ResponseEntity<byte[]> thumbnailImg() throws IOException { log.info("[GET] - /img"); // 이미지 파일을 읽어옴 ClassPathResource imgFile = new ClassPathResource("sample.png"); byte[] bytes = Files.readAllBytes(imgFile.getFile().toPath()); // 이미지 파일을 읽어서 응답 HttpHeaders headers = new HttpHeaders(); headers.setContentType(MediaType.IMAGE_PNG); return new ResponseEntity<>(bytes, headers, HttpStatus.OK); }

/** * 파일 다운로드 * @param fileNo * @param response * @throws Exception */ @GetMapping("/{fileNo}") public void fileDownload(@PathVariable("fileNo") int fileNo ,HttpServletResponse response) throws Exception { // 파일 조회 Files file = fileService.read(fileNo); // 파일이 존재하지 않으면, if( file == null ) { // 응답 상태코드 : 400, 클라이언트의 요청이 잘못되었음을 나타내는 상태코드 response.setStatus(response.SC_BAD_REQUEST); return; } String fileName = file.getFileName(); // 파일 명 String filePath = file.getFilePath(); // 파일 경로 // 파일 다운로드를 위한 헤더 세팅 // - ContentType : application/octet-straem // - Content-Disposition : attachment; fileanme="파일명.확장자" response.setContentType("application/octet-stream"); response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\""); // 파일 입력 File downloadFile = new File(filePath); FileInputStream fis = new FileInputStream(downloadFile); ServletOutputStream sos = response.getOutputStream(); // 다운로드 FileCopyUtils.copy(fis, sos); }