Tomcat 5 JNDI DataSource를 통한 DB 커넥션 풀 사용
|
JNDI를 이용한 커넥션 풀에 대해서 정리해봤습니다. 블로그에 쓴글이라 반말이예요... 양해를 ^^ 원문 : http://kr.blog.yahoo.com/kwon37xi/1236540.html Tomcat 5 JNDI DataSource를 통한 DB 커넥션 풀 사용 이미 눈치 채셨겠지만, 요즘 내가 RDBMS 배우기에 열을 올리고 있다. 지금까지는 JSP/Servlet에서 직접 커넥션을 맺거나, 웹 컨텍스트내에 커넥션 풀 라이브러리를 두고 호출에서 사용했는데, 좀 바꿔야겠다. JNDI를 통한 커넥션 풀 사용은 J2EE 표준이고, 현존하는 거의 모든 웹 컨테이너가 지원한다고 한다. JNDI를 서버에 설정하는 방법은 각 WAS 별로 다르지만, 사용하는 것은 모두 동일하므로 호환성에 문제도 없다. 이 글은 Jakarta의 DBCP 커넥션 풀과 Tomcat JNDI 설정을 통해 데이터베이스 커넥션 풀을 사용하는 방법이다. JNDI와 커넥션 풀에 관한 자세한 설명이 JavaServer Pages 3rd ed.에 실려있다. 이 책 너무 좋다. 꼭 읽어보라고 강력하게 권하고 싶다. * 참조 URL : http://jakarta.apache.org/tomcat/tomcat-5.0-doc/jndi-datasource-examples-howto.html 이 글은 사실상 저 참조 URL의 번역에 가깝다. * Tomcat Admin을 이용한 DataSource 설정 : http://www.okjsp.pe.kr/lecture/viewlet/okjsp2005/05_webdev_datasource.html 기본적으로 필요한 라이브러리 * commons-dbcp.jar * commons-collections.jar * commons-pool.jar 예제 JDBC 드라이버 * Oracle 9i classes12.jar JNDI Naming Resource 설정 1. 위 라이브러리들을 $CATALINA_HOME/common/lib 에 복사한다. 그 이외 디렉토리에 두면 안된다. ZIP 파일은 JAR로 확장자를 바꿔야 한다. 톰캣은 JAR파일만 클래스패스에 추가한다. 2. Connection 풀을 이용할 경우에는 ResultSet과 Connection 객체를 필히 직접 닫아 줘야만 한다. 3. $CATALINA_HOME/conf/server.xml 혹은 각 웹 컨텍스트별 XML 파일의 <Context>의 자식 요소로 다음을 추가한다. <Resource name="jdbc/forumDb" auth="Container" type="javax.sql.DataSource"/> <!-- Resource의 name 속성을 이용해서 각 어플리케이션에서 javax.sql.DataSource 객체를 얻어가게 된다. --> <!-- 자세한 파라미터 설정은 http://jakarta.apache.org/tomcat/tomcat-5.0-doc/jndi-datasource-examples-howto.html 참조 --> <ResourceParams name="jdbc/forumDb"> <parameter> <name>factory</name> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value> </parameter> <parameter> <name>maxActive</name> <value>100</value> </parameter> <parameter> <name>maxIdle</name> <value>30</value> </parameter> <parameter> <name>maxWait</name> <value>10000</value> </parameter> <!-- DB 사용자명과 비밀번호 설정 --> <parameter> <name>username</name> <value>dbuser</value> </parameter> <parameter> <name>password</name> <value>dbpasswd</value> </parameter> <!-- JDBC 드라이버 클래스 --> <parameter> <name>driverClassName</name> <value>oracle.jdbc.driver.OracleDriver</value> </parameter> <!-- JDBC 접속 URL --> <parameter> <name>url</name> <value>jdbc:oracle:thin:@dbhost:1521:ORA</value> </parameter> </ResourceParams> 4. 웹 어플리케이션의 web.xml파일에 다음을 추가하여 JNDI 리소스를 사용할 수 있도록 한다. <resource-ref> <description>Forum DB Connection</description> <!-- 다음이 바로 리소스의 이름 --> <res-ref-name>jdbc/forumDb</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> JSP/Servlet 에서 사용하기 이제 다음과 같이 JNDI를 이용해 DataSource 객체를 얻고, 그 객체에서 커넥션을 얻어오면 된다. 다음은 서블릿을 작성하고, 그 서블릿에서 DB커넥션을 얻고, 쿼리를 날린 뒤, 그 결과를 JSP 파일에 포워딩하여 JSTL을 이용해 출력하는 것이다. 1. 예제 테이블과 데이터 SQL - 오라클 계정으로 다음과 같은 데이터를 생성했다고 가정하면 create table test ( num NUMBER NOT NULL, name VARCHAR2(16) NOT NULL ); truncate table test; insert into test values(1,'영희'); insert into test values(2, '철수'); insert into test values(3, '미숙'); commit; 2. test.JndiDataSourceTestServlet 소스 package test; import java.io.IOException; import java.sql.Connection; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.naming.Context; import javax.naming.InitialContext; import javax.naming.NamingException; import javax.servlet.RequestDispatcher; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.sql.DataSource; public class JndiDataSourceTestServlet extends HttpServlet { protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Connection conn = null; ResultSet rs = null; Statement stmt = null; try { // 커넥션을 얻기 위한 전초작업. 이 부분을 메소드화 하면 되겠다. ------------ Context initContext = new InitialContext(); Context envContext = (Context)initContext.lookup("java:/comp/env"); DataSource ds = (DataSource)envContext.lookup("jdbc/forumDb"); // 커넥션 얻기 conn = ds.getConnection(); //------------------------------------------------------------------ String sql = "SELECT * from test"; stmt = conn.createStatement(); rs = stmt.executeQuery(sql); List results = new ArrayList(); while (rs.next()) { Map row = new HashMap(); row.put("num", rs.getString("num")); row.put("name", rs.getString("name")); results.add(row); } request.setAttribute("results", results); RequestDispatcher rd = request.getRequestDispatcher("/dbtest.jsp"); rd.forward(request, response); } catch (NamingException e) { throw new ServletException("JNDI 부분 오류", e); } catch (SQLException e) { throw new ServletException("SQL 부분 오류", e); } finally { // 리소스를 필히 반환할 것! if (rs != null) { try { rs.close(); } catch (Exception ignored) {} } if (stmt != null) { try { stmt.close(); } catch (Exception ignored) {} } if (conn != null) { try { conn.close(); } catch (Exception ignored) {} } } } } 3. web.xml에 서블릿 등록 <servlet> <servlet-name>dbtest.svl</servlet-name> <servlet-class>test.JndiDataSourceTestServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>dbtest.svl</servlet-name> <url-pattern>/dbtest.svl</url-pattern> </servlet-mapping> 4. /dbtest.jsp 소스 <%@ page contentType="text/html" pageEncoding="EUC-KR" %> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> <%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql" %> <!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> <html> <head> <title>JNDI DataSource Test</title> </head> <body bgcolor="#FFFFFF"> <h2>Results</h2> <c:forEach var="row" items="${results}"> NUM : ${row.num}<br /> Name : ${row.name}<br /> <hr /> </c:forEach> </body> </html> 5. 이제 웹 브라우저에서 "/dbtest.svl" 을 호출해보면 결과를 볼 수 있다. 전역적인 JNDI 리소스 이용 <Resource>와 <ResourceParams> 요소를 server.xml의 <GlobalNamingResources> 의 자식노드로 옮기면 특정 웹 어플리케이션이 아니라, 이 톰캣에 설치된 전체 웹 어플리케이션에서 사용 할 수 있게 된다. 하지만 각 웹 어플리케이션 "<Context>"에 다음과 같은 설정을 해야 한다. <ResourceLink name="jdbc/forumDb" global="jdbc/forumDb" type="javax.sql.DataSource" /> 아니면 server.xml에서 <Host> 요소의 자식으로 다음을 추가하면 각 컨텍스트별 설정 필요없이 전체 웹 어플리케이션 컨텍스트에서 GlobalNamingResources로 지정된 JNDI 리소스를 사용할 수 있다. <DefaultContext> <ResourceLink name="jdbc/forumDb" global="jdbc/forumDb" type="javax.sql.DataSource" /> </DefaultContext> 문제가 생겼어요! 1. DB 커넥션이 간혹 끊어져요. Tomcat이 작동중인 JVM이 가비지 컬렉션을 할 때, 그 시간이 JNDI Resource에 파라미터로 설정한 maxWait보다 길게 갈 경우 DB 커넥션이 끊어질 수 있다. CATALINA_OPTS=-verbose:gc 옵션을 주면 $CATALINA_HOME/logs/catalina.out에 가비지 컬렉션 상황이 기록된다. 거기에 GC 작업에 걸린 시간도 나오니 그것을 참조로 maxWait 파라미터를 늘려주면 된다. 보통 10~15초로 주면 된다. GC 시간은 거의 99% 이상 1초 이내에 끝나야 하나보다.. 2. 무작위로 커넥션이 close 되요. 그건.. Connection 객체를 두 번 이상 close 했기 때문이다. DB Connection Pool은 close()를 호출할 때 정말로 닫는 것이 아니라, 단지 재사용할 수 있다고 표시만 할 뿐이다. 커넥션을 사용하다가 close()하면 다른 쓰레드이서 이 커넥션을 쓸 수 있는데, 이걸 현재 쓰레드에서 계속 잡고 있다가 또 다시 close()를 해버리면, 다른 쓰레드에서 사용중에 close()됐다고 나와 버리게 되는 거다. conn.close(); conn = null; 위와 같이 커넥션을 close()한 뒤에 바로 null 로 설정하여 절대로 다시 사용할 수 없게 만들면 이런 실수는 생기지 않을 것이다. |
| 검색어(web.xml)제거 |
'IT 세상 > 자바세상' 카테고리의 다른 글
| DBCP 를 이용한 db프로그래밍 (0) | 2009.11.04 |
|---|---|
| jndi (0) | 2009.11.04 |
| Io exception: NL Exception was generated (ibatis 설정) (0) | 2009.10.29 |
| ibatis sqlMap 설정하기 (0) | 2009.10.27 |
| 자바 RMI (Remote Method Invovation) (0) | 2009.10.22 |