tomcat의 기본 Database
Connection Pool은 Apache Commons
DBCP($CATALINA_HOME/lib/tomcat-dbcp.jar)를 사용하고 있다.
따라서 DB와 연동을 위해서는
DBCP 설정이 필요하다.
tomcat7.0에서 사용된
DBCP와는 다르게 tomcat8.0은 DBCP2를
사용하고 있다.
DBCP2는 DB와 연동함에
있어서 사용되는 몇 가지 설정이 변경되었다.
|
tomcat7.0 |
tomcat8.0 |
|
maxActive |
maxTotal |
|
maxWait |
maxWaitMillis |
|
validationQuery 미 설정 시 체크하지 않음 |
validationQuery 미 설정 시 CUBRID connection 에러 발생 |
특히 validationQuery가 설정되어 있지 않은 상태에서 DB와 연동 시 접속에 실패하며 아래와 같은 에러 메시지가
$CATALINA_HOME/log/catalina.out 에 기록된다.
|
java.lang.UnsupportedOperationException
at
cubrid.jdbc.driver.CUBRIDConnection.isValid(CUBRIDConnection.java:1006)
at org.apache.tomcat.dbcp.dbcp2.DelegatingConnection.isValid(DelegatingConnection.java:917)
at
org.apache.tomcat.dbcp.dbcp2.PoolableConnection.validate(PoolableConnection.java:282)
at org.apache.tomcat.dbcp.dbcp2.PoolableConnectionFactory.validateConnection(PoolableConnectionFactory.java:357)
at
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.validateConnectionFactory(BasicDataSource.java:2307)
at
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.createPoolableConnectionFactory(BasicDataSource.java:2290)
at
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:2038)
at
org.apache.tomcat.dbcp.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:1532)
at org.apache.jsp.cubrid_jsp._jspService(cubrid_jsp.java:153)
…
at java.lang.Thread.run(Thread.java:744) |
이는 DBCP를 통해 최초
connection 시 해당 connection이 유효한지 체크하는 isValid를 호출하게 되는데, CUBRID JDBC Driver에서는
해당 함수를 지원하지 않아 exception 처리하고 있기 때문에 오류가 발생한다. ( testOnBorrow=false 로 설정되어 있어도 오류 발생함 )
이를 해결하기 위해 가장 간단한 쿼리(ex: select 1 ) 를 validationQuery로 설정해줘야 한다.
참고로 Tomcat7.0까지는 validationQuery
가 설정되어 있지 않으면 유효성 체크가 생략되어 오류가 발생하지 않았다.
validationQuery 사용하여 수행하는 connection 검증은 불필요한 쿼리 호출을 수행함으로 성능을 감소시킨다.
CUBRID는 connection 검증을 위한 설정이 필요 없다. Connection이
유효하지 않을 경우 CUBRID JDBC Driver가 재접속을 수행하기 때문이다.
따라서 connection 검증을 위한 validationQuery 사용이 필수가 된 tomcat8.0 에서는
아래와 같은 추가적인 설정이 필요하다.
|
설정 |
기본값 |
설명 |
|
testOnBorrow=false |
true. |
커넥션 풀에서 커넥션을 하나 꺼내 올 때 validationQuery에
설정된 SQL을 수행, 검증에 성공한 커넥션 객체만 얻어
옴 |
|
testOnReturn=false |
false |
사용한 커넥션을 풀로 반환할 때 validationQuery에
설정된 SQL을 수행, 검증에 성공한 커넥션 객체만 풀에
들어감 |
|
testWhileIdle=false |
false |
유휴 상태에 있는 커넥션 객체를 정리하는 스레드가 동작할 때 유휴 상태에 있는 커넥션의 검증 여부 |
추가적으로 statement pooling 기능을 사용하여 쿼리 파싱의
부하를 줄이도록 poolPreparedStatements=true 설정한다.
위 설명을 토대로 한 tomcat 연동 예제
-
CUBRID JDBC
Driver($CUBRID/jdbc/cubrid_jdbc.jar)를 $CATALINA_HOME/lib
에 복사
-
$CATALINA_HOME/conf/context.xml
에 JNDI DataSource 설정
|
<Resource name="jdbc/CUBRIDDS"
auth="Container" type="javax.sql.DataSource"
driverClassName="cubrid.jdbc.driver.CUBRIDDriver"
url="jdbc:cubrid:localhost:33000:demodb:::" username="public"
password=""
maxTotal="10" maxIdle="10"
maxWaitMillis="-1"
validationQuery="select 1" testOnBorrow="false" poolPreparedStatements=”true” /> |
-
$CATALINA_HOME/conf/web.xml 설정
|
<resource-ref>
<description>CUBRID</description>
<res-ref-name>jdbc/CUBRIDDS</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth> </resource-ref> |
-
아래 예제를 cubrid.jsp 로 $CATALINA_HOME/webapp/ROOT에 생성
|
<%@ page contentType="text/html;
charset=euc-kr"%> <%@ page
import="java.util.*" %> <%@ page import="java.sql.*"
%> <%@ page
import="javax.sql.*" %> <%@ page
import="javax.naming.*" %> <%
Connection conn = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
try {
Context initContext = new InitialContext();
DataSource ds = (DataSource)
initContext.lookup("java:comp/env/jdbc/CUBRIDDS"); conn = ds.getConnection(); String sql = "select name
from nation";
pstmt =
conn.prepareStatement(sql); rs = pstmt.executeQuery(); while(rs.next()) { out.println("name
==> " + rs.getString(1)); out.println("<br>"); }
} catch ( SQLException e ) { e.printStackTrace();
} catch ( Exception e ) { e.printStackTrace();
} finally {
try{ if ( rs != null ) rs.close(); }catch( Exception e ) {}
try{ if ( pstmt != null )
pstmt.close(); }catch( Exception e ) {}
try{ if ( conn != null )
conn.close(); }catch( Exception e ) {}
} %> |
-
웹브라우저에서 http://ip:8080/cubrid.jsp 호출
|
name ==> Serbia name ==> Kiribati name ==> Serbia and Montenegro name ==> Timor-Leste … |
JDBC를 사용한 다중화 구성 SELECT Query 부하 분산 가이드