SQL 데이터베이스에 연결 connecting-to-sql-databases
CQ 애플리케이션이 데이터와 상호 작용할 수 있도록 외부 SQL 데이터베이스를에 액세스합니다.
JDBC 데이터베이스 드라이버 번들 bundling-the-jdbc-database-driver
일부 데이터베이스 공급업체는 예를 들어 OSGi 번들에 JDBC 드라이버를 제공합니다 MySQL. 데이터베이스의 JDBC 드라이버를 OSGi 번들로 사용할 수 없는 경우 드라이버 JAR를 가져와 OSGi 번들로 래핑합니다. 번들은 데이터베이스 서버와 상호 작용하는 데 필요한 패키지를 내보내야 합니다. 번들은 참조하는 패키지를 가져와야 합니다.
다음 예제에서는 Maven용 번들 플러그인 OSGi 번들로 HSQLDB 드라이버를 래핑하려면 다음을 수행하십시오. POM은 플러그인에게 종속성으로 식별되는 hsqldb.jar 파일을 포함하도록 지시합니다. 모든 org.hsqldb 패키지를 내보냅니다.
이 플러그인은 가져올 패키지를 자동으로 결정하고 번들의 MANIFEST.MF 파일에 나열합니다. CQ 서버에서 패키지를 사용할 수 없는 경우 설치 시 번들이 시작되지 않습니다. 가능한 두 가지 해결 방법은 다음과 같습니다.
-
POM에 패키지가 선택 사항임을 나타냅니다. JDBC 연결에 실제로 패키지 멤버가 필요하지 않은 경우 이 솔루션을 사용합니다. 다음 예제와 같이 Import-Package 요소를 사용하여 선택적 패키지를 나타냅니다.
<Import-Package>org.jboss.*;resolution:=optional,*</Import-Package> -
패키지를 내보내는 OSGi 번들에 패키지가 들어 있는 JAR 파일을 래핑하고 번들을 배포합니다. 코드 실행 중에 패키지 멤버가 필요한 경우 이 솔루션을 사용하십시오.
소스 코드에 대한 지식을 사용하여 사용할 솔루션을 결정할 수 있습니다. 솔루션을 테스트하고 솔루션을 검증하는 테스트를 수행할 수도 있습니다.
hsqldb.jar를 번들로 제공하는 POM pom-that-bundles-hsqldb-jar
<project xmlns="https://maven.apache.org/POM/4.0.0"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.adobe.example.myapp</groupId>
<artifactId>hsqldb-jdbc-driver-bundle</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>wrapper-bundle-hsqldb-driver</name>
<url>www.adobe.com</url>
<description>Exports the HSQL JDBC driver</description>
<packaging>bundle</packaging>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.apache.felix</groupId>
<artifactId>maven-bundle-plugin</artifactId>
<version>1.4.3</version>
<extensions>true</extensions>
<configuration>
<instructions>
<Embed-Dependency>*</Embed-Dependency>
<_exportcontents>org.hsqldb.*</_exportcontents>
</instructions>
</configuration>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>hsqldb</groupId>
<artifactId>hsqldb</artifactId>
<version>2.2.9</version>
</dependency>
</dependencies>
</project>
다음 링크를 통해 몇 가지 인기 있는 데이터베이스 제품에 대한 다운로드 페이지를 열 수 있습니다.
JDBC 접속 풀 서비스 구성 configuring-the-jdbc-connection-pool-service
JDBC 드라이버를 사용하여 데이터 소스 객체를 생성하는 JDBC 접속 풀 서비스에 대한 구성을 추가합니다. 응용 프로그램 코드는 이 서비스를 사용하여 개체를 가져오고 데이터베이스에 연결합니다.
JDBC 접속 풀( com.day.commons.datasource.jdbcpool.JdbcPoolService)은 공장 서비스입니다. 읽기 전용 또는 읽기/쓰기 액세스와 같이 다른 속성을 사용하는 연결이 필요한 경우 여러 구성을 만드십시오.
CQ를 사용하여 작업하는 경우 이러한 서비스에 대한 구성 설정을 관리하는 방법에는 여러 가지가 있습니다. 참조 OSGi 구성 자세한 내용
다음 속성을 사용하여 풀링된 연결 서비스를 구성할 수 있습니다. 속성 이름은 웹 콘솔에 나타나는 대로 나열됩니다. 에 해당하는 이름 sling:OsgiConfig 노드가 괄호로 표시됩니다. HSQLDB 서버 및 별칭이 인 데이터베이스에 대한 예제 값이 표시됩니다 mydb:
-
JDBC 드라이버 클래스(
jdbc.driver.class): 예를들어 java.sql.Driver 인터페이스를 구현하는 데 사용할 Java 클래스입니다org.hsqldb.jdbc.JDBCDriver. 데이터 유형은 다음과 같습니다String. -
JDBC 연결 URI (
jdbc.connection.uri): 연결을 만드는 데 사용할 데이터베이스의 URL입니다. 예를 들면 다음과 같습니다jdbc:hsqldb:hsql//10.36.79.223:9001/mydb. URL의 형식은 java.sql.DriverManager 클래스의 getConnection 메서드에 사용할 수 있어야 합니다. 데이터 유형은 다음과 같습니다String. -
사용자 이름 (
jdbc.username): 데이터베이스 서버를 인증하는 데 사용할 사용자 이름입니다. 데이터 유형은 다음과 같습니다String. -
암호 (
jdbc.password): 사용자의 인증에 사용할 암호입니다. 데이터 유형은 다음과 같습니다String. -
유효성 검사 쿼리(
jdbc.validation.query): 연결이 성공했는지 확인하는 데 사용할 SQL 문(예:select 1 from INFORMATION_SCHEMA.SYSTEM_USERS. 데이터 유형은 다음과 같습니다String. -
기본적으로 읽기 전용(default.readonly): 연결에 읽기 전용 액세스를 제공하려면 이 옵션을 선택합니다. 데이터 유형은 다음과 같습니다
Boolean. -
기본적으로 자동 커밋(
default.autocommit): 데이터베이스에 전송되는 각 SQL 명령에 대해 별도의 트랜잭션을 만들고 각 트랜잭션이 자동으로 커밋되도록 하려면 이 옵션을 선택합니다. 코드에서 트랜잭션을 명시적으로 커밋할 때에는 이 옵션을 선택하지 마십시오. 데이터 유형은 다음과 같습니다Boolean. -
풀 크기(
pool.size): 데이터베이스에서 사용할 수 있는 동시 연결 수입니다. 데이터 유형은 다음과 같습니다Long. -
풀 대기(
pool.max.wait.msec): 연결 요청이 시간 초과되기 전 시간입니다. 데이터 유형은 다음과 같습니다Long. -
데이터 소스 이름 (
datasource.name): 이 데이터 소스의 이름입니다. 데이터 유형은 다음과 같습니다String. -
추가 서비스 속성 (
datasource.svc.properties): 연결 URL에 추가할 이름/값 쌍 집합입니다. 데이터 유형은 다음과 같습니다String[].
JDBC 접속 풀 서비스는 팩터리입니다. 따라서 sling:OsgiConfig 노드 연결 서비스를 구성하려면 노드 이름에 팩터리 서비스 PID 다음에 가 와야 합니다 -alias. 사용하는 별칭은 해당 PID의 모든 구성 노드에 대해 고유해야 합니다. 노드 이름의 예는 다음과 같습니다. com.day.commons.datasource.jdbcpool.JdbcPoolService-myhsqldbpool.
데이터베이스에 연결 connecting-to-the-database
Java 코드에서 DataSourcePool 서비스를 사용하여 javax.sql.DataSource 개체를 생성할 수 있습니다. DataSourcePool 서비스는 getDataSource 를 반환하는 메서드 DataSource 지정된 데이터 소스 이름에 대한 개체입니다. 메서드 인수로 데이터 소스 이름(또는 datasource.name) JDBC 접속 풀 구성에 대해 지정한 등록 정보입니다.
다음 예제 JSP 코드는 hsqldbds 데이터 소스의 인스턴스를 가져오고 단순 SQL 쿼리를 실행하고 반환된 결과 수를 표시합니다.
데이터베이스 조회를 수행하는 JSP jsp-that-performs-a-database-lookup
<%@include file="/libs/foundation/global.jsp"%><%
%><%@page session="false"%><%
%><%@ page import="com.day.commons.datasource.poolservice.DataSourcePool" %><%
%><%@ page import="javax.sql.DataSource" %><%
%><%@ page import="java.sql.Connection" %><%
%><%@ page import="java.sql.SQLException" %><%
%><%@ page import="java.sql.Statement" %><%
%><%@ page import="java.sql.ResultSet"%><%
%><html>
<cq:include script="head.jsp"/>
<body>
<%DataSourcePool dspService = sling.getService(DataSourcePool.class);
try {
DataSource ds = (DataSource) dspService.getDataSource("hsqldbds");
if(ds != null) {
%><p>Obtained the datasource!</p><%
%><%final Connection connection = ds.getConnection();
final Statement statement = connection.createStatement();
final ResultSet resultSet = statement.executeQuery("SELECT * from INFORMATION_SCHEMA.SYSTEM_USERS");
int r=0;
while(resultSet.next()){
r=r+1;
}
resultSet.close();
%><p>Number of results: <%=r%></p><%
}
}catch (Exception e) {
%><p>error! <%=e.getMessage()%></p><%
}
%></body>
</html>