Configurando um agrupamento de conexões no servidor de aplicativos JBoss

Consulte também

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:

  1. Abra a janela Favoritos (Ctrl-3).
  2. Clique com o botão direito do mouse na janela, escolha Adicionar aos favoritos e navegue até a pasta docs/examples/jca da pasta de instalação do JBoss.
  3. Selecione o arquivo -ds.xml de sua preferência. 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.
  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 implantação 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 um aplicativo da 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 de aplicativos JBoss:

  1. Registre o servidor de aplicativos 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 estiver usando o domínio default, o arquivo server.xml será encontrado aqui:
    \server\default\deploy\jbossweb-tomcat55.sar\server.xml
  3. Crie um aplicativo da Web e selecione o servidor JBoss 4.0.3 como servidor de destino.
  4. Acesse a fonte de dados, por exemplo, em uma página JSP.
Consulte também
Trabalhando com o servidor de aplicativos JBoss
Tarefas do servidor de aplicativos JBoss: Referência rápida

Notificações legais