Conversion Struts to Spring MVC
기존 Struts로 개발되어있는 웹프레임워크를 Spring MVC기반으로 전환하기 위한 방법을 소개한다.
web.xml 변경
- Spring 속성정의 파일 위치 지정
웹단에서 호출하는 서비스들이 Spring bean으로 정의되어 있는 속성 정의 파일의 위치를 다음과 같이 지정해 준다.
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/config/spring/applicationContext-*.xml
</param-value>
</context-param>
- Listener 등록
Spring에서 제공해주는 Listener를 등록한다.
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
- servlet class 변경 및 contextConfigLocation 정의
servlet class를 다음과 같이 변경하고 param-name을 config 대신 contextConfigLocation으로 정의한 후 config파일 위치를 지정해 준다.
- 변경 전
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>
anyframe.web.struts.common.action.DefaultActionServlet
</servlet-class>
<init-param>
<param-name>config</param-name>
<param-value>
/config/struts/struts-config.xml
</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
- 변경 후
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/config/springmvc/*-servlet.xml
</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
- 인코딩 필터 추가
폼입력 데이터 값이 한글일 경우 한글 깨짐 현상을 방지하기 위해 다음과 같이 인코딩 필터를 추가 한다.
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>
org.springframework.web.filter.CharacterEncodingFilter
</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>euc-kr</param-value>
</init-param>
</filter>
<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="euc-kr"/>
- message properties의 한글 인코딩을 위한 character-encoding 추가
Spring에서 제공해주는 <spring:message> 태그를 사용할 경우 유니코드가 아닌 다른 인코딩 방법(ex>UTF-8, euc-kr)으로 인코딩된 한글 메시지가 깨지는 현상이 발생된다.
<context-param>
<param-name>character-encoding</param-name>
<param-value>utf-8</param-value>
</context-param>
단, resource bundle editor등을 이용한 유니코드로 직접 작성된 경우는 기존의 <spring:message>태그를 사용한다.
Controller 단 변경
Anyframe Java의 Struts 웹 프레임워크의 Action은 결과적으로 Struts에서 제공하는 Action을 상속받게 되어 있는데,
이를 Spring MVC로 전환하기 위해서는 Spring Fraemwork에서 제공해주는 Controller를 상속받도록 구현해야한다.
Struts 웹 프레임워크를 사용할 때 대표적으로 Anyframe Java에서 제공하는 DefaultActionSupport와 DefaultDispatchActionSupport를 상속받게 되는데
이는 모두 Anyframe Web에서 제공하는 AnyframeFormController로 대체될 수 있으며 그 예는 아래와 같다.
- DefaultActionSupport
한 Action에서 하나의 요청만 처리하면 DefaultActionSupport,
여러 요청을 처리하면 DefaultDispatchAction을 상속받아 구현하도록 되어있다. 이중 DefaultActionSupport를 Anyframe Spring MVC로 Conversion하기 위해서는
Anyframe Web의 AnyframeFormControlle를 상속 받고 process() 메소드를 구현하며
데이터 바인딩은 bind()메소드를 통해 할 수 있다.
또한 ApplicationContext의 getBean을 사용하여 Service를 호출하는 것이 아니라 Setter Injection을 통해 Service를 호출한다.
- 변경 전
public class GetUserAction extends DefaultActionSupport {
public Log getLogger() throws Exception {
return DefaultActionUtils.getLogger(this.getClass().getName());
}
public ActionForward process(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)
throws Exception {
ApplicationContext ctx = getWebApplicationContext();
UserService userService = (UserService) ctx.getBean("userService");
....중략...
UserForm userForm = (UserForm) form;
....중략...
request.setAttribute("userVO", userVO);
request.setAttribute("flag", "user");
return mapping.findForward("success");
}
}
- 변경 후
public class GetUserController extends AnyframeFormController {
//Setter Injection을 통해 서비스를 호출한다.
private UserService userService = null;
public void setUserService(UserService userService) {
this.userService = userService;
}
//process 메소드 구현
protected ModelAndView process(HttpServletRequest request,
HttpServletResponse response{
....중략...
UserVO uesrVO = new UserVO();
//bind() 메소드를 이용한 request에 parameter로 넘어온 폼 입력 데이터 바인딩
bind(request, userVO);
....중략...
request.setAttribute("userVO", userVO);
request.setAttribute("flag", "user");
// return할 페이지 지정
return new ModelAndView("/sample/user/updateUser.jsp");
}
}
- DefaultDispatchActionSupport
DefaultDispatchActionSupport 또한 AnyframeFormContoller로
변경한 후 각 요청별 처리에 맞는 메소드를 구현해야한다. 마찬가지로 bind() 메소드를 사용하여 데이터를 바인딩한다.
DefaultActionSupport의 전환과정과 마찬가지로 ApplicationContext의 getBean을 사용하여 Service를 호출하는 것이 아니라 Setter Injection을 통해 Service를 호출한다.
- 변경 전
public class AdminCompanyMgmtAction extends DefaultDispatchActionSupport {
public ActionForward getCompanyList(ActionMapping mapping,
ActionForm form, HttpServletRequest request,
HttpServletResponse response) throws Exception{
ApplicationContext ctx= getWebApplicationContext();
AdminCompanyMgmt compMgmt = (AdminCompanyMgmt) ctx.getBean(AdminCompanyMgmt.ROLE);
AdminCompanyForm companyForm = (AdminCompanyForm) form;
PageInfo compListInfo = null;
HashMap searchArgs = new HashMap();
this.getLogger().debug("test Logger");
...중략...
request.setAttribute("LinesPerPage", new Integer(pageSize));
request.setAttribute("searchPage", new Integer(searchPage));
String forward = request.getParameter("type");
if (forward == null || "".equals(forward))
forward = "success";
return mapping.findForward(forward);
}
public ActionForward getCompany(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)
throws Exception {
ApplicationContext ctx = getWebApplicationContext();
AdminCompanyForm companyForm = (AdminCompanyForm) form;
AdminCompanyMgmt companyMgmt = (AdminCompanyMgmt) ctx.getBean(AdminCompanyMgmt.ROLE);
AdminCompanyVO companyVO = companyMgmt.getCompanyDetail(companyForm.getCom_sq());
String forward = request.getParameter("type");
if ( forward == null ){
forward = "readView";
}else{
forward = "UpdateView";
}
request.setAttribute("companyDetail", companyVO);
return mapping.findForward(forward);
}
}
- 변경 후
public class AdminCompanyMgmtController extends AnyframeFormController {
private AdminCompanyMgmt compMgmt = null;
public void setAdminCompanyMgmt(AdminCompanyMgmt compMgmt) {
this.compMgmt = compMgmt;
}
//view객체이름을 프로퍼티로 xml파일에 지정해 주었을 경우 Setter Injection을 통해 호출한다.
private String successView = null;
public void setSuccessView(String view){
this.successView=view;
}
public ModelAndView getCompanyList(HttpServletRequest request,
HttpServletResponse response) throws Exception {
AdminCompanyForm companyForm = new AdminCompanyForm();
this.getLogger.debug("before bind=========="+request.getParameter("searchCompany"));
//bind메소드를 통한 데이터 바인딩
bind(request, companyForm);
String a = companyForm.getSearchCompany();
this.getLogger.debug("searchCompany============"+a);
this.getLogger.debug("encoding=========="+request.getCharacterEncoding());
...중략..
request.setAttribute("LinesPerPage", new Integer(pageSize));
request.setAttribute("searchPage", new Integer(searchPage));
String forward = request.getParameter("type");
if (forward == null || "".equals(forward))
forward = "success";
request.setAttribute("companyForm", companyForm);
return new ModelAndView(successView);
}
public ModelAndView getCompany(HttpServletRequest request,
HttpServletResponse response) throws Exception {
AdminCompanyVO companyVO = new AdminCompanyVO();
bind(request, companyVO);
companyVO = compMgmt.getCompanyDetail(companyVO.getCom_sq());
String forward = request.getParameter("type");
request.setAttribute("companyDetail", companyVO);
if (forward == null) {
return new ModelAndView("/admin/AU0202_R1.jsp");
} else {
return new ModelAndView("/admin/AU0202_UD1.jsp");
}
}
}
AnframeFormController에 대한 자세한 설명은 여기를 참고한다.
configuration 파일 변경
기존 struts-config로 정의되어있던 request요청에 따른 매핑정보를 spring에서 지원하는 형태의 xml로 모두 변경해야 한다. 작성 방법은
여기를 참고한다.
JSP파일 내의 태그 변경
기존 Struts의 태그를 쓴 경우 JSTL및 Spring에서 제공하는태그로 변경해 줘야 한다. 여기서는 간단히 Struts 태그와 같은 역할을 하는 태그를 간단히
소개한다.
