Spring MVC - @RequestMapping, @RequestParam, ModelAndView

스프링이 제공하는 컨트롤러는 어노테이션 기반으로 동작해서 유연하고 실용적입니다.

v1 - @RequestMapping 도입

@RequestMapping 기반의 어노테이션 컨트롤러를 코드를 통해 먼저 살펴보겠습니다.

 

1. MemberForm

SpringMemberFormControllerV1

@Controller
public class SpringMemberFormControllerV1 {

    @RequestMapping("springmvc/v1/members/new-form")
    public ModelAndView process()
    {
        return new ModelAndView("new-form");
    }
}

@Controller 

• 스프링이 자동으로 스프링 빈으로 등록 ( @Controller 어노테이션 내부에 @Component가 있어서 컴포넌트 스캔 대상으로 등록 )
• 스프링 MVC에서 어노테이션 기반 컨트롤러로 인식

@RequestMapping

• 요청 정보를 매핑. 파라미터로 입력한 URL이 호출되면 이 메소드가 호출됩니다.
• 어노테이션 기반 동작으로 메소드의 이름은 임의로 지을 수 있습니다. 

ModelAndView

• Model과 View의 정보를 담아서 리턴 
• Spring에서 제공하는 모듈
• Model도 있지만 ModelAndView는 view설정, model설정, 상태 설정 까지 가능합니다.

 

@Controller 어노테이션을 사용하지 않고 직접 @Component를 사용해 스프링 빈으로 등록해도 동일하게 동작합니다.

@Component
@RequestMapping
public class SpringMemberFormControllerV1 {

    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process()
    {
        return new ModelAndView("new-form");
    }
}

 

또는 아래 처럼 애플리케이션에 수동으로 빈으로 등록해도 동일하게 동작합니다.

@ServletComponentScan
@SpringBootApplication
public class ServletApplication {

   public static void main(String[] args) {
      SpringApplication.run(ServletApplication.class, args);
   }
   @Bean
   SpringMemberFormControllerV1 springMemberFormControllerV1(){
      return new SpringMemberFormControllerV1();
   }
}

package hello.servlet.web.springmvc.v1;

import org.springframework.stereotype.Component;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

//@Component
//@RequestMapping

@RequestMapping
public class SpringMemberFormControllerV1 {

    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process()
    {
        return new ModelAndView("new-form");
    }
}

 

일반적으로는 @Controller 어노테이션을 사용하기 때문에, 이제부터는 빈을 @Component를 직접 사용해 등록하거나, 수동으로 등록하지 않고 @Controller를 사용하도록 하겠습니다.

2. MemberSave

@Controller
public class SpringMemberSaveControllerV1 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members/save")
    public 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;
    }
}

 

어노테이션 설명없이 로직만 요약하고 넘어가겠습니다.

1. springmvc/v1/members/save URL 호출
2. request로부터 "username", "age" parameter ➣ String username, int age 각각 저장
3. Member 객체 username, age를 통해 생성
4. 싱글톤 MemberRepository에 저장
5. ModelAndView 생성 - 생성자는 파라미터는 뷰 논리이름
6. Model에 member객체 "member"로 담고 리턴

• mv.addObject("member",member) : 스프링이 제공하는 ModelAndView를 통해 Model 데이터를 추가할 때는 addObject()를 사용하며 됩니다.

3. MemberList

@Controller
public class SpringMemberListControllerV1 {

    private final MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members")
    public ModelAndView process(HttpServletRequest request, HttpServletResponse response)
    {
        List<Member> members = memberRepository.findAll();
        ModelAndView mv = new ModelAndView();
        mv.addObject("members",members);
        return mv;
    }
}

logic

 

1. /springmvc/v1/members URL 호출 

2. 리포지토리 -> FindAll() -> List<Member> member에 저장

3. ModelAndView 생성 -> 뷰 논리이름 "members"

4. ModelAndView 객체에 addObject()를 통해 List 담음

5. ModelAndView return

v2 - Controller 통합

package hello.servlet.web.springmvc.v2;

import hello.servlet.basic.domain.member.Member;
import hello.servlet.basic.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/new-form")
    @ResponseBody
    public ModelAndView newForm() {
        return new ModelAndView("new-form");
    }

    @RequestMapping("/save")
    public ModelAndView save(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;
    }

    @RequestMapping
    public ModelAndView members(HttpServletRequest request, HttpServletResponse response) {
        List<Member> members = memberRepository.findAll();

        ModelAndView mv = new ModelAndView("members");
        mv.addObject("members", members);
        return mv;
    }
}

 

컨트롤러 클래스를 통합하는 것 뿐만 아니라 조합도 가능합니다.

첫 번째 방식에서 각 컨트롤러는 "/springmvc/v1/members" URL의 중복이 있었습니다.

모든 컨트롤러를 한 클래스에 통합하고 위와 같이 클래스레벨에 중복 URL을 @RequestMapping 해주면 훨씬 클린하게 작성할 수 있습니다.

 

v3 - 실용성 올리기 ( 실무 )

 

SpringMemberControllerV3

package hello.servlet.web.springmvc.v3;

import hello.servlet.basic.domain.member.Member;
import hello.servlet.basic.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {
    private MemberRepository memberRepository = MemberRepository.getInstance();

//     @GetMapping(value="/new-form")
    @RequestMapping(value="/new-form", method= RequestMethod.GET)
    public String newForm()
    {
        return "new-form";
    }

//     @PostMapping("/save")
    @RequestMapping(value = "/save", method = RequestMethod.POST)
    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";
    }

    // @GetMapping
    @RequestMapping(method = RequestMethod.GET)
    public String members(Model model)
    {
        List<Member> members = memberRepository.findAll();
        model.addAttribute("members",members);
        return "members";
    }


}

1. Model 도입

• save(), members()를 보면 Model을 파라미터로 받는 것을 확인할 수 있습니다.

2. ModelAndView가 아닌 String으로 ViewName 직접 반환

• view의 논리이름을 String 형태로 직접 리턴

3. @RequestParam 사용

• 스프링은 HTTP 요청 파라미터를 @RequestParam으로 받을 수 있습니다.
• @RequestParam("username")은 request.getParameter("username")과 같은 코드라 생각하시면 됩니다.
• 물론 GET 방식(쿼리 파라미터), POST(메시지 바디) 방식 모두 지원 

4. @RequestMapping ➣ @GetMapping, @PostMapping

• @RequestMapping의 파라미터로 method=RequestMethod.GET 또는 method=RequestMethod.POST 를 사용해서 쿼리 파라미터로 전송할지(GET), 메시지 바디로 전달할지(POST)를 선택할 수도 있습니다만, @GetMapping, @PostMapping을 이용해 더 편리하게 사용할 수 있습니다.
• Get,Post,Put,Delete,Patch 모두 어노테이션이 준비되어 있습니다.

---

<참고 자료>

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1/dashboard

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의

https://bestkingit.tistory.com/155

[Spring Boot] Model 과 ModelAndView 차이.