[MAVEN] SpringMVC2 버전1 연습 (Controller)

🔍 목적

중간 프로젝트 때 진행했던 카메라 커뮤니티 사이트를 Spring으로 이관하는 것

실무에서 어떤 버전을 사용할지 알 수 없기 때문에 여러 버전을 연습

앞에서 썼던 SpringMVC2에 대한 설명이 생각보다 이해하기 힘든 것 같아 Refresh!!

---

🔍 DispatcherServlet (FrontController)

DispatcherServlet은 MVC2 패턴에서 유일하게 사용하는 서블릿이다. 그냥 이게 없으면 뭘 할 수가 없음

 

Spring에서는 FrontController 대신 DispatcherServlet을 사용한다.

버전 1에서는 개발자가 만든 DispatcherServlet을 사용한다.

💡 import com.spring.controller.common.DispatcherServlet

 

DispatcherServlet.java

package com.spring.controller.common;

import java.io.IOException;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import com.spring.controller.common.DispatcherServlet;

// FrontController
// 클라이언트의 모든 요청을 받아 처리하는 서블릿으로서, Front Controller 디자인 패턴을 따른다.
// 주요 역할은 클라이언트로부터의 모든 요청을 받아 해당 요청에 맞는 컨트롤러를 찾아 실행하고,
// 실행된 컨트롤러가 반환한 뷰 정보를 가지고 클라이언트에게 응답한다.
public class DispatcherServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
    private HandlerMapping handler; // 핸들러 매핑을 담당하는 객체
    private ViewResolver viewResolver; // 뷰 리졸버를 담당하는 객체

    // init-method="init"
    // 서블릿이 초기화될 때 호출되는 메서드로, 멤버 변수 초기화를 담당한다.
    // 1. 멤버변수 초기화
    // 2. 생성자
    // 3. setter
    // 4. @Autowired
    // 5. DI(의존주입)
    // 6. init() 메서드
    public void init() {
        handler = new HandlerMapping(); // 핸들러 매핑 객체 생성
        viewResolver = new ViewResolver(); // 뷰 리졸버 객체 생성
        viewResolver.setPrefix("./"); // 뷰 파일의 경로(prefix) 설정
        viewResolver.setSuffix(".jsp"); // 뷰 파일의 확장자(suffix) 설정
    }

    // 클라이언트의 GET 요청을 처리하는 메서드
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doAction(request, response);
    }

    // 클라이언트의 POST 요청을 처리하는 메서드
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        doAction(request, response);
    }

    // 클라이언트의 모든 요청을 처리하는 메서드
    private void doAction(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 클라이언트의 요청 URI를 추출
        String uri = request.getRequestURI();
        String cp = request.getContextPath();
        String command = uri.substring(cp.length());
        System.out.println("FC : " + command); // 추출된 요청 URI를 콘솔에 출력

        // 핸들러 매핑을 사용하여 요청에 맞는 컨트롤러를 가져옴
        Controller controller = handler.getController(command);
        
        // 해당 컨트롤러의 execute() 메서드를 호출하고, 반환된 뷰 정보를 저장
        String view = controller.execute(request, response);

        // 반환된 뷰 정보가 ".do"로 끝나는 경우, 뷰 리졸버를 사용하여 실제 뷰 파일의 경로를 가져옴
        if (view.contains(".do")) {
            view = viewResolver.getView(view);
        }
        
        // 클라이언트에게 뷰로 리다이렉트하여 응답함
        response.sendRedirect(view);
    }
}

web.xml

• web-app 엘리먼트: XML 파일의 루트 엘리먼트로, Java EE 스키마와 네임스페이스를 선언한다.
• servlet 엘리먼트: 이 엘리먼트는 서블릿을 정의하며, 여기서는 DispatcherServlet을 정의하고 있다. 이때 servlet-name으로는 "dispatcherServlet"을, servlet-class로는 com.spring.controller.common.DispatcherServlet 클래스를 지정한다.
• servlet-mapping 엘리먼트: 이 엘리먼트는 서블릿과 URL 패턴을 매핑한다. DispatcherServlet과 "*.do" URL 패턴을 매핑하여, ".do" 확장자를 가지는 모든 URL 요청을 DispatcherServlet으로 전달한다.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns="http://java.sun.com/xml/ns/javaee"
		xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
		                    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
	
	<servlet>
		<servlet-name>dispatcherServlet</servlet-name>
		<servlet-class>com.spring.controller.common.DispatcherServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>dispatcherServlet</servlet-name>
		<url-pattern>*.do</url-pattern>
	</servlet-mapping>
	
</web-app>

---

🔍 Controller(Action)

SpringMVC2 버전 1에서는 Controller를 개발자가 직접 작성한다.

일반적인 클래스가 아닌 인터페이스이며 작성한 Controller를 각 기능별로 implements한다.

Java에서는 ActionForward를 통해 View에 전달하였지만 Spring에서는 ViewResolver를 이용한다.

Controller.java (인터페이스)

package com.spring.controller.common;

import java.io.IOException;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

// Action
public interface Controller {

	// ActionForward → String
	String execute(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException;
	
}

LoginAction.java

package com.spring.controller.member;

import java.io.IOException;

import com.spring.controller.common.Controller;
import com.spring.model.member.MemberDAO;
import com.spring.model.member.MemberDTO;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

// 로그인 액션을 처리하는 컨트롤러 클래스
public class LoginAction implements Controller {

    // execute 메서드 재정의
    @Override
    public String execute(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        
        // 회원 정보를 담을 DTO 객체 생성
        MemberDTO memberDTO = new MemberDTO();
        // 회원 DAO 객체 생성
        MemberDAO memberDAO = new MemberDAO();
        
        // 요청으로부터 회원 아이디와 비밀번호를 가져와 DTO 객체에 설정
        memberDTO.setId(request.getParameter("memberId"));
        memberDTO.setPw(request.getParameter("memberPw"));
        
        // DAO를 사용하여 회원 정보 조회
        memberDTO = memberDAO.selectOne(memberDTO);
        
        // 회원 정보가 존재하는 경우
        if(memberDTO != null) {
            // 메인 페이지로 이동
            return "mainPageAction.do";
        }
        // 회원 정보가 존재하지 않는 경우
        else {
            // 이전 페이지로 돌아감
            return "goBack.do";
        }
    }
}

---

🔍 HandlerMapping

HandlerMapping 역시 개발자가 직접 만든 HandlerMapping클래스를 사용한다.

의존 주입은 생성자를 통해 이루어진다.

HandlerMapping.java

package com.spring.controller.common;

import java.util.HashMap;
import java.util.Map;

import com.spring.controller.member.JoinAction;
import com.spring.controller.member.JoinPageAction;
import com.spring.controller.member.LoginPageAction;
import com.spring.controller.member.LogoutAction;
import com.spring.controller.member.MainPageAction;

// 요청 URI와 컨트롤러를 매핑하는 핸들러 클래스
public class HandlerMapping {
    private Map<String, Controller> mappings; // 요청 URI와 컨트롤러를 저장하는 맵

    // 생성자: 핸들러 매핑을 초기화하는 메서드
    public HandlerMapping() {
        mappings = new HashMap<String, Controller>(); // 맵 생성
        
        // 맵에 요청 URI와 컨트롤러를 매핑하여 추가
        mappings.put("/main.do", new MainPageAction()); // 메인 페이지 요청 매핑
        mappings.put("/joinPage.do", new JoinPageAction()); // 회원 가입 페이지 요청 매핑
        mappings.put("/join.do", new JoinAction()); // 회원 가입 요청 매핑
        mappings.put("/loginPage.do", new LoginPageAction()); // 로그인 페이지 요청 매핑
        mappings.put("/logout.do", new LogoutAction()); // 로그아웃 요청 매핑
    }
    
    // 요청 URI에 해당하는 컨트롤러를 반환하는 메서드
    public Controller getController(String commend) {
        return mappings.get(commend);
    }
}

---

🔍 ViewResolver

마지막인 ViewResolver 또한 개발자가 직접 작성한 클래스이다.

ViewResolver는 HandlerMapping과는 다르게 Setter를 이용해 의존 주입을 한다.

ViewResolver.java

package com.spring.controller.common;

// 뷰 리졸버 클래스
public class ViewResolver {
    public String prefix; // 뷰 파일의 경로(prefix)
    public String suffix; // 뷰 파일의 확장자(suffix)

    // prefix 설정 메서드
    public void setPrefix(String prefix) {
        this.prefix = prefix;
    }

    // suffix 설정 메서드
    public void setSuffix(String suffix) {
        this.suffix = suffix;
    }

    // 실제 뷰 파일의 경로를 반환하는 메서드
    public String getView(String view) {
        return prefix + view + suffix;
    }
}

---

💡 결론

오늘 이관 작업을 하면서 아직 Spring에 대한 이해가 부족하다는 것을 깨달았다.

블로그 포스팅을 하면서 느낀점은 배운 내용을 적용시키면서 뭐가 부족한지 생각하고 차근차근 다시 복기하는 식으로 해야 할 것 같다는 것이다.

앞으로 SpringMVC2에서의 Controller 파트에 대해 버전별로 다시 정리를 해야 할 것 같다.

---