Configurando um agrupamento de conexões no servidor Web Tomcat

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.

Para obter informações detalhadas sobre a funcionalidade do agrupamento de conexões do banco de dados do Tomcat, consulte:

A primeira etapa na criação de um agrupamento de conexões do banco de dados do Tomcat é criar um recurso JDBC (também chamado de 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 no server.xml ou usar a ferramenta de aministração do Tomcat.

Para adicionar um recurso JDBC usando a ferramenta de administração do servidor Web Tomcat:

  1. Acesse a ferramenta de administração do servidor Web Tomcat.
  2. Em Ferramenta de administração, clique em Fontes de dados.
  3. Escolha Criar nova fonte de dados na lista suspensa Ações da fonte de dados, à direita.
  4. Digite valores como os abaixo para definir a fonte de dados:
  5. Clique em Salvar. Em seguida clique em Confirmar alterações. Em seguida clique em Logoff.
  6. Faça referência ao recurso JDBC a partir do aplicativo da Web como descrito abaixo.

Para adicionar um recurso JDBC manualmente no arquivo server.xml:
Tenha em mente que a edição manual do arquivo server.xml é de sua responsabilidade; o IDE não corrige danos no arquivo server.xml. Recomenda-se enfaticamente que você crie uma versão de backup do arquivo server.xml de trabalho antes de editá-lo manualmente.

  1. Na janela Tempo de execução, expanda o nó dos servidores e o nó dos servidores Tomcat 5.
  2. Pare o servidor clicando com o botão direito do mouse no nó da instância Tomcat e escolhendo Parar.
  3. Clique com o botão direito do mouse no nó da instância Tomcat e escolha Editar server.xml no menu contextual para abrir o arquivo server.xml no Editor de código.
  4. Faça alterações.
  5. Faça referência ao recurso JDBC a partir do aplicativo da Web como descrito abaixo.

Para fazer referência a um recurso JDBC a partir de um aplicativo da Web:

  1. Expanda o nó do projeto na janela Projetos. Em seguida expanda o nó de páginas da Web e o nó WEB-INF. Clique duas vezes no nó web.xml e use o Editor de código para adicionar a referência do recurso ao arquivo web.xml, da seguinte forma:

        	  <resource-ref>
    	      <description>Tomcat DBCP</description>
    	      <res-ref-name>jdbc/poolDB</res-ref-name>
    	      <res-type>javax.sql.DataSource</res-type>
    	      <res-auth>Container</res-auth>
    	  </resource-ref>
  2. Expanda o nó META-INF. Clique com o botão direito do mouse no nó context.xml, escolha Editar no menu contextual e use o Editor de código para adicionar o seguinte link de recurso entre as marcas de <context> no arquivo context.xml:
              <ResourceLink name="jdbc/poolDB" type="javax.sql.DataSource" global="jdbc/poolDB"/>
    Observação: Não clique duas vezes no arquivo context.xml. Se clicar, o IDE abrirá o arquivo context.xml no Editor de contexto e não no Editor de código. Não é possível adicionar um link de recurso no Editor de contexto. Como não é possível abrir o arquivo context.xml no Editor de código e no Editor de contexto ao mesmo tempo, o IDE desativará Editar no menu contextual se o arquivo context.xml for aberto no Editor de contexto.

    A aparência do arquivo META-INF/context.xml do aplicativo da Web agora deve ser semelhante a esta:

        	  <Context path="/Employees">
    	      <ResourceLink name="jdbc/poolDB" type="javax.sql.DataSource"
    	       global="jdbc/poolDB"/>
    	      <Logger className="org.apache.catalina.logger.FileLogger"
    	       prefixo="MyApp" sufixo=".log" carimbo de data/hora="true"/>
    	  </Context>
  3. Finalmente, use o recurso JDBC no aplicativo da Web.
Consulte também
Sobre o servidor Web Tomcat
Definindo um nome de usuário e uma senha para o gerenciador Tomcat
Definindo um agrupamento de conexões do banco de dados do Tomcat em uma arquivo JSP

Notificações legais