@RestController와 한글 출력 설정

* @RestController

 

컨트롤러 하나를 새로 생성한다.

 

 

 

NoticeController.java

package com.newlecture.web.controller.api;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

//RESTFUL한 결과물을 반환하는 클래스
@RestController("apiNoticeController")
@RequestMapping("/api/notice/")
public class NoticeController {

	@RequestMapping("list")
	public String list() {
		
		return "notice list";
	}
}

 

@RestController는 restful한 결과물을 반환하는, 특화된 컨트롤러를 위한 어노테이션이다. 이 어노테이션이 있다면 메소드에 @ResponseBody가 없더라도 문자열을 그대로 반환한다.

 

@RestController에 붙은 "apiNoticeController"은 컨트롤러의 식별자를 의미한다. 만약 식별자, 즉 이름을 지정하지 않는다면 에러가 발생하는데, 그 이유는 다른 customer 패키지 안에 NoticeController 클래스가 또 존재하기 때문이다.

 

이름을 지정하지 않았을 때는 묵시적으로 다음과 같이 빈이 생성된다.

 

NoticeController noticeController = new NoticeController();

또는
<bean id="noticeController" class="패키지.NoticeController">

 

패키지는 다르더라도 생성하는 객체의 이름 또는 bean의 id가 같을 수가 있기 때문에 식별 에러가 발생하게 되는 것이다. 따라서 이러한 에러를 방지하기 위해 @RestController("apiNoticeController")와 같이 이름을 붙이는 것이다. 둘 중 하나에만 붙여도 되고, 둘 다 붙여도 된다.

 

 

 

* 한글 출력 설정

 

영문자를 리턴하면 정상적으로 출력되지만, 한글 문자를 리턴하면 문자열이 깨지게 된다. 이 경우 xml 설정을 추가하면 된다.

 

 

servlet-context.xml

    <!-- 컨트롤러에서 RequestMapping 할 수 있게 하는 태그 -->
    <mvc:annotation-driven>
    	<mvc:message-converters> 
    	<!-- 
    	@ResponseBody로 String 처리할 때 한글 처리
    	매핑된 url을 찾아간 후 값을 ResponBody 타입으로 값을 리턴할 때, 
        반환하는 값이 한글이라면 가로채서 한글 설정.
    	-->
    		<bean class="org.springframework.http.converter.StringHttpMessageConverter">
    			<property name="supportedMediaTypes">
    				<list>
    					<value>text/html;charset=UTF-8</value>
    				</list>
    			</property>
    		</bean>
    	</mvc:message-converters>
    </mvc:annotation-driven> 

 

 

annotation-driven 태그를 열고 message-converters를 추가한다. (이름에서 알 수 있듯이 converter는 여러 개가 될 수 있다.)

annotation-driven 설정으로 RequestMapping을 통해 매핑된 url을 찾아간 후 값을 ResponBody 타입으로 값을 리턴할 때, 반환하는 값이 한글이라면 가로채서 한글 인코딩을 설정한다.