Test funzionali Java™
Scopri come scrivere test funzionali Java™ per AEM as a Cloud Service
Guida introduttiva ai test funzionali getting-started-functional-tests
Al momento della creazione di un nuovo archivio di codice in Cloud Manager, una cartella it.tests
viene creata automaticamente con esempi di test.
it.tests
di Cloud Manager, puoi anche generare la versione più recente utilizzando l’archetipo di progetto AEM.Una volta ottenuto il contenuto della cartella it.tests
, puoi utilizzarla come base per i test e quindi:
- Sviluppare esempi di test.
- Eseguire i test in locale.
- Salvare il codice nell’archivio di Cloud Manager ed eseguire una pipeline di Cloud Manager.
Scrittura di test funzionali personalizzati writing-functional-tests
Per scrivere test funzionali personalizzati è possibile utilizzare gli stessi strumenti impiegati da Adobe per la scrittura dei test funzionali del prodotto. Per la scrittura dei test, puoi consultare i test funzionali del prodotto in GitHub come esempio.
Il codice per i test funzionali personalizzati è il codice Java incluso nella cartella it.tests
del progetto. Deve produrre un unico JAR con tutti i test funzionali. Se la generazione produce più di un JAR di test, quello selezionato non è deterministico. Se non viene prodotto alcun JAR di test, il passaggio di test viene superato per impostazione predefinita. Per dei test di esempio,consulta la sezione Archetipo del progetto AEM.
I test vengono eseguiti su un’infrastruttura di test gestita da Adobe, che prevede almeno due istanze di authoring, due istanze di pubblicazione e una configurazione del Dispatcher. Questa configurazione significa che i test funzionali personalizzati vengono eseguiti sull’intero stack di AEM.
Struttura dei test funzionali functional-tests-structure
I test funzionali personalizzati devono essere inclusi come file JAR separati prodotti dalla stessa build Maven degli artefatti da distribuire in AEM. Generalmente, questa build è di un modulo Maven separato. Il file JAR risultante deve contenere tutte le dipendenze richieste e generalmente viene creato con il maven-assembly-plugin
utilizzando il descrittore jar-with-dependencies
.
Inoltre, l’intestazione del manifesto Cloud-Manager-TestType
del file JAR deve essere impostata su integration-test
.
Di seguito è riportata una configurazione di esempio per maven-assembly-plugin
.
<build>
<plugins>
<!-- Create self-contained jar with dependencies -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>3.1.0</version>
<configuration>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
<archive>
<manifestEntries>
<Cloud-Manager-TestType>integration-test</Cloud-Manager-TestType>
</manifestEntries>
</archive>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
All’interno di questo file JAR, i nomi delle classi dei test effettivi da eseguire devono terminare con IT
.
Ad esempio, una classe denominata com.myco.tests.aem.it.ExampleIT
verrebbe eseguita, mentre una denominata com.myco.tests.aem.it.ExampleTest
no.
Inoltre, per escludere il codice di test dal controllo di copertura dell’analisi del codice, il codice di test deve trovarsi all’interno di un pacchetto denominato it
(il filtro di esclusione della copertura è **/it/**/*.java
).
Le classi di test devono essere normali test JUnit. L’infrastruttura di test è progettata e configurata per la compatibilità con le convenzioni utilizzate dalla libreria di test aem-testing-clients
. Si consiglia ai team di sviluppo di utilizzare questa libreria e seguire le relative best practice.
Per ulteriori dettagli, consulta l’aem-testing-clients
archivio GitHub.
Prerequisiti prerequisites
- I test in Cloud Manager sono eseguiti utilizzando un utente amministratore tecnico.
- L'infrastruttura a contenitori per il test funzionale è limitata dai seguenti vincoli:
Dipendenze
- aem-cloud-testing-client:
Le modifiche imminenti nell'infrastruttura containerizzata utilizzata per eseguire i test funzionali richiederanno l'aggiornamento della libreria aem-cloud-testing-clients utilizzata nei test funzionali personalizzati almeno alla versione 1.2.1
Verificare che la dipendenza in it.tests/pom.xml
sia stata aggiornata.
<dependency>
<groupId>com.adobe.cq</groupId>
<artifactId>aem-cloud-testing-clients</artifactId>
<version>1.2.1</version>
</dependency>
Se non si aggiorna la libreria di dipendenze, si verificheranno errori di pipeline nel passaggio "Test funzionale personalizzato".
Esecuzione locale dei test local-test-execution
Prima di attivare i test funzionali in una pipeline di Cloud Manager, si consiglia di eseguirli localmente utilizzando SDK di AEM as a Cloud Service o un’istanza di AEM as a Cloud Service.
Esecuzione in un IDE running-in-an-ide
Poiché le classi di test sono test JUnit, possono essere eseguite da IDE Java principali come Eclipse, IntelliJ e NetBeans. Poiché i test funzionali del prodotto e i test funzionali personalizzati sono basati sulla stessa tecnologia, entrambi possono essere eseguiti a livello locale copiando i test del prodotto nei test personalizzati.
Tuttavia, durante l’esecuzione di questi test, è necessario impostare diverse proprietà di sistema previste dalla libreria aem-testing-clients
(e dalla libreria sottostante Sling Testing Client).
Le proprietà del sistema sono indicate di seguito.
sling.it.instances
2
2
sling.it.instance.url.1
http://localhost:4502
sling.it.instance.runmode.1
author
author
sling.it.instance.adminUser.1
admin
sling.it.instance.adminPassword.1
sling.it.instance.url.2
http://localhost:4503
sling.it.instance.runmode.2
publish
publish
sling.it.instance.adminUser.2
admin
sling.it.instance.adminPassword.2
Esecuzione di tutti i test con Maven using-maven
-
Apri una shell e passa alla cartella
it.tests
nell’archivio. -
Esegui il comando seguente fornendo i parametri necessari per avviare i test utilizzando Maven.
mvn verify -Plocal \
-Dit.author.url=https://author-<program-id>-<environment-id>.adobeaemcloud.com \
-Dit.author.user=<user> \
-Dit.author.password=<password> \
-Dit.publish.url=https://publish-<program-id>-<environment-id>.adobeaemcloud.com \
-Dit.publish.user=<user> \
-Dit.publish.password=<password>