Last Updated on 27/12/2023
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!