Adicionar datasource ao Wildfly

Este tutorial irá mostrar como adicionar um datasource ao Wildfly utilizando o banco de dados Postgres.

Pré-requisitos

• Wildfly – clique aqui para o tutorial.
• Usuário administrativo do Wildfly – clique aqui para o tutorial.

Driver

Para que o Wildfly se conecte a um banco de dados, é necessário que um driver respectivo ao banco de dados utilizado (Postgres nesse caso) seja disponibilizado.

Download

O driver é um simples arquivo .jar. Acesse este link do repositório maven e selecione a versão mais recente do driver para exibir suas informações. Na nova janela, baixe o jar conforme indicado nas imagens abaixo:

Em seguida, crie a pasta drivers dentro do diretório /opt e mova o jar para o novo diretório:

sudo mkdir /opt/drivers
sudo mv postgresql-9.4-1200-jdbc41.jar /opt/drivers/

Instalação

Com o Wildfly iniciado, iremos acessar sua linha de comando para instalar o driver que baixamos, portanto, acesse o diretório bin de seu Wildfly e conecte-se ao cli:

cd /opt/wildfly-8.2.0.Final/bin
./jboss-cli.sh --connect

Agora que você está conectado à linha de comando, iremos adicionar adicionar um módulo ao Wildfly que apontará para o jar do driver que baixamos:

module add --name=org.postgres --resources=/opt/drivers/postgresql-9.4-1200-jdbc41.jar --dependencies=javax.api,javax.transaction.api

E para concluir esta etapa, instalaremos o driver no Wildfly:

/subsystem=datasources/jdbc-driver=postgres:add(driver-name="postgres",driver-module-name="org.postgres",driver-class-name=org.postgresql.Driver)

Se tudo correu bem, uma mensagem de sucesso será exibida:

{"outcome" => "success"}

Datasource

Com o driver devidamente instalado, certifique-se que seu Wildfly foi iniciado e acesse sua página administrativa em http://localhost:9990/console/App.html e insira seu usuário e senha.

Na aba Configuration, selecione a categoria Connector -> Datasources e em seguida, a sub-aba Datasources e clique em Add:

Na primeira etapa você deve escolher um nome pra identificar sua conexão através do campo Name, já no campo JNDI Name você deverá escolher o nome que será utilizado por suas aplicações Java para encontrar sua conexão, geralmente especificado em seu persistence.xml. Para este exemplo, utilizaremos o nome bgasparotto acompanhado do nome JNDI java:jboss/datasources/bgasparotto conforme a imagem:

Em seguida, deveremos escolher qual driver utilizaremos. Selecione o driver Postgres criado anteriormente:

Na última etapa, devemos informar os dados de acesso ao banco de dados que este datasource irá se conectar. Certifique-se de criar e iniciar o banco de dados desejado em seu Postgres, e preencha o formulário com as credencias de seu banco de dados. O campo Connection URL deve ser preenchido seguindo o padrão jdbc:postgresql://<ip:porta>/nome_do_banco.

Após preencher, clique em Test Connection para confirmar que tudo correu bem, e finalmente em Done:

Seu novo datasource será exibido porém ainda estará inativo. Selecione-o e clique Enable:

Agora seu novo datasource já está pronto para ser utilizado em suas aplicações Java publicadas em seu Wildfly.

Espero que ajude. Até mais!