Cấu hình Datasource sử dụng WildFly Maven Plugin

JBoss WildFly sử dụng Java JNDI để cấu hình thông tin Datasource, giúp cho các ứng dụng được deploy có thể sử dụng thông tin Datasource này để connect và làm việc với database. Nếu các bạn sử dụng JBoss WildFly standalone thì có thể cấu hình thông tin Datasource này trong tập tin standalone.xml của JBoss WildFly. Còn nếu các bạn sử dụng WildFly Maven Plugin trong quá trình development thì sẽ cấu hình thông tin Datasource này như thế nào? Chúng ta sẽ cùng nhau tìm hiểu trong bài viết này các bạn nhé!

Trước khi đi vào cấu hình Datasource, các bạn cần làm thêm một bước, đó là: để xem được thông tin Datasource đã được cấu hình trong JBoss WildFly server hay chưa, sử dụng Management Console, các bạn hãy cấu hình thông tin user cho WildFly Maven Plugin trước nhé. Ví dụ của mình như sau:

<plugin>
  <groupId>org.wildfly.plugins</groupId>
  <artifactId>wildfly-maven-plugin</artifactId>
  <version>4.2.1.Final</version>
  <configuration>
    <version>27.0.1.Final</version>
    <add-user>
      <users>
        <user>
          <username>khanh</username>
          <password>123456</password>
        </user>
      </users>
    </add-user>
  </configuration>
</plugin>

<groupId>org.wildfly.plugins</groupId>

<artifactId>wildfly-maven-plugin</artifactId>

<version>4.2.1.Final</version>

<version>27.0.1.Final</version>

<add-user>

<users>

<user>

<username>khanh</username>

</user>

</users>

</add-user>

</configuration>

</plugin>

Bây giờ, chúng ta sẽ bắt đầu cấu hình Datasource các bạn nhé!

Đầu tiên, chúng ta cần phải thêm JDBC Driver cho database mà ứng dụng của các bạn sẽ sử dụng vào JBoss WildFly trước.

Trong ví dụ này, mình sẽ sử dụng PostgreSQL database nha các bạn!

Để làm được điều này, chúng ta sẽ cần phải khai báo dependency cho JDBC Driver của database mà các bạn sẽ sử dụng trong project. Mình sẽ khai báo PostgreSQL JDBC Driver như sau:

<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>42.7.0</version>
</dependency>

<groupId>org.postgresql</groupId>

<artifactId>postgresql</artifactId>

</dependency>

Tiếp theo, chúng ta sẽ sử dụng goal “deploy-artifact” của WildFly Maven Plugin để thêm JDBC Driver vào JBoss WildFly như sau:

<plugin>
  <groupId>org.wildfly.plugins</groupId>
  <artifactId>wildfly-maven-plugin</artifactId>
  <version>4.2.1.Final</version>
  <configuration>
    <version>27.0.1.Final</version>
    <add-user>
      <users>
        <user>
          <username>khanh</username>
          <password>123456</password>
        </user>
      </users>
    </add-user>
  </configuration>

  <executions>
    <execution>
      <id>deploy-driver</id>
      <phase>install</phase>
      <configuration>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <name>postgresql.jar</name>
      </configuration>
      <goals>
        <goal>deploy-artifact</goal>
      </goals>
    </execution>
  </executions>
</plugin>

<groupId>org.wildfly.plugins</groupId>

<artifactId>wildfly-maven-plugin</artifactId>

<version>4.2.1.Final</version>

<version>27.0.1.Final</version>

<add-user>

<users>

<user>

<username>khanh</username>

</user>

</users>

</add-user>

</configuration>

<id>deploy-driver</id>

<phase>install</phase>

<groupId>org.postgresql</groupId>

<artifactId>postgresql</artifactId>

<name>postgresql.jar</name>

</configuration>

<goals>

<goal>deploy-artifact</goal>

</goals>

</execution>

</executions>

</plugin>

Chúng ta chỉ cần khai báo groupId và artifactId của JDBC Driver, không cần version nha các bạn! Goal “deploy-artifact” của WildFly Maven Plugin sẽ được thực thi ở phase “install”, có nghĩa là khi các bạn chạy “mvn install” đó các bạn!

Bây giờ thì chúng ta đã có thể sử dụng goal “add-resource” của WildFly Maven Plugin để thêm datasource vào JBoss WildFly.

Các bạn có thể thêm mới một execution như sau:

<execution>
  <id>add-datasource</id>
  <phase>install</phase>
  <configuration>
    <address>subsystem=datasources,data-source=huongdanjavaDatasource</address>
    <resources>
      <resource>
        <properties>
          <connection-url>jdbc:postgresql://localhost/example</connection-url>
          <jndi-name>java:/huongdanjavaDatasource</jndi-name>
          <enabled>true</enabled>
          <user-name>postgres</user-name>
          <password>123456</password>
          <driver-name>postgresql.jar</driver-name>
          <use-ccm>false</use-ccm>
        </properties>
      </resource>
    </resources>
  </configuration>
  <goals>
    <goal>add-resource</goal>
  </goals>
</execution>

<id>add-datasource</id>

<phase>install</phase>

<address>subsystem=datasources,data-source=huongdanjavaDatasource</address>

<connection-url>jdbc:postgresql://localhost/example</connection-url>

<jndi-name>java:/huongdanjavaDatasource</jndi-name>

<user-name>postgres</user-name>

<driver-name>postgresql.jar</driver-name>

<use-ccm>false</use-ccm>

</properties>

</resource>

</resources>

</configuration>

<goals>

<goal>add-resource</goal>

</goals>

</execution>

Thông tin trong tag <address> sẽ giúp chúng ta nói cho WildFly Maven Plugin biết rằng, chúng ta cần thêm vào subsystem “datasources”, một datasource mới, với thông tin về database được cấu hình trong tag <properties>.

Tag <driver-name> thì các bạn khai báo tên driver mà chúng ta đã cấu hình ở trên. Tag <use-ccm> thì liên quan đến tính năng Cache Connection Manager của JBoss WildFly. Thông tin datasource này, các ứng dụng có thể sử dụng thông qua JNDI nha các bạn!

Các bạn có thể khai báo sử dụng goal “deploy” của WildFly Maven Plugin để deploy ứng dụng lúc chạy command “mvn install” luôn cũng được. Ví dụ như sau:

<execution>
  <id>deploy</id>
  <phase>install</phase>
  <goals>
      <goal>deploy</goal>
  </goals>
</execution>

<id>deploy</id>

<phase>install</phase>

<goals>

<goal>deploy</goal>

</goals>

</execution>

Đến đây là chúng ta đã hoàn thành việc cấu hình Datasource sử dụng WildFly Maven Plugin rồi đó các bạn!

Bây giờ, các bạn có thể chạy ứng dụng với command:

mvn clean wildfly:start install -f pom.xml

1	mvn clean wildfly:start install -f pom.xml

Chúng ta cần execute goal “wildfly:start” để start một JBoss WildFly trước các bạn nhé. Bởi vì phải có JBoss WildFly server start trước thì chúng ta mới có thể thêm JDBC Driver và cấu hình datasource được.

Sau khi command Maven chạy xong, đi đến trang Management Console của JBoss WildFly ở địa chỉ http://localhost:9990/, rồi đi đến phần Configuration, kiểm tra Subsystems -> Datasources & JDBC Drivers, các bạn sẽ thấy kết quả như sau:

JDBC Drivers: