Pular para o conteúdo principal

Criando Módulos e DataSources no Wildfly

Hoje iremos ver como criar um Módulos e DataSources no Wildfly Application Server.

O que é um Módulo ?


Módulos no Wildfly são recursos que podem ser utilizados em diversos lugares dentro da instância em execução do Container, eles podem ser reaproveitados em diversos lugares, tais como: artefatos, datasources, entre outros.

Criando um novo Módulo


A criação de módulos no Wildfly é uma tarefa simples, em nosso exemplo, iremos criar um módulo referente ao Driver JDBC do PostgreSQL, para isso deve-se executar os seguintes passos:

1- Acessar o diretório: {WILDFLY_HOME}/modules/system/layers/base:
Diretório base.

2- Criar a estrutura org/postgresql/main, e adicionar o driver(.jar) do PostgreSQL dentro do diretório main:
Driver do banco de dados PostgreSQL.

3- Ainda no diretório main, criar o arquivo module.xml com o seguinte conteúdo:

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="org.postgresql">
    <resources>
        <resource-root path="postgresql-9.4.1208.jar"/>
    </resources>
 <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

4- Após seguir os passos o módulo esta criado e pronto para o uso:

Diretório main com os arquivos.

Agora iremos criar um DataSource referenciando o módulo acima.


O que é um DataSource ?


DataSource é uma fonte de dados onde as aplicações iram buscar informações externas ao Container, estas informações geralmente estão em um banco de dados, mas também podem vir de outras fontes, ao criar DataSources podemos estipular várias características de acesso a fonte de dados, tais como: pool de conexão, registro JNDI, entre outras.


Criando um novo DataSource


1- Acessar o diretório: {WILDFLY_HOME}/standalone/configuration:
Diretório com arquivos de configuração.

2- Editar o arquivo standalone.xml, e adicionar o driver a tag <drivers />:
<drivers>
  <driver name="postgresql" module="org.postgresql">
      <xa-datasource-class>org.postgresql.Driver</xa-datasource-class>
  </driver>
</drivers>

3- Ainda no arquivo standalone.xml, criar um DataSource na tag <datasources />:
<datasources>
  <datasource jndi-name="java:jboss/datasources/testePostgreSQL" 
              jta="true" 
              pool-name="testePostgreSQL" 
              enabled="true" 
              use-java-context="true">
      <connection-url>jdbc:postgresql://localhost:5432/teste</connection-url>
      <driver>postgresql</driver>
      <pool>
        <min-pool-size>5</min-pool-size>
        <max-pool-size>10</max-pool-size>
        <prefill>true</prefill>
      </pool>
      <security>
         <user-name>postgres</user-name>
         <password>admin</password>
      </security>
  </datasource>
</datasources>

Após seguir todos os passos e iniciar o Wildfly, dentro do sistema de administração, na aba configuração, podemos ver o DataSource criado:

DataSource criado e pronto para uso.

Até a próxima.


Comentários

Postagens mais visitadas do Blog