Chapter. RequestDispatcher 활용 요청재지정이란? RequestDispatcher 활용 요청재지정구현예제
Chapter.9 : RequestDispatcher 활용 1. 요청재지정이란? 클라이언트로부터요청받은 Servlet 프로그램이응답을하지않고다른자원에수행흐름을넘겨다른자원의처리결과를대신응답하는것또는다른자원의수행결과를포함하여응답하는것을요청재지정이라고한다. 이때요청재지정되는다른자원은 HTML, 이미지, Servlet 그리고 JSP 등 Web Application 을구성하는어떤파일이든대상이될수있다. HTML Servlet 이미지 JSP 다른자원의대상이 될수있음 요청재지정기능구현에사용되는 API 는 javax.servlet 패키지의 RequestDispatcher 이다. 2. RequestDispatcher 활용 1) RequestDispatcher 객체생성 RequestDespatcher 는클라이언트로부터요청받은정보를서버의다른자원즉, HTML, JSP 또는 Servlet 등의자원에보내는역할을하는인터페이스이다. 인터페이스인 RequestDispatcher 의객체를생성할때에는다음과같은메서드들을사용한다. 이렇게 일반메서드이면서다른 API 의객체생성을대신하는메서들을팩토리메서드라고한다. ServletContext 에서제공되는 getrequestdispatcher(string path) ServletContext 에서제공되는 getnameddispatcher(string name) ServletRequest 에서제공되는 getrequestdispatcher(string path) 요청이재지정될대상에대한정보를 path 형식, name 등어떤것으로지정하는가만다를뿐대상을지정하면서 RequestDispatcher 객체를추출하는기능은동일하다. 세개모두동일하다. getnameddispatcher() 는대상을지정할때재정의된이름을사용해야하며 getrequestdispatcher() 는패스형식으로지정해야한다. 일반적으로 ServletContext 와 2/13
ServletRequest 의 getrequestdispatcher() 를사용한다. 다음은 ServletContext 의 getrequestdispatcher() 를사용하여객체를생성하는예이다. getservletcontext() 를호출하여먼저 ServletContext 객체를생성한후에요청이 재지정될대상파일에대한패스를지정하여 getrequestdispatcher() 를호출한다. 이때 주의할사항은 패스지정시에현재 Web 어플리케이션의최상의디렉토리 (docbase 디렉토리 ) 를기준으로하여 / 기호로시작해야한다는것이다. ServletContext context = getservletcontext(); RequestDispatcher rd = context.getrequestdispatcher("/servlet/forwardservlet2") 다음은 ServletRequest 의 getrequestdispatcher() 를사용하여객체를생성하는예이다. doget() 이나 dopost() 메서드의첫번째매개변수로전달되는 HttpServletRequest 객체를사용한다. 요청이재지정될대상파일에대한패스를지정하여 getrequestdispatcher() 를호출하며 / 기호로시작하는절대패스형식을사용해도되고현재디렉토리를기준으로하는상대패스형식을사용해도된다. public void doget (HttpServletRequest req, HttpServletResponse res) throws ServletException, IOException { : req.getrequestdispatcher("/servlet/forwardservlet2"); // req.getrequestdispatcher("forwardservlet2"); 도가능 RequestDispatcher rd = context.getrequestdispatcher("/servlet/forwardservlet2"); RequestDispatcher 인터페이스에는다음과같이두개의메서드를지원한다. public void forward(servletrequest req, ServletResponse res) public void include(servletrequest req, ServletResponse res) 2) forward() 메서드 forward() 메서드는클라이언트에서수행요청을받는 Servlet 에서다른 Servlet, JSP 또는 3/13
HTML 파일등으로수행권한을넘겨서다른자원의수행결과가대신클라이언트로응답하는기능을지원한다. 그러므로클라이언트는요청한 Servlet 프로그램의수행결과대신다른파일즉, Servlet,JSP 그리고 HTML 등의수행결과를보게되지만이사실을알수없다. forward 되는대상은동일한서버에존재하는자원으로제한되며다른 Web Site 의 자원으로는 forward 될수없다. forward 될대상을찾을수없는경우에는 404 응답 코드를사용하여파일을찾을수없다는오류화면을클라이언트로출력한다. 다음은 forward() 메서드의기능을쉽게이해할수있도록처리과정을소개하는그림이다. 2) include() 메서드 include() 메서드는다른자원의수행결과내용을클라이언트로부터요청된 Servlet 안에포함시켜응답하는기능을지원한다. 그러므로클라이언트는요청한 Servlet 프로그램의수행결과대신다른파일즉, Servlet,JSP 그리고 HTML 등의수행결과를보게되지만이사실을알수없다. include 되는대상은동일한서버에존재하는자원으로제한되며다른 Web Site 의자원으로는 forward 될수없다. 또한 include 기능으로요청재지정을처리할때대상을찾을수없는경우에는 include 처리는무시되고클라이언트에서요청한 Servlet 의수행결과만응답됩다. forward 와같이오류화면이출력되지는않는다. 다음은 include() 메서드의기능을쉽게이해할수있도록처리과정을소개하는그림이다. 4/13
4) 다른 Web Application 으로의요청재지정 WAS 에의해인식되는 Web Application 단위로 ServletContext 객체가생성된다는것은 이미학습한바있다. 그러므로클라이언트로부터요청되는파일이속한 ServletContext 객체에의해생성되는 RequestDispatcher 객체로는동일한 Web Application 에존재하는파일들만을요청 재지정의대상이될수있다. 만일다른 Web Application 에존재하는파일을요청재지정의대상으로하려는경우에는해당 Web Application 의 ServletContext 객체를추출한후에 RequestDispatcher 객체를생성해야한다. 다음은다른 Web Application 에존재하는파일을요청재지정의대상으로처리하는것을소개하는그림이다. /exam 을컨텍스트패스로사용하는 Web Application exam ROOT / 를컨텍스트패 스로 사용하는 5/13 Web Application
다음은 webapps/root 디렉토리로구성되는 Web Application 에대한 ServletContext 객체를생성하여 index.jsp 를요청재지정의대상으로처리하는부분예제이다. 현재 Web Application 에대한 ServletContext 객체를추출한후에 getcontext( / ) 를호출하여 / 를컨텍스트패스로사용하는 Web Application 디렉토리에대한 ServletContext 객체를추출한후에 RequestDispatcher 객체를생성하고있다. ServletContext context = getservletcontext().getcontext("/"); RequestDispatcher rd = context.getrequestdispatcher("/index.jsp"); rd.forward(req, res); 다른 Web Application 에존재하는파일로요청재지정을처리하려는경우에는서로다른 Web Application 간에 ServletContext 객체를추출할수있도록하는환경설정이되어있어야한다. 톰캣이설치된디렉토리의 conf/context.xml 파일에서 <Context> 태그에 crosscontext= true 속성을추가한다. RequestDispatcher 를활용하는요청재지정은동일서버에존재하는자원만대상이될 수있다. 다른서버에존재하는자원으로 forward 를처리하고자하는경우에는 HttpServletResponse 의 sendredirect() 를호출하여처리할수있다. 3. 요청재지정구현예제 1) forward 기능을테스트하는예제 다음은클라이언트로부터요청된 ForwardTestServlet1 이 ForwardTestServlet2 로요청을 forward 하는예제이다. 서블릿예제 (ForwardTestServlet1.java) 6/13
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 // 파일명 : ForwardTestServlet1.java import java.io.*; import javax.servlet.*; import javax.servlet.http.*; public class ForwardTestServlet1 extends HttpServlet { protected void doget(httpservletrequest req, HttpServletResponse res) throws ServletException, IOException { res.setcontenttype("text/html; charset=euc-kr"); PrintWriter out = res.getwriter(); out.println("<html><head><title>forward 예제 </TITLE>"); out.println("</head><body><h3>forwardtestservlet1의수행결과 </H3>"); out.println("</body></html>"); ServletContext context = getservletcontext(); RequestDispatcher rd = context.getrequestdispatcher("/servlet/forwardtestservlet2"); rd.forward(req, res); out.close(); 클라이언트로부터요청을받으면바로 /servlet/forwardtestservlet2 로 forward 기능을처리하는 Servlet 소스이다. 다음에제시된내용을위주로점검한다. 15 행 : HttpServlet 에서상속받은 getservletcontext() 메서드를호출하여 ServletContext 객체를추출한다. 16-17 행 : /servlet/forwardtestservlet2 을매개변수로지정하여 RequestDispatcher 객체를생성한다. /servlet/forwardtestservlet2 에서맨앞에있는 / 는현재 Web Application 을기반으로하여인식되므로 ForwardTestServlet2 를찾을때실제로는 /exam/servlet/forwardtestservlet2 을찾게되는결과가된다. 18 행 : HttpServletRequest 객체와 HttpServletResponse 객체를전달하면서 forward() 메서드를호출한다. 7/13
서블릿예제 (ForwardTestServlet2.java) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 // 파일명 : ForwardTestServlet2.java import java.io.*; import javax.servlet.*; import javax.servlet.http.*; public class ForwardTestServlet2 extends HttpServlet { protected void doget(httpservletrequest req, HttpServletResponse res) throws ServletException, IOException { res.setcontenttype("text/html; charset=euc-kr"); PrintWriter out = res.getwriter(); out.println("<html><head><title>forward 예제 </TITLE>"); out.println("</head><body><font color=blue><h3>forwardtestservlet2 의수행결과입니다.</H3></font>"); out.println("</body></html>"); out.close(); 클라이언트로부터요청되는 ForwardTestServlet1 에의해 forward 되는소스로서 브라우저에서보게되는결과화면은이클래스의수행결과이다. 다음결과화면에서클라이언트에서는 ForwardTestServlet1 을요청하였는데 ForwardTestServlet2 의수행결과가대신응답된것을볼수있다. ForwardTestServlet1 대신 ForwardTestServlet2 의수행결과가대신응답되었지만주소필드가바뀌지않으므로브라우저사용자는요청이재지정된사실을알수없다. 8/13
2) forward 기능을테스트하는예제 다음은클라이언트로부터요청된 ForwardTestServlet1 이 ForwardTestServlet2 로 요청을 forward 하는예제이다. 서블릿예제 (IncludeTestServlet1.java) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 // 파일명 : IncludeTestServlet1.java import java.io.*; import javax.servlet.*; import javax.servlet.http.*; public class IncludeTestServlet1 extends HttpServlet { protected void doget(httpservletrequest req, HttpServletResponse res) throws ServletException, IOException { res.setcontenttype("text/html; charset=euc-kr"); PrintWriter out = res.getwriter(); out.println("<html><head><title>include 예제1</TITLE>"); out.println("</head><body><h3>includetestservlet1의수행결과 </H3>"); out.println("</body></html>"); ServletContext context = getservletcontext(); RequestDispatcher rd = context.getrequestdispatcher("/servlet/includetestservlet2"); out.println("<hr>"); rd.include(req, res); out.println("<hr>"); rd.include(req, res); out.close(); 클라이언트로부터요청을받으면 /servlet/includetestservlet2 의수행결과를두번포함하여응답하는기능의 Servlet 소스이다. 다음에제시된내용을위주로점검한다. 15 행 : HttpServlet 에서상속받은 getservletcontext() 메서드를호출하여 ServletContext 객체를추출한다. 9/13
16-17 행 : /servlet/includetestservlet2 을매개변수로지정하여 RequestDispatcher 객체를생성한다. /servlet/includetestservlet2 에서맨앞에있는 / 는현재 Web Application 을기반으로하여인식되므로 IncludeTestServlet2 를찾을때실제로는 /exam/servlet/includetestservlet2 을찾게되는결과가된다. 19 행, 21 : HttpServletRequest 객체와 HttpServletResponse 객체를전달하면서 include() 메서드를호출한다. 두번호출하고있으므로수행결과가두번포함되어클라이언트로응답된다. 서블릿예제 (IncludeTestServlet2.java) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 // 파일명 : IncludeTestServlet2.java import java.io.*; import javax.servlet.*; import javax.servlet.http.*; public class IncludeTestServlet2 extends HttpServlet { protected void doget(httpservletrequest req, HttpServletResponse res) throws ServletException, IOException { PrintWriter out = res.getwriter(); out.println("<font color=red><h3>includetestservlet2의수행결과 </H3></font>"); out.println("<br>"); 클라이언트로부터요청되는 IncludeTestServlet1 에의해수행결과가두번 include 되는 소스로서브라우저에서보게되는결과화면에이클래스의수행결과가포함된다. 다음결과화면에서클라이언트에서요청한 IncludeTestServlet1 의수행결과안에 IncludeTestServlet2 의수행결과가두번포함되어응답된것을볼수있다. 검은색으로 출력된내용은 IncludeTestServlet1 의수행결과이고빨간색으로출력된내용은포함된 IncludeTestServlet2 의수행결과이다. 10/13
3) 다른 Web Application 의자원으로의요청재지정을테스트하는예제 다음은클라이언트로부터요청된 ForwardTestServlet3 다른 Web Application 에존재하는 파일로요청을 forward 하는예제이다. 서블릿예제 (IncludeTestServlet1.java) 11/13
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 // 파일명 : ForwardTestServlet3.java import java.io.*; import javax.servlet.*; import javax.servlet.http.*; public class ForwardTestServlet3 extends HttpServlet { protected void doget(httpservletrequest req, HttpServletResponse res) throws ServletException, IOException { res.setcontenttype("text/html; charset=euc-kr"); PrintWriter out = res.getwriter(); out.println("<html><head><title>forward 예제 </TITLE>"); out.println("</head><body><h3>forwardtestservlet1의수행결과 </H3>"); out.println("</body></html>"); ServletContext context = getservletcontext().getcontext("/"); RequestDispatcher rd = context.getrequestdispatcher("/index.jsp"); rd.forward(req, res); out.close(); 클라이언트로부터요청을받으면바로 /index.jsp 로 forward 기능을처리하는소스이다. 다음에제시된내용을위주로점검한다. 15 행 : HttpServlet 에서상속받은 getservletcontext() 메서드를호출하여 ServletContext 객체를추출한다음 getcontext( / ) 를호출하여컨텍스트패스를 / 로사용하는 Web Application 디렉토리에대하여 ServletContext 객체를추출한다. 16 행 : /index.jsp 을매개변수로지정하여 RequestDispatcher 객체를생성한다. /index.jsp 에서앞에있는 / 는컨텍스트패스를 / 로사용하는 Web Application 의컨텍스트루트디렉토리를의미하므로 webapps/root/index.jsp 을찾게된다. 17 행 : HttpServletRequest 객체와 HttpServletResponse 객체를전달하면서 forward() 메서드를호출한다. 다음결과화면에서클라이언트에서는 ForwardTestServlet3 를요청하였는데 /index.jsp 의 수행결과가대신응답된것을볼수있다. ForwardTestServlet3 대신 /index.jsp 의수행 12/13
결과가대신응답되었지만주소필드가바뀌지않으므로브라우저사용자는요청이재지정된 사실을알수없다. 13/13