27. Model 추가 - v3

FrontController란?

- 웹 애플리케이션의 디자인 패턴 중 하나입니다

- 클라이언트 요청을 받고 처리하는 중앙 집중형 컨트롤러 입니다

- 이 패턴은 중복 코드를 최소화하고 유지보수성을 높이기 위해 사용됩니다

 

FrontController 역할

- 클라이언트 모든 요청을 처음 받아드립니다

- 요청에 따라 적절한 핸들러(컨트롤러) 호출하고 요청을 위임합니다

- 요청에 대한 인증, 권한 부여 및 로깅과 같은 공통 작업을 처리합니다

- 응답을 생성하고 클라이언트에게 반환합니다

 

프론트 컨트롤러 패턴은 웹 애플리케이션의 아키텍처를 단순화하고 확장성을 높이며

다양한 요청을 효율적으로 관리할 수 있도록 도와줍니다

대표적인 프론트컨트롤러 구현체로는 Java에서는 Spring Framework의 DispatcherServiet이 있습니다

---

DispatcherServlet 이란?

-  HTTP 프로토콜로 들어오는 모든 요청을 가장 먼저 받아 적합한 컨트롤러에 위임해주는 프론트 컨트롤러

- 자세히 설명하자면, 클라이언트에서 요청이 오면 톰캣과 같은 서블릿 컨테이너가 요청을 받게된다

- 그리고 그 모든 요청을 프론트 컨트롤러인 디스패치 서블릿이 가장 먼저 받게 된다

- 그러면 디스패처 서블릿은 공통적인 작업을 먼저 처리한 후, 해당 요청을 처리해야 하는 컨트롤러를 찾아서 작업을 위임한다

- 여기서 Front Controller라는 용어가 사용되는데, Front Controller는 주로 서블릿 컨테이너의 제일 앞에서 서버로 들어오는 클라이언트의 모든 요청을 받아서 처리해주는 컨트롤러로써, MVC 구조에서 함께 사용되는 디자인 패턴입니다

 

Dispatcher-Servlet(디스패처 서블릿)의 장점

- Spring MVC는 DispatcherServlet이 등장함에 따라 web.xml의 역할을 상당히 축소시켜주었습니다.

- 과거에는 모든 서블릿을 URL 매핑을 위해 web.xml에 모두 등록해주어야 했지만, dispatcher-servlet이 해당 어플리케이션으로 들어오는 모든 요청을 핸들링해주고 공통 작업을 처리면서 상당히 편리하게 이용할 수 있게 되었습니다.

- 우리는 컨트롤러를 구현해두기만 하면 디스패처 서블릿가 알아서 적합한 컨트롤러로 위임을 해주는 구조가 되었습니다.

---

Model 추가 - v3

 

서블릿  종속성 제거

- 컨트롤러 입장에서 HttpServletRequest, HttpServletResponse가 꼭 필요할까?

- request, response가 필요한게 아니라 요청 파라미터가 필요한거다. 

- 그럼, 요청 파라미터의 정보는 자바의 Map으로 대신 넘기도록 하면 지금 구조에서는 컨트롤러가 서블릿 기술을 몰라도 동작할 수 있다. 

- 그리고 request 객체를 Model로 사용하는 대신에 별도의 Model 객체를 만들어서 반환하면 된다.

- (기존에 request가 했던 역할을 직접 Model이란 객체를 만들어서 대신 하도록)

- 궁극적으로 우리가 구현하는 컨트롤러가 서블릿 기술을 전혀 사용하지 않도록 변경해보자

- 이렇게 하면 구현 코드도 매우 단순해지고, 테스트 코드 작성이 쉽다

 

뷰 이름 중복 제거 

- 컨트롤러에서 지정하는 뷰 이름에 중복이 있는 것을 확인할 수 있다

- 컨트롤러는 뷰의 논리 이름을 반환하고, 실제 물리 위치의 이름은 프론트 컨트롤러에서 처리하도록 단순화 하자

- 이렇게 해두면 향후 뷰의 폴더 위치가 함께 이동해도 프론트 컨트롤러만 고치면 된다.

 

예 ) 

• /WEB-INF/views/new-form.jsp → new-form
• /WEB-INF/views/save-result.jsp → save-result
• /WEB-INF/views/members.jsp → members

---

V3 구조

---

ModelView

지금까진 컨트롤러에서 서블릿에 종속적인 HttpServletRequest를 사용했다.

그리고 Model도 request.setAttribute()를 통해 데이터를 저장하고 뷰에 전달했다.

서블릿의 종속성을 제거하기 위해 Model을 직접 만들고, 추가로 View 이름까지 전달하는 객체를 만들자

 

(이전 버전에서는 컨트롤러에서 HttpServletRequest를 사용할 수 없다.

따라서 직접 request.setAttribure()를 호출할 수 도 없다. 따라서 Model이 별도로 필요하다)

참고로 ModelView 객체는 다른 버전에서도 사용함으로 패키지를 frontcontroller에 둔다.

 

 

ModelView

package hello.servlet.web.frontcontroller;
import java.util.HashMap;
import java.util.Map;

public class ModelView {
	 private String viewName;
	 private Map<String, Object> model = new HashMap<>();

	public ModelView(String viewName) {
	 this.viewName = viewName;
 	}
 
 	public String getViewName() {
 		return viewName;
     }
 
 	public void setViewName(String viewName) {
 		this.viewName = viewName;
 	}
 
 	public Map<String, Object> getModel() {
 		return model;
 	}
 
 	public void setModel(Map<String, Object> model) {
 		this.model = model;
 	}
}

 

이 ModelView class에서는 뷰의 이름과 뷰를 렌더링할 때 필요한 model 객체를 가지고 있다.

model은 단순히 map으로 되어 있으므로 컨트롤러 에서 뷰에 필요한 데이터를 key, value로 넣어주면 된다

 

---

ControllerV3

package hello.servlet.web.frontcontroller.v3;
import hello.servlet.web.frontcontroller.ModelView;
import java.util.Map;

public interface ControllerV3 {
	 ModelView process(Map<String, String> paramMap);
}

 

이 컨트롤러는 서블릿 기술을 전혀 사용하지 않는다.

따라서 구현이 매우 단순해지고, 테스트 코드 작성시 테스트 하기 쉽다.

HttpServletRequest가 제공하는 파라미터는 프론트 컨트롤러가 paramMap에 담아서 호출해주면 된다.

응답 결과로 뷰 이름과 뷰에 전달할 Model 데이터를 포함하는 ModelView 객체를 반환하면 된다.

 

---

MemberFormControllerV3 - 회원 등록 폼

package hello.servlet.web.frontcontroller.v3.controller;
import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import java.util.Map;

public class MemberFormControllerV3 implements ControllerV3 {

	@Override
	 public ModelView process(Map<String, String> paramMap) {
		 return new ModelView("new-form");
 	}
}

 

ModelView 를 생성할 때 new-form 이라는 view의 논리적인 이름을 지정한다.

실제 물리적인 이름은 프론트 컨트 롤러에서 처리한다

---

MemberSaveControllerV3 - 회원 저장

package hello.servlet.web.frontcontroller.v3.controller;
import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import java.util.Map;

public class MemberSaveControllerV3 implements ControllerV3 {

	private MemberRepository memberRepository = MemberRepository.getInstance();

	@Override
	 public ModelView process(Map<String, String> paramMap) {
		 String username = paramMap.get("username");
 		int age = Integer.parseInt(paramMap.get("age"));
 
 		Member member = new Member(username, age);
 		memberRepository.save(member);
 
 		ModelView mv = new ModelView("save-result");
 		mv.getModel().put("member", member);
 		
        return mv;
 	}
}

 

paramMap.get("username");

파라미터 정보는 map에 담겨있다. map에서 필요한 요청 파라미터를 조회하면 된다.

 

mv.getModel().put("member", member);

모델은 단순한 map이므로 모델에 뷰에서 필요한 member 객체를 담고 반환한다

---

MemberListControllerV3 - 회원 목록

package hello.servlet.web.frontcontroller.v3.controller;
import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import hello.servlet.web.frontcontroller.ModelView;
import hello.servlet.web.frontcontroller.v3.ControllerV3;
import java.util.List;
import java.util.Map;

public class MemberListControllerV3 implements ControllerV3 {

	private MemberRepository memberRepository = MemberRepository.getInstance();

	@Override
	public ModelView process(Map<String, String> paramMap) {
 
 	List<Member> members = memberRepository.findAll();
 	ModelView mv = new ModelView("members");
 	mv.getModel().put("members", members);
 
 	return mv;
 	}
}

---

FrontControllerServletV3

ort hello.servlet.web.frontcontroller.v3.controller.MemberFormControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberListControllerV3;
import hello.servlet.web.frontcontroller.v3.controller.MemberSaveControllerV3;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

@WebServlet(name = "frontControllerServletV3", urlPatterns = "/front-controller/
v3/*")
public class FrontControllerServletV3 extends HttpServlet {

	private Map<String, ControllerV3> controllerMap = new HashMap<>();

	public FrontControllerServletV3() {
		 controllerMap.put("/front-controller/v3/members/new-form", new MemberFormControllerV3());
 		 controllerMap.put("/front-controller/v3/members/save", new MemberSaveControllerV3());
 		 controllerMap.put("/front-controller/v3/members", new MemberListControllerV3());
 	}

	@Override
	protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 	
    	String requestURI = request.getRequestURI();
 		
        ControllerV3 controller = controllerMap.get(requestURI);
 		if (controller == null) {
 			response.setStatus(HttpServletResponse.SC_NOT_FOUND);
 		return;
 	}
 
 	Map<String, String> paramMap = createParamMap(request);
 	ModelView mv = controller.process(paramMap);
 	
    String viewName = mv.getViewName();
 	MyView view = viewResolver(viewName);
 	view.render(mv.getModel(), request, response);
 }
 
 private Map<String, String> createParamMap(HttpServletRequest request) {
 	
    Map<String, String> paramMap = new HashMap<>();
 	
    request.getParameterNames().asIterator().forEachRemaining(paramName -> paramMap.put(paramName, request.getParameter(paramName)));
 	
    return paramMap;
 }
 
 private MyView viewResolver(String viewName) {
 	return new MyView("/WEB-INF/views/" + viewName + ".jsp");
 }
}

 

view.render(mv.getModel(), request, response) 코드에서 컴파일 오류가 발생할 것이다.

다음 코드를 참고해서 MyView 객체에 필요한 메서드를 추가하자.

 

createParamMap()

HttpServletRequest에서 파라미터 정보를 꺼내서 Map으로 변환한다.

그리고 해당 Map( paramMap )을 컨트롤러 에 전달하면서 호출한다

 

---

뷰 리졸버

 

MyView view = viewResolver(viewName)

컨트롤러가 반환한 논리 뷰 이름을 실제 물리 뷰 경로로 변경한다. 그리고 실제 물리 경로가 있는 MyView 객체를 반환 한다.

- 논리 뷰 이름: members

- 물리 뷰 경로: /WEB-INF/views/members.jsp

 

view.render(mv.getModel(), request, response)

-  뷰 객체를 통해서 HTML 화면을 렌더링 한다.

-  뷰 객체의 render() 는 모델 정보도 함께 받는다.

-  SP는 request.getAttribute() 로 데이터를 조회하기 때문에, 모델의 데이터를 꺼내서 request.setAttribute() 로 담아둔다.

-  JSP로 포워드 해서 JSP를 렌더링 한다

---

MyView

package hello.servlet.web.frontcontroller;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Map;

public class MyView {

	private String viewPath;

	public MyView(String viewPath) {
		 this.viewPath = viewPath;
	 }

	public void render(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 	 	RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
 		dispatcher.forward(request, response);
 	}
 
 	public void render(Map<String, Object> model, HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 
    		modelToRequestAttribute(model, request);
 		RequestDispatcher dispatcher = request.getRequestDispatcher(viewPath);
 		dispatcher.forward(request, response);
 	}
 
 	private void modelToRequestAttribute(Map<String, Object> model, HttpServletRequest request) {
 		model.forEach((key, value) -> request.setAttribute(key, value));
 }
}

 

이렇게 실행하면

등록: http://localhost:8080/front-controller/v3/members/new-form

목록: http://localhost:8080/front-controller/v3/members