Connessione ai database SQL connecting-to-sql-databases

Accedi a un database SQL esterno in modo che le applicazioni CQ possano interagire con i dati:

Bundling del driver di database JDBC bundling-the-jdbc-database-driver

Alcuni fornitori di database forniscono driver JDBC in un bundle OSGi, per esempio MySQL. Se il driver JDBC per il database non è disponibile come bundle OSGi, ottieni il driver JAR e inseriscilo in un bundle OSGi. Il bundle deve esportare i pacchetti necessari per interagire con il server di database. Il bundle deve anche importare i pacchetti a cui fa riferimento.

Nell'esempio seguente viene utilizzato il Plug-in bundle per Maven avvolgere il driver HSQLDB in un bundle OSGi. Il POM indica al plug-in di incorporare il file hsqldb.jar identificato come dipendenza. Vengono esportati tutti i pacchetti org.hsqldb.

Il plugin determina automaticamente quali pacchetti importare ed elenca nel file MANIFEST.MF del bundle. Se uno qualsiasi dei pacchetti non è disponibile sul server CQ, il bundle non si avvia al momento dell'installazione. Due possibili soluzioni sono le seguenti:

La conoscenza del codice sorgente consente di decidere quale soluzione utilizzare. Puoi anche provare entrambe le soluzioni ed eseguire test per convalidare la soluzione.

POM che raggruppa hsqldb.jar 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>

I seguenti collegamenti consentono di aprire le pagine di download per alcuni dei più comuni prodotti di database:

Configurazione del servizio del pool di connessioni JDBC configuring-the-jdbc-connection-pool-service

Aggiungi una configurazione per il servizio JDBC Connections Pool che utilizza il driver JDBC per creare oggetti di origine dati. Il codice dell'applicazione utilizza questo servizio per ottenere l'oggetto e connettersi al database.

Pool di connessioni JDBC ( com.day.commons.datasource.jdbcpool.JdbcPoolService) è un servizio di fabbrica. Se hai bisogno di connessioni che utilizzano proprietà diverse, ad esempio accesso in sola lettura o in lettura/scrittura, crea più configurazioni.

Quando si lavora con CQ esistono diversi metodi per gestire le impostazioni di configurazione per tali servizi; vedere Configurazione di OSGi per informazioni complete.

Per configurare un servizio di connessione in pool sono disponibili le seguenti proprietà. I nomi delle proprietà vengono elencati come visualizzati nella console Web. Nome corrispondente per un sling:OsgiConfig viene visualizzato tra parentesi. Vengono visualizzati valori di esempio per un server HSQLDB e un database con un alias di mydb:

Il servizio JDBC Connections Pool è una fabbrica. Pertanto, se utilizzi un sling:OsgiConfig nodo per configurare il servizio di connessione, il nome del nodo deve includere il PID del servizio di fabbrica seguito da -alias. L'alias utilizzato deve essere univoco per tutti i nodi di configurazione per quel PID. Un nome di nodo di esempio è com.day.commons.datasource.jdbcpool.JdbcPoolService-myhsqldbpool.

Connessione al database connecting-to-the-database

Nel codice Java, utilizza il servizio DataSourcePool per ottenere un javax.sql.DataSource oggetto per la configurazione creata. Il servizio DataSourcePool fornisce la variabile getDataSource metodo che restituisce un DataSource oggetto per un nome di origine dati specificato. Come argomento del metodo, utilizza il valore del Nome origine dati (o datasource.name) specificata per la configurazione del pool di connessioni JDBC.

Nell'esempio seguente il codice JSP ottiene un'istanza dell'origine dati hsqldbds, esegue una semplice query SQL e visualizza il numero di risultati restituiti.

JSP che esegue una ricerca di database 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>