입력의 종류 / QueryString 입력

지금까지는 스프링 MVC를 이용한 매핑, 출력을 알아보았다. 이제부터는 사용자 입력에 대해 알아보도록 하겠다.

 

 

 

 

* QueryString 입력

 

 

 

컨트롤러에서 입력 도구인 HttpServletRequest를 얻어와서 getParameter 메소드를 이용해 값을 입력받을 수 있다. 하지만 이 방법은 이전에 사용했던 서블릿에서의 방법과 크게 다르지 않다. 스프링에서 프론트 컨트롤러는 조금 더 나은 방법 역시 제공한다. 입력 도구가 아닌 입력 값을 얻어오는 방법이다.

 

 

 

 

사용자가 "p=1" 이라는 옵션으로 요청을 보냈을 때 프론트 컨트롤러에서 요청을 받아 해당하는 컨트롤러에는 "1"이라는 값을 넘겨주게 된다. 그러면 컨트롤러는 "p"라는 변수로 값을 얻어와서 사용할 수 있다.

 

 

 

* HttpServletRequest 사용하기

 

 

NoticeController.java (com.newlecture.web.controller.customer)

@Controller
@RequestMapping("/customer/notice/")
public class NoticeController{

	@Autowired
	private NoticeService noticeService;

	@RequestMapping("list")
	public String list(HttpServletRequest request) throws ClassNotFoundException, SQLException {
		
		String p = request.getParameter("p");
		System.out.println(p);
		
		List<Notice> list = noticeService.getList(1, "TITLE", "");
		
		return "notice.list";
	}
}

 

"localhost:8080/customer/notice/list?p=1" 을 실행하면 request 객체를 얻어와 콘솔창에 "1"이 출력된다.

 

 

 

* 입력 값만 얻어서 사용하기

 

NoticeController.java

@Controller
@RequestMapping("/customer/notice/")
public class NoticeController{

	@Autowired
	private NoticeService noticeService;

	@RequestMapping("list")
	public String list(String p) throws ClassNotFoundException, SQLException {
		
		System.out.println(p);
		
		List<Notice> list = noticeService.getList(1, "TITLE", "");
		
		return "notice.list";
	}

 

"localhost:8080/customer/notice/list?p=5" 을 실행하면 콘솔창에 "5"가 출력된다. url에서 "p=5"라고 옵션을 달아 요청을 보냈고, 컨트롤러에서는 변수명만 맞춰서 String을 받아오면 스프링이 알아서 url의 쿼리스트링 값을 받아온다.

 

 

 

* QueryString 변수명과 기본 값 처리

 

위의 예시처럼 url에 옵션으로 값을 보내면서 요청하면 프론트 컨트롤러는 그것을 받아 같은 변수명(여기서는 p)으로 컨트롤러에 값을 보내고, 컨트롤러는 그 변수명으로 String을 받아 값을 사용할 수 있다. 이때 컨트롤러에서 다른 변수명으로 값을 받아오고 싶을 때 쓰는 방법이 바로 @RequestParam이다.

 

 

 

 

url의 요청대로 "p"라는 변수와 그에 해당하는 값을 보내는데, 컨트롤러에서는 "page"라는 이름으로 그것을 받겠다는 선언이다.

 

만약 사용자가 p라는 옵션 없이 url 요청을 한다면 다음과 같은 에러가 발생한다.

 

 

이러한 상황을 방지하기 위해서 p 값이 없을 때는 기본값을 지정해 주는 것이 좋다. 스프링에서는 값을 받아올 때 defaultValue, name, required, value와 같은 몇 가지 옵션을 제공한다.

 

 

스프링이 제공하는 @RequestParam의 옵션

 

 

NoticeController.java

@Controller
@RequestMapping("/customer/notice/")
public class NoticeController{

	@Autowired
	private NoticeService noticeService;

	@RequestMapping("list")
	public String list(@RequestParam(name="p", defaultValue="1") int page) throws ClassNotFoundException, SQLException {
		
		/*
		 * 입력 값 얻어오는 방법 *
		1. HttpServletRequest 입력 도구 객체를 얻어와서 
			String p = request.getParameter("p"); 방식으로 받는다.
		2. String p 라는 값으로 받아온다. 
			url에서 보낸 변수명대로 받아올 때 사용한다.
		3. @RequestParam("p") String page 라는 값으로 받아온다. 
			p라는 변수로 보내고 page라는 변수로 받는다.
		 */
		
		System.out.println("page : " + page);
		
		List<Notice> list = noticeService.getList(1, "TITLE", "");
		
		return "notice.list";
	}
}

 

name으로 받아올 쿼리스트링을 지정, defaultValue로 받아올 값의 기본값 지정을 하였다. 쿼리스트링은 일반적으로 String으로 받아와서 다른 타입으로 형 변환을 해야하지만(ParseInt 등) 스프링은 형 변환하지 않고도 값을 받아올 때 값 타입을 지정하면 그 타입으로 받아올 수 있게 하는 기능 역시 지원한다.

 

 

 

* @RequestParam의 required 속성

 

 

NoticeController.java

@Controller
@RequestMapping("/customer/notice/")
public class NoticeController{

	@Autowired
	private NoticeService noticeService;

	//url 구조는 파일 구조와 같게 해야 파일 찾아가기 쉽다.
	@RequestMapping("list")
	public String list(@RequestParam(name="p", required=false) Integer page) throws ClassNotFoundException, SQLException {
		//defaultValue 대신 required=false 사용, Integer 타입으로 받아온다.
				
		System.out.println("page : " + page);
		
		List<Notice> list = noticeService.getList(1, "TITLE", "");
		
		return "notice.list";
	}
}

 

required 옵션은 해당 파라미터가 필수인지의 여부를 나타내며, 기본값은 true이다. 

"@RequestParam(name="p", required=false) Integer page"의 의미는 파라미터 p가 존재하지 않았을 때 Integer page를 null로 받는다는 뜻이다. 기본타입인 int는 null을 받을 수 없으므로 page 파라미터의 타입을 Integer으로 선언하였다.

 

 

 

* @RequestParam의 value 속성

 

value 속성은 name을 대신할 수 있는, name의 별칭이다. 둘이 비슷하지만 name과 value를 둘 다 사용해서는 안 된다. 둘이 같으니 아무거나 쓰자.