Conexão com Bancos de Dados SQL connecting-to-sql-databases

Acesse um banco de dados SQL externo para que seus aplicativos CQ possam interagir com os dados:

Pacote do driver de banco de dados JDBC bundling-the-jdbc-database-driver

Alguns fornecedores de banco de dados fornecem drivers JDBC em um pacote OSGi, por exemplo MySQL. Se o driver JDBC do seu banco de dados não estiver disponível como um pacote OSGi, obtenha o JAR do driver e coloque-o em um pacote OSGi. O pacote deve exportar os pacotes necessários para interagir com o servidor de banco de dados. O pacote também deve importar os pacotes que ele faz referência.

O exemplo a seguir usa a variável Plug-in do pacote para Maven para embrulhar o driver HSQLDB em um pacote OSGi. O POM instrui o plug-in a incorporar o arquivo hsqldb.jar identificado como uma dependência. Todos os pacotes org.hsqldb são exportados.

O plug-in determina automaticamente quais pacotes serão importados e os lista no arquivo MANIFEST.MF do pacote. Se algum dos pacotes não estiver disponível no servidor CQ, o pacote não será iniciado após a instalação. Duas soluções possíveis são as seguintes:

O conhecimento do código-fonte permite que você decida qual solução usar. Você também pode tentar qualquer solução e realizar testes para validar a solução.

POM que empacota 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>

Os links a seguir abrem as páginas de download de alguns produtos de banco de dados populares:

Configuração do Serviço de Pool de Conexões JDBC configuring-the-jdbc-connection-pool-service

Adicione uma configuração para o serviço Pool de conexões JDBC que usa o driver JDBC para criar objetos de fonte de dados. O código de aplicativo usa esse serviço para obter o objeto e se conectar ao banco de dados.

Pool de conexões JDBC ( com.day.commons.datasource.jdbcpool.JdbcPoolService) é um serviço de fábrica. Se você precisar de conexões que usam propriedades diferentes, por exemplo, acesso somente leitura ou leitura/gravação, crie várias configurações.

Ao trabalhar com o CQ, há vários métodos de gerenciamento das configurações desses serviços; see Configuração do OSGi para obter detalhes completos.

As seguintes propriedades estão disponíveis para configurar um serviço de conexão agrupado. Os nomes das propriedades são listados conforme aparecem no Console da Web. O nome correspondente de um sling:OsgiConfig é exibido entre parênteses. Os valores de exemplo são mostrados para um servidor HSQLDB e um banco de dados que tem um alias de mydb:

O serviço Pool de Conexões JDBC é de fábrica. Portanto, se você usar um sling:OsgiConfig nó para configurar o serviço de conexão, o nome do nó deve incluir o PID do serviço de fábrica seguido por -alias. O alias que você usa deve ser exclusivo para todos os nós de configuração desse PID. Um exemplo de nome de nó é com.day.commons.datasource.jdbcpool.JdbcPoolService-myhsqldbpool.

Conexão com o banco de dados connecting-to-the-database

No seu código Java, use o serviço DataSourcePool para obter um javax.sql.DataSource objeto para a configuração criada. O serviço DataSourcePool fornece a variável getDataSource que retorna um método DataSource para um determinado nome da fonte de dados. Como argumento do método, use o valor do Nome da Fonte de Dados (ou datasource.name) que você especificou para a configuração do Pool de Conexões JDBC.

O exemplo de código JSP a seguir obtém uma instância da fonte de dados hsqldbds, executa uma consulta SQL simples e exibe o número de resultados que são retornados.

JSP que executa uma pesquisa de banco de dados 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>