Criando uma conexão JDBC no Wildfly 8

27 de março de 2014

Olá pessoal,

Um dos fatores mais interessantes de utilizar um servidor de aplicação é a possibilidade de atribuir a ele algumas tarefas que nós devemos nos preocupar quando desenvolvemos aplicações que são executadas apenas em um container Java, como o Tomcat por exemplo.

Nesse tutorial, vamos aprender como configurar o Wildfly para prover para nossas aplicações as conexões com o banco de dados, removendo a dependência da conexão da nossa aplicação e atribuindo ao nosso AS essa função.

Para esse exemplo, utilizaremos uma conexão com o PostgreSQL, mas lembrando que o formato da configuração é o mesmo para qualquer tipo de banco de dados.

Primeiramente, iremos abrir o Painel de controle do Wildfly. O Painel de controle fica exposto para nós através da porta 9990 do nosso AS. No meu caso, como estou executando ele na minha própria máquina, minha URL de acesso ficou http://localhost:9990/.

Primeiramente, precisamos instalar o driver JDBC em nosso servidor. O Wildfly trata a instalação do driver como um deploy de um módulo. Para essa configuração, selecione a opção: Runtime -> Server -> Manage Deployments -> Add.

Feito isso, vamos instalar o driver JDBC para o PostgreSQL. Eu obtive o meu driver do repositório central do Maven. Você pode efetuar o download clicando aqui. Após efetuar o download do driver, basta seguir os passos abaixo.

Após efetuar a instalação do módulo, a próxima etapa que devemos fazer é habilitar esse módulo no Wildfly.

Ok, nesse ponto já temos 50% do trabalho efetuado. A próxima etapa é criar a nossa conexão. Para isso, agora vamos para a opção: Profile -> Subsystems -> Connector -> Datasources.

Um detalhe bastante interessante é que o Wildfly necessita que o JDNI inicie com a sigla java:/. Uma vez que seu uso é obrigatório, eu finalizei o registro do JNDI com a URL jdbc/Postgresql.

Na próxima etapa, iremos definir qual driver será utilizado para a conexão.

E por ultimo, iremos definir as informações referentes a conexão com o banco de dados. No meu caso, eu estou utilizando nesse exemplo uma base de dados PostgreSQL sendo executada no serviço OpenShift da RedHat. Esse PaaS é gratuito (em algumas combinações de serviço) e possui muitas opções para você iniciar o deploy de suas aplicações na nuvem, sem se preocupar em configuração de serviços como servidores de banco de dados, servidores de aplicações, linguagens de scripts, etc…

Para efetuar a conexão em meu servidor local com a base de dados na nuvem, foi necessário uma configuração de port-forward no console do RHC. Essas configurações sobre o OpenShift ficarão para um próximo tutorial sobre a plataforma, o objetivo desde post é exemplificar a configuração do Wildfly.