* 회원가입 * 아이디/비밀번호 찾기   ID PW
Last Modified : 2008.11.21

서블릿 예제

1. HelloServlet

서블릿의 첫번째 예제는 "안녕! 2008년" 를 출력하는 예제입니다.
앞으로 나오는 모든 예제는 ROOT 웹 애플리케이션에서 실행합니다.
아래 파일을 ROOT 웹 애플리케이션의 WEB-INF/src/example 폴더에 저장합니다.
/WEB-INF/src/example/ 폴더로 이동하여 아래와 같이 컴파일합니다.

/WEB-INF/src/example/HelloServlet.java

package example;

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

public class HelloServlet extends HttpServlet {
  public void doGet( HttpServletRequest req, HttpServletResponse res )
    throws ServletException,IOException {
    
    res.setContentType( "text/html;charset=euc-kr" );
    PrintWriter out = res.getWriter();
    
    out.println( "<HTML>" );
    out.println( "<BODY>" );
    out.println( "안녕! 2008년" );
    out.println( "</BODY>" );
    out.println( "</HTML>" );
    out.close();
    
  }
}
(1) web.xml 파일 편집

web.xml 파일을 열고 web-app 엘리멘트안에 아래를 추가합니다.

/WEB-INF/web.xml

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

<servlet-mapping>
    <servlet-name>HelloServlet</servlet-name>
    <url-pattern>/servlet/HelloServlet</url-pattern>
</servlet-mapping>
(2) HelloServlet.java 컴파일

CLASSPATH 에 C:/apps/tomcat/common/lib/servlet-api.jar 파일경로를 추가했다면 아래처럼 컴파일합니다.
javac -d C:/www/myproject/WEB-INF/classes HelloServlet.java
CLASSPATH 에 servlet-api.jar 파일을 추가하지 않은 경우엔 아래처럼 컴파일합니다.
javac -d c:/www/myproject/WEB-INF/classes -classpath c:/apps/tomcat/common/lib/servlet-api.jar HelloServlet.java

(3) http://localhost:8080/servlet/HelloServlet 로 방문하여 테스트

아파치, Tomcat 을 재시작하고
http://localhost/servlet/HelloServlet 을 방문하여 실행이 되는지 확인합니다.

(4) HelloServlet.java 서블릿 소스 설명

1) HttpServlet 클래스를 상속받은 우리의 서블릿은 public class 로 선언해야 합니다.
2) HTTP 의 GET 방식으로 웹 브라우저가 요청해오면 doGet() 메소드를 작성합니다.
(일반적으로 웹서버의 자원을 요청하는 것은 HTTP 프로토콜의 GET 방식의 요청입니다.)
3) doGet() 메소드는 HttpServletRequest 와 HttpServletResponse 타입의 아규먼트를 가집니다.
이 메소드는 예외가 발생할 수 있으므로 다음 문장으로 예외를 처리합니다.
throws ServletException, IOExcepiton
4) res.setContentType("text/html;charset=euc-kr");
은 웹브라우저에 응답으로 출력될 문서의 MIME 타입을 설정합니다.
;charset=euc-kr 을 쓰지 않으면 한글이 깨지는 경우가 발생합니다.
setContentType()메소드는 HttpServletResponse 의 메소드입니다.
5) PrintWriter out = res.getWriter();
웹브라우저가 목적지인 문자 출력 스트림을 얻습니다.
PrintWriter의 plintln() 메소드안에 문자열을 넣으면 클라이언트의 웹브라우저에 출력됩니다.
6) http://localhost/servlet/HelloServlet 는 web.xml 에서 매핑한 내용대로 접근해야 합니다.
7) HelloServlet 서블릿이 응답을 보내기까지
클라이언트가 서버의 HelloSerlvet 서블릿 자원을 요청합니다.
서블릿 컨테이너는 클라이언트의 요청을 캡슐화한 HttpSerlvetRequest 인터페이스를 구현한 객체와
응답을 위한 HttpSerlvetResponse 인터페이스를 구현한 객체를 아규먼트로 받는 protected void service(HttpServletRequest req,HttpServletResponse res) 메소드를 호출합니다.
이 메소드의 내용은 단지 웹브라우저가 헤더로 보낸 HTTP 메소드타입(GET,POST)에 따라 자동적으로 doGet() 또는 doPost()메소드를 호출하도록 하는 것이 전부입니다.
(따라서 doGet()이나 doPost()를 생각하지 않으려면 service()메소드를 직접 오버라이딩해도 됩니다.)

이제는 클라이언트가 웹브라우저를 통해서 요청과 함께 정보를 어떻게 보내는지 그리고 그 정보를 서블릿에서 어떻게 다룰 수 있는지 알아봅니다.

2. 웹 브라우저가 서버에 문자열을 전송하는 방법

HTML FORM 태그를 이용하여 웹브라우저가 서버로 문자열 데이터를 전달하는 방법과 서블릿에서 그 정보를 받는 코드조각은 다음과 같습니다.

폼 작성 서블릿
<input type="text" name="addr"/> req.getParameter("addr");
<input type="radio" name="os" value="WinXP"/>
<input type="radio" name="os" value="Win2003"/> 		req.getParameter("os");
<input type="hidden" name="curPage" value="1"/> req.getParameter("curPage");
<input type="password" name="passwd"/> req.getParamter("passwd");
<input type="checkbox" name="hw" value="intel"/>
<input type="checkbox" name="hw" value="amd"/> 		req.getParameterValues("hw");
<select name="os" multiple>
  <option value="win">windows</option>
  <option value="linux">linux</option>
  <option value="solaris">solaris</option>
</select> 		req.getParameterValues("os");
multiple 속성이 없다면
req.getParameter( "os" )도 가능

HttpServletRequest 객체의 getParameter(name:String) 메소드

HttpServletRequest 의 getParameter(name:String) 메소드는 웹브라우저에서 사용자가 보내는 데이터를 서블릿에서 받기 위해 사용하는 가장 보편적인 메소드입니다.
라디오 버튼은 name 속성이 같게 두면 같은 name 속성의 라디오 버튼들은 그룹이 됩니다.
그룹화되어 있는 라디오 버튼은 사용자가 한개 항목만을 선택할 수 있으며 서버로 전송하는 파라미터값도 하나만이 전송됩니다
이렇듯 파라미터와 값 하나의 쌍으로 전송되는 데이터를 수신하는 메소드가 바로 getParameter(name:String) 메소드입니다.
이 밖에 input 엘리먼트의 type 속성이 text, passwd, hidden 로 된 폼 역시 HttpServletRequest 의 getParameter(name:String) 메소드를 이용해서 사용자가 전달한 파라미터 값을 받습니다.
이때 클라이언트, 즉 웹 브라우저에서 서버로는 문자열만을 전송할 수 있습니다.
(물론 서버측에서 같은 메모리상의 존재하는 서버자원끼리는 모든 타입이 전달될 수 있습니다.)

HttpServletRequest 객체의 getParameterValues(name:String) 메소드

폼 양식에서 하나의 파라미터명에 값을 여러개 전송할 때는 HttpServletRequet 의 getParamter(name:String) 메소드가 아닌 getParamterValues(name:String) 메소드가 사용됩니다.
이 메소드의 리턴값은 사용자가 선택한 값들만으로 구성된 String 배열입니다.

HttpServletRequest 객체의 getParamterNames()

만약 사용자가 어떤 파라미터명으로 데이터를 보내는지 알수 없다면(그럴 경우는 거의 없지만) 이때 사용자가 보내는 파라미터명을 알 수 있는 메소드가 HttpServletRequest 의 getParamterNames()입니다.
getParameterNames() 메소드는 리턴값으로 파라미터 이름을 접근할 수 있는 Enumeration 타입을 반환합니다.
Enumeration 인터페이스는 hasMoreElements() , nextElement() 2개의 메소드를 이용하여 데이터를 접근할 수 있습니다.

HttpServletRequest 객체의 setCharacterEncoding(env:String) 메소드

HttpServletRequest 의 setCharacterEncoding("euc-kr") 은 요청의 바디의 인코딩을 한글 인코딩으로 변경해주는 메소드입니다.
만일 한글 데이터를 서버로 폼 태그를 이용해서 전송할 때 위 코드가 없다면 서블릿에서 한글 데이터는 깨질 것입니다.
주의할 점은 setCharacterEncoding 메소드가 실행되기 전에 파라미터를 받는 코드가 선행된다면 setCharacterEncoding 메소드는 효력을 내지 못한다는 것입니다.

HttpServletResponse 객체의 setContentType(type:String)

HttpServletResponse 의 setContentType(type:String) 메소드는 서블릿이 만드는 HTML 문서의 타입과 문자셋을 지정하는 것입니다.
HttpServletRequest 의 setCharacterEncoding(env:String) 와 구별하여서 기억해야 합니다.

3. RequestDispatcher 사용 예제

javax.servlet.RequestDispathcer 클래스는 클라이언트의 요청을 서버상의 다른 자원(서블릿,JSP)으로 보내는 작업을 할 때 사용됩니다.
RequestDispathcer 는 include() 와 forward() 2개의 메소드가 있습니다.
include() 메소드는 요청을 다른 자원으로 보냈다가 다른 자원에서 실행이 끝나면 다시 요청을 가져오는 메소드입니다. 결론적으로 말하면 요청을 전달한 자원의 결과를 포함해서 클라이언트에게 보여주게 됩니다.
forward() 메소드는 이름 그대로 클라이언트의 요청을 서버상의 다른 자원에게 넘기는 메소드입니다.

/WEB-INF/src/example/ControllerServlet.java

package example;

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

public class ControllerServlet extends HttpServlet {

  public void doPost( HttpServletRequest req, HttpServletResponse res ) 
    throws IOException, ServletException {
    
    String url = req.getServletPath();
    int end = url.indexOf(".do");
    url = url.substring(1, end);
    
    if ( url.equals( "list" ) ) {
      url = "/example/list.jsp";
    }
    
    ServletContext sc = getServletContext();
    RequestDispatcher rd= sc.getRequestDispatcher( url );
    rd.forward( req, res );
    
  }

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

/example/list.jsp

<%@ page language="java" contentType="text/html; charset=EUC-KR"
  pageEncoding="EUC-KR"%>
<!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=EUC-KR">
<title>Insert title here</title>
</head>
<body>
  게시판 목록을 보이는 페이지...
</body>
</html>

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

/WEB-INF/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>*.do</url-pattern>
</servlet-mapping>

다음으로 아파치 설정 파일 httpd.conf 을 열고 아래를 추가합니다.
JkMount /*.do tomcat1
ControllerServlet 코드에서 "/example/list.jsp" 에 대한 RequestDispatcher 를 얻은 다음 forward() 메소드를 이용해서 사용자의 요청을 전달하고 있습니다.
아파치, Tomcat 을 재가동하고 http://localhost/list.do 로 방문하여 /example/list.jsp 이동하는지 확인합니다.

4. 서블릿 JDBC 연동예제

- (1) 오라클 JDBC 연동 테스트 파일 GetEmp.java 를 서블릿으로 변환

/WEB-INF/src/example/GetEmpServlet.java

package example;

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

public class GetEmpServlet extends HttpServlet {
  
  private String DB_URL;
  private String DB_USER;
  private String DB_PASSWORD;

  public void init() throws ServletException {
    //설치과정에서 자신이 정한 정보에 맞게 바꾼다.
    DB_URL = "jdbc:oracle:thin:@127.0.0.1:1521:orcl";
    DB_USER = "scott";
    DB_PASSWORD = "tiger";

    try {
      //드라이버를 로딩합니다.
      Class.forName( "oracle.jdbc.driver.OracleDriver" );
    } catch ( ClassNotFoundException e ) {
      e.printStackTrace();
    }
  }
  
  public void doGet( HttpServletRequest req, HttpServletResponse res ) 
    throws IOException, ServletException {
    res.setContentType( "text/html;charset=euc-kr" );
    PrintWriter out = res.getWriter();
    Connection conn = null;
    Statement stmt = null;
    ResultSet rs = null;
    String query = "select * from emp";
    try {
      
      //데이터베이스의 연결을 설정합니다.
      conn = DriverManager.getConnection( DB_URL, DB_USER, DB_PASSWORD );
      
      //Statement를 가져온다.
      stmt = conn.createStatement();
      
      //SQL문을 실행합니다.
      rs = stmt.executeQuery( query);
      
      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 {
      try {
        if ( rs != null ) rs.close();
        if ( stmt != null) stmt.close();
        if ( conn != null) conn.close();
      } catch ( SQLException e ) {}
    }
  }
}

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 에 GetEmpServlet 바이트코드 존재여부
  • /WEB-INF/lib 에 classes12.jar
  • 웹 애플리케이션이 성공적으로 로드되었는지 확인
  • 톰캣 로깅 메시지

5. ServletConfig 의 getInitParameter() 사용 예제

ServletConfig 의 getInitParameter() 메소드는 해당 서블릿에서만 사용할 수 있는 초기화 파라미터를 web.xml 으로부터 가져올 때 사용하는 메소드입니다.
이전에 사용했던 ConnectionPool 관련 소스는 JDBC 설정내용을 자바의 Properties 파일(oracle.properties, mysql.properties)을 이용했습니다.
예제에서는 이 JDBC 설정 파일을 자바 프로퍼티 파일에서 XML 파일로 변경하는 예제입니다.
해당 서블릿의 init 메소드내에 ServletConfig 의 getInitParameter() 메소드를 이용해서 JDBC 설정 XML 파일에 대한 실제 시스템상의 경로를 얻은 XML 파일의 내용을 읽어 ConnectionPool 관련 객체를 생성한 다음 그 객체를 ServletContext 에 저장합니다.
다음은 위에서 예제로 사용했던 ControllerServlet.java 에 아래와 같이 init 메소드를 추가합니다.
그리고 다음과 같은 import 문장을 추가해야 합니다.

  • import net.java_school.db.dbpool.*;
  • import javax.xml.xpath.*;
  • import org.xml.sax.*;

/WEB-INF/classes/ControllerServlet.java

public void init() throws ServletException {
  
  ServletContext cxt = getServletConfig().getServletContext();
  
  String pool = getInitParameter( "pool" );

  String dbServer = null;
  String port = null;
  String dbName = null;
  String userID = null;
  String passwd = null;
  int maxConn = 0;
  int initConn = 0;
  int maxWait = 0;

  if ( pool != null ) {
    try {
      XPathFactory xpathFactory = XPathFactory.newInstance();
      XPath xpath = xpathFactory.newXPath();

      pool = cxt.getRealPath( pool );

      InputSource xmlSource = new InputSource(pool);

      dbServer = xpath.evaluate("/DBproperties/dbServer",xmlSource);
      port = xpath.evaluate("/DBproperties/port",xmlSource);
      dbName = xpath.evaluate("/DBproperties/dbName",xmlSource);
      userID = xpath.evaluate("/DBproperties/userID",xmlSource);
      passwd = xpath.evaluate("/DBproperties/passwd",xmlSource);
      maxConn = Integer.parseInt(xpath.evaluate("/DBproperties/maxConn",xmlSource));
      initConn = Integer.parseInt(xpath.evaluate("/DBproperties/initConn",xmlSource));
      maxWait = Integer.parseInt(xpath.evaluate("/DBproperties/maxWait",xmlSource));
    } catch ( Exception e ) {}
  }
  ConnectionManager dbmgr = new OracleConnectionManager( dbServer, dbName, port, userID, 
  passwd, maxConn, initConn, maxWait );
  
  // OracleConnectionManager 객체를 ServletContext 에 dbmgr 이란 이름으로 저장
  cxt.setAttribute("dbmgr",dbmgr);
}

web.xml 열고 아래를 추가합니다.

/WEB-INF/web.xml

<servlet>			
  <servlet-name>Controller</servlet-name>
  <servlet-class>example.ControllerServlet</servlet-class>

  <init-param>
    <param-name>pool</param-name>
    <param-value>/WEB-INF/oracle.xml</param-value>
  </init-param>

  <load-on-startup>1</load-on-startup>

</servlet>

oracle.xml 파일을 /WEB-INF 에 자신의 설정에 맞게 아래를 참고해서 만듭니다.

/WEB-INF/oracle.xml

<?xml version="1.0"?>
<DBproperties>
  <dbServer>10.10.10.10</dbServer>
  <port>1521</port>
  <dbName>orcl</dbName>
  <userID>scott</userID>
  <passwd>tiger</passwd>
  <maxConn>20</maxConn>
  <initConn>5</initConn>
  <maxWait>5</maxWait>
</DBproperties>

메인메뉴 JDBC 에서 실습한 ConnectionPool 관련 소스 중 ConnectionManager.java 와 OracleConnectionManager.java 를 각각 다음과 같이 고칩니다.

ConnectionManager.java

package net.java_school.db.dbpool;

import java.sql.*;

public abstract class ConnectionManager {

  protected DBConnectionPoolManager connMgr = null;
  protected String poolName, dbServer, dbName, port, userID, passwd;
  int maxConn,initConn, maxWait;

  public ConnectionManager() {}
  
  public ConnectionManager( String pool, String dbServer, String dbName, String port, 
    String userID, String passwd, int maxConn, int initConn, int maxWait ) {
    poolName = pool;
    this.dbServer = dbServer;
    this.dbName = dbName;
    this.port = port;
    this.userID = userID;
    this.passwd = passwd;
    this.maxConn = maxConn;
    this.initConn = initConn;
    this.maxConn = maxConn;
  }

  public Connection getConnection() {
    return ( connMgr.getConnection( poolName ) );
  }

  public void freeConnection( Connection conn ) {
    connMgr.freeConnection( poolName, conn );
  }

  public int getDriverNumber() {
    return connMgr.getDriverNumber();
  }
}

OracleConnectionManager.java

package net.java_school.db.dbpool;

public class OracleConnectionManager extends ConnectionManager {
  
  public OracleConnectionManager() {}

  public OracleConnectionManager( String dbServer, String dbName, String port, 
    String userID, String passwd, int maxConn, int initConn, int maxWait ) {
    
    super( "oracle", dbServer, dbName, port, userID, passwd, 
	maxConn, initConn, maxWait );
    
    String JDBCDriver = "oracle.jdbc.driver.OracleDriver";

    // 오라클용 JDBC thin driver
    String JDBCDriverType = "jdbc:oracle:thin";

    String url = JDBCDriverType + ":@" + dbServer + ":" + port + ":" + dbName;

    connMgr = DBConnectionPoolManager.getInstance();
    connMgr.init( poolName, JDBCDriver, url, userID, passwd, 
	maxConn, initConn, maxWait );
  }
}

위에서 간단하게 테스트했던 /exmaple/list.jsp 파일을 아래와 같이 수정합니다.

/example/list.jsp

<%@ page contentType="text/html;charset=euc-kr" %>
<%@ page import="java.sql.*, net.java_school.db.dbpool.*" %>
<jsp:useBean id="dbmgr" class="net.java_school.db.dbpool.OracleConnectionManager"
scope="application" />
<%
  Connection conn = null;
  Statement stmt = null;
  ResultSet rs = null;
  String query = "select * from emp";
  try {

    //데이터베이스의 연결을 설정합니다.커넥션풀 이용
    conn = dbmgr.getConnection();

    //Statement를 가져온다.
    stmt = conn.createStatement();

    //SQL문을 실행합니다.
    rs = stmt.executeQuery( query );

    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 ) {
    out.println( "SQLException: " + e.getMessage() );
  } finally {
    try {
      if ( rs != null ) rs.close();
      if ( stmt != null) stmt.close();
      dbmgr.freeConnection( conn );
    } catch ( SQLException e ){}
  }
%>

Tomcat, 아파치를 재시작하고 http://localhost/list.do 로 방문해서 테스트합니다.

6. 파일 업로드을 위한 MultipartRequest 팩키지

MultipartRequest 팩키지는 파일 업로드에 널리 이용되고 있는 팩키지입니다.
http://www.servlets.com/cos/index.html 에서 가장 최신 버전인 cos-05Nov2002.zip 를 다운로드 하여 압축을 풉니다.
lib 디렉토리에 있는 cos.jar 파일을 /WEB-INF/lib 디렉토리에 복사합니다.
MultipartRequest 클래스의 생성자는 아래 링크에서 확인할 수 있듯이 8가지나 됩니다.
http://www.servlets.com/cos/javadoc/com/oreilly/servlet/MultipartRequest.html
그 중 아래의 생성자는 한글 인코딩 문제를 해결할 수 있고, 또한 업로드되는 파일이 기존의 파일명과 중복될 때 파일명을 변경해서 업로드할 수 있습니다.
MultipartRequest ( HttpServletRequest req, String dir, int max, String encoding, FileRenamePolicy policy )

MultipartRequest 메소드

<input type="file" name="photo"/> 태그를 이용해서 logo.gif 를 업로드했다고 가정하에 설명합니다.

메소드 설명
getContentType( "photo" ); 업로드된 파일의 MIME 타입 리턴, 리턴값 "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 를 이용한 파일 업로드 예제

/example/upload.html

<!--
파일명: upload.html
-->

<html>
<head>
    <meta http-equiv="content-type" content="text/html; charset=euc-kr">
</head>
<body>
<h2>MultipartRequest 를 이용한 파일 업로드 테스트</h2><
<form action="../servlet/UploadTest" method="post" enctype="multipart/form-data">
    이름 : <input type="text" name="name"/><br>
    파일1 : <input type="file" name="file1"/><br>
    파일2 : <input type="file" name="file2"/><br>
    <input type="submit" value="전송"/>
</form>
</body></html>

/WEB-INF/classes/UploadTest.java

package example;

import java.io.*;
import java.util.*;
import javax.servlet.*;
import javax.servlet.http.*;
import com.oreilly.servlet.MultipartRequest;
import com.oreilly.servlet.multipart.DefaultFileRenamePolicy;

public class UploadTest extends HttpServlet {
  public void doPost( HttpServletRequest req, HttpServletResponse res ) 
  throws IOException, ServletException {
    
    res.setContentType( "text/html;charset=euc-kr" );
    PrintWriter out = res.getWriter();
    //req.setCharacterEncoding( "euc-kr" );
    ServletContext cxt = getServletContext();
    String dir = cxt.getRealPath( "upload" );

    try {
      MultipartRequest multi = new MultipartRequest( req, dir, 
        5*1024*1024, "euc-kr", 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>" );
  }
}

테스트를 위해서는

  1. 웹 애플리케이션의 루트에 upload 라는 폴더를 만듭니다
  2. 컴파일을 위해 cos.jar 파일을 CLASSPATH 에 추가하고 컴파일합니다
  3. cos.jar 파일을 /WEB-INF/lib 에 복사합니다.
  4. /WEB-INF/web.xml 파일을 열어 UploadTest 서블릿을 등록합니다.(아래참조)
  5. 톰캣을 재가동하고 http://localhost/example/upload.html 를 방문하여 테스트 합니다.
  6. 중복된 파일을 업로드 테스트하고 upload 폴더에 파일명을 확인합니다.

/WEB-INF/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>

7. 쿠키

HTTP 전송방식의 특징상 각각의 웹 브라우저가 서버와 통신에서 세션을 유지하지 못하는 것을 보완하기 위한 기술입니다.
서버가 쿠키를 전송하면 웹 브라우저는 그 다음 요청마다 쿠키 값을 서버로 전달하여 사용자 정보를 유지할 수 있게 합니다.
서버 -> 웹 브라우저 (쿠키를 굽는다고 표현되는데 아래와 같은 정보가 클라이언트의 웹 브라우저를 통해서 파일로 저장됩니다.)
이때 전달되는 정보 형태는 아래와 같습니다.

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

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

Cookie ; name = value1 ; name2 = value2 ;

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

(1) 쿠키 설정 절차

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) 웹브라우저에 생성된 쿠키를 전송 : res.addCookie(cookie);

(2) 구워진 쿠키 이용

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

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();
    }
  }
}

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

Cookie cookie = new Cookie("id","");
cookie.setMaxAge(0);
res.addCookie(cookie);
(3) 쿠키 실습

다음은 간단한 쿠키예제입니다.
실습 후 cookieList.jsp 파일을 cookie 폴더 외에 다른 폴더에 복사하고 테스트해 보세요.

/cookie/setCookie.jsp

<%@ page contentType="text/html; charset=euc-kr" %>
<%
  String cookieName = "id";
  String cookieValue = "xman";

  Cookie cookie = new Cookie(cookieName,cookieValue);
  String path = request.getContextPath();
  path = path + "/cookie";
  cookie.setPath( path );
  response.addCookie(cookie);
%>
<a href="cookieList.jsp">쿠키 목록보기</a>

/cookie/cookieList.jsp

<%@ page contentType="text/html; charset=euc-kr" %>
<html><body>
저장되어 있는 쿠키 목록입니다.<br />
<%
  Cookie[] cookies = request.getCookies();
  if ( cookies != null ) {
    for ( int i=0 ;i < cookies.length; i++ ) {
      out.println(cookies[i].getName());
      out.println("<br />");
      out.println(cookies[i].getValue());
      out.println("<br />");
    }
  }
%>
<a href="removeCookie.jsp">쿠키 제거하기</a> <a href="setCookie.jsp">쿠키 굽기</a>
</body></html>

/cookie/removeCookie.jsp

<%@ page contentType="text/html; charset=euc-kr" %>
<%
  Cookie cookie = new Cookie( "id", "" );
  String path = request.getContextPath();
  path = path + "/cookie";
  cookie.setPath( path );
  cookie.setMaxAge( 0 );
  response.addCookie( cookie );
%>
<a href="cookieList.jsp">쿠키 목록보기</a>

8. 세션

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

아래는 세션 생성하는 코드입니다.
HttpSession session = req.getSession( true ); //세션이 없으면 생성합니다.
HttpSession session = req.getSession( false ); // 세션이 없다면 null 을 리턴
세션 객체가 생성되었으면 세션에 정보를 아래코드처럼 저장할 수 있습니다.
session.setAttribue( "data", value ); //data 이름으로 value 객체 저장

9. File 클래스

자바에서는 파일을 표현하기 위해 File 클래스를 사용합니다.
디렉토리도 File 클래스로 표현됩니다.
주의할 것은 File 클래스는 파일을 읽거나 쓰는 메소드는 가지고 있지 않습니다.
파일을 읽거나 쓰기 위해서는 입출력 클래스를 사용해야 합니다.
File 클래스로 할 수 있는 작업은 아래와 같습니다.

  1. 디렉토리 내용을 알아본다.
  2. 파일의 속성을 알아보거나 설정합니다.
  3. 파일의 이름을 변경하거나 삭제합니다.

File 객체를 생성하는 코드는 아래와 같습니다.
File dir = new File( path );
여기서 path 에 해당하는 파일이나 디렉토리는 시스템의 풀패스가 되어야 한다는 것입니다.
다음은 File 클래스의 중요 메소드입니다.

File
isDirectory() : boolean
dir.isDirectory(); // dir 이 디렉토리이면 true 리턴
isFile() : boolean
dir.isFile(); // dir 이 파일이면 true 리턴
list() : String[]
dir.list() : // dir 이 디렉토리일 때 디렉토리에 있는 파일명이 String[] 값으로 리턴
listFiles() : File[]
dir.listFiles(); // 디렉토리에 있는 파일의 파일 객체 배열 리턴
mkdir() : boolean
dir.mkdir(); // File 객체의 이름을 가진 디렉토리를 만든다
getName() : String
파일명을 리턴
getPath() : String
경로를 리턴
delete() : boolean
파일을 지운다.
exists() : boolean
파일이나 경로가 존재하는지 여부

이것으로 아주 간단하게 서블릿 문법을 살펴보았습니다.
서블릿에 대한 이해가 있어야 JSP 할때에 이해가 쉽습니다.
다음은 JSP 문법으로 넘어갑니다.