SQL 데이터베이스에 연결 connecting-to-sql-databases

외부 SQL 데이터베이스에 액세스하여 CQ 애플리케이션이 데이터와 상호 작용할 수 있도록 합니다.

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.

chlimage_1-7

데이터베이스에 연결 connecting-to-the-database

Java™ 코드에서 DataSourcePool 서비스를 사용하여 javax.sql.DataSource 생성된 구성에 대한 객체입니다. DataSourcePool 서비스는 다음을 제공합니다. getDataSource 를 반환하는 메서드 DataSource 지정된 데이터 소스 이름에 대한 개체입니다. 메서드 인수로 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>
NOTE
데이터 소스를 찾을 수 없기 때문에 getDataSource 메서드가 예외를 throw하는 경우 연결 풀 서비스 구성이 올바른지 확인하십시오. 속성 이름, 값 및 데이터 유형을 확인합니다.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2