ActionServlet의 init() 메소드에서 다음과 같이 초기화 절차가 진행된다.

아래는 RequestProcessor 를 struts-config.xml의 <controller>로 설정한 예이다.

<controller contentType="text/html;charset=UTF-8"
                debug="3" locale="true" nocache="true"
                        processorClass="org.apache.struts.action.RequestProcessor"/>

위의 processorClass 에는 필요에 따라 RequestProcessor를 확장한 Controller를 설정할 수 있다. Anyframe 에서는 RequestProcessor 를 확장한 DefaultRequestProcessor 를 제공한다.

Action 클래스에서 execute() 메소드는 ActionForward 객체를 리턴한다. ActionForward는 리소스를 감싸서 어플리케이션과 물리적인 리소스를 분리하며 설정 파일에 forward의 name, path, redirect 속성과 같은 요소들로 정의하고 코드에는 포함하지 않는다. RequestDispatcher는 redirect 요소의 값에 따라 ActionForward의 포워드나 리다이렉트를 실행하게 된다. Action에서 ActionForward를 반환할 때 설정 파일에 미리 정의된 ActionForward를 알아내기 위해 일반적으로 ActionMapping을 사용한다. 다음 코드는 ActionMapping을 사용하여 논리적 이름에 근거해 ActionForward를 찾는 방법을 보여준다.

return mapping.findForward("success");

다음 그림은 Struts 의 org.apache.struts.actions 패키지에 해당하는 클래스들의 간단한 클래스 다이어그램이다.

단순히 포워딩만 실행하는 경우 Action 클래스를 직접 구현하지 않고 struts에서 미리 구현된 ForwardAction을 사용한다. 이 Action 클래스는 파라미터 속성에 정의된 URI로 포워드를 실행한다.

<action
    path="/loginView"
    type="org.apache.struts.actions.ForwardAction"
    parameter="/basic/login.jsp">
</action>

request url이 loginView.do이면 /basic/login.jsp로 포워드하게 된다. Action 클래스를 통하지 않고 JSP를 직접 호출하는 것은 바람직하지 못하다. MVC 구조에서 Controller의 책임을 위반할 뿐만 아니라 Struts에서 처리하는 중간 단계를 건너뛰게 되므로 문제가 발생할 수 있다.(ex. 리소스 번들에서 올바른 메시지를 가져오지 못함)

ForwardAction과 비슷하며 기존에 있던 서블릿 기반 컴포넌트들을 스트럿츠 기반 웹 어플리케이션과 쉽게 통합하기 위해 제공하는 것이다.

<action
    input="/subscription.jsp"
    name="subscriptionForm"
    path="/saveSubscription"
    parameter="/path/to/processing/servlet"
    scope="request"
    type="org.apache.struts.actions.IncludeAction" />
</action>

기능마다 각각의 Action 클래스를 만들게 되면 클래스 수가 많아져서 관리하기가 어렵다. Struts에서는 관련된 기능을 하나의 Action으로 모을 수 있는 DispatchAction을 제공한다. 예를 들면 add, update, view 와 같은 여러 기능을 하나의 Action(extends DispatchAction) 안에 메소드로 구현하면 (cf. 일반 Action에서는 execute() 메소드 구현 ) 설정 파일의 parameter 속성값으로 지정한 문자열 키값(아래에서는 "method"로 지정하였음. 다른 문자열을 써도 됨.)으로 메소드를 호출할 수 있게 된다. 아래는 DispatchAction을 extends한 ShoppingCartAction.java 의 소스코드이다.

public class ShoppingCartAction extends DispatchAction {

    public ActionForward add (
        ActionMapping mapping,
        ActionForm form,
        HttpServletRequest request,
        HttpServletResponse response) throws Exception{
	    // TODO : add 기능 관련 로직
        return mapping.findForward("add");
    }

    public ActionForward update (
    ...
    // TODO : update 기능 관련 로직
    return mapping.findForward("update");
    }

    public ActionForward search (
    ...
    // TODO : search 기능 관련 로직
    return mapping.findForward("search");
    }

    public ActionForward view (
    ...
    // TODO : view 기능 관련 로직
    return mapping.findForward("view");
    }
}

ShoppingCartAction에 대한 action 매핑 정보를 설정한 struts-config-dispatch.xml 의 일부이다.

<action
    path="/shoppingCart"
    type="org.anyframe.sample.struts.web.action.ShoppingCartAction"
    name="dispatchForm"
    parameter="dispatchMethod"
    scope="request">
    <forward name="add" path="/dispatchActionView.do" />
    <forward name="list" path="/dispatchActionView.do" />
    <forward name="update" path="/dispatchActionView.do" />
    <forward name="delete" path="/dispatchActionView.do" />
</action>

DispatchAction과 비슷하나 메소드를 찾을 때 parameter 속성에서 찾는 것이 아니라 리소스 번들에 키 값을 이용해 찾게 된다. LookupDispatchAction을 사용하게 되면 하나의 HTML Form에 submit 버튼이 여러 개 있는 경우 더 쉽게 처리할 수 있다.

이 클래스는 하나의 어플리케이션 모듈에서 다른 모듈로 스위칭을 지원하고 어플리케이션의 리소스를 컨트롤한다. prefix, page 파라메터를 통하여 어플리케이션 모듈을 전환할 수 있다. 사용 예는 다음과 같다.

<action path="/toModule"
          type="org.apache.struts.actions.SwitchAction"/>

/toModule.do?prefix=/moduleB&page=/index.do

디폴트 모듈로 전환하고자 하는 경우 prefix를 null String으로 설정하여 호출할 수 있다.

/toModule.do?prefix=&page=/index.do

Struts Tag library의 종류는 아래와 같다.

사용법은 다른 Tag Library와 같다. 아래는 JSP에 taglib 선언한 예이다.

<%@ taglib
        uri="http://struts.apache.org/tags-bean"
        prefix="bean"%>

많은 경우 Tag Library 들은 자바빈즈와 함께 사용된다. 자바 빈은 HTML 폼의 입력 필드에 대응하는 프로퍼티들을 포함하는 ActionForm일 수도 있지만 Value Object들도 사용할 수 있다.

<tr>
    <td colspan="4" align="center">
    <html:link page="/html-link.do?doubleProperty=321.321&longProperty=321321">
        Double and long via hard coded changes
    </html:link>
    </td>
</tr>

<html:password property="password"
          size="15" maxlength="16" redisplay="false" />

<logic:notEmpty name="userSummary" property="addresses">
<!—이 부분은 address Collection 의 모든 객체들을 돌며 반복 출력하는 logic 태그로 구성하면 됨 -->
</logic:notEmpty>

<logic:iterate id="address" name="usersSummary" property="addresses">
<!—address 객체를 테이블 형태로 출력한다. -->
</logic:iterate>

<td><bean:message key="global.user.firstName"/>:</td>

<td>Hello <bean:write name="user" property="firstName"/>:</td>

JSTL은 데이터의 포맷, 반복 처리, 조건 처리 등 전형적인 프리젠테이션 레이어를 위한 표준 구현을 제공하기 때문에, JSP 작성자들이 어플리케이션 개발에 집중하는데 도움이 되며 일반적인 기능을 커스텀 태그 라이브러리의 표준 세트로 패키징했기 때문에 JSP 작성자들이 스크립팅 엘리먼트에 대한 필요를 줄이고 관련된 관리 비용을 피할 수 있도록 한다. 이에 반해 pure 자바 코드에 비해 시스템 리소스를 많이 사용하며 극한 부하 상황에서는 2~3배의 성능 저하가 발생할 수 있으므로 성능이 이슈가 되는 경우 사용에 유의하도록 한다.

Struts Bean, Logic 태그들은 JSTL로 바꾸어 더 쉽게 사용할 수 있다. 다음은 JSTL Core 태그 중 조건 분기 및 Collection loop 처리의 예이다.

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
..

<!-- 테이블의 리스트 반복부  -->
<c:choose>                                      	
    <c:when test="${page.totalCount <= 0}">
        <tr class="ct_list_pop">
            <td colspan="11" align="center">::: 조회된 사용자 정보가 없습니다. :::</td>	
        </tr>
        <tr>
            <td colspan="11" bgcolor="D6D7D6" height="1"></td>
        </tr>
    </c:when>
    <c:otherwise>
        <c:forEach var="userVO" items="${page.list}" varStatus="status">
            <tr class="ct_list_pop">
                <td align="center">
                    <c:out value="${status.count + ((page.currentPage - 1) * pageSize) }"/>
                </td>
                <td></td>
                <td align="left">
                    <a href="javascript:fncGetUser('<c:out value="${userVO.userId}"/>');">
                        <c:out value="${userVO.userId}"/>
                    </a>
                </td>
                <td></td>
                <td align="left"><c:out value="${userVO.userName}"/></td>
                <td></td>
                <td align="center" style="padding-right:3px;"><c:out value="${userVO.ssn}"/>
                </td>
                <td></td>
                <td align="center"><c:out value="${userVO.cellPhone}"/></td>
                <td></td>
                <td align="left"><c:out value="${userVO.email}"/></td>		
            </tr>
            <tr>
                <td colspan="11" bgcolor="D6D7D6" height="1"></td>
            </tr>
        </c:forEach>
    </c:otherwise>
</c:choose>
..

<init-param>
    <param-name>chainConfig</param-name>
    <param-value>org/apache/struts/tiles/chain-config.xml</param-value>
</init-param>

<plug-in className="org.apache.struts.tiles.TilesPlugin">
    <set-property
        property="definitions-config"
        value="/WEB-INF/tiles-defs.xml"/>
</plug-in>

 <%@ taglib
      uri="http://struts.apache.org/tags-tiles" prefix="tiles" %>

어플리케이션이 국제화를 지원한다고 해서 모든 언어와 지역에서 곧바로 쓸 수 있는 것을 의미한다는 것은 아니다. 국제화를 지원한다는 것은 언어나 지역에 영향을 받는 부분과 영향을 받지 않는 코드를 분리하여 쉽게 지역화될 수 있게 만들었다는 것을 의미한다.

국제화 지원 시 위의 특징들 중 일부만 골라서 구현하는 것은 별 의미가 없다. 모두 지원하든지 지원하지 않든지 둘중의 하나이다. cf.) Anyframe 에서는 모든 국제화 문제를 고려할 수는 없고 Core Class 인 java.util.Locale, java.util.ResourceBundle 위주로 논의되었다. Anyframe 에서 제공하는 리소스들은 텍스트와 이미지에 초점이 맞추어져 있다. MessageResource Bundle은 PropertyResourceBundle Class 의 규약에 따라 만들어야 한다. 확장자 .properties 의 텍스트 파일로, 메시지들은 key=value와 같은 형식으로 작성해야 함은 이미 말한 바 있다. 또한 클래스처럼 찾아오기 때문에 클래스패스 상에 작성해야 한다. MessageResource Bundle 이 여러 개 있을 경우 Struts는 번들 중 하나에서 메시지를 찾을 때 기본 이름과 지역을 사용하여 이름이 가장 가깝게 일치하는 번들을 찾는다. 찾는데 실패하면 기본 번들을 사용한다. 다음은 메시지 정의의 예이다.

# error message
common.msg.authorization.error=You can not access this page.
..
# text resource
common.ui.title=eMarketPlace
..

다음은 ActionMessage 생성 시 메시지 키를 설정하는 예이다.

erros.add(ActionErrors.GLOBAL_ERROR, new ActionMessage("common.msg.authorization.error"));

다음은 Bean 태그 라이브러리의 MessageTag 를 사용하여 해당 메시지 키에 대한 실제 텍스트 value를 표시하는 예이다.

<head>
    <title><bean:message key="common.ui.title"/></title>
</head>

Validator를 사용하기 위해서는 struts-config.xml에 org.apache.struts.validator.ValidatorPlugIn을 등록해야 한다. ValidatorPlugIn은 property로 pathname을 가지며 pathname의 값으로는 Struts에서 기본으로 제공하고 있는 검증 규칙이 정의되어 있는 validator-rules.xml과 사용자가 검증한 ActionForm에 대한 검증 규칙을 정의한 xml파일을 세팅한다.

다음은 Validator Plug-in을 설정한 struts-config-validator.xml 의 일부분이다.

<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
    <set-property property="pathnames"
        value="/org/apache/struts/validator/validator-rules-compressed.xml,
        /WEB-INF/validator/validation-sample.xml" />
</plug-in>

Struts에서는 일반적으로 많이 사용하고 있는 검증 규칙에 대한 정의가 포함된 validator-rules.xml과 validator-rules-compressed.xml을 struts-core-1.3.x.jar파일에 같이 배포하고 있다. validation-sample.xml은 검증하고자 하는 ActionForm에 대한 formset 설정 이 포함되어 있다.

Struts에서 기본적으로 많은 검증 규칙을 제공하고 있기 때문에 사용자가 검증규칙을 새로 작성하는 번거로운 작업이 많이 줄어들었다. 다음은 validation rule 설정의 예이다.

<validator name="minlength"
    classname="org.apache.struts.validator.FieldChecks"
    method="validateMinLength"
    methodParams="java.lang.Object,
            org.apache.commons.validator.ValidatorAction,
            org.apache.commons.validator.Field,
            org.apache.struts.action.ActionErrors,
            javax.servlet.http.HttpServletRequest"
        epends="required"
        msg="errors.minlength">
    <javascript>[function validateMinLength(form) {
    // javascript를 사용하고자 할 경우 여기에 작성하면 된다.
    }
    </javascript>
</validator>

name 은 unique 해야 하며 다른 rule에서 참조할 때도 name을 사용하게 된다. classname과 method는 실제 validation 로직이 들어있는 클래스와 메소드의 이름이다. depends 는 validator rule 간의 우선순위이다. 위의 예는 minlength를 체크하기 전에 required 라는 validation rule을 먼저 수행한다는 뜻이다. depends="required,integer"라고 되어있다면 null 인지 체크하고, Integer 인지 체크하고 그 다음에 minlength를 체크하겠다는 뜻이다. msg 는 validation error 가 발생했을 때 뿌려줄 메시지를 resource bundle 에서 가져올 때 사용할 key 값이다.

기본적으로 다음의 값들을 사용한다.

# Struts Validator Error Messages 
errors.required={0} is required.
errors.minlength={0} can not be less than {1} characters.
errors.maxlength={0} can not be greater than {1} characters.
errors.invalid={0} is invalid.
errors.byte={0} must be a byte.
errors.short={0} must be a short.
errors.integer={0} must be an integer.
errors.long={0} must be a long.
errors.float={0} must be a float.
errors.double={0} must be a double.
errors.date={0} is not a date.
errors.range={0} is not in the range {1} through {2}.
errors.creditcard={0} is an invalid credit card number.
errors.email={0} is an invalid e-mail address.

다음은 validator-rules.xml에 포함되어 있는 검증 규칙에 대한 설명이다.

Validator를 이용할 때는 ActionForm이 아닌 org.apache.struts.validator.ValidatorForm을 상속 받아야 한다. ValidatorForm은 유효성 검증에 필요한 validate() 메소드를 포함하고 있으며 검증 실패 시 ActionErrors에 error message를 셋팅해서 리턴한다.

다음은 ValidatorForm을 상속받은 ValidatorSampleForm.java 의 일부분이다.

public class ValidatorSampleForm extends ValidatorForm{

    private String userName;
    private String userId;
    private String password;
    private String phoneNumber;
    private String email;
    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }
    //중략
    }
}

validator-rules.xml에 등록된 검증 규칙과 ActionForm과의 매핑을 하기 위해서는 formset을 정의해야 한다. 다음은 <form>의 attribute들이다.

다음은 ValidatorSampleForm에 Struts에서 제공한 검증규칙을 적용하기 위해 설정한 validation-sample.xml 의 일부분이다.

<form name="validatorSampleForm">
    <field property="userName" depends="required,minlength,maxlength">
        <arg key="validator.sample.userName" position="0"/>
        <arg name="minlength" key="${var:minlength}" resource="false" position="1"/>
        <arg name="maxlength" key="${var:maxlength}" resource="false" position="1"/>
        <var>
            <var-name>minlength</var-name>
            <var-value>4</var-value>
        </var>
        <var>
            <var-name>maxlength</var-name>
            <var-value>10</var-value>
        </var>
    </field>
        <!-- 중략  -->
    <field property="email" depends="email">
        <arg key="validator.sample.email" position="0"/>
    </field>
</form>

<form>의 name attribute에 struts-config.xml에 등록된 ActionForm의 form name을 등록하고 <form의 하위의 <field>에 ActionForm의 유효성 검사를 할 attribute에 대한 설정을 등록한다. 위의 Sample에서는 userName은 필수 입력값에, 4자리 이상 10자리 이하로 설정을 했고 email은 e-mail 주소 검증 규칙을 적용했다. 유효성 검증에 실패하면 arg 값을 에러 메시지의 arguements로 설정하여 돌려주게 된다. 기본으로 arg0-arg3 요소는 message resources에서 해당 key 값으로 찾게되고. resource 속성이 false로 설정되면 message resources에서 찾지 않고 해당 값을 바로 돌려준다. validation.xml은 크게 global 과 formset 으로 나누는데 global은 file 내에서 상수로 사용될 값들을 정의한다. formset은 다시 constant 와 form으로 나누는데 constant는 global과 같으며 form 은 validation을 적용할 ActionForm 에 매핑된다. 참고로 formset 에는 language와 country라는 attribute 가 있어서 다국어 지원이 가능하다.

RequestProcessor가 들어온 Request 정보를 이용해 ActionForm을 생성할 때 유효성 검증을 실행하기 위해서는 struts-config.xml의 <action>에 validate="true"를 설정해야 한다.

다음은 struts-config.xml의 <action>에 Validator를 적용하기 위한 설정을 보여주는 struts-config-validator.xml 의 일부이다.

<action
    path="/validatorSample"
    type="org.anyframe.sample.struts.basic.ValidatorSampleAction"
    validate="true"
    cancellable="true"
    scope="request"
    input="/basic/validatorSample.jsp" 
    name="validatorSampleForm">
    <forward name="success" path="/basic/validatorSuccess.jsp"></forward>
</action>

다음은 <exceptions>의 attribute들이다.

다음은 struts-config.xml 파일에서 global-exceptions 설정에 대한 예제이다.

<global-exceptions>
    <exception key="global.exception.message" 
        path="/basic/globalException.jsp" 
        type="java.lang.Exception" 
        handler="org.apache.struts.action.ExceptionHandler" />
</global-exceptions>

Action 클래스의 execute() 메소드에서 Exception이 발생하면 ExceptionHandler에서 exception message key값(global.exception.message)을 이용해 Resource Bundle에서 Exception Message를 세팅한 후 path에 설정된 /basic/globalException.jsp로 forwarding한다.

다음은 <exception>의 attribute들이다.

다음은 struts-config-login.xml 파일에서 <action> 하위의 <exception> 설정에 대한 예제이다.

<action
    path="/login"
    type="org.anyframe.sample.struts.action.LoginAction"
    name="userForm"
    scope="request"
    input="/basic/login.jsp">
    <exception key="error.password.mismatch" path="/basic/login.jsp" 
        type="javax.security.auth.login.FailedLoginException" />
    <forward name="success" path="/basic/main.jsp" />
</action>

Global Level Exception 설정과 달리 모든 Action에서 발생하는 Exception이 아닌 LoginAction의 execute() 메소드에서 발생하는 Exception에 대한 처리를 담당한다. FailedLoginException이 발생했을 경우 /basic/login.jsp로 forwarding되고, 이 외 다른 Exception이 발생할 경우 Global Level Exception에 설정된 error page로 forwarding된다.

아래는 인증 및 권한 처리를 수행하고 있는 DefaultRequestProcessor의 processRoles 메소드 구현 로직의 일부이다.

protected boolean processRoles(HttpServletRequest request,
                        HttpServletResponse response, ActionMapping mapping)
                                throws IOException, ServletException {
    // [public] Is this action protected by role requirements?
    String roles[] = mapping.getRoleNames();
    if ((roles == null) || (roles.length < 1)) {
        return (true);
    }
	
    Subject _subject = null;
	
    HttpSession session = request.getSession();
    _subject = (Subject) session.getAttribute("subject");
	
    if (_subject == null) {
        log.debug("#AuthenticationException is encounted");
	    
    ExceptionConfig config = mapping.findException(AuthenticationException.class);
	    
    if(config == null ){
        mapping.findException(Exception.class);
    }
	    
    AuthenticationException ae = new AuthenticationException(config.getKey(), request
	            .getRequestURI());
	// 중략 ...

위의 소스 코드에서 보듯이 Struts 속성 정의 파일의 특정 action 매핑 정보에 role이 부여되었을 때 Session에 저장된 Subject에서 사용자 인증 정보를 확인한 후, 인증되지 않았을 경우 AuthenticationException을 throw한다. Exception 메시지의 key는 Struts 속성 정의 파일 <exception> 내에 정의된 AuthenticationException에 대한 key와 동일하며, 정의되지 않았을 경우엔 java.lang.Exception에 대한 key와 동일하다. 아래는 struts-config-exception.xml 파일의 일부로 AuthenticationException을 Global Level Exception으로 등록한 예이다.

<global-exceptions>
     <exception key="common.msg.authentication.error" 
                    path="/WEB-INF/jsp/struts/common/error.jsp"
                    type="org.anyframe.struts.util.AuthenticationException" 
                    handler="org.anyframe.struts.action.DefaultExceptionHandler" />
</global-exceptions>

메시지리소스로 등록하는 메시지 properties 파일에는 common.msg.authentication.error 의 메시지 키에 대하여

common.msg.authentication.error=Authentication Fail 
        - You are not logon or Session expired. Please try re-logon. - {0}.
common.msg.authorization.error=You can not access this page. - {0}.
..

다음은 AbstractActionSupport를 상속받아 구현한 LoginAction.java 이다.

public class LoginAction extends AbstractActionSupport {
	
    public Log getLogger() throws Exception {
        return LogFactory.getLog(this.getClass().getName());
    }
	
    public ActionForward process(ActionMapping mapping, ActionForm form,
                HttpServletRequest request, HttpServletResponse response)
                    throws Exception {
        AuthenticationService authenticationService = 
                (AuthenticationService) getService("authenticationService");

        UserForm userForm = (UserForm) form;
        UserVO userVO = new UserVO();
        BeanUtils.copyProperties(userVO, userForm);

        Subject subject = authenticationService.authenticate(userVO);

        HttpSession session = request.getSession();

        session.setAttribute("subject", subject);
        return (mapping.findForward("success"));
    }
}

위의 소스코드에서는 LoginAction 클래스에서 개별 Logger를 사용하기 위해 AbstractActionSupport의 getLogger 메소드를 오버라이드하고 있다.

다음은 DefaultDispatchActionSupport를 상속받아 구현한 ProductAction.java 이다.

public class ProductAction extends DefaultDispatchActionSupport {

    public ActionForward get(ActionMapping mapping, ActionForm form,
            HttpServletRequest request, HttpServletResponse response)
            throws Exception {
            
        // TODO : 단건 조회 기능 관련 로직
			
        return mapping.findForward("success_get");
			
	}

    public ActionForward list(ActionMapping mapping, ActionForm form,
            HttpServletRequest request, HttpServletResponse response)
            throws Exception {
		
        // TODO : 리스트 조회 기능 관련 로직
		
        return mapping.findForward("success_list");
    }
}

DefaultDispatchActionSupport를 상속한 Action 클래스는 DispatchAction이므로, AbstractActionSupport를 상속한 Action 클래스 작성과 다르게 한 Action 내에 여러 메소드 정의가 가능하다.

다음은 AnyframeMiPAction을 상속받아 구현한 클래스의 일부로, process 메소드 내부에서 비즈니스 서비스를 실행하고, 그 결과값을 반환하고 있다.

public void process(ActionMapping mapping, PlatformRequest request,
        VariableList inVl, DatasetList inDl, VariableList outVl,
            DatasetList outDl) throws Exception {
    this.inVl = inVl;
    this.inDl = inDl;
    this.outVl = outVl;
    this.outDl = outDl;

    MiPUserService userService = (MiPUserService)getService("userService");
    Dataset ds = userService.getUserList(inVl);
    outDl.addDataset("ds_access",ds);

    // 중략 ...
}

Anyframe 에서는 Page 처리에 대한 구현이 편리하도록 page 관련 Tag Library인 Page Navigator Tag를 제공한다. 이 태그를 사용하면 리스트 화면을 출력할 때 Tag Library를 사용하여 간단히 Page Navigator를 출력해줄 수 있다. 이 태그를 사용하기 위해 JSP의 상단에 다음과 같이 anyframe-pagenavigator.tld 파일을 taglib으로 지정해 준다.

<%@ taglib uri="http://www.anyframejava.org/tags" prefix="anyframe" %>

prefix를 'anyframe'으로 정의할 경우 아래와 같이 태그를 사용할 수 있다.

<anyframe:pagenavigator linkUrl="javascript:fncGetUserList(2);" 
       pages="<%=resultPage%>" formName="listForm"
    firstImg="sample/images/ct_btn_pre.jpg" 
    prevImg="sample/images/ct_btn_pre01.jpg" 
    lastImg="sample/images/ct_btn_next.jpg" 
    nextImg="sample/images/ct_btn_next01.jpg" />

anyframe을 prefix로 하는 태그로 tag name은 pagenavigator이다 . 이 때 pages라는 attribute는 반드시 org.anyframe.pagination.Page 타입의 객체를 설정해줘야 함에 유의하도록 한다.

다음은 struts-config-exception.xml 의 일부로 선언적인 exception 처리의 예이다.

<action path="/exceptionHandling"
    type="org.anyframe.struts.sample.action.ExceptionHandlingAction"
    scope="request">
    <exception type="org.anyframe.exception.BaseException"
        key="common.msg.action.error"
        path="/extensions/error.jsp" 
        handler="org.anyframe.struts.action.DefaultBaseExceptionHandler"/>
</action>

위 설정을 통해 ExceptionHandlingAction 수행시 Exception이 발생한 경우, 발생한 Exception이 BaseException 유형이면 DefaultBaseExceptionHandler를 통해 해당 Exception이 처리된다. 아래와 같이 <global-exceptions> 내에 Exception에 대한 처리를 공통 정의할 수도 있다. 만일, <action>과 <global-exceptions> 내에 동일한 Exception이 정의되어 있는 경우 <action>에 정의된 Exception 처리가 우선 적용된다.

<global-exceptions>
    <exception path="/extensions/error.jsp"
        key="common.msg.authentication.error"
        type="org.anyframe.struts.util.AuthenticationException"
        handler="org.anyframe.struts.sample.common.SampleExceptionHandler" />
    <exception path="/extensions/error.jsp"
        key="common.msg.authorization.error"
        type="org.anyframe.struts.util.AuthorizationException"
        handler="org.anyframe.struts.sample.common.SampleExceptionHandler" />
    <exception path="/extensions/error.jsp" 
        key="common.msg.base.error"
        type="org.anyframe.struts.util.BaseException"
        handler="org.anyframe.struts.sample.common.SampleExceptionHandler" />
</global-exceptions>

다음은 DB 기반의 사용자 인증 처리를 수행하는 서비스 DBAuthenticationServiceImpl.java 의 일부분이다.

public class DBAuthenticationServiceImpl implements AuthenticationService {

    // 중략 ...
     
    public Subject authenticate(org.anyframe.sample.struts.services.UserVO userVO)
            throws Exception {

        Subject subject = null;
        ResultSet rsu = null;
        PreparedStatement pstmt = null;
        Connection conn = null;

        String userId = userVO.getUserId();
        String password = userVO.getPassword();

        try {
            conn = dataSource.getConnection();

            pstmt = conn.prepareStatement(sqlQuery);

            pstmt.setString(1, userId);
            pstmt.setString(2, password);

            // 입력된 사용자 정보를 기반으로 등록된 사용자 정보 검색
            rsu = pstmt.executeQuery();

            if (rsu.next()) {

                userId = rsu.getString(1);
                String userName = rsu.getString(2);
                rsu.getString(3);
                String grade = rsu.getString(5);

                Set principals = new HashSet();
                Set credentials = new HashSet();

                principals
                    .add(new TypedPrincipal(userName, TypedPrincipal.USER));

                StringTokenizer tokens = new StringTokenizer(grade, ",");
                while (tokens.hasMoreTokens()) {
                    principals.add(new TypedPrincipal(tokens.nextToken(),
                            TypedPrincipal.GROUP));
                }

                // 사용자 정보를 Subject 객체에 저장
                subject = new Subject(false, principals, credentials,
                        credentials);
            } else {
                throw new FailedLoginException();
            }
        }catch (Exception e) {
            // 중략 ...
        } finally {
            // 중략 ...
        }
        return subject;
    }
}

다음은 앞서 구현한 DBAuthenticationServiceImpl 클래스의 속성 정의 파일인 context-authentication.xml의 일부이다. USER_ID와 PASSWORD 정보를 이용하여 사용자 정보와 그룹(Role) 정보를 조회하는 쿼리문을 속성값으로 정의하고 있음을 알 수 있다. 해당 서비스는 이 쿼리문을 이용하게 될 것이다.

<bean id="authenticationService"
    class="org.anyframe.sample.struts.services.impl.DBAuthenticationServiceImpl">
    <property name="dataSource" ref="dataSource" />
    <property name="sqlQuery"
        value="SELECT u.USER_ID,u.USER_NAME,u.PASSWORD,u.ENABLED,a.AUTHORITY 
        FROM USERS u, AUTHORITIES a 
        WHERE u.USER_ID=? and u.PASSWORD=? and a.USER_ID = u.USER_ID" />
</bean>

다음은 LoginAction.java 로, 앞서 정의한 서비스를 이용하여 사용자의 유효성을 체크하고, 유효한 사용자 정보를 Session에 저장하는 역할을 수행하고 있다.

public ActionForward process(ActionMapping mapping, ActionForm form,
        HttpServletRequest request, HttpServletResponse response) 
        throws Exception {
	
    AuthenticationService authenticationService = 
            (AuthenticationService) getService("authenticationService");

    UserForm userForm = (UserForm) form;
    UserVO userVO = new UserVO();
    BeanUtils.copyProperties(userVO, userForm);

    Subject subject = authenticationService.authenticate(userVO);

    HttpSession session = request.getSession();

    session.setAttribute("subject", subject);
		
    return (mapping.findForward("success"));
}

다음 그림에서 보여지는 사용자 정보를 기반으로 어떻게 특정 URL에 대한 접근 제어가 이루어지는지 살펴보도록 하자.

다음은 특정 URL에 접근 가능한 사용자 그룹(Role)을 지정하고 있는 Action 매핑 정보이다.

<action path="/authorization"
    type="org.anyframe.struts.action.DefaultForwardAction"
    roles="admin"
    scope="request"
    parameter="/extensions/accessSuccess.jsp">
</action>

위의 예에서 tester라는 USER_ID를 가진 사용자는 admin이란 GROUP에 속해 있으므로 authorization.do라는 요청을 수행할 수 있게 된다. roles 속성값이 부여되지 않은 Action의 경우에는 모든 사용자가 접근할 수 있음을 의미한다.

Servlet 2.3 이상에서는 웹 컨텍스트(하나의 웹 어플리케이션) 라이프 사이클 관련 이벤트인 ServletContextEvent와 Session의 라이프 사이클 관련 이벤트인 HttpSessionEvent가 추가되었다. 따라서 web.xml에 이러한 웹 어플리케이션의 이벤트에 응답하는 Context Event Listner를 등록해줌으로써 해당 Listener 구현 클래스에서 웹 컨텍스트 초기나 종료 시점에 무언가 유용한 작업 (ex. 어플리케이션의 초기 속성 로드, 서비스 컨테이너 기동 등..)을 수행할 수 있도록 해야 한다. org.springframework.web.context.ContextLoaderListener 클래스는 ServletContextListener 인터페이스를 구현하고 있으며, 어플리케이션이 Servlet 컨테이너에 의해 처음으로 로드되는 시점에 발생하는 startup 이벤트와 어플리케이션이 종료되는 시점에 발생하는 shutdown 이벤트를 처리할 수 있도록 다음의 두 메소드를 포함한다.

다음은 Spring Framework 연계를 위한 web.xml (ContextLoaderListener, contextConfigLocation) 의 일부이다.

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
        /config/spring/context-*.xml
    </param-value>
</context-param>
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>