test

Testes Backend - Addon Studio 2.0 (JUnit + Mockito)

Documento define como desenvolver testes automatizados backend Addon Studio 2.0 com libs de mercado.

Objetivo

• Garantir comportamento regras negocio.
• Permitir refator seguro.
• Reduzir regressao em servicos e mapeamentos.

Bibliotecas recomendadas

• JUnit 5 (org.junit.jupiter)
• Mockito 4.x (org.mockito) — usar 4.11.0. Projeto Java 8. Mockito 5.x exige Java 11+.
• AssertJ (assercoes fluentes)
• mockito-inline (mock estatico JapeSession, SessionFile etc.)

O que testar

Foque em logica de negocio isolada — classes de servico, regras em entidades, mapeamentos. Pular o que e framework / SDK.

Regra pratica:

• Testar unidade de negocio isolada.
• Nao testar framework Addon Studio em si.
• Nao acoplar teste unitario a banco real, Wildfly ou infra externa.
• Onde organizar arquivos de teste fica a criterio da arquitetura do projeto (convencao Maven/Gradle: espelhar pacote do src/main/java em src/test/java).

Padrao nome:

• Classe teste: <ClasseAlvo>Test
• Metodo teste: deve<Resultado>_quando<Condicao>()

Configuracao completa (Gradle)

1. build.gradle raiz — adicionar classpath do plugin de log visual

buildscript {
    repositories {
        // ... repositorios existentes ...
        maven {
            url = uri("https://plugins.gradle.org/m2/")
        }
    }

    dependencies {
        // ... dependencias existentes ...
        classpath "com.adarshr:gradle-test-logger-plugin:3.2.0"
    }
}

2. <modulo-backend>/build.gradle — dependencias e configuracao

apply plugin: 'com.adarshr.test-logger'

testlogger {
    theme 'mocha'
    showExceptions true
    showStackTraces true
    showFullStackTraces false
    showCauses true
    slowThreshold 2000
    showSummary true
    showPassed true
    showSkipped true
    showFailed true
    showStandardStreams false
    showPassedStandardStreams false
    showFailedStandardStreams true
    logLevel 'lifecycle'
}

dependencies {
    // SDK do Addon Studio no classpath de teste.
    // Obrigatorio: repositorios (ex.: TdcXyzCadastroRepository) estendem JapeRepository
    // do SDK da Sankhya, que so e disponibilizado para compilacao principal pelo
    // plugin Gradle do Studio. Sem isso, o compilador nao resolve findByPK/save nos testes.
    testImplementation 'br.com.sankhya.studio:sdk-sankhya:2+'

    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.10.2'
    testRuntimeOnly    'org.junit.jupiter:junit-jupiter-engine:5.10.2'

    // mockito-core 4.x: compativel com Java 8 (5.x exige Java 11+)
    testImplementation 'org.mockito:mockito-core:4.11.0'
    testImplementation 'org.mockito:mockito-junit-jupiter:4.11.0'

    // mockito-inline: necessario para mockar metodos estaticos (JapeSession, SessionFile etc.)
    testImplementation 'org.mockito:mockito-inline:4.11.0'

    testImplementation 'org.assertj:assertj-core:3.26.3'
}

test {
    useJUnitPlatform()
}