Testing

Overview

JSIFEN uses Quarkus testing framework with JUnit 5 and REST Assured for comprehensive testing coverage. The project includes unit tests and integration tests.

Running Tests

Execute all tests using Gradle:

./gradlew test

The test configuration outputs detailed logs for passed, skipped, and failed tests.

Test Configuration

From build.gradle:39-44:

test {
    systemProperty "java.util.logging.manager", "org.jboss.logmanager.LogManager"
    testLogging {
        events "passed", "skipped", "failed", "standardOut", "standardError"
    }
}

Test Dependencies

The project uses these testing libraries:

testImplementation 'io.quarkus:quarkus-junit5'
testImplementation 'io.rest-assured:rest-assured'

Integration Tests

QuarkusTest Annotation

All integration tests use the @QuarkusTest annotation to start the Quarkus application:

@QuarkusTest
public class ConsultaRucResourceTest {
    
    @Inject
    ConsultarRucUseCase consultarRucUseCase;
    
    @Test
    void testRucExistente() {
        JsonObject response = consultarRucUseCase.execute("3437941");
        assertNotNull(response);
        assertTrue(response.containsKey("datosRUC"));
        System.out.println("RUC existente: " + response);
    }
}

From ConsultaRucResourceTest.java:12-24

Testing Use Cases

Test use cases directly by injecting them:

@Inject
ConsultarRucUseCase consultarRucUseCase;

@Test
public void testInyeccionDependencias() {
    // Verify dependency injection works
    assertNotNull(consultarRucUseCase);
}

From ConsultaRucResourceTest.java:51-54

Testing Patterns

RUC Query Tests

Test different RUC scenarios:

@Test
void testRucExistente() {
    JsonObject response = consultarRucUseCase.execute("3437941");
    assertNotNull(response);
    assertTrue(response.containsKey("datosRUC"));
    System.out.println("RUC existente: " + response);
}

@Test
void testRucNoExistente() {
    JsonObject response = consultarRucUseCase.execute("100000");
    assertNotNull(response);
    assertTrue(response.containsKey("datosRUC"));
    System.out.println("RUC no existe: " + response);
}

@Test
void testRucInvalido() {
    JsonObject response = consultarRucUseCase.execute("0");
    assertNotNull(response);
    assertTrue(response.containsKey("error") || response.containsKey("statusCode"));
    System.out.println("RUC inválido: " + response);
}

@Test
void testRucNull() {
    JsonObject response = consultarRucUseCase.execute(null);
    assertNotNull(response);
    System.out.println("RUC null: " + response);
}

From ConsultaRucResourceTest.java:18-47

Invoice Processing Tests

Test invoice submission with complete JSON data:

@QuarkusTest
public class AsyncRecibeResourceTest {
    
    private static final String FACTURA_JSON = """
    {
        "iTipEmi":1,
        "dDesTipEmi":"Normal",
        "dCodSeg":"106381931",
        "iTiDE":1,
        "dDesTiDE":"Factura electrónica",
        "dNumTim":16693341,
        "dEst":"001",
        "dPunExp":"002",
        "dNumDoc":"0000090",
        // ... more fields
        "Detalles":[
            {
                "dCodInt":"6016",
                "dDesProSer":"MERCADERIAS VARIOS 10%",
                "cUniMed":"77",
                "dDesUniMed":"UNI",
                "dCantProSer":"1.0",
                "dPUniProSer":"1000.0",
                // ... more fields
            }
        ]
    }
    """;
    
    @Inject
    RecibirFacturaUseCase recibirFacturaUseCase;
    
    @Test
    void testdeintegracion() throws Exception {
        JsonObject jsonObject = Json.createReader(new StringReader(FACTURA_JSON))
            .readObject();
        JsonObject jsonResponse = recibirFacturaUseCase.execute(jsonObject);
        
        System.out.println(jsonResponse);
    }
}

From AsyncRecibeResourceTest.java:16-129

SOAP Client Tests

Test SOAP client connectivity:

@QuarkusTest
public class RucClientTest {
    
    @Inject
    RucClient rucClient;
    
    @Test
    public void testConsultaRUC() {
        String ruc = "3437941";
        HttpResponse<String> httpResponse = rucClient.consultaRUC(ruc);
        
        System.out.println("Código de estado: " + httpResponse.statusCode());
        System.out.println("Cuerpo de la respuesta:");
        System.out.println(httpResponse.body());
    }
}

From RucClientTest.java:11-27

Mocking SIFEN Services

Integration tests make real calls to SIFEN services. Ensure you have valid credentials configured in sifen.properties before running tests.

For unit tests that should not call external services, you can mock the SIFEN clients:

// Example of mocking a SIFEN client
@InjectMock
RucClient rucClient;

@Test
void testWithMock() {
    // Setup mock behavior
    when(rucClient.consultaRUC(anyString()))
        .thenReturn(mockHttpResponse);
    
    // Test your code
    JsonObject response = consultarRucUseCase.execute("123456");
    
    // Verify
    verify(rucClient).consultaRUC("123456");
}

Test Structure

The test directory mirrors the source structure:

src/test/java/com/jsifen/
├── presentacion/rest/          # REST endpoint tests
│   ├── ConsultaRucResourceTest.java
│   ├── ConsultaLoteResourceTest.java
│   ├── ConsultaDEResourceTest.java
│   └── AsyncRecibeResourceTest.java
├── infrastructure/
│   ├── adapter/                # Repository implementation tests
│   ├── config/                 # Configuration tests
│   ├── soap/                   # SOAP client tests
│   ├── time/                   # NTP client tests
│   └── util/                   # Utility tests

Testing Best Practices

Use @QuarkusTest - Ensures proper dependency injection and configuration
Test all error cases - Include tests for invalid input, null values, and error responses
Print responses - Use System.out.println() for debugging during development
Assert non-null - Always verify responses are not null
Test JSON structure - Verify expected fields exist in responses
Test integration - Include end-to-end tests that call real SIFEN services
Mock external services - For unit tests, mock SOAP clients to avoid external dependencies

Running Specific Tests

Run a specific test class:

./gradlew test --tests ConsultaRucResourceTest

Run a specific test method:

./gradlew test --tests ConsultaRucResourceTest.testRucExistente

Continuous Testing

Run tests in continuous mode during development:

./gradlew test --continuous

Or use Quarkus dev mode which includes automatic test execution:

./gradlew quarkusDev

Test Reports

Test reports are generated in:

build/reports/tests/test/index.html

Open this file in a browser to view detailed test results.

Debugging Tests

Add -Dquarkus.log.level=DEBUG for verbose logging
Use IntelliJ IDEA or VSCode debug mode
Add breakpoints in test methods
Check test output in console for detailed errors
Review SOAP request/response XML in logs

Get Started

Configuration

Architecture

Guides

Overview

Running Tests

Test Configuration

Test Dependencies

Integration Tests

QuarkusTest Annotation

Testing Use Cases

Testing Patterns

RUC Query Tests

Invoice Processing Tests

SOAP Client Tests

Mocking SIFEN Services

Test Structure

Testing Best Practices

Running Specific Tests

Continuous Testing

Test Reports

Debugging Tests

Build docs developers (and LLMs) love

Get Started

Configuration

Architecture

Guides

​Overview

​Running Tests

​Test Configuration

​Test Dependencies

​Integration Tests

​QuarkusTest Annotation

​Testing Use Cases

​Testing Patterns

​RUC Query Tests

​Invoice Processing Tests

​SOAP Client Tests

​Mocking SIFEN Services

​Test Structure

​Testing Best Practices

​Running Specific Tests

​Continuous Testing

​Test Reports

​Debugging Tests

Build docs developers (and LLMs) love

Overview

Running Tests

Test Configuration

Test Dependencies

Integration Tests

QuarkusTest Annotation

Testing Use Cases

Testing Patterns

RUC Query Tests

Invoice Processing Tests

SOAP Client Tests

Mocking SIFEN Services

Test Structure

Testing Best Practices

Running Specific Tests

Continuous Testing

Test Reports

Debugging Tests