Red Hat Summit13.2. JDBC 드라이버
애플리케이션에서 사용할 데이터 소스를 JBoss EAP에 정의하기 전에 먼저 적절한 JDBC 드라이버를 설치해야 합니다.
13.2.1. JDBC 드라이버를 코어 모듈로 설치
다음 단계를 사용하여 관리 CLI를 사용하여 JDBC 드라이버를 코어 모듈로 설치할 수 있습니다.
JDBC 드라이버를 다운로드합니다.
데이터베이스 벤더에서 적절한 JDBC 드라이버를 다운로드합니다. 공통 데이터베이스의 JDBC 드라이버에 대한 표준 다운로드 위치는 JDBC 드라이버 다운로드 위치를 참조하십시오.
JDBC 드라이버 JAR 파일이 ZIP 또는 TAR 아카이브에 포함된 경우 아카이브를 추출해야 합니다.
- JBoss EAP 서버를 시작합니다.
관리 CLI를 시작하지만
--connect또는-c인수를 사용하여 실행 중인 인스턴스에 연결하지 마십시오.Copy to Clipboard Copied! Toggle word wrap Toggle overflow EAP_HOME/bin/jboss-cli.sh
$ EAP_HOME/bin/jboss-cli.sh모듈 추가관리 CLI 명령을 사용하여 새 코어 모듈을 추가합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow module add --name=MODULE_NAME --resources=PATH_TO_JDBC_JAR --dependencies=DEPENDENCIES
module add --name=MODULE_NAME --resources=PATH_TO_JDBC_JAR --dependencies=DEPENDENCIES예를 들어 다음 명령은 MySQL JDBC 드라이버 모듈을 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow module add --name=com.mysql --resources=/path/to/mysql-connector-java-5.1.36-bin.jar --dependencies=javax.api,javax.transaction.api
module add --name=com.mysql --resources=/path/to/mysql-connector-java-5.1.36-bin.jar --dependencies=javax.api,javax.transaction.api중요이 명령을 사용하여 모듈을 추가 및 제거하는 방법에 대한 자세한 내용은
module --help를 실행합니다.연결관리 CLI 명령을 사용하여 실행 중인 인스턴스에 연결합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow connect
connectJDBC 드라이버를 등록합니다. 관리형 도메인에서 실행하는 경우 이 명령 앞에
/profile=PROFILE_NAME이어야 합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow /subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME, driver-class-name=DRIVER_CLASS_NAME)
/subsystem=datasources/jdbc-driver=DRIVER_NAME:add(driver-name=DRIVER_NAME,driver-module-name=MODULE_NAME,driver-xa-datasource-class-name=XA_DATASOURCE_CLASS_NAME, driver-class-name=DRIVER_CLASS_NAME)참고driver-class-name매개변수는 JDBC 드라이버에서/META-INF/services/java.sql.Driver파일에서 두 개 이상의 클래스를 정의하는 경우에만 필요합니다.예를 들어 MySQL 5.1.36 JDBC 드라이버 JAR의
/META-INF/services/java.sql.Driver파일은 다음 두 개의 클래스를 정의합니다.- com.mysql.jdbc.Driver
- com.mysql.fabric.jdbc.FabricMySQLDriver
이 경우
driver-class-name=com.mysql.jdbc.Driver를 전달합니다.예를 들어 다음 명령은 MySQL JDBC 드라이버를 등록합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)
/subsystem=datasources/jdbc-driver=mysql:add(driver-name=mysql,driver-module-name=com.mysql,driver-xa-datasource-class-name=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource, driver-class-name=com.mysql.jdbc.Driver)
이제 애플리케이션 데이터 소스에서 JDBC 드라이버를 참조할 수 있습니다.
13.2.2. JAR 배포로 JDBC 드라이버 설치
JDBC 드라이버는 관리 CLI 또는 관리 콘솔을 사용하여 JAR 배포로 설치할 수 있습니다. 드라이버가 JDBC 4를 준수하는 한 배포 시 JDBC 드라이버로 자동 인식 및 설치됩니다.
다음 단계에서는 관리 CLI를 사용하여 JDBC 드라이버를 설치하는 방법을 설명합니다.
JDBC 드라이버에 권장되는 설치 방법은 코어 모듈로 설치하는 것입니다.
JDBC 드라이버를 다운로드합니다.
데이터베이스 벤더에서 적절한 JDBC 드라이버를 다운로드합니다. 공통 데이터베이스의 JDBC 드라이버에 대한 표준 다운로드 위치는 JDBC 드라이버 다운로드 위치를 참조하십시오.
JDBC 드라이버 JAR 파일이 ZIP 또는 TAR 아카이브에 포함된 경우 아카이브를 추출해야 합니다.
- JDBC 드라이버가 JDBC 4와 호환되지 않는 경우 JDBC 드라이버 JAR를 JDBC 4 호환으로 업데이트하는 단계를 참조하십시오.
JAR을 JBoss EAP에 배포합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow deploy PATH_TO_JDBC_JAR
deploy PATH_TO_JDBC_JAR참고관리형 도메인에서 적절한 서버 그룹을 지정합니다.
예를 들어 다음 명령은 MySQL JDBC 드라이버를 배포합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow deploy /path/to/mysql-connector-java-5.1.36-bin.jar
deploy /path/to/mysql-connector-java-5.1.36-bin.jar데이터 소스를 정의할 때 사용할 배포된 드라이버 이름을 표시하는 JBoss EAP 서버 로그에 메시지가 표시됩니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1
WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.jdbc.Driver_5_1
이제 애플리케이션 데이터 소스에서 JDBC 드라이버를 참조할 수 있습니다.
JDBC 드라이버 JAR을 JDBC 4 호환으로 업데이트
JDBC 드라이버 JAR이 JDBC 4와 호환되지 않는 경우 다음 단계를 사용하여 배포할 수 있습니다.
- 비어 있는 임시 디렉토리를 만듭니다.
-
META-INF하위 디렉터리를 만듭니다. -
META-INF/services하위 디렉터리를 만듭니다. META-INF/services/java.sql.Driver파일을 생성하고 한 행을 추가하여 JDBC 드라이버의 정규화된 클래스 이름을 표시합니다.예를 들어, MySQL JDBC 드라이버에 대한 아래 행이 추가됩니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow com.mysql.jdbc.Driver
com.mysql.jdbc.DriverJAR 명령줄 툴을 사용하여 이 새 파일을 JAR에 추가합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow jar \-uf jdbc-driver.jar META-INF/services/java.sql.Driver
jar \-uf jdbc-driver.jar META-INF/services/java.sql.Driver
13.2.3. JDBC 드라이버 다운로드 위치
다음 표는 JBoss EAP와 함께 사용되는 공통 데이터베이스의 JDBC 드라이버에 대한 표준 다운로드 위치를 제공합니다.
이러한 링크는 Red Hat에서 제어하거나 적극적으로 모니터링하지 않는 타사 웹 사이트를 가리킵니다. 데이터베이스에 대한 최신 드라이버의 경우 데이터베이스 공급 업체의 문서 및 웹 사이트를 확인하십시오.
| vendor | 위치 다운로드 |
|---|---|
| MySQL | |
| PostgreSQL | |
| Oracle | http://www.oracle.com/technetwork/database/features/jdbc/index-091264.html |
| IBM | |
| Sybase | jConnect JDBC 드라이버는 SAP ASE 설치를 위한 SDK의 일부입니다. 현재 이 드라이버에 대한 별도의 다운로드 사이트는 자체적으로 없습니다. |
| Microsoft |
13.2.4. Vendor-Specific 클래스에 액세스
경우에 따라 애플리케이션에서 JDBC API의 일부가 아닌 벤더별 기능을 사용해야 합니다. 이러한 경우 해당 애플리케이션에 종속성을 선언하여 벤더별 API에 액세스할 수 있습니다.
이것은 고급 사용법입니다. JDBC API에서 찾을 수 없는 기능이 필요한 애플리케이션만 이 절차를 구현해야 합니다.
이 프로세스는 재인증 메커니즘을 사용하고 벤더별 클래스에 액세스하는 경우 필요합니다.
MANIFEST.MF 파일 또는 jboss-deployment-structure.xml 파일을 사용하여 애플리케이션에 대한 종속성을 정의할 수 있습니다.
아직 수행하지 않은 경우 JDBC 드라이버를 코어 모듈로 설치합니다.
MANIFEST.MF 파일 사용
-
애플리케이션의
META-INF/MANIFEST.MF파일을 편집합니다. Dependencies행을 추가하고 모듈 이름을 지정합니다.예를 들어 아래 줄은
com.mysql모듈을 종속성으로 선언합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow Dependencies: com.mysql
Dependencies: com.mysql
jboss-deployment-structure.xml 파일 사용
-
애플리케이션의
META-INF/또는 article-INF/ 폴더에이라는 파일을 생성합니다.jboss-deployment-structure.xml dependencies요소를 사용하여 모듈을 지정합니다.예를 들어 다음 예제
jboss-deployment-structure.xml파일은com.mysql모듈을 종속성으로 선언합니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow <jboss-deployment-structure> <deployment> <dependencies> <module name="com.mysql"/> </dependencies> </deployment> </jboss-deployment-structure><jboss-deployment-structure> <deployment> <dependencies> <module name="com.mysql"/> </dependencies> </deployment> </jboss-deployment-structure>
아래 예제 코드는 MySQL API에 액세스합니다.
import java.sql.Connection; import org.jboss.jca.adapters.jdbc.WrappedConnection; ... Connection c = ds.getConnection(); WrappedConnection wc = (WrappedConnection)c; com.mysql.jdbc.Connection mc = wc.getUnderlyingConnection();
import java.sql.Connection;
import org.jboss.jca.adapters.jdbc.WrappedConnection;
...
Connection c = ds.getConnection();
WrappedConnection wc = (WrappedConnection)c;
com.mysql.jdbc.Connection mc = wc.getUnderlyingConnection();벤더별 API 지침을 따르십시오. 연결이 CryostatJacamar 컨테이너에 의해 제어되기 때문입니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}