서블릿

FRAMEWORK/SERVLET 2014. 11. 5. 17:33

블릿이란?

게시판과 같은 프로그램을 만들기 위한 자바측 기술 중 하나이다.
java.sql 팩키지를 JDBC 라고 부르는 것처럼, javax.servlet 과 javax.servlet.http 팩키지를 서블릿이라 부른다.

서블릿은 네트워크 프로토콜과 무관하게 설계되었지만, 대부분 HTTP 프로토콜을 사용하는, 웹환경에서 동적인 컨텐츠를 만들 때에 사용된다.
참고로, JSP는 서블릿 이후에, 서블릿 기술을 기반으로 탄생했는데, 서블릿보다 동적인 웹 페이지 화면을 쉽게 만들 수 있다.

서블릿을 학습할 때는 javax.servlet, javax.servlet.http 팩키지에서 서블릿의 기본골격을 먼저 공략하는 것이 현명한 학습방법이다.

서블릿의 기본 골격

서블릿 기본골격은, 모든 서블릿이 구현해야 하는 javax.servlet.Servlet 인터페이스, 대부분의 모든 서블릿이 상속해야 하는 javax.servlet.GenericServlet 추상클래스, HTTP 프로토콜을 사용하는 서블릿이 상속해야 하는 javax.servlet.http.HttpServlet 클래스로 구성된다.
아래 그림¹처럼 GenericServlet 은 프로그래머가 사용하기 편하도록 javax.servlet.ServletConfig 인터페이스를 구현하고 있다.

Servlet 인터페이스

javax.servlet.Servlet 인터페이스는 서블릿 아키텍처의 핵심이다.
모든 서블릿은 Servlet 인터페이스를 구현해야 한다.
이 인터페이스에는 서블릿의 라이프 사이클 메소드가 선언되어 있다.

init() : 서블릿 초기화
service() : 클라이언트 요청에 대한 서비스
destroy() : 서비스 중지, 자원반납

init() 메소드

서블릿 컨테이너는 서블릿 객체가 생성된 후, 단 한번 init() 메소드를 호출한다.
서블릿은 init() 메소드가 완료되어야 서비스할 수 있다. init() 메소드 완료 전의 요청은 블록킹된다.
init() 메소드가 호출될 때 ServletConfig 인터페이스 타입의 객체를 매개변수로 전달받는데, 만약 web.xml 에서 서블릿 초기화 파라미터를 설정했다면, 전달받은 ServletConfig 에는 web.xml에서 설정했던 서블릿 초기화 파라미터 정보를 가지고 있게 된다.
초기화 파라미터가 있다면 init() 메소드에 서블릿의 초기화 작업을 수행하는 코드가 있어야 할 것이다.

void init(ServletConfig config) throws ServletException;

service() 메소드

클라이언트가 서블릿에 요청을 보낼때마다, 서블릿 컨테이너는 서블릿의 service() 메소드를 호출한다.
전달받은 ServletRequest 타입의 객체를 통해서 요청정보와 클라이언트가 전달한 데이터를 읽을 수 있으며, 전달받은 ServletResponse 타입의 객체를 사용하여 클라이언트에게 응답할 수 있다.
여기서 주목해야 할 점은, 서블릿 컨테이너는 새로운 쓰레드에서 service()메소드를 실행한다는 것이다.
즉, 요청시마다 새로운 쓰레드에서 service() 메소드를 동시에 실행한다.
가각의 스레드에서 동시에 실행되기에 수많은 클라이언트의 요청에 대해 지체없이 응답을 할 수 있지만, 서블릿에서 공유되는 자원(파일이나 네트워크 커넥션, static 변수, 인스턴스 변수)은 "자바기초의 스레드"에서 보았던 문제가 발생할 수 있다.
문제가 발생하지 않도록 하려면, 서블릿에서 문제가 될 수 있는 static 이나 인스턴스 변수를 만들지 않는 것이 좋다.
서블릿이 공유하는 자원을 모두 동기화하는 것은 대부분의 경우에 옳은 코딩이 아니다.

void service(ServletRequest req, ServletResponse res) 
	throws ServletException, IOException;

destroy() 메소드

서블릿이 더이상 서비스를 하지 말아야 할 때 서블릿 컨테이너에 의해 호출된다.
이 메소드는 프로그래머가 호출하는게 아니다.
따라서 destroy() 를 예제로 확인하려면 "톰캣 매니저"를 사용하여 애플리케이션을 언로드하거나 톰캣을 셧다운시켜야 한다.
참고로 톰캣매니저는 http://localhost:port/manager 로 접근할 수 있는 웹 애플리케이션으로 웹 애플리케이션을 관리할 용도로 제공된다.
톰캣을 설치할 때 정해준 관리자와 관리자 비밀번호를 사용하여 로그인을 해야 화면을 볼 수 있다.
관리자와 관리자 비밀번호가 생각나지 않으면 {톰캣홈}/conf/tomcat-users.xml 파일을 열어보면 알 수 있다.

void destroy();

GenericServlet 추상클래스

GenericServlet 클래스는 부모 클래스로 쓰인다.
GenericServlet 클래스는 편의를 위해서 ServletConfig 인터페이스를 구현한다.
GenericServlet 는 Servlet 인터페이스를 불완전하게 구현한다.
Servlet 인터페이스의 service() 메소드를 구현하지 않았기 때문에, GenericServlet 의 service() 메소드는 abstract 가 붙어야 하고, 그래서 GenericServlet 은 추상클래스이다.
GenericServlet 를 상속하는 자식 클래스는 service() 메소드를 구현해야 한다.

public abstract void service(ServletRequest req, ServletResponse res) 
	throws ServletException, IOException;

init(ServletConfig config) 메소드는 다음과 같이 GenericServlt 에 구현되었다.

public void init(ServletConfig config) throws ServletException {
	this.config = config;
	this.init();
}

init(ServletConfig config) 구현부에 마지막에 매개변수가 없는 init() 메소드를 호출하고 있다.
매개변수가 없는 init() 메소드는 편의를 위해 GenericServlet 에 추가되었다.
자식 클래스에서 init(ServletConfig config) 메소드를 오버라이딩하는 것보다 이 메소드를 오버라이딩하는 것이 편리하다.
왜냐하면 ServletConfig 객체를 저장해야 한다는 걱정을 하지 않아도 되기 때문이다.
init(ServletConfig config) 메소드의 경우 자식 클래스에서 오버라이딩하려면 구현부에 super(config); 코드가 반드시 있어야 한다.
이 코드가 없으면 서블릿이 ServletConfig 객체를 저장하지 못하게 된다.
매개변수가 없는 init() 메소드는 다음과 같이 아무일도 하지 않는 것으로 구현되어 있다.

public void init() throws ServletException {

}

Servlet 인터페이스의 getServletConfig() 메소드는, init(ServletConfig config) 메소드에서 전달받아서 인스턴스 변수 config 에 저장된 ServletConfig 객체를 반환하도록 구현되어 있다.

public ServletConfig getServletConfig() {
	return config;
}

ServletConfig 인터페이스의 getServletContext() 메소드는 ServletContext 타입의 객체를 반환한다.

public ServletContext getServletContext() {
	return getServletConfig().getServletContext();
}

ServletConfig 인터페이스의 getInitParameter() 와 getInitParameterNames() 메소드는 GenericServlet 에서 다음과 같이 구현되어 있다.

public String getInitParameter(String name) {
	return getServletConfig().getInitParameter(name);
}

public Enumeration getInitParameterNames() {
	return getServletConfig().getInitParameterNames();
}

편의를 위해서 GenericServlet이 ServletConfig를 구현했다는 말은 이런 것이다.
서블릿에서 ServletContext에 대한 레퍼런스를 얻기 위해서 this.getServletConfig().getServletContext(); 란 코드도 되지만 this.getServletContext(); 를 쓰는 것이 편리할 것이다.
초기화 파라미터 정보를 얻기 위해서 String driver = this.getServletConfig().getInitParameter("driver"); 와 같이 쓰기 보다는 String driver = this.getInitParameter("driver"); 쓰는 것이 편리할 것이다.

HttpServlet 클래스

HTTP 요청을 서비스하는 서블릿을 작성하는 경우에는 HttpServlet을 상속한다.
GenericServlet 추상 클래스를 상속하는 HttpServlet 클래스는 HTTP 프로토콜에 특화된 서블릿이다.
HttpServlet 클래스는 HTTP 요청을 처리하는 메소드를 제공한다.
클라이언트의 요청은 HttpServletRequest 객체 타입으로 서블릿에 전달되며, 서버는 HttpServletResponse 객체 타입으로 사용하여 응답한다.
HttpServlet 클래스는 GenericServlet 의 service() 추상 메소드를 구현했는데 구현 내용은 단지 클라이언트의 요청을 protected void service(HttpServletRequest req, HttpServletResponse resp) 메소드에 전달하는 것이다.

public void service(ServletRequest req, ServletResponse res) 
	throws ServletException, IOException {
	
	HttpServletRequest  request; 
	HttpServletResponse response;
	
	try {
		request = (HttpServletRequest) req;
		response = (HttpServletResponse) res;
	} catch (ClassCastException e) {
		throw new ServletException("non-HTTP request or response");
	}
	
	service(request, response);
}

결국, 다음 메소드가 HTTP 요청을 처리한다.

protected void service(HttpServletRequest req, HttpServletResponse resp) 
	throws ServletException, IOException {
	
	String method = req.getMethod();
	
	if (method.equals(METHOD_GET)) {
		long lastModified = getLastModified(req);
		if (lastModified == -1) {
			// servlet doesn't support if-modified-since, no reason
			// to go through further expensive logic
			doGet(req, resp);
		} else {
			long ifModifiedSince = req.getDateHeader(HEADER_IFMODSINCE);
			if (ifModifiedSince < (lastModified / 1000 * 1000)) {
				// If the servlet mod time is later, call doGet()
				// Round down to the nearest second for a proper compare
				// A ifModifiedSince of -1 will always be less
				maybeSetLastModified(resp, lastModified);
				doGet(req, resp);
			} else {
				resp.setStatus(HttpServletResponse.SC_NOT_MODIFIED);
			}
		}
	} else if (method.equals(METHOD_HEAD)) {
		long lastModified = getLastModified(req);
		maybeSetLastModified(resp, lastModified);
		doHead(req, resp);
	} else if (method.equals(METHOD_POST)) {
		doPost(req, resp);
	} else if (method.equals(METHOD_PUT)) {
		doPut(req, resp);
	} else if (method.equals(METHOD_DELETE)) {
		doDelete(req, resp);
	} else if (method.equals(METHOD_OPTIONS)) {
		doOptions(req,resp);
	} else if (method.equals(METHOD_TRACE)) {
		doTrace(req,resp);
	} else {
		//
		// Note that this means NO servlet supports whatever
		// method was requested, anywhere on this server.
		//
		
   		String errMsg = lStrings.getString("http.method_not_implemented");
   		Object[] errArgs = new Object[1];
   		errArgs[0] = method;
   		errMsg = MessageFormat.format(errMsg, errArgs);
   		
		resp.sendError(HttpServletResponse.SC_NOT_IMPLEMENTED, errMsg);
	}
}

HttpServlet 의 +service()는 단지 #service()메소드에게 제어권을 넘기는 역할만 한다.
HttpServlet 클래스의 #service() 메소드가 호출되면 이 메소드는 요청객체(HttpServletRequest타입의 객체)안에서 HTTP 메소드(대표적으로 POST, GET이 있다.)를 읽어내고 이 값에 따라 매칭되는 메소드를 호출한다.
이를 테면 HTTP 메소드가 "GET"이면 doGet(), "POST"이면 doPost() 메소드를 호출한다.
doGet(), doPost() 와 같은 메소드가 우리가 오버라이딩 해야 하는 메소드이다.

HttpServletRequest 인터페이스는 ServletRequest 인터페이스를 상속하고, HttpServletResponse 인터페이스는 ServletResponse 인터페이스를 상속한다.
서블릿 컨테이너는 클라이언트의 요청이 오면 HttpServletRequest타입의 객체와 HttpServletResponse 타입의 객체를 만들어서 서블릿의 +service(req:ServletRequest,res:ServletResponse)메소드를 호출하면서 전달한다.
HttpServletRequest, HttpServletResponse 인터페이스를 구현한 클래스는 서블릿 컨테이너를 제작하는 벤더의 몫이다.

서블릿 클래스, 인터페이스 요약

Servlet 인터페이스: init (config:ServletConfig); service(req:ServletRequest, res:ServletResponse); destroy(); getServletConfig() : ServletConfig; 서블릿 초기화에 관련된 변수를 가지고 있는 ServletConfig 객체를 리턴; getServletInfo() : String; 서블릿에 대한 간단한 정보를 리턴

ServletConfig 인터페이스: getInitParameter(name:String) : String; name에 해당하는 초기화 파라미터 값을 리턴; getInitParameterNames() : Enumeration; 서블릿의 초기화 파라미터 이름들을 Enumeration 타입으로 리턴; getServletContext() : ServletContext; ServletContext 를 리턴; getServletName() : String; 서블릿 인스턴스의 이름 리턴

+GenericServlet 추상 클래스: 프로토콜에 무관한 기본적인 서비스 기능을 제공하는 클래스로 Servlet, ServletConfig 인터페이스를 구현; +init(); 서블릿 초기화 메소드로, GenericServlet의 init(config:ServletConfig) 메소드의 의해 호출됨; <<abstract>> + service (req:ServletRequest, res:ServletResponse); Servlet 인터페이스의 service() 메소드는 여전히 추상 메소드

HttpServlet 추상 클래스: GenericServlet 추상 클래스 상속; #doGet (req:HttpServletRequest, res:HttpServletResponse); HTTP의 GET 요청을 처리하기 위한 메소드; #doPost (req:HttpServletRequest, res:HttpServletResponse); HTTP의 POST 요청을 처리하기 위한 메소드; +service (req:ServletRequest, res:ServletResponse); GenericServlet 추상클래스의 추상 메소드 service() 구현함. 구현내용은 아래 service() 메소드에 호출하는 것이 전부; #service (req:HttpServletRequest, res:HttpServletResponse); 클라이어트의 요청에 따라 doGet(), doPost() 메소드 호출

ServletContext 인터페이스: 서블릿이 서블릿 컨테이너와 통신하기 위해서 사용하는 메소드 제공한다.
파일의 MIME 타입, 파일의 전체경로, RequestDispatcher 레퍼런스를 얻거나 로그파일에 기록할 수 있다.
ServletContext 객체는 웹 애플리케이션마다 하나씩 존재하며, 그래서 웹 애플리케이션 전체의 공동 저장소를 역할을 한다.
ServletContext 에 저장된 데이터는 같은 웹 애플리케이션내의 서블릿이나 JSP 에서 자유롭게 접근할 수 있다.; setAttribute (name:Strng, value:Object); 데이터를 이름과 값의 쌍으로 저장한다.; getAttribute (name:String) : Object; 이름을 이용해서 저장된 데이터를 리턴; removeAttribute(name:String); name에 해당하는 데이터를 삭제; getInitParameter(name:String) : String; 웹 애플리케이션 전영역에 대한 초기화 파라미터 이름에 해당하는 값 반환; getRequestDispatcher(path:String) : RequestDispatcher; 주어진 Path 를 위한 RequestDispatcher 를 리턴; getRealPath(path:String) : String; 주어진 가상 Path의 실제 Path를 리턴; getResource(path:String) : URL; 주어진 Path 에 해당되는 자원의 URL을 리턴; log(msg:String); 로그에 기록; log(String message, Throwable throwable); 로그에 기록

RequestDispatcher 인터페이스: 클라이언트의 요청을 다른 자원(서블릿, JSP)으로 전달하거나 다른 자원의 내용을 응답에 포함하기 위해 사용한다.; forward(req:ServletRequest, res:ServletResponse); 클라이언트의 요청을 다른 자원으로 전달; include(req:ServletRequest, res:ServletResponse); 다른 자원의 내용을 응답에 포함

ServletRequest 인터페이스: 서블릿에 대한 클라이언트의 요청 정보을 담고 있음.; setAttribute(name:String,o:Object); 객체를 주어진 이름으로 저장; getAttribute(name:String) : Object; 주어진 이름의 저장된 데이터를 리턴; removeAttribute(name:String); 주어진 이름의 데이터를 삭제; getInputStream() : ServletInputStream; 클라이언트 요청의 바디에 있는 바이너리 테이터를 읽기 위한 입력 스트림 리턴; getParameter(name:String) : String; 클라이언트의 요청에 포함되어 있는 파라미터 이름에 해당하는 값 리턴; getParameterNames() : Enumeration; 클라이언트의 요청에 포함되어 있는 모든 파라미터 이름을 Enumeration 타입으로 리턴; getParameterValues(name:String) : String[]; 파라미터 name에 해당하는 모든 값을 String 배열로 리턴.
체크박스나 다중 선택 리스트와 같이 값이 여러 개 있을 때 이 메소드를 사용한다.; getServletPath() : String; "/" 로 시작하는 경로를 리턴. 경로에 쿼리스트링은 포함되지 않음.; getRemoteAddr() : String; 클라이언트의 IP 주소를 리턴

HttpServletRequest 인터페이스: ServletReqeust 상속; getCookies() : Cookie[]; 브라우저가 전달한 쿠키 배열을 리턴; getSession() : HttpSession; 현재 세션(HttpSession)을 리턴; getSession(created:boolean) : HttpSession; 현재 세션을 리턴, 만약 세션이 없는 경우 created 가 true 이면 세션을 생성후 리턴하고 created 가 false 면 null 리턴; getContextPath() : String; 요청 URI 에서 컨텍스트를 지시하는 부분을 리턴한다.
http://localhost:port/ContextPath/board/list.do?curPage=1 를 요청하면 /ContextPath 를 리턴한다.; getRequestURI() : String; http://localhost:port/ContextPath/board/list.do?curPage=1 를 요청하면
/ContextPath/board/list.do 를 리턴한다.; getQueryString() : String; http://localhost:port/ContextPath/board/list.do?curPage=1 를 요청하면
curPage=1 를 리턴한다.

ServletResponse 인터페이스: 클라이언트에 응답을 보내기 위해 사용; getOutputStream() : ServletOutputStream; 응답으로 바이너리 데이터를 전송하기 위한 출력 스트림 리턴; getWriter() : PrintWriter; 응답으로 문자 데이터를 전송하기 위한 출력 스트림 리턴; setContentType(type:String); 응답 데이터의 MIME 타입을 설정.
HTML은 text/html, 일반 텍스트는 text/plain, 바이너리 데이터는 application/octet-stream 으로 설정
이 메소드는 getWriter() 메소드 전에 호출되어야 한다.; getContentType() : String; setContentType()메소드에서 지정한 MIME 타입 리턴
만약 지정하지 않았다면 null 리턴; setCharacterEncoding(charset:String); 응답 데이터의 캐릭터셋을 설정
UTF-8로 설정하려면 setCharacterEncoding("UTF-8");
이것은 setContentType("text/html; charset=UTF-8"); 에서의 캐릭터셋 설정과 동일하다.
getWrite()메소드가 실행되기 전에 호출되어야 한다.; getCharacterEncoding() : String; 설정된 응답 데이터의 캐릭터셋 리턴
캐릭터셋이 지정되지 않았다면 "ISO-8859-1" 을 리턴; setContentLength(length:int); 응답 데이터의 크기를 int형 값으로 설정
이 메소드는 클라이언트측에서 서버로부터의 응답 데이터를 어느 정도 다운로딩하고 있는지 표시하는데 응용될 수 있다.

HttpServletResponse 인터페이스: ServletResponse 인터페이스를 상속, HTTP 응답을 클라이언트에 보내기 위해 사용; addCookie(cookie:Cookie); 응답에 쿠키를 전송; sendRedirect(location:String); 주어진 URL로 리다이렉트

HttpSession 인터페이스: 세션유지에 필요한 사용자의 정보를 서버측에서 저장할 때 사용한다.; getAttribute(name:String) : Object; setAttribute(name:String, value:Object); removeAttribute(name:String); invalidate()

Cookie: 서블릿에서 만들어져서 웹브라우저로 보내는 작은 정보로 브라우저에 저장된 후에 다시 서버로 보내어진다.
이말은 세션 유지에 필요한 정보를 클라이언트측에서 저장한다는 것이다.
쿠키는 name 과 name 에 대해 하나의 value 를 가지며 경로, 도메인, 유효기간, 보안에 대한 옵션값을 가지기도 한다.
서블릿에서 쿠키를 만들면 쿠키에 대한 일정한 형식의 문자열이 응답헤더에 추가된다.
쿠키가 포함된 응답을 받은 웹브라우저는 이후 쿠키 정보를 모든 요청시 같이 보내게 된다.
서버 요소로 전달된 쿠키 정보는 HttpServletRequest.getCookie() 메소드를 이용하면 전송된 모든 쿠키의 배열을 얻을 수 있다.
쿠키나 세션은 응답후 접속을 끊는 HTTP 프로토콜의 한계를 극복하기 위한 기술이다.; + Cookie(name:String, value:String); + getName() : String; + getValue() : String; + setValue(newValue:String); + getPath() : String; + setPath(uri:String); + getDomain() : String; + setDomain(pattern:String); + getMaxAge() : int; + setMaxAge(expiry:int); + getSecure() : boolean; + setSecure(flag:boolean)

서블릿 예제

아래 나오는 모든 예제는 ROOT 애플리케이션에 작성한다.
웹 애플리케이션 작성 실습에서 도큐먼트베이스가 C:/www/myapp 인 애플리케이션을 ROOT 애플리케이션으로 변경했었다.
JSP는 C:/www/myapp 아래에, 자바는 C:/www/myapp/WEB-INF/src 아래 자바 팩키지 이름의 서브디렉토리에 생성한다.
이클립스를 사용하지 않고 에디트플러스와 같은 일반 에디터를 사용한다.

SimpleServlet.java

package example;

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class SimpleServlet extends HttpServlet {

	@Override
	public void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws ServletException, IOException {
		doPost(req,resp);
	}
	
	@Override
	public void doPost(HttpServletRequest req, HttpServletResponse resp) 
			throws ServletException, IOException {
			
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
    	
		out.println("<html>");
		out.println("<body>");
    	
		//요청한 클라이언트의 IP를 출력
		out.println("당신의 IP 는 " + req.getRemoteAddr() + "입니다.\n");
		out.println("</body></html>");
		out.close();
	}
  
}

SimpleServlet은 서블릿 라이프 사이클 메소드 중 init()과 destroy()는 구현하지 않았다.
이 메소드들은 GenericServlet 에서 이미 구현되어 있고, 또 특별히 오버라이딩할 이유가 없기 때문에 위의 소스에서 보이지 않는 것이다.
/WEB-INF/web.xml 파일을 열고 web-app 엘리먼트의 자식 엘리먼트로 servlet 엘리먼트와 내용을 아래와 같이 추가한다.

web.xml

/* .. 중간 생략 .. */

    <servlet>
      <servlet-name>SimpleServlet</servlet-name>
      <servlet-class>example.SimpleServlet</servlet-class>
    </servlet>

    <servlet-mapping>
      <servlet-name>SimpleServlet</servlet-name>
      <url-pattern>/simple</url-pattern>
    </servlet-mapping>

/* .. 중간 생략 .. */

명령 프롬프트에서 SimpleServlet.java 가 있는 소스 폴더로 이동하여 아래와 같이 컴파일한다.

javac -d C:/www/myapp/WEB-INF/classes ^
-cp "C:/Program Files/Apache Software Foundation/Tomcat 7.0/lib/servlet-api.jar" ^
SimpleServlet.java

package javax.servlet.http does not exist

SimpleServlet.java 를 컴파일할 때 위와 같은 컴파일 에러가 나온다는 것은 자바 컴파일러가 javax.servlet.http 팩키지를 찾지 못한다는 의미로, javac 의 classpath 옵션의 값으로 servlet-api.jar 파일의 전체경로를 잘못 적었기 때문이다.
classpath 옵션값으로 주는 경로가 중간에 공백이 있다면 "" 으로 묶어주어야 한다.
다른 방법으로는 CLASSPATH 란 환경변수에 servlet-api.jar 의 전체경로를 추가해주면 아래와 같이 classpath 옵션을 사용하지 않고도 컴파일을 할 수 있다.
javac -d C:/www/myapp/WEB-INF/classes SimpleServlet.java (CLASSPATH 환경변수의 값은 반드시 현재 디렉토리를 나타내는 . 를 포함해야 한다.
그래서 CLASSPATH를 설정하면 아래와 같다.
.;C:\Program Files\Apache Software Foundation\Tomcat 7.0\lib\servlet-api.jar

톰캣을 재시작한 후 http://localhost:8989/simple 로 방문하여 테스트한다.

SimpleServlet.java 소스설명

public class SimpleServlet extends HttpServlet {

HttpServlet 클래스를 상속받은 서블릿은 public class으로 선언해야 한다.

@Override
public void doGet(HttpServletRequest req, HttpServletResponse resp) 
	throws ServletException, IOException {
	
   doPost(req,res);
}

@Override
public void doPost(HttpServletRequest req, HttpServletResponse resp) 
	throws ServletException, IOException {
	
   ..생략..
   
}

doGet()과 doPost()메소드는 HttpServlet의 doGet()와 doPost()메소드를 오버라이드 한 메소드이다.
모든 비즈니스 로직이 이 메소드에 존재한다.
HTTP METHOD가 GET으로 요청해오면 doGet() 메소드를 오버라이딩한다.
웹브라우저의 주소창에서 웹서버의 자원을 요청하는 것은 GET방식의 요청이다.
예제에서는 doGet()메소드는 단순히 doPost()메소드를 호출하는 것으로 구현하여 GET이든 POST요청이든 같은 코드가 실행된다.
doGet()과 doPost()메소드는 HttpServletRequest와 HttpServletResponse타입의 파라미터를 가진다.
이 메소드는 예외가 발생할 수 있으므로 throws ServletException, IOExcepiton가 메소드 선언부에 추가되어 있다.

resp.setContentType("text/html; charset=UTF-8");
PrintWriter out = resp.getWriter();

resp.setContentType("text/html; charset=UTF-8");은 응답(HttpServletResponse)의 컨텐츠타입을 셋팅하는 작업을 한다.
웹브라우저에 응답으로 출력될 문서의 MIME²타입을 설정하는 것이다.
이 코드는 서블릿에서 단 한번만 사용이 가능하며 PrintWriter를 획득하기 전에 실행되야 한다.
; charset=UTF-8 부분이 빠지면 한글이 깨진다.
PrintWriter의 획득은 HttpServletResponse의 getWriter()을 호출함으로써 이루어진다.
PrintWriter out = resp.getWriter();
out 은 웹브라우저가 목적지인 문자 출력 스트림이다.

out.println("<html>");
out.println("<body>");
//요청한 클라이언트의 IP를 출력
out.println("당신의 IP 는 " + req.getRemoteAddr() + "입니다.\n");

PrintWrtier는 클라이언트로의 응답으로 보내는 스트림에 글을 쓸 수 있게 한다.
PrintWriter의 plintln()메소드안에 문자열을 넣으면 클라이언트의 웹브라우저에 출력된다.
위에서 보듯이 SimpleServlet는 클라이언트에게 HTML을 보내기 위해 PrintWriter의 println()메소드를 사용하고 있다.
req.getRemoteAddr()은 클라이언트의 IP주소값을 반환하는 메소드이다.
이와같이 HttpServeltRequest 는 클라이언트가 보내거나 클라이언트에 관한 정보를 담고 있다.

SimpleServlet 서블릿이 응답을 보내기까지 과정을 살펴보자.
클라이언트가 웹브라우저를 이용해서 서버의 SimpleSerlvet을 요청한다.
서블릿 컨테이너인 톰캣은 SimpleServlet의 +service(ServletRequest req, ServletResponse res) 메소드를 호출하면서 클라이언트의 요청을 캡슐화한 객체(HttpSerlvetRequest 인터페이스 구현체)와 응답을 위한 객체(HttpSerlvetResponse 인터페이스 구현체)를 메소드의 인자로 전달한다.
+service(ServletRequest req, ServletResponse res) 메소드는 단지 #service(HttpServletRequest req,HttpServletResponse res) 메소드를 호출하도록 구현되어 있다.
#service(HttpServletRequest req,HttpServletResponse res) 메소드는 HTTP 메소드타입(GET,POST 등)에 따라 doGet() 또는 doPost()메소드를 호출한다.
테스트에서는 웹브라우저의 주소창에서 서블릿 자원을 요청했기 때문에 GET 방식의 요청이다.
따라서 doGet() 메소드가 호출된다.

사용자가 문자열 데이터를 서버측 자원으로 전송하는 방법과 이 데이터를 서버측 자원에서 수신하는 방법

웹 환경에서 동적인 요소라 하면 클라이언트가 보낸 문자열 데이터에 따라 응답을 하는 요소를 말한다.
웹에서 동적인 요소를 만들어야 하는 웹 프로그래머는 클라이언트가 웹 브라우저를 통해서 문자열 데이터를 보내는 방법과 그 데이터를 획득하는 방법을 알아야 한다.
클라이언트 사이드에서 서버 사이드로 문자열 데이터를 전송하기 위해서는 주로 form 엘리먼트와 form의 서브 엘리먼트를 사용한다.³
클라이언트가 서버로 전달하는 데이터는 form 엘리먼트의 action 속성의 값으로 지정된 자원으로 전달된다.

파라미터 전송 방법과 전송된 파라미터의 값 얻기

아래 표에서 폼 작성은 사용자로부터 값을 받기 위한 form 양식을 출력하기 위한 HTML 태그를 보여주고 있다.
표에서 서블릿은 form 양식에서 입력받은 파라미터 값을 서블릿에서 가져오기 위한 코드 조각이다.

폼 작성	서블릿
<input type="text" name="addr" />	req.getParameter("addr");
<input type="radio" name="os" value="Windows" /> <input type="radio" name="os" value="Linux" />	req.getParameter("os");
<input type="hidden" name="curPage" value="1" />	req.getParameter("curPage");
<input type="password" name="passwd" />	req.getParamter("passwd");
<textarea name="content" cols="60" rows="12"> </textarea>	req.getParamter("content");
<select name="grade"> <option value="A">A</option> <option value="B">B</option> <option value="C">C</option> <option value="D">D</option> <option value="F">F</option> </select>	req.getParameter("grade");
<input type="checkbox" name="hw" value="Intel" /> <input type="checkbox" name="hw" value="AMD" />	req.getParameterValues("hw");
<select name="sports" multiple="multiple"> <option value="soccer">축구</option> <option value="basketball">농구</option> <option value="baseball">야구</option> </select>	req.getParameterValues("sports");

getParameter(String name)

ServletRequest 의 getParameter(String name) 메소드는 사용자가 보낸 데이터를 얻기 위해 사용하는 가장 보편적인 메소드이다.
전달되는 데이터는 파라미터 이름과 값의 쌍으로 서버 요소에 전달된다.
|name|value| 이때 파라미터의 이름은 form 의 서브 엘리먼트(input, textarea, select)의 name 속성값과 같고 value 는 사용자가 입력한 값이다.
getParameter(String name) 인자값으로 파라미터명(input, textarea, select 엘리먼트의 name 속성값)을 전달하면 사용자가 입력하거나 선택한 값을 얻을 수 있다.

input 엘리먼트의 type 속성값이 radio(라디오 버튼)인 의 경우, name 속성값이 같은 라디오 버튼들은 그룹을 형성한다.
그룹내의 라디오 버튼은 그 중 하나만 선택된다.

getParameterValues(String name)

클라이언트 사이드에서 하나의 파라미터명에 여러 개의 값이 전송할 때 서블릿에서 이 데이터를 수신하려면 HttpServletRequest 의 getParamterValues(String name) 메소드를 사용한다.
이 메소드의 리턴 타입은 사용자가 선택한 값들만으로 구성된 String 배열이다.

클라이언트 사이드에서 하나의 파라미터에 값을 여러개 보내려면 체크박스나 multiple 속성값이 "multiple" 인 select 엘리먼트가 사용된다.
체크박스는 input 엘리먼트의 type 속성값이 checkbox 인 것을 말한다.
체크박스는 라디오 버튼과 마찬가지로 name 속성값을 같게 하면 그룹화되는데 라디오 버튼과 다른 점은 그룹내에서 선택을 다중으로 할 수 있다는 것이다.
select 엘리먼트는 일반적으로 값을 하나만 선택할 수 있지만 multiple 속성값이 "multiple" 인 select 엘리먼트는 Ctrl 이나 Shift 버튼을 이용해서 값을 여러개 선택할 수 있다.

getParamterNames()

클라이언트 사이드에서 전송되는 데이터가 어떤 파라미터에 담겨 오는지 알 수 있는 메소드가 HttpServletRequest 의 getParamterNames() 메소드이다.
getParameterNames() 메소드는 파라미터 이름을 접근할 수 있는 Enumeration⁴ 타입을 반환한다.

input type="file" 은 파일 업로드에 쓰인다.

type 속성값이 file 인 input 엘리먼트는 이미지와 같은 바이너리 데이터를 서버 사이드로 전송할 때 쓰인다.
이때 form 엘리먼트의 method 속성값은 post 이고 동시에 enctype 속성(속성값이 "multipart/form-data")이 반드시 있어야 한다.
<form action="서버요소" method="post" enctype="multipart/form-data">
업로드하는 파일뿐만 아니라 다른 부가 정보(예를 들면 이름,제목,내용 등등)을 전송해야 한다면 이들 엘리먼트 역시 input type="file" 이 있는 form 안에 같이 위치시키면 된다.
submit 버튼을 누르면 이제까지와는 다른 전송 규약에 의해 서버 요소로 전송된다.
따라서 서버 요소에서는 getParameter() 메소드를 사용하여 데이터에 접근할 수 없다.
서블릿 JSP API를 가지고 바이너리 데이터를 수신하는 방법을 서블릿에 구현할 수 있겠지만 대부분의 경우 외부 라이브러리를 있고 이용한다.
이에 대한 예제는 곧 다룬다.

문자열 전송 예제

회원가입 예제를 통해 사용자가 보낸 데이터를 서블릿에서 수신하는 방법을 실습한다.
이 예제의 목적은 사용자가 보낸 데이터를 확인하는 것이다.
회원가입 양식(form)을 보여주는 HTML 파일을 작성한다.

/example/join.html

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>회원가입 폼</title>
</head>
<body>
<h3>회원가입</h3>
<form id="joinForm" action="../RegisterServlet" method="post">
아이디 <input type="text" name="id" /><br />
별명 <input type="text" name="nickname" /><br />
비밀번호 <input type="password" name="passwd" /><br />
이름 <input type="text" name="name" /><br />
<br />
성별<br />
남 <input type="radio" name="gender" value="M" /> 
여 <input type="radio" name="gender" value="F" /><br />

<br />
생년월일 <input type="text" name="birthyear" style="width: 30px" /> 년
 
<select name="birthmon">
   <option value="0" selected="selected">-월-</option>
   <option value="1">1</option>
   <option value="2">2</option>
   <option value="3">3</option>
   <option value="4">4</option>
   <option value="5">5</option>
   <option value="6">6</option>
   <option value="7">7</option>
   <option value="8">8</option>
   <option value="9">9</option>
   <option value="10">10</option>
   <option value="11">11</option>
   <option value="12">12</option>
</select>
월

<select name="birthday">
   <option value="0" selected="selected">-일-</option>
   <option value="1">1</option>
   <option value="2">2</option>
   <option value="3">3</option>
   <option value="4">4</option>
   <option value="5">5</option>
   <option value="6">6</option>
   <option value="7">7</option>
   <option value="8">8</option>
   <option value="9">9</option>
   <option value="10">10</option>
   <option value="11">11</option>
   <option value="12">12</option>
   <option value="13">13</option>
   <option value="14">14</option>
   <option value="15">15</option>
   <option value="16">16</option>
   <option value="17">17</option>
   <option value="18">18</option>
   <option value="19">19</option>
   <option value="20">20</option>
   <option value="21">21</option>
   <option value="22">22</option>
   <option value="23">23</option>
   <option value="24">24</option>
   <option value="25">25</option>
   <option value="26">26</option>
   <option value="27">27</option>
   <option value="28">28</option>
   <option value="29">29</option>
   <option value="30">30</option>
   <option value="31">31</option>		
</select>
일
<br />

양력 <input type="radio" name="solar" value="Y" checked="checked" />
음력 <input type="radio" name="solar" value="N" /><br />
<br />

휴대전화 <input type="text" name="mobile" /><br />
일반전화 <input type="text" name="tel" /><br />
<br />

주소<br />
<input type="text" name="zipcode1" style="width: 30px" /> -
<input type="text" name="zipcode2" style="width: 30px" /><br />
<input type="text" name="add" style="width: 300px" /><br />
<br />
이메일 <input type="text" name="email" /><br />
이메일수신여부<br />
수신 <input type="radio" name="emailyn" value="Y" checked="checked" />
수신안함 <input type="radio" name="emailyn" value="N" /><br />
<br />
좋아하는 운동<br />
<input type="checkbox" name="sports" value="soccer" />축구<br />
<input type="checkbox" name="sports" value="baseball" />야구<br />
<input type="checkbox" name="sports" value="basketball" />농구<br />
<input type="checkbox" name="sports" value="tennis" />테니스<br />
<input type="checkbox" name="sports" value="tabletennis" />탁구<br />
<br />
복수선택<br />
<select name="focus" multiple="multiple">
	<option value="">-- 복수선택 --</option>
	<option value="java">JAVA</option>
	<option value="jdbc">JDBC</option>
	<option value="jsp">JSP</option>
	<option value="css-layout">CSS Layout</option>
	<option value="jsp-prj">JSP 프로젝트</option>
	<option value="spring">Spring</option>
	<option value="javascript">자바스크립트</option>
</select>
<br />
<br />
자기소개<br />
<textarea name="aboutMe" cols="40" rows="7"></textarea><br />
<input type="submit" value="전송" />
</form>
</body>
</html>

RegisterServlet 서블릿 작성 : 회원 등록처리

데이터를 처리하는 서블릿을 아래와 같이 작성한다.

RegisterServlet.java

package example;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class RegisterServlet extends HttpServlet {
	@Override
	public void doPost(HttpServletRequest req, HttpServletResponse resp)
			throws IOException,ServletException {
		
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		req.setCharacterEncoding("UTF-8");
		
		String id = req.getParameter("id");
		
		out.println("<html><body>");
		out.println("id : " + id);
		
		String[] sports = req.getParameterValues("sports");
		int len = sports.length;
		
		out.println("<ol>");
		for (int i = 0; i < len; i++) {
			out.println("<li>" + sports[i] + "</li>");
		}
		
		out.println("</ol>");
		
		String path = req.getContextPath();
		out.println("<a href=" + path + "/example/join.html>Join</a>");
		out.println("</body></html>");
	}
}

명령 프롬프트를 열고 위 소스코드가 있는 /WEB-INF/src/exampe 로 이동하여 아래와 같이 컴파일한다.

javac -d C:/www/myapp/WEB-INF/classes ^
-cp "C:/Program Files/Apache Software Foundation/Tomcat 7.0/lib/servlet-api.jar" ^
RegisterServlet.java

다음으로 web.xml 파일을 열고 아래를 추가한다.

web.xml

<servlet>			
    <servlet-name>RegisterServlet</servlet-name>
    <servlet-class>example.RegisterServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>RegisterServlet</servlet-name>
    <url-pattern>/RegisterServlet</url-pattern>
</servlet-mapping>

톰캣을 재시작 한 후 http://localhost:8989/example/join.html로 방문하여 테스트한다.
ID와 좋아하는 운동외에 사용자가 입력하거나 선택한 값을 확인하는 소스를 서블릿에 추가하고 테스트해 보자.

RequestDispatcher 인터페이스

RequestDispathcer는 include()와 forward() 2개의 메소드가 있다.
include()메소드는 요청을 다른 자원으로 보냈다가 다른 자원에서 실행이 끝나면 다시 요청을 가져오는 메소드로 요청을 전달한 자원의 결과를 포함해서 클라이언트에게 보내게 된다.
forward()메소드는 이름 그대로 클라이언트의 요청을 서버상의 다른 자원에게 넘기는 메소드이다.
다음은 RequestDispatcher 의 forward() 메소드의 예로 모델 2 컨트롤러에 대한 이해에 도움이 될 것이다.

ControllerServlet.java

package example;

import java.io.IOException;

import javax.servlet.RequestDispatcher;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class ControllerServlet extends HttpServlet {

	@Override
	public void doGet(HttpServletRequest req, HttpServletResponse resp) 
			throws ServletException, IOException {
		doPost(req,resp);
	}

	@Override
	public void doPost(HttpServletRequest req, HttpServletResponse resp) 
			throws ServletException, IOException {

		req.setCharacterEncoding("UTF-8");
		
		String uri = req.getRequestURI();
		String contextPath = req.getContextPath();
		String command = null;
		String view = null;
		boolean isRedirect = false;
		
		command = uri.substring(contextPath.length());
		
		if (command.equals("/example/join.action")) {
			view = "/example/join.html";
		}
		if (isRedirect == false) {
			ServletContext sc = this.getServletContext();
			RequestDispatcher rd = sc.getRequestDispatcher(view);
			rd.forward(req,resp);
		} else {
			resp.sendRedirect(view);
		}
		
	}
	
}

명령 프롬프트를 열고 위 소스코드가 있는 /WEB-INF/src/exampe 로 이동하여 컴파일한다.

javac -d C:/www/myapp/WEB-INF/classes ^
-cp "C:/Program Files/Apache Software Foundation/Tomcat 7.0/lib/servlet-api.jar" ^
ControllerServlet.java

다음으로 web.xml 파일을 열고 아래를 추가한다.

web.xml

<servlet>
    <servlet-name>Controller</servlet-name>
    <servlet-class>example.ControllerServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>Controller</servlet-name>
    <url-pattern>*.action</url-pattern>
</servlet-mapping>

톰캣을 재시작한 다음 http://localhost:8989/example/join.action 방문하여 /example/join.html 이 응답하는지 확인한다.
ControllerServlet 에서 isRedirect 를 true 로 변경한 다음 테스트한다.

소스 설명

web.xml에서 모든 action 확장자의 요청을 ControllerServlet 담당하도록 설정했다.
확장자가 action 인 요청이 오면 톰캣은 web.xml 의 매핑정보를 해석해서 ControllerServlet 서블릿의 +service(req:ServletRequest, res:ServletResponse) 메소드를 호출한다.
+service(req:ServletRequest, res:ServletResponse) 메소드는 #service(req:HttpServletRequest, resp:HttpServletResponse) 메소드를 호출한다.
#service(req:HttpServletRequest, resp:HttpServletResponse) 메소드에서는 요청의 HTTP METHOD가 무엇인지 판단하고 그에 맞는 메소드를 호출한다.
웹브라우저의 주소창에서 http://localhost:8989/example/join.action 를 요청했으므로 GET 방식의 요청이다.
따라서 이 경우는 doGet()메소드를 호출된다.
ControllerServlet서블릿의 doGet()메소드는 단순히 doPost()을 호출한다.
doPost()의 구현부에서 사용된 HttpServletRequest 의 다음 메소드를 다음과 같이 정리한다.

getRequestURI()
웹브라우저로 http://localhost:8989/example/join.action 을 요청시 "/example/join.action" 을 리턴한다.
getContextPath()
컨텍스트 파일의 path 속성값을 얻을 수 있다.(이를 Context Path 라 한다.)
우리는 ROOT 애플리케이션에서 작업하므로 이 메소드를 통해 얻을 수 있는 값은 "" 이다.
req.getRequestURI().substring(req.getContextPath().length())
결과는 "/example/join.action" 를 리턴한다.
이 값이 getRequestURI() 의 리턴값이 같은 이유는 ROOT 애플리케이션이기 때문이다.
ROOT 애플리케이션이 아니라도 이 값은 달라지지 않는다.

/example/join.html 에 대한 RequestDispatcher 를 얻은 후 forward() 메소드를 이용해서 사용자의 요청을 /example/join.html 로 전달한다.
제어권이 ControllerServlet 에서 /example/join.html 로 이동한 것이다.
결과적으로 /example/join.action 을 요청한 사용자는 /example/join.html 의 응답을 받게 된다.

데이터베이스 연동

JDBC 메뉴에서 실습했던 오라클 JDBC 연동 테스트 파일인 GetEmp.java 를 서블릿으로 변환해보자.
이번 예제는 순수 자바 애플리케이션을 서블릿으로 바꾸는 예제인 것이다.
ROOT 애플리케이션의 /WEB-INF/src/example 디렉토리에 GetEmpServlet.java 파일을 생성한다.

GetEmpServlet.java

package example;

import java.io.IOException;
import java.io.PrintWriter;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class GetEmpServlet extends HttpServlet {
	
	private String DB_URL = "jdbc:oracle:thin:@127.0.0.1:1521:XE";
	private String DB_USER = "scott";
	private String DB_PASSWORD = "tiger";
	
	/*
	 * GenericServlet의 init() 메소드
	 * init(ServletConfig config) 메소드 구현부에서 이 메소드를 호출하도록 구현되어 있다.
	 * 따라서 굳이 init(ServletConfig config) 메소드를 오버라이딩하지 않아도 된다.
	 */
	@Override
	public void init() throws ServletException {
		try {
			Class.forName( "oracle.jdbc.driver.OracleDriver" );
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}
	

	@Override
	protected void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws ServletException, IOException {
		
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		
		Connection con = null;
		Statement stmt = null;
		ResultSet rs = null;
		
		String sql = "select * from emp";
		
		try {
			// Connection 레퍼런스를 획득
			con = DriverManager.getConnection(DB_URL, DB_USER, DB_PASSWORD);
			// Statement를 생성
			stmt = con.createStatement();
			// SQL문 실행
			rs = stmt.executeQuery(sql);
			
			while (rs.next()) {
				String empno = rs.getString(1);
				String ename = rs.getString(2);
				String job = rs.getString(3);
				String mgr = rs.getString(4);
				String hiredate = rs.getString(5);
				String sal = rs.getString(6);
				String comm = rs.getString(7);
				String depno = rs.getString(8);
				
				out.println( empno + " : " + ename + " : " + job + " : " + mgr + 
				" : " + hiredate + " : " + sal + " : " + comm+" : " + depno + "<br />" );
			}

		} catch (SQLException e) {
			e.printStackTrace(out);
		} finally {
			if (rs != null) {
				try {
					rs.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
			if (stmt != null) {
				try {
					stmt.close();
				} catch (SQLException e) {

					e.printStackTrace();
				}
			}
			if (con != null) {
				try {
					con.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
		}
		
	}

}

명령 프롬프트를 이용해서 ROOT 애플리케이션의 /WEB-INF/src/example 디렉토리로 이동 한 후 컴파일한다.

javac -d C:/www/myapp/WEB-INF/classes ^ 
-cp "C:/Program Files/Apache Software Foundation/Tomcat 7.0/lib/servlet-api.jar" ^
GetEmpServlet.java

컴파일 후에는 web.xml 파일을 편집한다.
web.xml 열고 아래와 같이 서블릿 선언과 매핑을 추가한다.

web.xml

<servlet>
    <servlet-name>GetEmpServlet</servlet-name>
    <servlet-class>example.GetEmpServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>GetEmpServlet</servlet-name>
    <url-pattern>/empList</url-pattern>
</servlet-mapping>

이미 설명한 대로 톰캣 클래스로더는 환경변수 CLASSPATH 를 참조하지 않는다.
JDBC 드라이버 파일은 특별한 이유로 반드시 {톰캣홈}/lib 두어야 한다.

톰캣을 재시작한 후, http://localhost:8989/empList 를 방문하여 확인한다.

7369 : SMITH : CLERK : 7902 : 1980-12-17 00:00:00.0 : 800 : null : 20

7499 : ALLEN : SALESMAN : 7698 : 1981-02-20 00:00:00.0 : 1600 : 300 : 30

7521 : WARD : SALESMAN : 7698 : 1981-02-22 00:00:00.0 : 1250 : 500 : 30

7566 : JONES : MANAGER : 7839 : 1981-04-02 00:00:00.0 : 2975 : null : 20

7654 : MARTIN : SALESMAN : 7698 : 1981-09-28 00:00:00.0 : 1250 : 1400 : 30

7698 : BLAKE : MANAGER : 7839 : 1981-05-01 00:00:00.0 : 2850 : null : 30

7782 : CLARK : MANAGER : 7839 : 1981-06-09 00:00:00.0 : 2450 : null : 10

7788 : SCOTT : ANALYST : 7566 : 1987-04-19 00:00:00.0 : 3000 : null : 20

7839 : KING : PRESIDENT : null : 1981-11-17 00:00:00.0 : 5000 : null : 10

7844 : TURNER : SALESMAN : 7698 : 1981-09-08 00:00:00.0 : 1500 : 0 : 30

7876 : ADAMS : CLERK : 7788 : 1987-05-23 00:00:00.0 : 1100 : null : 20

7900 : JAMES : CLERK : 7698 : 1981-12-03 00:00:00.0 : 950 : null : 30

7902 : FORD : ANALYST : 7566 : 1981-12-03 00:00:00.0 : 3000 : null : 20

7934 : MILLER : CLERK : 7782 : 1982-01-23 00:00:00.0 : 1300 : null : 10

원하는 결과가 나오지 않을 때에는 아래 리스트를 체크한다.

web.xml 파일에서 서블릿 선언과 서블릿 매핑정보가 올바른지 확인한다.
/WEB-INF/classes/example 에 GetEmpServlet 바이트코드 있는지 확인한다.
{톰캣홈}/lib 에 오라클 JDBC 드라이버 파일(ojdbc6.jar)이 있는지 확인한다.
웹 애플리케이션이 성공적으로 로드되었는지 확인한다.

ServletConfig 초기화 파라미터를 이용하는 예제

위 예제에서 서블릿의 메소드 구현부에서 JDBC 코드가 있었다.
이번 예제는 JDBC 설정을 ServletConfig 초기화 파라미터를 이용하도록 만든다.
아래 서블릿을 /WEB-INF/src/example 폴더에 만든다.

InitParamServlet 서블릿

package example;

import java.io.IOException;
import java.io.PrintWriter;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class InitParamServlet extends HttpServlet {
	
	private String url;
	private String user;
	private String passwd;
	private String driver;
	
	@Override
	public void init() throws ServletException {
		url = this.getInitParameter("url");
		user = this.getInitParameter("user");
		passwd = this.getInitParameter("passwd");
		driver = this.getInitParameter("driver");
		
		try {
			Class.forName(driver);
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}
	
	@Override
	public void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws IOException, ServletException {
		
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		
		Connection con = null;
		PreparedStatement stmt = null;
		ResultSet rs = null;
		
		String sql = "SELECT * FROM emp";
		
		try {
			con = DriverManager.getConnection(url, user, passwd);
			stmt = con.prepareStatement(sql);
			rs = stmt.executeQuery();
			
			while (rs.next()) {
				String empno = rs.getString(1);
				String ename = rs.getString(2);
				String job = rs.getString(3);
				String mgr = rs.getString(4);
				String hiredate = rs.getString(5);
				String sal = rs.getString(6);
				String comm = rs.getString(7);
				String depno = rs.getString(8);
				
				out.println(empno + " : " + ename + " : " + job + " : " + mgr + 
				  " : " + hiredate + " : " + sal + " : " + comm+" : " + depno + "<br />");
			}
		} catch (SQLException e) {
			e.printStackTrace(out);
		} finally {
			if (rs != null) {
				try {
					rs.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
			if (stmt != null) {
				try {
					stmt.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
			if (con != null) {
				try {
					con.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
		}
		
	}
	
}

ServletConfig 초기화 파라미터 선언은 web.xml 파일에서 아래와 같이 servlet 엘리먼트의 자식 엘리먼트 init-param 를 이용한다.

web.xml

<servlet>
  <servlet-name>InitParamServlet</servlet-name>
  <servlet-class>example.InitParamServlet</servlet-class>

  <init-param>
    <param-name>driver</param-name>
    <param-value>oracle.jdbc.driver.OracleDriver</param-value>
  </init-param>
  <init-param>
    <param-name>url</param-name>
    <param-value>jdbc:oracle:thin:@127.0.0.1:1521:XE</param-value>
  </init-param>
  <init-param>
    <param-name>user</param-name>
    <param-value>scott</param-value>
  </init-param>
  <init-param>
    <param-name>passwd</param-name>
    <param-value>tiger</param-value>
  </init-param>
</servlet>

<servlet-mapping>
  <servlet-name>InitParamServlet</servlet-name>
  <url-pattern>/initParam</url-pattern>
</servlet-mapping>

위에서 설정한 ServletConfig 의 초기화 파라미터의 값은 ServletConfig 의 getInitParameter(String name) 메소드를 이용하면 얻어진다. 톰캣을 재시작한 후에
http://localhost:8989/initParam 으로 방문하여 테스트한다.

ServletContext 초기화 파라미터를 이용하는 예제

위에서 ServletConfig 의 초기화 파라미터는 해당 서블릿에서만 참조 할 수 있다.
ServletContext 초기화 파라미터는 웹 애플리케이션 내 모든 서블릿과 JSP에서 참조할 수 있다.
ServletContext 초기화 파라미터는 context-param 엘리먼트를 이용한다.
엘리먼트의 위치는 web.xml 엘리먼트 순서를 참조한다.
기존의 servlet 선언부보다 먼저 있어야 한다.
web.xml 열고 아래 내용을 추가한다.

web.xml

<context-param>
    <param-name>url</param-name>
    <param-value>jdbc:oracle:thin:@127.0.0.1:1521:XE</param-value>
</context-param>

ServletContext 객체의 레퍼런스는 서블릿에서 getServletContext() 메소드를 이용하면 얻을 수 있다.
위에서 선언한 ServletContext 의 초기화 파라미터 url 의 값은 ServletContext 의 getInitParameter(String name) 메소드를 이용하여 구한다.
따로 예제를 만들지 않고 위에서 작성한 SimpleSerlvet 에 다음과 같이 코드를 적당한 위치에 추가한 후 다시 컴파일한다.

SimpleServlet 서블릿 편집

ServletContext sc = getServletContext();
String url = sc.getInitParameter("url");
out.println(url);

톰캣을 재실행하고
http://localhost:8989/simple
으로 방문하여 테스트한다.
InitParamServlet 에서 url 을 이 ServletContext 초기화 파라미터를 이용해서 설정하도록 코드를 수정하고 테스트해 보자.

리슨너

리슨너는 웹 애플리케이션의 이벤트에 실행된다.
웹 애플리케이션 이벤트는 서블릿 스펙 2.3 이후 등장했다.
웹 애플리케이션 이벤트는 다음과 같이 나뉜다.

애플리케이션 스타트업과 셧다운
세션 생성 및 세션 무효

애플리케이션 스타트업 이벤트는 톰캣과 같은 서블릿 컨테이너에 의해 웹 애플리케이션이 처음 로드되어 스타트될 때 발생한다.
애플리케이션 셧다운 이벤트는 웹 애플리케이션이 셧다운될 때 발생한다.

세션 생성 이벤트는 새로운 세션이 생성될 때 발생한다.
세션 무효 이벤트는 세션이 무효화 될때 매번 발생한다.

이벤트를 이용하기 위해서는 리슨너라는 클래스를 작성해야 한다.
리슨너 클래스는 순수 자바 클래스로 다음의 인터페이스를 구현한다.

javax.servlet.ServletContextListener
javax.servlet.http.HttpSessionListener

애플리케이션 스타트업 또는 셧다운 이벤트를 위한 리슨너를 원한다면 ServletContextListener 인터페이스를 구현한다.
세션 생성 및 세션 무효 이벤트를 위한 리슨너를 원한다면 HttpSessionListener 인터페이스를 구현한다.

ServletContextListener 인터페이스는 다음 2개의 메소드로 구성되어 있다.

public void contextInitialized(ServletContextEvent sce);
public void contextDestroyed(ServletContextEvent sce);

HttpSessionListener 인터페이스는 다음 2개의 메소드로 구성되어 있다.

public void sessionCreated(HttpSessionEvent se);
public void sessionDestroyed(HttpSessionEvent se);

다음은 애플리케이션 스타트업과 셧다운 이벤트를 이용하는 예제이다.
우리의 웹 애플리케이션이 스타트업되면 OracleConnectionManager 객체를 생성하여 ServletContext 에 저장하기 위해 아래와 같은 클래스를 작성한다.

MyServletContextListener.java

package net.java_school.listener;

import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

import net.java_school.db.dbpool.OracleConnectionManager;

public class MyServletContextListener implements ServletContextListener {

	@Override
	public void contextInitialized(ServletContextEvent sce) {
		ServletContext sc = sce.getServletContext();
		OracleConnectionManager dbMgr = new OracleConnectionManager();
		sc.setAttribute("dbMgr", dbMgr);
	}

	@Override
	public void contextDestroyed(ServletContextEvent sce) {
		ServletContext sc = sce.getServletContext();
		sc.removeAttribute("dbMgr");
	}

}

이 클래스가 제 기능을 다하도록 하려면 web.xml 에 아래를 web-app 엘리먼트의 자식 엘리먼트로 추가한다.
이때 다음 http://java.sun.com/dtd/web-app_2_3.dtd 를 참고하여 엘리먼트의 순서에 맞게 추가해야 한다.
context-param 보다는 아래에 servlet 보다는 위에 추가해야 함을 알 수 있다.

<!ELEMENT web-app (icon?, display-name?, description?, distributable?, context-param*, filter*, filter-mapping*, listener*, servlet*, servlet-mapping*, session-config?, mime-mapping*, welcome-file-list?, error-page*, taglib*, resource-env-ref*, resource-ref*, security-constraint*, login-config?, security-role*, env-entry*, ejb-ref*, ejb-local-ref*)>

web.xml

<listener>
    <listener-class>net.java_school.listener.MyServletContextListener</listener-class>
</listener>

JDBC 메뉴의 ConnectionPool 소스를 WEB-INF/src 에 추가한다.
net.java_school.util.Log.java 파일에서 다음 부분을 수정한다.
public String dbgFile = "C:/www/myapp/WEB-INF/debug.txt";
orcale.properties 파일은 WEB-INF 폴더에 위치시킨다.
ConnectionManager.java 파일에서 다음 부분을 수정한다.
configFile = "C:/www/myapp/WEB-INF/"+poolName+".properties";
이제 우리의 웹 애플리케이션이 시작될 때 OracleConnectionManager 객체를 생성되고 그 레퍼런스가 ServletContext 에 저장될 것이다.
테스트를 위해 GetEmpServlet.java 파일을 아래와 같이 수정한다.

GetEmpServlet.java

package example;

import java.sql.*;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

import net.java_school.db.dbpool.*;

public class GetEmpServlet extends HttpServlet {

	private OracleConnectionManager dbMgr;
	
	@Override
	public void init() throws ServletException {
		ServletContext sc = getServletContext();
		dbMgr = (OracleConnectionManager) sc.getAttribute("dbMgr");
	}
	
	@Override
	public void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws IOException, ServletException {
			
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		
		Connection con = null;
		PreparedStatement stmt = null;
		ResultSet rs = null;
		
		String sql = "SELECT * FROM emp";
		
		try {
			con = dbMgr.getConnection();
			stmt = con.prepareStatement(sql);
			rs = stmt.executeQuery();
			
			while (rs.next()) {
				String empno = rs.getString(1);
				String ename = rs.getString(2);
				String job = rs.getString(3);
				String mgr = rs.getString(4);
				String hiredate = rs.getString(5);
				String sal = rs.getString(6);
				String comm = rs.getString(7);
				String depno = rs.getString(8);
				
				out.println( empno + " : " + ename + " : " + job + " : " + mgr +
					" : " + hiredate + " : " + sal + " : " + comm+" : " + depno + "<br>" );
			}
		} catch (SQLException e) {
			e.printStackTrace(out);
		} finally {
			if (rs != null) {
				try {
					rs.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
			if (stmt != null) {
				try {
					stmt.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
			if (con != null) {
				try {
					con.close();
				} catch (SQLException e) {
					e.printStackTrace();
				}
			}
		}
	
	}
	
}

GetEmpServlet를 컴파일하고 톰캣을 재가동 후 http://localhost:8989/empList 를 방문한다.
(GetEmpServlet 서블릿에 대한 선언과 매핑은 이미 이전 예제 테스트에서 설정했다.)

다음은 HttpSessionListener 에 대한 설명과 예제이다.
HttpSessionListener 인터페이스 역시 2개의 메소드로 구성되어 있는데 하나는 세션 생성되는 이벤트와 세션이 무효화 되는 이벤트를 위한 것이다.

public void sessionCreated(HttpSessionEvent se);
public void sessionDestroyed(HttpSessionEvent se);

SessionCounterListener.java

package net.java_school.listener;

import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;

public class SessionCounterListener implements HttpSessionListener {
	public static int totalCount;
	
	@Override
	public void sessionCreated(HttpSessionEvent event) {
		totalCount++;
		System.out.println("세션증가 총세션수:" + totalCount);
	}

	@Override
	public void sessionDestroyed(HttpSessionEvent event) {
		totalCount--;
		System.out.println("세션감수 총세션수:" + totalCount);
	}

}

web.xml 에 다음을 추가한다.

<listener>
    <listener-class>net.java_school.listener.SessionCounterListener</listener-class>
</listener>

설정파일인 web.xml이 변경되었으므로 톰캣을 재실행한 후
http://localhost:8989/simple 을 방문한다.
다른 웹브라우저로 http://localhost:8989/simple 을 방문한다.
톰캣 로그 파일에서 로그 메시지를 확인한다.

Filter

필터란 사용자의 요청이 서버 자원에 전달되기 전에 언제나 수행되어야 하는 코드 조각이 있을 때 사용한다.
필터는 web.xml 에서 선언과 매핑을 해야 한다.
web.xml 에 필터1 다음에 필터2 가 순서대로 선언되고 매핑되었다면
필터1-필터2-서버 자원 순으로 실행될 것이다.
필터는 응답이 사용자의 웹브라우저에 도달되기 전에도 필터링 할 수 있다.
필터2-필터1-웹브라우저 순서로 응답이 도달된다.

여기서 서버 자원은 서블릿,JSP는 물론이고 HTML페이지와 이미지와 같은 정적인 자원를 포함하며, web.xml 에서 필터 관련 매핑 설정에서 URL 패턴에 부합하는 자원을 말한다.
필터 클래스를 작성하기 위해서는 javax.servlet.Filter 인터페이스를 구현해야 한다.

Filter 인터페이스

init (FilterConfig filterConfig) throws ServletException
서블릿 컨테이너에 의해 호출되면 필터는 서비스 상태가 됨
doFilter (ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException
서블릿 컨테이너에 의해 호출되어 필터링 작업을 수행
destroy()
서블릿 컨테이너에 의해 호출되면 해당 필터는 더 이상 서비스를 할 수 없음. 주로 자원반납을 위해 사용

doFilter 메소드의 아규먼트를 보면, 필터가 요청이나 응답을 가로챌 때 ServletRequest 와 ServletResponse 그리고 javax.servlet.FilterChain 객체를 접근할 수 있음을 알 수 있다.
여기서 FilterChain 객체는 순서대로 호출되어야 하는 필터의 리스트를 담고 있다.
필터의 doFilter 메소드에서 FilterChain 의 doFilter 메소드를 호출하기 전까지가 요청전에 실행되는 필터링 코드이며 FilterChain의 doFilter 메소드 호출다음은 응답전에 호출되는 필터링 코드이다.
이와 같이 작동하는 이유가 궁금하면 아래 필터를 흉내낸 자바 순수 애플리케이션을 실행해 본다.

필터 매커니즘을 흉내낸 자바 순수 애플리케이션

ChainFilter.java

package net.java_school.filter;

import java.util.ArrayList;
import java.util.Iterator;

public class ChainFilter {
	private ArrayList<Filter> filters;
	private Iterator<Filter> iterator;

	public void doFilter() {
		if (iterator.hasNext()) {
			iterator.next().doFilter(this);
		} else {
			System.out.println("서버 자원을 호출한다.");
		}
	}

	public ArrayList<Filter> getFilters() {
		return filters;
	}

	public void setFilters(ArrayList<Filter> filters) {
		this.filters = filters;
		this.iterator = filters.iterator();
	}
	
}

Filter.java

package net.java_school.filter;

public interface Filter {
	
	public void doFilter(ChainFilter chain);

}

Filter1.java

package net.java_school.filter;

public class Filter1 implements Filter {

	@Override
	public void doFilter(ChainFilter chain) {
		System.out.println("서버 자원 실행전에 필터1 실행부");
		chain.doFilter();
		System.out.println("서버 자원 실행후에 필터1 실행부");
	}

}

Filter2.java

package net.java_school.filter;

public class Filter2 implements Filter {

	@Override
	public void doFilter(ChainFilter chain) {
		System.out.println("서버 자원 실행전에 필터2 실행부");
		chain.doFilter();
		System.out.println("서버 자원 실행후에 필터2 실행부");
	}

}

Tomcat.java

package net.java_school.filter;

import java.util.ArrayList;

public class Tomcat {

	public static void main(String[] args) {
		ChainFilter chain = new ChainFilter();
		ArrayList<Filter> filters = new ArrayList<Filter>();
		Filter f1 = new Filter1();
		Filter f2 = new Filter2();
		filters.add(f1);
		filters.add(f2);
		chain.setFilters(filters);
		chain.doFilter();
	}

}

서버 자원 실행전에 필터1 실행부
서버 자원 실행전에 필터2 실행부
서버 자원을 호출한다.
서버 자원 실행후에 필터2 실행부
서버 자원 실행후에 필터1 실행부

Filter 예제

다음은 모든 요청에 대해 ServletRequest 의 setCharacterEncoding("UTF-8"); 가 먼저 수행되도록 하려 한다.
아래와 같이 CharsetFilter.java 파일을 작성한다.

/WEB-INF/src/net/java_school/filter/CharsetFilter.java

package net.java_school.filter;

import java.io.IOException;

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;

public class CharsetFilter implements Filter {

	private String charset = null;
	
	@Override
	public void init(FilterConfig config) throws ServletException {
		this.charset = config.getInitParameter("charset");
	}
	
	@Override
	public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) 
		throws IOException, ServletException {
		
		if (req.getCharacterEncoding() == null) {
			req.setCharacterEncoding(charset);
			chain.doFilter(req,resp);
		}
	}

	@Override
	public void destroy() {
		//반납할 자원이 있다면 작성한다.
	}

}

/WEB-INF/src/net/java_school/filter/ 폴더로 이동해서 아래와 같이 컴파일한다.

javac -d C:/www/myapp/WEB-INF/classes ^
-cp "C:/Program Files/Apache Software Foundation/Tomcat 7.0/lib/servlet-api.jar" ^
CharsetFilter.java

다음 web.xml 파일을 열고 아래를 추가한다. 이때 기존 엘리먼트와의 순서에 주의한다.
context-param 엘리먼트와 listener 엘리먼트 사이에 아래 코드가 위치해야 한다.

web.xml

<filter>
   <filter-name>CharsetFilter</filter-name>
   <filter-class>net.java_school.filter.CharsetFilter</filter-class>
   <init-param>
      <param-name>charset</param-name>
      <param-value>UTF-8</param-value>
   </init-param>
</filter>

<filter-mapping>
   <filter-name>CharsetFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

테스트

위에서 실행했던 회원가입 예제의 RegisterServlet.java 소스에서
req.setCharacterEncoding( "UTF-8" ); 을 주석처리 한 후 RegisterServlet 서블릿을 재컴파일한다.
http://localhost:8989/example/join.jsp 를 방문하여 아이디에 한글을 입력하고 좋아하는 운동을 선택한 후 전송을 클릭한다.
이때 RegisterServlet 이 사용자가 입력한 한글 아이디 값을 제대로 출력하는지 테스트한다.

소스 설명

필터의 초기화 파라미터를 읽기 위해서는 FilterConfig의 getInitParameter()메소드나 getInitParameters()메소드를 이용한다.
filter-mapping엘리먼트를 이용해서 URL패턴이나 서블릿 이름으로 이들 자원에 앞서 필터링 작업을 수행할 필터를 정의한다.
필터는 배치 정의자에 나와 있는 순으로 FilterChain에 추가된다.
이때 서블릿 이름과 매핑된 필터는 URL 패턴에 매칭되는 필터 다음에 추가된다.
필터 클래스 코드내에서 FilterChain.doFilter() 메소드를 이용하면 FilterChain의 다음 아이템을 호출하게 된다.

파일 업로드

MultipartRequest

MultipartRequest 팩키지는 파일 업로드에 널리 이용되고 있는 팩키지이다.
http://www.servlets.com/cos/index.html 에서 가장 최신 버전인 cos-26Dec2008.zip 를 다운로드 하여 압축을 푼 후 서브 디렉토리 lib 에 있는 cos.jar 파일을 /WEB-INF/lib 디렉토리에 복사한다.

MultipartRequest 클래스의 생성자는 아래 링크에서 확인할 수 있듯이 8개가 있다.
http://www.servlets.com/cos/javadoc/com/oreilly/servlet/MultipartRequest.html
그 중 아래의 생성자는 한글 인코딩 문제를 해결할 수 있고 업로드하는 파일이 중복될 때 파일명을 변경해서 업로드한다. 예제에서는 이 생성자를 이용한다.

public MultipartRequest(
	HttpServletRequest request,
	String saveDirectory,
	int maxPostSize,
	String encoding,
	FileRenamePolicy policy) throws IOException

MultipartRequest 메소드

MultipartRequest 객체가 성공적으로 생성되었다면 이미 업로드는 성공한 것이다.
아래 메소드는 서버의 파일 시스템에 파일을 업로드 된 후 이용하는 MultipartRequest 멤버 메소드를 소개하고 있다.
<input type="file" name="photo"/>를 이용해서 logo.gif 를 업로드했다고 가정하에 설명한다.

메소드	설명
getContentType("photo");	업로드된 파일의 MIME 타입 리턴, 예를 들어 확장자가 gif 이미지라면 "image/gif" 가 반환
getFile("photo");	업로드되어 서버에 저장된 파일의 File 객체 리턴
getFileNames();	폼 요소 중 input 태그 속성이 file 로 된 파라미터의 이름을 Enumeration 타입으로 리턴
getFilesystemName("photo");	업로드되어 서버 파일시스템에 존재하는 실제 파일명을 리턴
getOriginalFileName("photo");	원래의 파일명을 리턴
HttpServletRequest 구현체와 같은 인터페이스를 제공하기 위한 메소드
getParameter(String name);	name 에 해당하는 파라미터의 값을 String 타입으로 리턴
getParameterNames();	모든 파라미터의 이름을 String 으로 구성된 Enumeration 타입으로 리턴
getParameterValues(String name);	name 에 해당하는 파라미터의 값들을 String[] 타입으로 리턴

MultipartRequest 예제

사용자로 부터 업로드 파일을 선택하도록 유도하는 페이지를 ROOT 애플리케이션의 최상위 디렉토리의 서브 디렉토리 example 에 작성한다.

/example/MultipartRequest.html

<!DOCTYPE html 
     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
   <title>MultipartRequest 서블릿 예제</title>
   <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
</head>
<body>
<h2>MultipartRequest 를 이용한 파일 업로드 테스트</h2>
<form action="../servlet/UploadTest" method="post" enctype="multipart/form-data">
  <p>
    이름 : <input type="text" name="name" /><br />
    파일1 : <input type="file" name="file1" /><br />
    파일2 : <input type="file" name="file2" /><br />
  <input type="submit" value="전송" />
  </p>  
</form>
</body></html>

업로드를 실행할 서블릿을 아래와 같이 작성하고 컴파일한다.
컴파일 할 때에 자바 컴파일러는 cos.jar 파일에 대한 경로를 알아야 한다.

UploadTest.java

package example;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;

import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.oreilly.servlet.MultipartRequest;
import com.oreilly.servlet.multipart.DefaultFileRenamePolicy;

public class UploadTest extends HttpServlet {
	
	@Override	
	public void doPost(HttpServletRequest req, HttpServletResponse resp) 
			throws IOException, ServletException {
			
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		
		ServletContext cxt = getServletContext();
		String dir = cxt.getRealPath("/upload");
		
		try {
			MultipartRequest multi = 
				new MultipartRequest(
					req,
					dir,
					5*1024*1024,
					"UTF-8",
					new DefaultFileRenamePolicy());
					
			out.println("<html>");
			out.println("<body>");
			out.println("<h1>사용자가 전달한 파라미터들</h1>");
			out.println("<ol>");
			Enumeration<?> params = multi.getParameterNames();
			
			while (params.hasMoreElements()) {
				String name = (String) params.nextElement();
				String value = multi.getParameter(name);
				out.println("<li>" + name + "=" + value + "</li>");
			}
			
			out.println("</ol>");
			out.println("<h1>업로드된 파일</h1>");
			
			
			Enumeration<?> files = multi.getFileNames();
			
			while (files.hasMoreElements()) {
				out.println("<ul>");
				String name = (String) files.nextElement();
				String filename = multi.getFilesystemName(name);
				String orginalname =multi.getOriginalFileName(name);
				String type = multi.getContentType(name);
				File f = multi.getFile(name);
				out.println("<li>파라미터 이름 : "  + name + "</li>");
				out.println("<li>파일 이름 : " + filename + "</li>");
				out.println("<li>원래 파일 이름 : " + orginalname + "</li>");
				out.println("<li>파일 타입 : " + type + "</li>");
				
				if (f != null) {
					out.println("<li>크기: " + f.length() + "</li>");
				}
				out.println("</ul>");
			}
		} catch(Exception e) {
			out.println("<ul>");
			e.printStackTrace(out);
			out.println("</ul>");
		}
		out.println("</body></html>");
	}
}

다음으로 web.xml 파일을 열고 작성한 서블릿을 등록하고 매핑한다.

web.xml

<servlet>
    <servlet-name>UploadTest</servlet-name>
    <servlet-class>example.UploadTest</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>UploadTest</servlet-name>
    <url-pattern>/servlet/UploadTest</url-pattern>
</servlet-mapping>

예제를 실행하기 전에 ROOT 웹 애플리케이션의 최상위 디렉토리에 upload 라는 서브 디렉토리를 만든다.
톰캣을 재가동하고 http://localhost:8989/example/upload.html 를 방문하여 테스트한다.
중복된 파일을 업로드한 후 upload 폴더에서 파일명을 확인한다.
중복된 파일을 업로드하면 확장자를 제외한 파일이름의 끝에 숫자가 붙어서 업로드 되고 있음을 확인할 수 있다.
만약 테스트가 실패했다면 아래 리스트를 체크한다.

UploadTest 서블릿의 바이트 코드가 생성되어 있는지 확인한다.
ROOT 애플리케이션의 최상위 디렉토리에 upload 라는 서브 디렉토리가 있는지 확인한다.
톰캣 클래스로더가 찾을 수 있도록 cos.jar 파일이 /WEB-INF/lib 에 위치하는지 확인한다.
web.xml 파일에 UploadTest 서블릿이 제대로 등록되고 매핑되어 있는지 확인한다.
웹 애플리케이션이 로드되었는지 확인한다.

commons-fileupload

http://commons.apache.org/proper/commons-fileupload/download_fileupload.cgi
http://commons.apache.org/proper/commons-io/download_io.cgi
에서 최신 바이너리 파일을 다운로드 한 후
/WEB-INF/lib에 commons-fileupload-x.x.jar 와 commons-io-x.x.jar 를 위치시킨다.

/example/commons-fileupload.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
	"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>commons-fileupload 테스트</title>
</head>
<body>
<h1>파일 업로드 테스트</h1>
<form action="../CommonsUpload" method="post" enctype="multipart/form-data">
파일 : <input type="file" name="upload" /><br />
<input type="submit" value="전송" />
</form>
</body>
</html>

CommonsUpload.java 서블릿

package example;

import java.io.*;

import javax.servlet.*;
import javax.servlet.http.*;

import java.util.Iterator;
import java.io.File;
import java.util.List;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

public class CommonsUpload extends HttpServlet {

	@Override
	public void doPost(HttpServletRequest req, HttpServletResponse resp) 
			throws IOException, ServletException {
			
		resp.setContentType("text/html; charset=UTF-8");
		PrintWriter out = resp.getWriter();
		//Check that we have a file upload request
		boolean isMultipart = ServletFileUpload.isMultipartContent(req);
		//Create a factory for disk-based file items
		DiskFileItemFactory factory = new DiskFileItemFactory();
		
		//Configure a repository (to ensure a secure temp location is used)
		ServletContext servletContext = this.getServletConfig().getServletContext();
		File repository = (File) servletContext.getAttribute("javax.servlet.context.tempdir");
		factory.setRepository(repository);
		
		//Create a new file upload handler
		ServletFileUpload upload = new ServletFileUpload(factory);
		upload.setHeaderEncoding("UTF-8");//한글파일명 처리위해 추가
		try {
			//Parse the request
			List<FileItem> items = upload.parseRequest(req);
			//Process a file upload
			Iterator<FileItem> iter = items.iterator();
			while (iter.hasNext()) {
				FileItem item = iter.next();
				String fileName = null;
				if (!item.isFormField()) {
					String fieldName = item.getFieldName();
					out.println(fieldName);
					fileName = item.getName();
					out.println(fileName);
					String contentType = item.getContentType();
					out.println(contentType);
					boolean isInMemory = item.isInMemory();
					out.println(isInMemory);
					long sizeInBytes = item.getSize();
					out.println(sizeInBytes);
				}
				// Process a file upload
				ServletContext cxt = getServletContext();
				String dir = cxt.getRealPath("/upload");
				File uploadedFile = new File(dir + "/" + fileName);
				item.write(uploadedFile);
			}
		} catch (Exception e) {
			out.println("<ul>");
			e.printStackTrace(out);
			out.println("</ul>");
		}
		out.println("<a href=\"example/commons-fileupload.html\">파일업로드폼으로</a>");
	}
}

web.xml 파일을 열고 작성한 서블릿을 등록하고 매핑한다.

web.xml

<servlet>
    <servlet-name>commonsUpload</servlet-name>
    <servlet-class>example.CommonsUpload</servlet-class>
</servlet>

<servlet-mapping>
	<servlet-name>commonsUpload</servlet-name>
	<url-pattern>/CommonsUpload</url-pattern>
</servlet-mapping>

톰캣을 재가동하고 http://localhost:8989/example/commons-fileupload.html 를 방문하여 테스트한다.
중복된 파일을 업로드한 후 upload 폴더에서 파일명을 확인한다.
중복된 파일을 업로드하면 cos.jar 와는 달리 기존 파일을 덮어쓴다는 것을 확인한다.
업로드된 파일을 확인하는 예제는 JSP에서 다룬다.

쿠키

HTTP 프로토콜은 상태를 유지할 수 없는 프로토콜이다.
쿠키는 HTTP 프로토콜의 특징상 각각의 웹 브라우저가 서버와의 통신에서 세션을 유지하지 못하는 것을 보완하기 위한 기술이다.
서버가 쿠키를 전송하면 웹 브라우저는 그 다음 요청마다 쿠키 값을 서버로 전달하여 사용자 정보를 유지할 수 있게 한다.

서버 -> 웹 브라우저

쿠키가 작동하려면 서버에서 쿠키값을 클라이언트로 전송해야 한다.
이것을 쿠키를 굽는다고 표현하는데 아래와 같은 정보가 서버로부터 웹 브라우저에 전달되고 웹 브라우저가 관리하는 폴더에 파일로 저장된다.

Set-Cookie : name = value ; expires = date ; path = path ; domain = domain ; secure

웹 브라우저 -> 서버

쿠키가 웹브라우저에 셋팅되면, 웹브라우저는 쿠기를 전달해준 서버로 요청시마다 아래와 같은 문자열을 서버로 보낸다.

Cookie ; name = value1 ; name2 = value2 ;

쿠키 이름과 값에는 []()="/?@:; 와 같은 문자는 올 수 없다.
다음은 쿠키를 설정하는 절차이다.

쿠키 설정 절차

1) Cookie 객체를 만든다. Cookie(String name, String value)
2) 다음 메소드를 이용해 쿠키에 속성을 부여한다.

메소드	설명
setValue(String value)	생성된 쿠키의 값을 재설정할 때 사용한다.
setDomain(String pattern)	쿠키는 기본적으로 쿠키를 생성한 서버에만 전송된다. 같은 도메인을 사용하는 서버에 대해서 같은 쿠키를 보내기 위해서 setDomain()을 사용한다. 주의할 점은 쿠키를 생성한 서버와 관련이 없는 도메인을 setDomain()에 값으로 설정하면 쿠키가 구워지지 않는다는 것이다.
setMaxAge(int expiry)	쿠키의 유효기간을 초단위로 설정한다. 음수 입력시에는 브라우저가 닫으면 쿠키가 삭제된다.
setPath(String uri)	쿠키가 적용될 경로 정보를 설정한다. 경로가 설정되면 해당되는 경로로 방문하는 경우에만 웹브라우저가 쿠키를 웹서버에 전송한다.
setSecure(boolean flag)	flag가 true이면 보안채널을 사용하는 서버의 경우에 한해 쿠키를 전송한다.

3) 웹브라우저에 생성된 쿠키를 전송 : resp.addCookie(cookie);

구워진 쿠키 이용

위에서 쿠키를 설정했다면 이제 서블릿에서 쿠키 이용하는 방법에 대해 알아본다.

Cookie[] cookie = req.getCookies();

HttpServletRequest 의 getCookies() 메소드를 사용해서 쿠키배열을 얻는다.
만약 구워진 쿠키가 없다면 getCookies() 메소드는 null 을 리턴한다.
다음 메소드를 이용하면 쿠키에 대한 정보를 얻을 수 있다.
이중 getName()과 getValue()가 주로 쓰인다.

Cookie 메소드	설명
getName()	쿠키의 이름을 구한다.
getValue()	쿠키의 값을 구한다.
getDomain()	쿠키의 도메인을 구한다.
getMaxAge()	쿠키의 유효시간을 구한다.

다음은 서버 사이드에서 쿠키값을 알아내는 코드조각이다.
예에서는 쿠키 이름이 id에 해당하는 쿠키값을 반환하는 예이다.

String id = null;
Cookie[] cookies = request.getCookies();
if (cookies != null) {
  for (int i = 0; i < cookies.length; i++) {
    String name = cookies[i].getName();
    if (name.equals("id")) {
      id = cookies[i].getValue();
      	break;
    }
  }
}

아래는 쿠키를 삭제하는 예이다.
방법은 삭제하고자 하는 쿠키와 같은 이름의 쿠키를 생성하고 setMaxAge(0) 을 호출한다.

Cookie cookie = new Cookie("id","");
cookie.setMaxAge(0);
resp.addCookie(cookie);

쿠키에 대한 실습은 JSP에서 다룬다.

세션

세션은 쿠키 기반 기술로 쿠키의 보안상 약점을 극복하기 위한 기술이다.
쿠키와 다른 점(즉, 보안상 개선된 점)은 웹브라우저는 서버가 정해준 세션ID 만을 쿠키값으로 저장한다는 것이다.
세션이 생성되면 서버에서는 세션ID에 해당하는 HttpSession 객체를 서블릿 컨테이너가 연결시켜 준다.
아래는 세션 생성하는 코드이다.

HttpSession session = req.getSession(true); //세션이 없으면 생성
HttpSession session = req.getSession(false); //세션이 없다면 null리턴

세션 객체가 생성되었으면 세션에 정보를 아래코드처럼 저장할 수 있다.

User user = new User("홍길동","1234");
session.setAttribue("user", user); //user 이름으로 user 객체 저장

세션에 대한 실습은 JSP에서 한다.

주석

그림(서블릿 기본골격 클래스 다이어그램)이 GenericServlet, HttpServlet 의 모든 속성과 메소드를 모두 나타내고 있지는 않다. 이어지는 설명을 쉽게 이해하려면 클래스 다이어그램에서 나오는 인퍼페이스,추상클래스,클래스 이름은 기억해야 한다.
MIME(Multipurpose Internet Mail Extensions)
.html 또는 .htm 은 text/html, .txt 는 text/plain .gif 는 image/gif 이다.
쿼리 스트링(Query tring)이라 하는 URL 뒤 ? 다음에 이어지는 문자열은 URL에 해당하는 서버측 자원에 전달된다. 정보가 1개 이상일 때는 두번째부터는 &를 사용한다.
Enumeration 인터페이스는 hasMoreElements() 와 nextElement() 2개의 메소드를 이용하여 데이터를 순서대로 접근할 수 있다.

참고

출처 - http://www.java-school.net/jsp/Servlet.php

저작자표시 비영리

'FRAMEWORK > SERVLET' 카테고리의 다른 글

RequestDispatcher forward method (0)	2014.11.05
RequestDispatcher include method (0)	2014.11.05
서블릿이란 (0)	2014.11.05
jsp 와 servlet 의 차이 (0)	2014.11.05

랄라라

서블릿

블릿이란?

서블릿의 기본 골격

Servlet 인터페이스

init() 메소드

service() 메소드

destroy() 메소드

GenericServlet 추상클래스

HttpServlet 클래스

서블릿 클래스, 인터페이스 요약

서블릿 예제

SimpleServlet.java

web.xml

package javax.servlet.http does not exist

SimpleServlet.java 소스설명

사용자가 문자열 데이터를 서버측 자원으로 전송하는 방법과 이 데이터를 서버측 자원에서 수신하는 방법

파라미터 전송 방법과 전송된 파라미터의 값 얻기

getParameter(String name)

getParameterValues(String name)

getParamterNames()

input type="file" 은 파일 업로드에 쓰인다.

문자열 전송 예제

/example/join.html

RegisterServlet 서블릿 작성 : 회원 등록처리

RegisterServlet.java

web.xml

RequestDispatcher 인터페이스

ControllerServlet.java

web.xml

소스 설명

데이터베이스 연동

GetEmpServlet.java

web.xml

ServletConfig 초기화 파라미터를 이용하는 예제

InitParamServlet 서블릿

web.xml

ServletContext 초기화 파라미터를 이용하는 예제

web.xml

SimpleServlet 서블릿 편집

리슨너

MyServletContextListener.java

web.xml

GetEmpServlet.java

SessionCounterListener.java

Filter

Filter 인터페이스

필터 매커니즘을 흉내낸 자바 순수 애플리케이션

ChainFilter.java

Filter.java

Filter1.java

Filter2.java

Tomcat.java

Filter 예제

/WEB-INF/src/net/java_school/filter/CharsetFilter.java

web.xml

테스트

소스 설명

파일 업로드

MultipartRequest

MultipartRequest 메소드

MultipartRequest 예제

/example/MultipartRequest.html

UploadTest.java

web.xml

commons-fileupload

/example/commons-fileupload.html

CommonsUpload.java 서블릿

web.xml

쿠키

서버 -> 웹 브라우저

웹 브라우저 -> 서버

쿠키 설정 절차

구워진 쿠키 이용

세션

주석

참고

'FRAMEWORK > SERVLET' 카테고리의 다른 글

티스토리툴바