이전 글들에서 MVC를 손수 만들었었는데, 이는 결국 스프링 내장 MVC와 매우 유사한 구조이다.
FrontController -> DispatcherServlet
handlerMappingMap -> HandlerMapping
MyHandlerAdapter -> HandlerAdapter
ModelView -> ModelAndView
viewResolver -> ViewResolver
MyView -> View
DispatchServlet은 부모클래스 FrameworkServlet(HttpServlet)을 상속해서 사용한다.
스프링 부트는 DispatchServlet을 서블릿으로 자동으로 등록하면서, 모든 경로를 매핑한다.
만약 이때, 기존에 등록한 서블릿이 있다면, 자세한 쪽이 우선순위를 가진다.
protected void doDispatch(HttpServletRequest request, HttpServletResponse
response) throws Exception {
HttpServletRequest processedRequest = request;
HandlerExecutionChain mappedHandler = null;
ModelAndView mv = null;
// 1. 핸들러 조회
mappedHandler = getHandler(processedRequest);
if (mappedHandler == null) {noHandlerFound(processedRequest, response);
return;
}
// 2. 핸들러 어댑터 조회 - 핸들러를 처리할 수 있는 어댑터
HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
// 3. 핸들러 어댑터 실행 -> 4. 핸들러 어댑터를 통해 핸들러 실행 -> 5. ModelAndView 반환
mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
processDispatchResult(processedRequest, response, mappedHandler, mv,
dispatchException);
}
private void processDispatchResult(HttpServletRequest request,
HttpServletResponse response, HandlerExecutionChain mappedHandler, ModelAndView
mv, Exception exception) throws Exception {
// 뷰 렌더링 호출
render(mv, request, response);
}
protected void render(ModelAndView mv, HttpServletRequest request,
HttpServletResponse response) throws Exception {
View view;
String viewName = mv.getViewName();
// 6. 뷰 리졸버를 통해서 뷰 찾기, 7. View 반환
view = resolveViewName(viewName, mv.getModelInternal(), locale, request);
// 8. 뷰 렌더링
view.render(mv.getModelInternal(), request, response);
핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.
핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다.
ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
viewResolver 호출: 뷰 리졸버를 찾고 실행한다.
JSP의 경우: InternalResourceViewResolver 가 자동 등록되고, 사용된다.
View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다.
JSP의 경우 InternalResourceView(JstlView) 를 반환하는데, 내부에 forward() 로직이 있다.
뷰 렌더링: 뷰를 통해서 뷰를 렌더링 한다.
@Component("/springmvc/old/old-controller")
public class OldController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
System.out.println("OldController.handleRequest");
return null;
}
}
이런 코드가 있다고 할때,
http://localhost:8080/springmvc/old/old-controller 이 주소로 들어가면, 이 컨트롤러가 호출되는것을 알 수 있다.
왜 호출이 되는걸까?
이 컨트롤러가 호출되려면 두가지가 필요하다.
스프링에서는 이미 필요한 핸들러 매핑과 어댑터가 있다. 따라서 따로 만들필요는 없다.
0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.
0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용) 처리
보통은 0순위를 쓰지만, 이 예제에서는 마지막 순위를 사용한다.
이번에는 HttpRequestHandler를 써보도록 하겠다.
http://localhost:8080/springmvc/request-handler
@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {
@Override
public void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
System.out.println("MyHttpRequestHandler.handleRequest");
}
}
핸들러 매핑으로 조회
빈 이름으로 돌려주는 BeanNameUrlHandlerMapping이 실행되어야 한다.
핸들러 어댑터 조회
supprot를 통해서 HttpRequestHandler가 지원대상이 된다.
핸들러 어뎁터 실행
조회한 HttpRequestHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
HttpRequestHandlerAdapter 는 핸들러인 MyHttpRequestHandler 를 내부에서 실행하고, 그 결과를
반환한다.
하지만 보통 개발할때는 @Annotation 방식을 쓰기때문에, 이 방식들은 거의 사용되지 않는다.
위 상태에서 return값에 view jsp이름을 넣어준다고 하자
@Component("/springmvc/old/old-controller")
public class OldController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
System.out.println("OldController.handleRequest");
return new ModelAndView("new-form");
}
}
이상태로 실행해보면, whitelabel 오류가 발생한다. 이는 viewResolver가 없어서 view를 찾을 수 없기 때문이다.
이를 해결하기 위해선, application.properties를 수정해야한다.
logging.level.org.apache.coyote.http11=debug
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
이렇게 수정하면
뷰 리졸버가 정상작동해서 new-form.jsp 뷰를 찾아오는것을 알 수 있다.
물론 이 밖에도 직접 Application에 ServletComponentScan으로 등록하고 직접 뷰 리졸버를 해줘도 되지만 권장되고있지 않다.
1 = BeanNameViewResolver : 빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성 기능에 사용)
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환한다.
위의 예제에서 new-form이라는 이름의 뷰는 스프링 빈에 등록이 따로 되어있지 않았기에, 1번 기능이 작동하지 않고, 2번 기능이 작동하였다.
@RequestMapping
가장 우선순위가 높은 매핑과 어댑터를 사용하고 있다.
@Controller
public class SpringMemberFormControllerV1 {
@RequestMapping("/springmvc/v1/members/new-form")
public ModelAndView process() {
return new ModelAndView("new-form");
}
}
@Controller
@RequestMapping
ModelAndView Process
@Controller
public class SpringMemberSaveControllerV1 {
private MemberRepository memberRepository = MemberRepository.getInstance();
@RequestMapping("/springmvc/v1/members/save")
ModelAndView process(HttpServletRequest request, HttpServletResponse response) {
String username = request.getParameter("username");
int age = Integer.parseInt(request.getParameter("age"));
Member member = new Member(username, age);
memberRepository.save(member);
ModelAndView mv = new ModelAndView("save-result");
mv.addObject("member", member);
return mv;
}
}
이런식으로 save, list도 구현할 수 있다.
리퀘스트 매핑은 메서드 단위로 작동한다. 따라서 기존의 흩어져있던 컨트롤러들은 한페이지에 전부 작성하는것도 가능하다.
또한 RequestMapping URL에서 중복되는 부분을 제거할 수 있다.
@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {
private MemberRepository memberRepository = MemberRepository.getInstance();
@RequestMapping("/new-form")
public ModelAndView newForm() {}
@RequestMapping("/save")
ModelAndView save(HttpServletRequest request, HttpServletResponse response) {}
@RequestMapping
public ModelAndView members() {}
}
실무적인 방식이다.
@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {
private MemberRepository memberRepository = MemberRepository.getInstance();
@RequestMapping("/new-form")
public String newForm() {
return "new-form";
}
@RequestMapping("/save")
public String save(@RequestParam("username") String username, @RequestParam("age") int age, Model model) {
Member member = new Member(username, age);
memberRepository.save(member);
model.addAttribute("member", member);
return "save-result";
}
@RequestMapping
public String members(Model model) {
List<Member> members = memberRepository.findAll();
model.addAttribute("members", members);
return "members";
}
}
굳이 모델앤뷰로 넘기지 않고 String으로 그냥 넘길 수 있다.
Map, request로 받지 않고 인자에서 직접
@RequestParam("username") String username, @RequestParam("age") int age, Model model)
을 통해 필요한것을 받아낼 수 있다.
호출한 모델에 attribute를 넣을 수 있는 함수이다.
지정되지 않은 방식으로 HTTP가 오면 이를 거절 할 수 있다.
@RequestMapping(value = "/new-form", method = RequestMethod.GET)
@RequestMapping(value = "/save", method = RequestMethod.POST)
@RequestMapping(method = RequestMethod.GET)
혹은, 아예 GetMapping, PostMapping같은 기능을 쓸 수도 있다.
@GetMapping(value = "/new-form")
@PostMapping(value = "/save")
@GetMapping