Trong phát triển Java doanh nghiệp, độ phủ kiểm thử là chỉ số then chốt đánh giá chất lượng mã nguồn. Dự án ballcat — một khung khởi tạo nhanh cho hệ thống quản trị nền tảng — hỗ trợ nhiều tính năng như phân quyền người dùng, bảo mật dữ liệu, ghi nhật ký, chống XSS và SQL injection. Để đảm bảo độ tin cậy của các thành phần này, việc tích hợp công cụ đo lường độ phủ mã nguồn JaCoCo (Java Code Coverage) là bước thiết yếu.

1. Tính tương thích giữa JaCoCo và kiến trúc ballcat

ballcat được xây dựng theo mô hình đa module (như security, datascope, api-signature...), cho phép áp dụng phân tích độ phủ độc lập trên từng thành phần. JaCoCo hoạt động bằng cách theo dõi luồng thực thi bytecode trong JVM, cung cấp các chỉ số chính xác như:

• Độ phủ dòng lệnh (Line Coverage)
• Độ phủ nhánh điều kiện (Branch Coverage)
• Độ phủ phương thức (Method Coverage)
• Độ phủ lớp (Class Coverage)

Công cụ này tích hợp mượt với Maven thông qua plugin jacoco-maven-plugin và xuất báo cáo HTML trực quan.

2. Cấu hình tích hợp JaCoCo vào ballcat

2.1 Cấu hình toàn cục tại POM cha

Thêm đoạn sau vào pom.xml gốc để kích hoạt JaCoCo trên toàn bộ dự án:

<build>
  <plugins>
    <plugin>
      <groupId>org.jacoco</groupId>
      <artifactId>jacoco-maven-plugin</artifactId>
      <version>0.8.10</version>
      <executions>
        <execution>
          <goals><goal>prepare-agent</goal></goals>
        </execution>
        <execution>
          <id>generate-report</id>
          <phase>test</phase>
          <goals><goal>report</goal></goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

2.2 Tùy chỉnh theo module con

Với các module cần loại trừ mã không cần kiểm thử (entity, config...), thêm cấu hình riêng:

<plugin>
  <groupId>org.jacoco</groupId>
  <artifactId>jacoco-maven-plugin</artifactId>
  <configuration>
    <excludes>
      <exclude>**/config/**/*.class</exclude>
      <exclude>**/model/**/*.class</exclude>
      <exclude>**/dto/**/*.class</exclude>
    </excludes>
  </configuration>
</plugin>

3. Tạo và xem báo cáo độ phủ

3.1 Lệnh thực thi

Chạy lệnh sau tại thư mục gốc:

mvn clean test jacoco:report

3.2 Vị trí báo cáo

Báo cáo HTML được sinh ra tại:

• common/ballcat-common-core/target/site/jacoco/index.html
• security/ballcat-security-core/target/site/jacoco/index.html
• api-signature/ballcat-spring-boot-starter-apisignature/target/site/jacoco/index.html

4. Phân tích báo cáo JaCoCo

Các chỉ số cần theo dõi:

• Line Coverage: Phần trăm dòng mã được thực thi
• Branch Coverage: Tỷ lệ nhánh điều kiện (if/else, switch) được kiểm thử

Ưu tiên cải thiện độ phủ ở các module then chốt:

• Xác thực và phân quyền (ballcat-security-core)
• Lọc dữ liệu theo phạm vi (ballcat-spring-boot-starter-datascope)
• Xác minh chữ ký API (ballcat-spring-boot-starter-apisignature)

5. Chiến lược nâng cao độ phủ kiểm thử

5.1 Tăng cường kiểm thử đơn vị

• Viết test tham số hóa cho các utility class
• Dùng Mockito để mock service phụ thuộc
• Bổ sung test case cho luồng xử lý ngoại lệ

5.2 Bổ sung kiểm thử tích hợp

Đối với logic liên quan database hoặc transaction:

@SpringBootTest
class DataScopeIntegrationTest {

    @Autowired
    private DataScopeService dataScopeService;

    @Test
    void shouldApplyTenantFilterCorrectly() {
        // Kiểm thử logic lọc dữ liệu theo tenant
    }
}

5.3 Tích hợp vào CI/CD

Trong file .gitlab-ci.yml:

coverage-check:
  script:
    - mvn clean verify jacoco:report
  artifacts:
    paths:
      - "*/target/site/jacoco/"

6. Xử lý sự cố thường gặp

6.1 Báo cáo trống

Kiểm tra lại đã chạy lệnh có chứa phase test và plugin đã khai báo goal prepare-agent.

6.2 Mã bên thứ ba bị tính vào độ phủ

Loại trừ bằng cấu hình:

<excludes>
  <exclude>**/springframework/**/*.class</exclude>
  <exclude>**/mybatis/**/*.class</exclude>
</excludes>

6.3 Độ phủ nhánh thấp

• Viết đủ test case cho mọi nhánh điều kiện
• Giảm độ phức tạp vòng lặp bằng cách tách hàm
• Sử dụng @ParameterizedTest trong JUnit 5

7. Thực hành tốt nhất

• Đặt mục tiêu: ≥80% cho logic nghiệp vụ, ≥90% cho utility class
• Kiểm tra độ phủ tăng dần bằng goal jacoco:check
• Xem xét báo cáo trong quá trình review code
• Kết hợp với SonarQube để giám sát toàn diện chất lượng mã