Configurando um agrupamento de conexões no servidor do aplicativo JBoss

Um pool de conexões JDBC consiste em um grupo de conexões reutilizáveis que o servidor do aplicativo mantém para um determinado banco de dados.© As aplicações que solicitam conexão a um banco de dados a obtêm do pool. Quando um aplicativo fecha uma conexão, esta é devolvida ao agrupamento. As propriedades do agrupamento de conexões variam conforme os diferentes fornecedores de banco de dados. Algumas propriedades comuns são a URL para o nome do banco de dados, o nome de usuário e a senha.

O primeiro passo para a criação de um pool de conexões de banco de dados no servidor do aplicativo JBoss é criar um recurso JDBC (também denominado fonte de dados). Um recurso JDBC oferece aplicações com uma conexão a um banco de dados. Geralmente, há pelo menos um recurso JDBC para cada banco de dados acessado por um aplicativo implantado em um domínio. É possível haver mais de um recurso JDBC para um banco de dados. Você pode criar um recurso JDBC manualmente em um arquivo feito sob medida para seu servidor de banco de dados, oferecido na pasta de instalação do JBoss.

Para configurar uma fonte de dados no servidor do aplicativo JBoss:

Abra a janela Favoritos (Ctrl-3).
Clique com o botão direito do mouse na janela, escolha Adicionar a favoritos e navegue até a pasta docs/examples/jca da pasta de instalação do JBoss.
Selecione o arquivo -ds.xml da sua escolha. Por exemplo, se PointBase for um servidor de banco de dados, selecione pointbase-ds.xml.
Um novo nó aparece na janela Favoritos.
Na janela Favoritos, clique com o botão direito do mouse no novo nó para que o arquivo seja aberto no Editor de código-fonte.

Defina a fonte de dados. Por exemplo, para PointBase, a fonte de dados poderia ser semelhante a:

<datasources>
   <local-tx-datasource>
      <jndi-name>jdbc/poolDB</jndi-name>
      <use-java-context>false</use-java-context>
      <connection-url>jdbc:pointbase://localhost:9092/sample</connection-url>
      <driver-class>com.pointbase.jdbc.jdbcUniversalDriver</driver-class>
      <user-name>pbpublic</user-name>
      <password>pbpublic</password>
      <metadata><type-mapping>PointBase</type-mapping></metadata>
  </local-tx-datasource>
</datasources>

Copie o arquivo para pasta de deployment JBoss. Por exemplo, se default for seu domínio, copie o arquivo em server/default/deploy.

Para fazer referência a uma fonte de dados a partir de uma aplicação Web:

No arquivo WEB-INF/jboss-web.xml, adicione uma referência a recursos. Por exemplo, para a fonte de dados abaixo, a referência a recursos poderia ser:
```
<resource-ref>
  <res-ref-name>jdbc/poolDB</res-ref-name>
  <jndi-name>jdbc/poolDB</jndi-name>
</resource-ref>
```

No arquivo WEB-INF/web.xml, adicione uma referência a recursos. Por exemplo, para a fonte de dados abaixo, a referência a recursos poderia ser:

<resource-ref>
  <res-ref-name>jdbc/poolDB</res-ref-name>
  <res-type>javax.sql.DataSource</res-type>
  <res-auth>Container</res-auth>
  <res-sharing-scope>Shareable</res-sharing-scope>
</resource-ref>

Para preparar uma fonte de dados para ser usada no servidor do aplicativo JBoss:

Registre o servidor do aplicativo JBoss 4.0.3.
Defina o número de porta JBoss no arquivo server.xml. Por padrão, o número de porta é 8080. Se você estiver usando o domínio padrão, o arquivo server.xml é encontrado aqui:
```
\server\default\deploy\jbossweb-tomcat55.sar\server.xml
```
Crie uma aplicação Web e selecione o servidor JBoss 4.0.3 como servidor de destino.
Acesse a fonte de dados em uma página JSP, por exemplo.

Consulte também: Trabalhando com o servidor do aplicativo JBoss; Tarefas do servidor do aplicativo JBoss: referência rápida

Notificações legais