Configurando um agrupamento de conexões no servidor da aplicação JBoss

Consulte também

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 uma aplicação fecha uma conexão, esta é devolvida ao pool. 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 da aplicação 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 uma aplicação implantada 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 da aplicação JBoss:

  1. Abra a janela Favoritos (Ctrl-3).
  2. 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.
  3. 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.

  4. 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.
  5. 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>
  6. 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:

  1. 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>
  2. 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 da aplicação JBoss:

  1. Registre o servidor da aplicação JBoss 4.0.3.
  2. 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
  3. Crie uma aplicação Web e selecione o servidor JBoss 4.0.3 como servidor de destino.
  4. Acesse a fonte de dados em uma página JSP, por exemplo.
Consulte também
Trabalhando com o servidor da aplicação JBoss
Tarefas do servidor da aplicação JBoss: referência rápida

Notificações legais