[Spring] @Controller 기초 및 데이터 송수신하기

🔻Controller

• 사용자의 입력 및 요청을 받아 해당 요청에 대한 비즈니스 로직을 수행하고, 그 결과를 사용자에게 응답으로 전달하는 주요한 컴포넌트이다.
• 컨트롤러는 모델과 뷰 사이의 중개자 역할을 하며, 이를 통해 시스템의 구성 요소들 간에 강한 결합을 방지하고 재사용성을 높인다.

 

🔻Controller 구현 방법

1. Controller 인터페이스 구현

2. @Controller 어노테이션 사용 > 편의성, 간결하다

 

1. Controller 인터페이스 구현

package com.test.spring.controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class Ex03Controller implements Controller{
	@Override
	public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
		
		return null;
	}
}

 

 

2. @Controller 어노테이션 사용

package com.test.spring.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping(value="/ex03.do")	//@WebServlet("/ex03.do")와 동일한 역할을 한다.
public class Ex03Controller {
	
	@RequestMapping
	public String test() {
		//업무 코드
		return "ex03";
	}
	
	//일반 메서드
	public int sum(int a, int b) {
		return a + b;
	}
}

 

 

@Controller을 사용하면 'implements Controller'를 사용하지 않아도된다.

 

업무 코드 다음 JSP 호출하기 위해 ModelAndView를 선언하였는데 어노테이션을 사용하면 ModelAndView 자동으로 생성되며 ViewResolver 가 동작된다. 그래서 return 문에 가상주소 만 적어도 ex03.jsp 파일로 이동된다.

 

핸들러(요청 메서드) 메서드는 최소한의 약속으로 @RequestMapping 어노테이션을 붙인다. Controller 클래스안에 여러개의 메서드가 있을 수 있어 @RequestMapping 으로 클래스 호출 시 실행할 메서드를 분별한다.

 

package com.test.spring.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class Ex04Controller {
	@RequestMapping(value="/ex04.do")
	public String ex04() {
		
		return "ex04";
	}
	
	@RequestMapping("/ex04_1.do")
	public String ex04_1() {
		
		return "ex04_1";
	}
}

 

컨트롤러 하나에 여러개의 가상 주소 사용하는 것을 권장한다.

컨트롤러 안에서 메서드의 @RequestMapping에게 주소를 주어 사용한다.

위 스타일에서 컨트롤러 전체에 @RequestMapping를 붙이는 것보다 메서드에게 붙이는 것이 보편적인 스타일이며 value 속성은 생략 가능하다.

이렇게 @Controller 사용하면 jsp만 호출하는 용도의 컨트롤러 갯수를 줄일 수 있다.

 

---

🔻@Controller의 데이터 송수신 

 

1. req, resq, @PostMapping

    @PostMapping(value="/ex05ok.do")
	public String ex05ok(HttpServletRequest req, HttpServletResponse resp) {
		
		//데이터 수신
		// Servlet&JSP : req.getParameter(), req.getParameterValues()
		// req를 사용하기 위해 HttpServletRequest 를 파라미터로 넣어준다.
		
		System.out.println(req == null);
		System.out.println(resp == null);
		System.out.println();
		
		String data = req.getParameter("data");
		req.setAttribute("data", data);
		
		return "ex05ok";
	}

 

Servlet&JSP 에서는 req.getParameter(), req.getParameterValues()로 데이터를 수신했다. Controller에서는 HttpServletRequest, HttpServletResponse가 선언이 되어 있지않아 메서드 매개변수로 받는다.

또한 데이터를 Post 방식으로 전달했을 때 @PostMapping 을 사용하여 응답한다. 

 

 

2. @RequestParam, Model

	@PostMapping(value="/ex05ok.do")
	//<div><input type="text" name="data"></div> 의 name과 연결
	public String ex05ok(@RequestParam(name = "data") String data, Model model) {
		
		//req.setAttribute("data", data) 와 동일
		model.addAttribute("data", data);
		
		return "ex05ok";
	}

 

@RequestParam HTTP 요청 파라미터를 메서드의 매개변수에 바인딩한다.
요청 파라미터의 이름과 메서드의 매개변수 이름이 동일하면 자동으로 바인딩되며, 이름이 다를 경우에 명시적으로 지정할 수 있다.

위 코드의 경우 JSP의 텍스트박스 name="data"를 @RequestParam(name = "data")로 바인딩하여 String data에 담았다.

또한 앞서 배운 ModelAndView의 Model 객체은 컨트롤러에서 뷰로 데이터를 전달할 때 사용하는 객체이다.  model 객체를 따로 매개변수로 받아 data 라는 이름으로 데이터를 보냈다.

 

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(String data, Model model) {
		model.addAttribute("data", data);
		return "ex05ok";
	}

 

텍스트 박스 name과 변수 이름이 같다면 @RequestParam  생략 가능하다.

 

 

3. 복합 데이터 수신

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(@RequestParam("name") String name, @RequestParam("age") String age, @RequestParam("address") String address, Model model) {
		
		SpringDTO dto = new SpringDTO();
		dto.setName(name);
		dto.setAddress(address);
		dto.setAge(age);
		
		SpringDAO dao = new SpringDAOImpl();
		
		int result = dao.add(dto);
		
		model.addAttribute("result", result);
		
		return "ex05ok";
	}

 

세 개의 요청 파라미터(name, age, address)를 받아와서 메서드의 매개변수로 사용한다.

데이터 전송을 위한 DTO에 담아 DAO로 DB 작업을 한다. 성공여부를 result에 담아 model로 전송했다.

여러개의 요청 파라미터가 있을 때는 번거로운 방법이다.

 

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(SpringDTO dto, String seq, Model model) {
		
		SpringDAO dao = new SpringDAOImpl();
		
		int result = dao.add(dto);
		
		System.out.println(seq);
		
		model.addAttribute("result", result);
		
		return "ex05ok";
	}

 

요청 파라미터가 DTO에 있을 때, dto로 수신 받을 수 있다. 만약 DTO에 없는 파라미터(seq)라면 따로 기재해주면 된다.

 

 

4. 다중값 수신

① Model , HttpServletRequest

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(Model model, HttpServletRequest req) {
		
		String[] cb = req.getParameterValues("cb");
		
		System.out.println(Arrays.toString(cb));
		
		return "ex05ok";
	}

 

체크박스처럼 다중값을 수신받을 때도 있다.

이번에는 Model 객체와 HttpServletRequest 객체를 매개변수로 받는다. 

HttpServletRequest의 getParameterValues 메서드를 사용하여 체크박스의 값들을 배열로 받아온다.
(여기서 "cb"는 HTML 폼에서 체크박스의 name 속성 값이다.)

 

 

② Model, @RequestParam

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(Model model, @RequestParam("cb") String[] cb) {
		
		System.out.println(Arrays.toString(cb));
		
		return "ex05ok";
	}

 

@RequestParam 를 사용하여 HTTP 요청 파라미터 중에서 "cb"라는 이름의 파라미터를 받아오는데, 이 값은 문자열 배열(String[])로 매핑을 해준다.

위 HttpServletRequest 객체를 사용하지 않고 바로 요청 파라미터를 인식할 수 있다.

 

 

③ @ModelAttribute

	@PostMapping(value="/ex05ok.do")
	public String ex05ok(@ModelAttribute(name="data") String data) {
		
		return "ex05ok";
	}

 

---

게시판 예제

파일 생성

패지키명	파일명	역할
com.test.spring.controller
	BoardController.java
view/board
	listjsp	게시판 목록 조회
	add.jsp	게시물 추가
	addok.jsp	게시물 추가 결과
	view.jsp	게시물 상세보기

 

BoardController.java

package com.test.spring.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class BoardController {

	//doGet() 역할
	@RequestMapping(value="/board/list.do", method=RequestMethod.GET)
	public String list() {
		// 경로 : "WEB-INF/views/board/list.jsp"
		return "board/list";
	}
	
	//doGet() 역할
	@RequestMapping(value="/board/add.do" , method=RequestMethod.GET)
	public String add() {
		return "board/add";
	}
	
	//doPost() 역할
	@RequestMapping(value="/board/addok.do", method=RequestMethod.POST)
	public String addok() {
		return "board/addok";
	}
	
	//doGet() 역할
	@RequestMapping(value="/board/view.do", method=RequestMethod.GET)
	public String view() {
		return "board/view";
	}
	
}

 

 

@RequestMapping - value

 

@RequestMapping 속성 value에는 파일 경로를 적어두는데 위치에 따라 경로를 다르게 적을 수 있다.

중첩되는 경로가 있으면 클래스 상단에 선언해주고 나머지 경로를 메소드 위에 선언한다. 이러면 중첩되는 경로는 한번만 적으면 된다. 하지만 이런 경우는 필수적인 부분이 아닌 본인 스타일에 맞춰 작성하면 된다.

package com.test.spring.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping(value="/board")
public class BoardController {
	
	//doGet() 역할
	@RequestMapping(value="/list.do", method={RequestMethod.GET, RequestMethod.POST})
	public String list() {
		return "board/list";
	}
	
	//doGet() 역할
	@RequestMapping(value="/add.do" , method=RequestMethod.GET)
	public String add() {
		return "board/add";
	}
	
	//doPost() 역할
	@RequestMapping(value="/addok.do", method=RequestMethod.POST)
	public String addok() {
		return "board/addok";
	}
	
	//doGet() 역할
	@RequestMapping(value="/view.do", method=RequestMethod.GET)
	public String view() {
		return "board/view";
	}
}

 

 

 

@RequestMapping - RequsetMethod.XXX

 

데이터 전송 방식인 GET, POST 을 @RequestMapping의 속성인 RequsetMethod.XXX으로 지정한다.

만약 요청 방식을 다르게 지정했다면, 405에러가 발생한다.

 

@RequestMapping(value="/board/list.do", method={RequestMethod.GET, RequestMethod.POST})

GET, POST 방식 둘 다 받아야하는 경우라면 배열로 GET, POST 방식 둘 다 전달 받을 수도 있다.

 

 

addok.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
<link rel="stylesheet" href="https://me2.do/5BvBFJ57">
</head>
<body>
	<!-- addok.jsp  -->
	<script src="https://code.jquery.com/jquery-1.12.4.js" ></script>
	
	<script>
		alert('글쓰기 완료');
		location.href='/spring/board/list.do';
	</script>
</body>
</html>

 

 

페이지 이동은 location.href를 이용하여 이동한다.  경로는 Servlet&JSP 때와 동일하게 'contextroot/폴더명/가상주소'로 사용한다.

 

이외 파일은 Servlet&JSP 때와 동일하게 작성하므로 자세한 설명은 생략한다.