[Spring] 페이지 반환

정적, 동적, @Controller, @RequestMapping

Spring에서 정적 및 동적 페이지 반환하기

Spring의 Model-View-Controller(MVC) 패턴을 활용하여, 정적 페이지와 동적 페이지를 어떻게 반환하는지 알아보자.

1. 정적 페이지 반환: 기본 에러 페이지 처리

Spring은 기본적으로 ErrorController를 통해 정적 에러페이지를 처리한다. 이때 특정 상태코드(404, 500 등)에 따라 정적 HTML파일을 반환할 수 있다. BasicErrorController라는 Spring의 기본 구현체를 통해, 사용자 정의 Controller 없이도 정적 에러페이지를 처리할 . 수있다.

 

@Controller
public class CustomErrorController implements ErrorController {

	@RequestMapping("/error")
    public String handleError(HttpServletRequest request) {
    	return "error"; // 정적 HTML 에러 페이지 반환
    }
}

 

2. 동적 페이지 반환: ModelAndView 사용

정적 페이지 반환과 달리, 동적 페이지는 ModelAndView 객체를 사용하여 상태 코드나 에러 메세지와 같은 데이터를 동적으로 페이지에 포함시킬 수 있다. 이는 페이지를 렌더링할 때 상황에 따라 모델 데이터를 추가하여 더 유연한 에러 처리가 가능하다.

@Controller // 해당 클래스가 Spring MVC의 컨트롤러 역할을 수행함을 나타낸다.
public class CustomErrorController implements ErrorController {
	
    // GET요청으로 /error 경로로 들어온 요청을 처리하는 메서드
    @RequestMapping(value = "/error", method = RequestMethod.GET)
    public ModelAndView handleError(HttpServletRequest request) {
    	// ModelAandVieww 객체 생성, View와 Model 데이터를 함께 반환할 수 있음.
        ModelAndView modelAndView = new ModelAndView();
        
        // 에러 상태 코드를 RequestDispatcher에서 가져온다.
        Object status = request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);
        
        // 상태 코드가 null이 아닌 경우 처리
        if (status != null) {
        	// 상태 코드를 Integer로 반환
            Integer statusCode = Integer.valueOf(status.toString());
            // 상태 코드가 404 (NOT_FOUND)인 경우
            if (statusCode == HttpStatus.NOT_FOUND.value()) {
            	// Model에 상태 코드 추가
                modelAndView.addObject("status", statusCode);
                // Model에 에러 이유 (Not Found) 추가
                modelAndView.addObject("reason", HttpStatus.NOT_FOUND.getReasonPhrase());
                
            // 상태 코드가 500 (INTERNAL_SERVER_ERROR)인 경우    
            } else if (statusCode == HttpStatus.INTERNAL_SERVER_ERROR.value()) {
            	// Model에 상태코드 추가
                modelAndView.addObject("status", statusCode);
                // Model에 에러 이유 (Internal Server Error) 추가
                modelAndView.addObject("reason", HttpStatus.INTERNAL_SERVER_ERROR.getReasonPhrase());
            }
        }
        
        // 반환할 View의 이름을 "error"로 설정, /resources/templates/error.html 파일을 찾음
        modelAndView.setViewName("error");
        // ModelAndView 객체를 반환하여 View와 Model 데이터르 함께 전달
        return modelAndView;
    }
}

 

3. 웹 페이지 반환: @Controller와 @RequestMapping

Spring에서 웹페이지 반환은 @Controller와 @RequestMapping을 통해 구현된다. 이때 요청 URL에 따라 특정 HTML 파일을 반환하도록 설정 할 수 있으며, 반환하는 문자열은 ViewTemplate을 지정한다.

@Controller
public class IndexController {
	
    @RequestMapping(method = RequestMethod.GET, value = "/")
    public String index() {
    	return "index"; // 반환할 ViewTemplate 지정
    }
}

• 해당 코드를 통해 / 경로로 들어오는 GET 요청에 대해 /resources/templates/index.html 파일이 반환된다.

4. @RequestMapping과 ViewTemplate 처리

@RequestMapping을 통해 HTTP메서드(GET,POST)와 URL 경로를 지정하고, 요청이 들어올 때 어떤 메서드가 실행될지를 정의한다.

반환하는 문자열은 Thymeleaft를 이용하여  ViewTemplate으로 해석되며, 지정된 경로의 HTML 파일을 반환한다.

@RequestMapping(value = "/", method = RequestMethod.GET)
public String index() {
	return "indext"; // index.html 반환
}

• 이 경우 Spring은 Thymeleaf를 통해 /resources/templates/index.html 파일을 찾아 반환한다.

---

ℹ️참고

[ASAC 6기 강의자료]