Filter

목차

1. 필터란?

2. 인터페이스 및 클래스

3. 필터 설정

[필터(Filter)란 무엇인가?]

HTTP 요청과 응답을 변경할 수 있는 재사용 가능한 코드이며, 서블릿 2.3 규약에 새롭게 추가되었다.
필터는 객체의 형태로 존재하며 클라이언트로부터 오는 요청(request)과 최종자원(서블릿/JSP/기타 문서)
사이에 위치하며 클라이언트의 요청 정보를 알맞게 변경할 수 있으며, 또한 필터는 최종 자원과 클라이언트로 가는
응답(response) 사이에 위치하여 최종 자원의 요청 결과를 알맞게 변경할 수 있다.

---

그림으로 보면 자원이 받게 되는 요청 정보는 클라이언트와 자원 사이에 존재하는 필터에 의해 변경된 요청정보가 되며,
클라이언트가 보게 되는 응답 정보는 클라이언트와 자원사이에 존재하는 필터에 의해 변경된 응답정보가 된다.
필터는 클라이언트와 자원사이에 1개가 존재하는 경우가 보통이지만, 여러개의 필터가 모여서 하나의 체인(chain)을 형성할 수 있다.

여러개의 필터가 모여서 하나의 체인을 형성할 때 첫번째 필터가 변경하는 요청정보는 클라이언트의 요청정보가 되지만,
체인의 두번째 필터가 변경하는 요청정보는 첫번째 필터를 통해서 변경된 요청정보가 된다. 즉 요청정보는 변경에 변경에 변경을 거듭한다.
응답정보의 경우도 요청정보와 비슷한 과정을 거치지만 차이점은 필터의 적용순서가 요청때와는 반대다.

또한 필터는 요청/응답 정보를 변경하는 역할 뿐 아니라 흐름을 변경하는 역할도 할 수 있다.

즉 필터는 클라이언트의 요청을 필터체인의 다음단계에 보내는 것이 아니라, 다른 자원의 결과를 클라이언트에 전송할 수도 있다.

필터의 이러한 기능은 사용자 인증이나 권한 체크와 같은 곳에서 사용 가능하다.

---

[필터 관련 인터페이스 및 클래스]

필터를 구현하는데 핵심적인 역할을 하는 인터페이스/클래스가 3개 있다. 그것은 바로
javax.servlet.Filter 인터페이스, javax.servlet.ServletRequestWrapper클래스, javax.servlet.ServletResponseWrapper클래스이다.
이 중 Filter 인터페이스는 클라이언트와 최종 자원 사이에 위치하는 필터를 나타내는 객체가 구현해야 하는 인터페이스다.
그리고 ServletRequestWrapper 클래스와 ServletResponseWrapper 클래스는 필터가 요청을 변경한 결과 또는 응답을 변경한 결과를 저장할 래퍼 클래스를 나타낸다.
개발자는 이 두 클래스를 알맞게 상속하여 요청/응답 정보를 변경하면 된다.

---

[필터 인터페이스]

Filter 메소드는 다음과 같은 메소드가 선언되어 있다.

• public void init(FilterConfig filterConfig) throw ServletException : 필터를 웹 콘테이너에 생성한 후 초기화할 때 호출
• public void doFilter(ServletRequest request, SevletResponse response, FilterChain chain) throws java.io.IOException, ServletException : 체인을 따라 다음에 존재하는 필터로 이동한다. 체인의 가장 마지막에는 클라이언트가 요청한 최종 자원이 위치한다.
• public void destroy() : 필터가 웹 콘테이너에서 삭제될 때 호출된다.
• 위 메소드에서 필터의 역할을 하는 메소드가 바로 doFilter() 메소드이다. 서블릿 콘테이너는 사용자가 특정한 자원 요청 시 그 자원 사이에 필터가 존재하는 경우
  그 필터 객체의 doFilter() 메소드를 호출하며, 바로 그 시점부터 필터가 작용하기 시작한다. 아래는 Filter 구현 예이다.

  public class FirstFilter implements javax.servlet.Filter {

     public void init(FilterConfig filterConfig) throws ServletException {
        // 필터 초기화 작업
     }

     public void doFilter(ServletRequest request,
                          ServletResponse response,
                          FilterChain chain)
                          throws IOException, ServletException {
        chain.doFilter(request, response);       
     }

     public void destroy() {
        // 주로 필터가 사용한 자원을 반납
     }
  }

만약 클라이언트의 자원 요청이 필터를 거치는 경우, 클라이언트의 요청이 있을 때마다 doFilter() 메소드가 호출된다. 위 코드에서 doFilter() 메소드의 세번째 파라미터로 FilterChain 객체를 전달받는데, 이는 클라이언트가 요청한 자원에 이르기까지 클라이언트 요청이 거쳐가게 될 필터 체인을 나타낸다. FilterCahing을 사용하여 필터는 체인에 있는 다음 필터에 변경한 요청과 응답을 건내줄 수 있다.

또한 요청을 필터링한 필터 객체에서 응답도 필터링이 된다. doFilter()메소드에서 이루어지는 작업 순서를 정리해보면 아래와 같다.

• request 파라미터를 이용하여 클라이언트 요청 필터링(RequestWrapper 클래스를 사용하여 클라이언트의 요청을 변경)
• chain.doFilter()메소드 호출(요청의 필터링 결과를 다음 필터에 전달)
• 필터 체인을 통해서 전달된 응답 데이터를 변경하여 그 결과를 클라이언트에 전송

---

[필터의 설정]

필터를 사용하기 위해서는 어떤 필터가 어떤 자원에 대해서 적용된다는 것을 서블릿/JSP 컨테이너에 알려주어야 한다. 서블릿 규약은 웹 어플리케이션과 관련된 설정은 웹 어플리케이션 디렉토리의 /WEB-INF 디렉토리에 존재하는 web.xml 파일을 통해 하도록 하고 있으며, 필터 역시 web.xml 파일을 통해 설정한다. web.xml파일에서 필터를 설정하기 위해서는 아래와 같이 와 태그를 활용하면 된다.

  <web-app>

     <filter>
        <filter-name>HighlightFilter</filter-name>
        <filter-class>javacan.filter.HighlightFilter</filter-class>
        <init-param>
           <param-name>paramName</param-name>
           <param-value>value</param-value>
        </init-param>
     </filter>

     <filter-mapping>
        <filter-name>HighlightFilter</filter-name>
        <url-pattern>*.txt</url-pattern>
     </filter-mapping>

  </web-app>

태그 간단 설명

• 어플리케이션에서 사용될 필터를 지정
• 특정 자원에 대해서 어떤 필터를 사용할지 지정(위 예제의 경우 txt 확장자를 갖는 자원을 요청할 경우 HighlightFilter가 사용되도록 지정됨)
• 필터가 초기화될때, 즉 init() 메소드가 호출될 때 전달되는 파라미터 값. 주로 필터를 사용하기 전에 초기화해야하는 객체나 자원을 할당할 때 필요한 정보를 제공하기 위해 사용된다.
• 클라이언트가 요청한 특정 URI에 대해서 필터링 할 때 사용된다. 기준은 아래와 같다
  • ’/’로 시작하고 ‘/*‘로 끝나는 url-pattern은 경로 매핑 시 사용됨
  • ‘*.’로 시작하는 url-pattern은 확장자에 대한 매핑 시 사용됨
  • 나머지 다른 문자열은 정확한 매핑을 위해 사용됨

---

서블릿 필터(Sevlet Filter)

java.servlet.Filter 인터페이스를 상속받아 구현하는 클래스이다.

HTTP 요청과 응답 사이에서 전달되는 데이터를 가로채어

서비스에 맞게 변경하고 걸러내는 필터링 작업을 수행한다.

요청과 응답의 처리 내용

Request: 보안 관련 사항, 요청 헤더와 바디 형식 지정, 요청 log 기록

Response: 응답 스트림 압축, 응답 스트림 내용 추가 및 수정, 새로운 응답 작성

코드 작성하는 법

1. DD설정 (Web.xml)

필터 설정

필터설정이름 필터를 구현한 클래스 // filter 에서 사용할 값 설정 초기값 설정 이름 설정값

필터 맵핑-1 .url 패턴 (우선적용)

등록된 필터이름 요청한 페이지 형식

필터 맵핑-2. 서블릿 매핑

등록된 필터이름

<servlet-name> 적용할 서블릿명 </servlet name>

2. 클래스 설정 (java)

public class EncodingFilter implements Filter { // 필터 인터페이스 상속

@Override
public void destroy() {

삭제시 작업 설정

}

@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {

필터링 할 작업 설정 (chain 작성 필요)

}

@Override
public void init(FilterConfig filterConfig) throws ServletException {

필터 호출시 작업 설정

}

필터 체인(Filter Chain)이란?

여러 개의 필터가 서로 연결되어 있고 순서대로 doFilter() 메소드를 이용하여 실행시키는 인터페이스이다.

chain과 doFilter() 메소드를 이용하여 다음 필터를 실행 할 수 있다.

---

예제

index

아이디와 비밀번호, 이름을 입력받아 회원가입 하는 페이지 작성 (Post방식)

web.xml

필터를 등록하고 매핑해준다.

encoding이라는 필터를 com.greedy.(중략).EncodingFilter 클래스에 구현을 하고,

필터의 초기값 이름은 encoding-type이고 필터 값(인코딩) UTF-8이다.

FirstFilter

필터에서 사용할 메소드를 가지고 있는 클래스

Filter 파일로 어노테이션 형식이 WebFilter이고 /first이하 모든 것을 mapping하였다.

(Filter 클래스는 Filter 인터페이스를 상속한다.)

init() 메소드로 필터가 호출되고, doFilter() 메소드는 Servlet으로 request가 전달되기 전에 가로채는 역할을 한다.

필터 인스턴스가 소멸될 때 호출되는 메소드이다.

EncodingFilter

필터를 사용하는 클래스로 해당 예제에서는 인코딩 처리를 하였다.

우선 init() 메소드를 상속 받아 모든 속성이 담겨 있는 filterConfig에서 getInitParameter() 메소드를 이용하여, 인코딩 타입(encoding-type)을 변수에 담아주었다.

그리고 doFilter에서 ServletRequest 타입인 request를 래퍼 클래스인 HttpServletRequest로 다운캐스팅하여, setCharacterEncoding() 메소드를 이용하여 인코딩을 해준다.

여기서 chain.doFilter(hrequest, response); 를 사용하여 다음 필터를 실행한다.

FirstFilterTestServlet

필터된 것을 응답해주는 서블릿이다.