JSP - 필터(Filter)

필터(Filter)

• HTTP 요청과 응답을 변경할 수 있는 재사용 가능한 클래스.
• 필터는 객체의 형태로 존재하며 클라이언트에서 오는 요청(request)과 최종 자원 (jsp, servlet 등) 사이에 위치해 클라이언트 요청 정보 알맞게 변경할 수 있음. 반대로 최종 자원과 클라이언트로 가는 응답(response)사이에 위치해 최종 자원의 요청 결과 알맞게 변경할 수도 있음.
• 필터사용 ex) JSP/서블릿 등을 실행하기 이전에 요청이 올바른지 또는 자원에 접근할 수 있는 권한을 가졌는지 여부를 미리 처리할 수 있음. JSP나 서블릿이 생성한 응답 데이터 변경하거나취소할 수 있는 기능을 구현할 수도 있음.

 

1. 필터(filter) 인터페이스

1. public void init(FilterConfig filterConfig) throws ServletException : 필터 초기화 할때 호출됨.

2. public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException : 필터 기능 수행. chain이용해 체인의 다음 필터로 처리를 전달할 수 있음.

3. public void destroy() : 필터가 웹 컨테이너에서 삭제될 때 호출된다.

 

-->필터의 역할을 하는 메서드 doFilter() : 서블릿 컨테이너는 사용자가 특정 자원을 요청했을 때 그 자원 사이에 필터가 존재하는 경우 필터 객체의 doFilter()메서드를 호출 , doFilter()메서드는 요청이 있을 때마다 매번 실행됨, 

 

2. 필터 기본 구조

- 필터는 클라이언트와 자원 사이에 위치하고 있다.

- 자원이 받는 정보: 필터가 변경한 요청정보, 클라이언트가 보는 응답 정보: 필터가 변경한 응답 정보

 

3. 필터 체인 구성

- 한개의 필터만 존재할 수 있는 것이 아니며, 여러개의 필터가 모여 필터 체인(Chain)을 형성함. 위의 그림은 필터체인의 구조를 나타낸것.

- 여러개의 필터를 거쳐 응답과 요청을 받음. (정보뿐만아니라 흐름도 변경 가능)

- 흐름을 변경하여, 모든 필터를 거치지 않고도 클라이언트나 자원으로 넘어갈 수도 있음.

 

4. 전형적인 필터 구현방법

public class FirstFilter implements Filter{
	
    public void init(FilterConfig filterConfig) throws ServletException{
    	//필터 초기화 작업
    }
    
    public void doFilter(ServletRequest request,
    			ServletResponse response,
                	FilterChain chain)
                    throws IOException, ServletException{
    	//1. request 피라미터를 이용하여 요청의 필터 작업 수행
        //Request파라이머 이용해 클라이언트 요청을 필터링함.
        
        //2. 체인의 다음 필터 처리
        //Chain.doFilter호출, 요청의 필터링 결과 다음 필터에 전달함.
        chain.doFilter(request, response);
        
        //3. response를 이용해 응답의 필터링 작업 수행
        //체인을 통해 전달된 응답 데이터 변경해 결과 클라이언트에 전송함.
    }
    
    public void destroy(){
    //주로 필터가 사용한 자원을 반납
    }
}

- 필터가 존재하는 경우, 필터 객체는 doFilter()메서드 호출. doFilter() 메서드는 요청이 있을 때마다 매번 실행됨.

- doFilter() 메서드 내 FilterChain을 사용해서 필터는 체인에 있는 다음 필터에 변경한 요청/응답을 전달할 수 있음.

 

5. 필터 사용예시

▶ web.xml이용해 필터 설정

- 콘솔창에서의 출력결과를통해, f03filter의 doFilter를 통과했음을 확인할수 있음

- <filter>태그 : 웹 어플리케이션에서 사용할 필터 지정

- <filter-mapping>태그 : 특정 자원에 대해 어떤 필터를 사용할지 지정.

 

▶@WebFilter애노테이션 사용 & Servlet동시 사용 예시

- Servlet이 요청결과 처리 전 Filter를 거친다는 것을 보여주는 예시

filter

Servlet

 

6. 여러개의 서블릿과, 여러개의 필터

- 하나의 필터를 거쳐 여러개의 서블릿으로 이동할 수 있고,

web.xml을통해 filter 설정

filter코드

/filterex2/s01 첫번째 서블릿

/filterex2/s01 두번째 서블릿

 

- 여러개의 필터를 거쳐 하나의 서블릿으로 이동할 수 있음.

Web.xml통해 필터 설정

/filterex3 경로로 통하는 첫번쨰 필터

/filterex3 경로로 통하는 두번쨰 필터

/filter03을 거치는 두개의 filer를 거치는 Servlet

 

7. 캐릭터 인코딩 필터

- 기본 JSP에서의 인코딩 코드

<% request.setCharacterEncoding("utf-8"); %>

 

- Filter에서의 인코딩 코드

public class CharacterEncodingFilter implements Filter{
	private String encoding;
    
    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
    		throws IOException, ServletException{
       //setCharacterEncoding()메서드 이용해 요청 캐릭터 인코딩 설정
       req.setCharacterEncoding(encoding);
       chain.doFilter(req, res);
    }
    
    @Override
    public void init(FilterConfig config) throws ServletException{
    	//"encoding" 초기화 파라미터를 이용해 설정.
    	encoding = config.getInitParameter("encoding");
        if(encoding == null){
        	encoding = "UTF-8";
        }
    }
    
    @Override
    public void destroy(){
    }
}

web.xml에 위같은 설정도 추가