O Edite o arquivo domain.xml localizado em [diretório_instalação]\appserver\domain\configuration. Edite o arquivo e procure pela linha que contém a tag <datasources>. Esta tag é responsável pelo agrupamento das conexões criadas na aplicação.
A seguir é apresentado um exemplo da tag no arquivo domain.xml: Bloco de código |
---|
language | xml |
---|
title | Tag datasource |
---|
linenumbers | true |
---|
| <subsystem xmlns="urn:jboss:domain:datasources:5.0">
<datasources> |
Dentro desta tag terá uma outra tag chamada <datasource>chamada <datasource>, responsável pelas configurações de uma conexão com um banco de dados. O exemplo abaixo apresenta o uso da tag <datasource> (conexão) criado dentro da primeira tag <datasources> (Responsável pelo agrupamento das conexões), sendo que seu arquivo já possuirá alguns <datasource> configurados, que são responsáveis pela comunicação com o banco de dados da plataforma. Bloco de código |
---|
language | xml |
---|
linenumbers | true |
---|
| <datasources>
<datasource jta="false" jndi-name="java:/jdbc/AppDS" pool-name="AppDS" enabled="true" use-java-context="false">
<connection-url>jdbc:mysql://localhost:3306/fluig</connection-url>
<driver>mysqlDriver</driver>
<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
<pool>
<min-pool-size>10</min-pool-size>
<max-pool-size>20</max-pool-size>
</pool>
<security>
<user-name>root</user-name>
<password>admin</password>
</security>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
<validate-on-match>true</validate-on-match>
<background-validation>false</background-validation>
</validation>
<statement>
<share-prepared-statements>false</share-prepared-statements>
</statement>
</datasource>
<drivers>
<driver name="mysqlDriver" module="com.mysql">
<driver-class>com.mysql.jdbc.Driver</driver-class>
</driver>
</drivers>
</datasources> |
Nota |
---|
| Nunca remova ou altere Não orientamos remover ou alterar as conexões (<datasource>) que já estão contidas no arquivo de configuração domain.xml. Estas conexões são vitais essenciais para o correto funcionamento da plataforma. Somente as novas conexões criadas com a finalidade de acesso aos datasets podem ser manipuladas. |
No exemplo apresentado, além do datasource, existem duas outras tags que ficam dentro da estrutura da tag <datasources> que são <drivers> e <driver>. A tag <drivers> é responsável pelo agrupamento das configurações de driver. Já a tag <driver> é responsável pela comunicação com o banco de dados. Pode haver uma ou várias configurações de driver caso seja acessado mais de um banco (Oracle, MySQL, SQLServer). Nota |
---|
| - O exemplo apresentado possui configurado somente o driver para uso do banco de dados MySQL. Se for utilizado outro banco, verifique a configuração do driver necessária para seu uso.
- Nunca remova o driver já configurado ou substitua ele por outro. Caso necessário, configure um novo driver seguindo a estrutura já descrita.
|
Neste caso, para criar um dataset que acesse uma determinada base de dados, é necessário acrescentar uma nova conexão <datasource> dentro da tag <datasources>. Exemplo: para acessar uma base de dados em MySQL cujo nome da base seja minhabase, a configuração do novo datasource ficará da seguinte forma: Bloco de código |
---|
language | xml |
---|
linenumbers | true |
---|
| <datasource jta="false" jndi-name="java:/jdbc/MeuDataSet" pool-name="MeuDataSet" enabled="true" use-java-context="false">
<connection-url>jdbc:mysql://localhost:3306/minhabase</connection-url>
<driver>mysqlDriver</driver>
<pool>
<min-pool-size>5</min-pool-size>
<max-pool-size>15</max-pool-size>
</pool>
<security>
<user-name>root</user-name>
<password>admin</password>
</security>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
<validate-on-match>true</validate-on-match>
<background-validation>false</background-validation>
</validation>
<timeout>
<blocking-timeout-millis>30000</blocking-timeout-millis>
</timeout>
<statement>
<share-prepared-statements>false</share-prepared-statements>
</statement>
</datasource>
|
A partir do código gerado acima, cabe destacar: - jndi-name = deverá seguir a sintaxe "java:/jdbc/" onde após a / deverá ser informado um alias para conexão. No exemplo foi dado o nome de MeuDataset ficando "java:/jdbc/MeuDataset"
- pool-name =usar o mesmo nome dado como alias para conexão. No exemplo ficou MeuDataset.
- <connection-url> = dentro desta tag deverá ser informada a conexão com base de dados, sendo que o exemplo mostra uma conexão com o banco de dados MySQL. Se for usado outro banco, deve ser verificada a forma correta de conexão datasource com o banco ao qual se pretende conectar.
- <user-name> = usuário de acesso ao banco de dados.
- <password> = senha de acesso ao banco de dados.
Aviso |
---|
| Para garantir a integridade da base de dados que será acessada, é importante garantir que o usuário configurado para acesso ao banco seja criado com privilégios somente de leitura, garantindo assim que nenhum registro possa ser alterado. Após criado o datasource, salve o arquivo domain.xml, e reinicie o serviço do fluig para que o servidor de aplicação (Wildfly) consiga mapear a nova conexão criada. |
|