반응형

1. HelloServlet

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

/WEB-INF/classes/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 컴파일

WEB-INF/classes 에 위 파일을 편집하여 복사하고 컴파일합니다.
(CLASSPATH에 {TOMCAT_HOME}/common/lib/servlet-api.jar 파일을 추가했다면)
javac -d . HelloServlet.java
(CLASSPATH에 servlet-api.jar 파일을 추가하지 않은 경우)
javac -d . -classpath D:\apps\Tomcat\common\lib\servlet-api.jar HelloServlet.java

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

톰캣을 재시작하고
http://localhost:8998/servlet/HelloServlet 을 방문하여 실행이 되는지 확인합니다.

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

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

"안녕! 2008년" 을 출력하는 기본적인 예제를 실행해 봤습니다.
이제는 웹브라우저, 즉 클라이언트가 보내는 정보를 어떻게 서블릿에서 다룰 수 있는지 알아봅니다.
정확하게 클라이언트가 보내는 문자열 정보를 서블릿에서 catch하는 코드를 설명합니다.

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

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

HTML 서블릿
<input type="text" name="addr"/> req.getParameter( "addr" );
<input type="radio" name="os" value="win98"/>
<input type="radio" name="os" value="win2000"/>
req.getParameter( "os" );
<input type="hidden" name="cur_page" value="1"/> req.getParameter( "cur_page" );
<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()

HttpServletRequest 의 getParameter() 메소드는 웹브라우저에서 사용자가 보내는 데이터를 서블릿에서 받기 위해 사용하는 가장 보편적인 메소드입니다. 라디오 버튼은 name 속성이 같게 두면 같은 name 속성의 라디오 버튼들은 그룹이 됩니다.
그룹화되어 있는 라디오 버튼은 사용자가 한개 항목만을 선택할 수 있습니다.
따라서 HttpServletRequest 의 getParameter() 메소드로 클라이언트가 보낸 데이터를 받습니다.
이 밖에 FORM 태그의 <input type="password" ../> 이나 <input type="hidden" ../> 도 역시 마찬가지로 HttpServletRequest 의 getParameter() 메소드를 이용해서 사용자가 전달한 파라미터 값을 받습니다.
클라이언트, 즉 웹 브라우저에서 서버로는 문자열만을 전송할 수 있습니다.
(물론 서버 사이드에서는 서버자원에서 서버자원으로 문자열 뿐만이 아닌 다른 객체를 만들어 전달 할 수 있습니다.)

HttpServletRequest.getParameterValues()

웹브라우저를 통해 사용자가 다중 선택을 하여 전송하는 데이터의 경우는 HttpServletRequet 의 getParamter() 메소드가 아닌 getParamterValues() 메소드가 쓰입니다.
이 메소드의 리턴값은 사용자가 선택한 값들만으로 구성된 String 배열입니다.

HttpServletRequest.getParamterNames()

만약 사용자가 어떤 파라미터명으로 데이터를 보내는지 알수 없다고 가정을 합니다.(그럴 경우는 거의 없지만) 이때 사용자가 보내는 파라미터명을 알 수 있는 메소드가 HttpServletRequest 의 getParamterNames()입니다.
getParameterNames() 메소드는 리턴값으로 Enumeration 타입을 반환합니다.
(Enumeration 의 hasMoreElements() , nextElement() 2개의 메소드가 기억나지 않는다면 Java Basic 에서 지금 바로 확인하세요.)

실습 1 - 2008년 투자 포트폴리오 설문조사

이 예제는 사이트의 회원으로부터 2008년의 투자 포트폴리오를 설문조사하는 예제입니다.
portfolio2008.html 은 사용자로부터 입력을 받는 페이지입니다.
Portfolio2008Servlet.java 는 portfolio2008.html에서 사용자가 입력한 정보를 데이터베이스에 인서트하는 JDBC 코드를 포함합니다.
portfolio2008.sql 은 관련 테이블 쿼리문입니다.

/example/portfolio2008.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitonal.dtd">	
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=EUC-KR" />
<title>2008년 투자 포트폴리오</title>
</head>
<body>
  <form action="../servlet/Portfolio2008Servlet" method="post">
   기관 : <input type="text" name="company"/><br />
   제안자 : <input type="text" name="name"/><br />
   제안일 : <input type="text" name="signdate"/><br />
   투자액 : <input type="text" name="money"/><br />
   투자성격 : <input type="radio" name="type" value="aggressive" />공격적
   <input type="radio" name="type" value="passive"/>위험회피<br />
   투자형태 :<br />
   <select name="investments" multiple="multiple">
   <option value="koreafund">국내펀드</option>
   <option value="overseasfund">해외펀드</option>
   <option value="direct">직접투자</option>
   <option value="bank">CMA 또는 은행</option>
   </select><br />
   국내펀드 1 <input type="text" name="koreafund1_nm"/>
   투자액 <input type="text" name="koreafund1_money"/>원<br />
   국내펀드 2 <input type="text" name="koreafund2_nm"/>
   투자액 <input type="text" name="koreafund2_money"/>원<br />
   국내펀드 3 <input type="text" name="koreafund3_nm"/>
   투자액 <input type="text" name="koreafund3_money"/>원<br /><br />
   해외펀드 1 <input type="text" name="overseasfund1_nm"/>
   투자액 <input type="text" name="overseasfund1_money"/>원<br />
   해외펀드 2 <input type="text" name="overseasfund2_nm"/>
   투자액 <input type="text" name="overseasfund2_money"/>원<br />
   해외펀드 3 <input type="text" name="overseasfund3_nm"/>
   투자액 <input type="text" name="overseasfund3_money"/>원<br /><br />
   직접투자 <input type="text" name="directp"/>원<br />
   CMA 또는 은행 <input type="text" name="bankp"/>원<br />
   <input type="submit" value="전송"/>
  </form>
</body>
</html>

/WEB-INF/classes/Portfolio2008Servlet.java

package example;

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

public class Portfolio2008Servlet 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" );

    String company = req.getParameter("company");
    String name = req.getParameter("name");
    String signdate = req.getParameter("signdate");
    String money = req.getParameter("money");
    String type = req.getParameter("type");
    String[] investments = req.getParameterValues("investments");

    String koreafund1_nm = req.getParameter("koreafund1_nm");
    String koreafund2_nm = req.getParameter("koreafund2_nm");
    String koreafund3_nm = req.getParameter("koreafund3_nm");

    String koreafund1_money = req.getParameter("koreafund1_money");
    String koreafund2_money = req.getParameter("koreafund2_money");
    String koreafund3_money = req.getParameter("koreafund3_money");

    String overseasfund1_nm = req.getParameter("overseasfund1_nm");
    String overseasfund2_nm = req.getParameter("overseasfund2_nm");
    String overseasfund3_nm = req.getParameter("overseasfund3_nm");

    String overseasfund1_money = req.getParameter("overseasfund1_money");
    String overseasfund2_money = req.getParameter("overseasfund2_money");
    String overseasfund3_money = req.getParameter("overseasfund3_money");

    String directp = req.getParameter("directp");
    String bankp = req.getParameter("bankp");

    out.println( "<html><body>" );
    out.println( "<h1>portfolio.html 에서 보내온 데이터는 다음과 같습니다.</h1>" );
    out.println( "<ul>" );
    out.println( "<li>기관 : " + company + "</li>");
    out.println( "<li>제안자 : " + name + "</li>");
    out.println( "<li>제안일 : " + signdate + "</li>");
    out.println( "<li>투자액 : " + money + "만원 </li>");
    out.println( "<li>투자성격 : " + type + "</li>");
    out.println( "</ul>" );
    out.println("<h3>투자형태</h3>");
    out.println( "<ul>" );
    if( investments != null ) {
      for( int i=0; i < investments.length; i++ ) {
        out.print( "<li>" );
        out.print( investments[i] );
        out.print( "</li>" );	
      }
    }
    out.println( "</ul>" );
    out.println("<h3>국내펀드</h3>");
    out.println( "<ul>" );
    out.println( "<li>" + koreafund1_nm + ": " + koreafund1_money + "만원 </li>");
    out.println( "<li>" + koreafund2_nm + ": " + koreafund2_money + "만원 </li>");
    out.println( "<li>" + koreafund3_nm + ": " + koreafund3_money + "만원 </li>");
    out.println( "</ul>" );

    out.println("<h3>해외펀드</h3>");
    out.println( "<ul>" );
    out.println( "<li>" + overseasfund1_nm + ": " + overseasfund1_money + "만원 </li>");
    out.println( "<li>" + overseasfund2_nm + ": " + overseasfund2_money + "만원 </li>");
    out.println( "<li>" + overseasfund3_nm + ": " + overseasfund3_money + "만원 </li>");
    out.println( "</ul>" );

    out.println("<h3>직접투자</h3>");
    out.println( "<ul>" );
    out.println( "<li>" + directp + "만원</li>");
    out.println( "</ul>" );

    out.println("<h3>CMA 또는 은행</h3>");
    out.println( "<ul>" );
    out.println( "<li>" + bankp + "만원 </li>");
    out.println( "</ul>" );

    String path = req.getContextPath();
    out.println( "<a href=" + path + "/example/portfolio2008.html>뒤로</a>" );
    out.println( "</body></html>" );
  }
}

HttpServletRequest.getContextPath()

HTML문서와 서블릿간의 상대경로에 주의를 기울려야 합니다.
서블릿 코드에서 HTML문서나 JSP문서에 링크를 걸때는 req.getContextPath() 메소드 로 일단 Context base 경로를 구한 후에 이를 이용해 경로를 링크시키면 됩니다.

HttpServletRequest.setCharacterEncoding()

HttpServletRequest 의 setCharacterEncoding("euc-kr")은 웹브라우저, 즉 클라이언트가 보내는 한글 데이터를 한글 인코딩으로 받기 위한 것입니다.
이 부분이 없다면 클라이언트가 보낸 한글 데이터는 깨져 보일 겁니다.

HttpServletResponse.setContentType()

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

portfolio2008.sql

create table portfolio (
  portfolio_no   int(11) not null,
  company   varchar(30)	not null,
  name   varchar(10) 	not null,
  signdate   varchar(16)	not null,
  money   int(11) default '0' not null,
  type   varchar(12)	not null,
  koreafund   enum('Y','N') not null default 'Y',
  overseasfund   enum('Y','N') not null default 'Y',
  direct   enum('Y','N') not null default 'Y',
  bank   enum('Y','N') not null default 'Y',
  directp   int(11) default '0' not null,
  bankp   int(11) default '0' not null,
  primary key (portfolio_no),
  index portfolio_no_idx  (portfolio_no)
);

create table koreafundp (
  koerafundp_no   int(11)	not null,
  portfolio_no   int(11)	not null,
  koreafund_nm   varchar(40) not null,
  koreafund_money   int(11) default '0' not null,
  primary key (koerafundp_no)
);

create table overseasfundp (
  overseasfundp_no   int(11)	not null,
  portfolio_no   int(11)	not null,
  overseasfund_nm   varchar(40) not null,
  overseasfund_money   int(11) default '0' not null,
  primary key (overseasfundp_no)
);

위 예제를 실행하려면, portfolio2008.html 의 form action 속성이 ../servlet/Portfolio2008Servlet 로 되어 있으므로 이에 맞게 web.xml 파일을 열어서 web-app 엘리멘트 안에 아래를 추가합니다.

/WEB-INF/web.xml

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

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

Portfolio2008Servlet.java 를 컴파일하여 Portfolio2008Servlet.class 파일이 /WEB-INF/classes/example 디렉토리에 생기도록 하고 톰캣을 재시동한 후 http://localhost:8998/example/portfolio2008.html 를 방문하여 테스트합니다.

Portfolio2008Servlet.java 에서 JDBC 관련 소스를 입력해 보기 바랍니다.
다음은 간단한 서블릿을 이용한 회원가입 예제입니다.
이 예제를 먼저 실습해 보면 응용이 가능하리라 생각합니다.
sendTF.html에서 이름과 주소를 입력받고 GetTFData.java서블릿은 sendTF.html 에서 사용자가 전달한 값을 JDBC 를 이용해서 memtest 테이블에 인서트를 합니다.
실습에 필요한 테이블은
memtest.sql이고 이 예제는 오라클을 사용해야 합니다.

3. RequestDispatcher 사용 예제

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

/WEB-INF/classes/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.getParameter( "url" );
    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>

ControllerServlet 에서 "/example/list.jsp" 에 대한 RequestDispatcher 를 얻은 다음 forward() 메소드를 이용해서 사용자의 요청을 전달하고 있습니다.
ControllerServlet 을 등록하기 위해서 web.xml 파일을 열어 web-app 엘리멘트 안에 아래를 추가합니다.
추가한 다음 톰캣을 재가동하고 http://localhost:8998/bbs/ControllerServlet?url=list 를 방문하여 /example/list.jsp 파일이 보이는지 확인합니다.

/WEB-INF/web.xml

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

<servlet-mapping>
    <servlet-name>Controller</servlet-name>
    <url-pattern>/ControllerServlet</url-pattern>
</servlet-mapping>

4. ServletConfig 의 getInitParameter() 사용 예제

ServletConfig 의 getInitParameter() 메소드는 해당 서블릿에서만 사용할 수 있는 초기화 파라미터를 web.xml 으로부터 가져올 때 사용하는 메소드입니다.
다음은 예제에 대한 설명입니다.
이전에 사용했던 ConnectionPool 관련 소스는 JDBC 설정내용을 자바의 Properties 파일(oracle.properties, mysql.properties)을 이용했습니다.
예제에서는 이 JDBC 설정 파일을 XML 파일로 변경합니다.
XML 파일을 읽기 위해서 서블릿을 이용합니다.
해당 서블릿의 init 메소드내에 ServletConfig 의 getInitParameter() 메소드를 이용해서 JDBC 설정 XML 파일에 대한 실제 시스템상의 경로를 얻은 다음 SAX 파서를 사용해서 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 ){}
  }
%>

톰캣을 재시작하고 http://localhost:8998/bbs/ControllerServlet?url=list 로 방문해서 테스트합니다.

5. 파일 업로드을 위한 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:8998/bbs/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>

java.lang.NoClassDefFoundError: javax/activation/DataSource

컴파일이 문제가 없었고 톰캣을 재가동한 후에 URL로 방문하여 테스트 하니 위와 같은 에러가 나왔다면 JavaBeans(TM) Activation Framework 라는 팩키지가 필요합니다.
http://java.sun.com 에 방문해서 jaf라는 이름으로 검색해서 팩키지를 다운로드를 한 다음 /WEB-INF/lib/ 폴더에 복사합니다.

jaf 다운로드
a. http://java.sun.com 에 방문해서 오른쪽 메뉴의 Popular Downloads: See All를 선택합니다.

b. 다음 페이지에서 JAVA SE 셀렉트박스에서 JavaBeans Activation Framework(JAF) 를 선택하여 다운로드 합니다.

c. 압축을 풀고 activation.jar 를 /WEB-INF/lib/ 디렉토리에 저장합니다.

쿠키

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

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

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

Cookie ; name = value1 ; name2 = value2 ;

쿠키 이름과 값에는 []()="/?@:; 와 같은 문자는 올 수 없습니다.

(1) 쿠키 설정 절차

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

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

(2) 구워진 쿠키 이용

① 서블릿에서 쿠키 이용

Cookie[] cookie = req.getCookies();

HttpServletRequest의 getCookies() 메소드를 사용해서 쿠키배열을 얻습니다.
만약 구워진 쿠키가 없다면 getCookies() 메소드는 null을 리턴합니다.
이제 쿠키 객체를 접근할 수 있게 되었습니다.
다음 메소드를 이용하면 쿠키에 대한 정보를 얻을 수 있습니다.
이중 getName()과 getValue()가 주로 쓰입니다.

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

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>

세션

세션은 쿠키 기반 기술로 쿠키의 보안상 약점을 극복하기 위한 기술입니다.
쿠키와 다른 점(즉, 보안상 개선된 점) : 웹브라우저는 서버가 정해준 세션ID 만을 쿠키값으로 저장합니다.
세션이 생성되면(즉, 세션ID 쿠키가 구워지면) 세션ID 쿠키만을 서버로 전송하게 되고,
서버에서는 세션ID로 해당 HttpSession 객체를 서블릿/JSP 컨테이너가 연결시켜 줍니다.
HttpSession 의 메소드
setAttribute( String name , Object value )
getAttribute( String name )
removeAttribute( String name )
invalidate();
사용법
세션 생성 : HttpSession session = req.getSession( true ); //세션이 없으면 생성합니다.
HttpSession session = req.getSession( false ); // 세션이 없다면 null 을 리턴
세션에 정보 저장 : session.setAttribue( "data", value ); //data 이름으로 value 객체 저장

File 클래스

자바에서는 파일을 표현하기 위해 File 클래스를 사용합니다.
디렉토리도 File 클래스로 표현됩니다.
주의할 것은 File 클래스는 파일을 읽거나 쓰는 메소드는 가지고 있지 않습니다.
파일을 읽거나 쓰기 위해서는 입출력 클래스를 사용합니다.
File 클래스로 할 수 있는 작업
① 디렉토리 내용을 알아본다.
② 파일의 속성을 알아보거나 설정합니다.
③ 파일의 이름을 변경하거나 삭제합니다.
File 클래스 생성
객체 생성 : File dir = new File( path );
주의) 여기서 path 에 해당하는 파일이나 디렉토리는 시스템의 풀패스가 되어야 한다는 것입니다.
File 클래스 중요 메소드 소개와 사용법
isDirectory() : dir.isDirectory(); // dir 이 디렉토리이면 true 리턴
isFile() : dir.isFile(); // dir 이 파일이면 true 리턴
list() : dir.list() : // dir 이 디렉토리일 때 디렉토리에 있는 파일명이 String[] 값으로 리턴
listFiles() : dir.listFiles(); // 디렉토리에 있는 파일의 파일 객체 배열 리턴
mkdir() : dir.mkdir(); // File 객체의 이름을 가진 디렉토리를 만든다
getName() : 파일명을 리턴
getPath() : 경로를 리턴
delete() : 파일을 지운다.
exists() : 파일이 존재하는지 여부를 알려준다.

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

+ Recent posts