Um agrupamento de conexões JDBC é um grupo de conexões reutilizáveis que um servidor da Web ou servidor de aplicativos mantém para um banco de dados específico. Aplicativos que solicitam uma conexão a um banco de dados obtêm essa conexão do agrupamento. 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 agrupamento de conexões de banco de dados no servidor de aplicativos JBoss é criar um recurso JDBC (também denominado fonte de dados). Um recurso JDBC oferece aplicativos 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 de aplicativos JBoss:
Um novo nó aparece na janela Favoritos.
<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>
Para fazer referência a uma fonte de dados a partir de um aplicativo da Web:
<resource-ref> <res-ref-name>jdbc/poolDB</res-ref-name> <jndi-name>jdbc/poolDB</jndi-name> </resource-ref>
<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 de aplicativos JBoss:
\server\default\deploy\jbossweb-tomcat55.sar\server.xml