Java™ Functional Testing

Senast uppdaterad: 9 oktober 2024
  • Gäller:
  • Experience Manager as a Cloud Service

Skapat för:

  • Administratör
  • Utvecklare

Lär dig skriva Java™-funktionstester för AEM as a Cloud Service

Komma igång med funktionstester

När en ny koddatabas skapas i Cloud Manager skapas en it.tests-mapp automatiskt med exempeltestfall.

OBSERVERA
Om din databas skapades innan Cloud Manager automatiskt skapade it.tests-mappar kan du även generera den senaste versionen med AEM Project Archetype.

När du har innehållet i mappen it.tests kan du använda den som grund för dina egna tester och sedan:

  1. Utveckla dina testfall.
  2. Kör testerna lokalt.
  3. Implementera koden i Cloud Manager-databasen och kör en Cloud Manager-pipeline.

Skriva anpassade funktionstester

Samma verktyg som Adobe använder för att skriva produktfunktionstester kan användas för att skriva dina anpassade funktionstester. Använd produktfunktionstesterna i GitHub som exempel på hur du skriver dina tester.

Koden för det anpassade funktionstestet är Java™-kod i mappen it.tests i ditt projekt. Den ska producera en enda JAR med alla funktionstester. Om bygget skapar mer än en test-JAR är den JAR som är vald icke-deterministisk. Om inga JAR-testversioner skapas godkänns teststeget som standard. Se AEM Project Archetype för exempel på tester.

Testerna körs på testinfrastruktur som underhålls av Adobe, inklusive minst två författarinstanser, två publiceringsinstanser och en Dispatcher-konfiguration. Detta innebär att dina anpassade funktionstester körs mot hela AEM.

Struktur för funktionstester

Anpassade funktionstester måste paketeras som en separat JAR-fil som skapas av samma Maven-bygge som de artefakter som ska distribueras till AEM. I allmänhet är detta bygge en separat Maven-modul. Den resulterande JAR-filen måste innehålla alla nödvändiga beroenden och skulle vanligtvis skapas med maven-assembly-plugin med hjälp av jar-with-dependencies-beskrivningen.

Dessutom måste JAR ha Cloud-Manager-TestType-manifesthuvudet inställt på integration-test.

Följande är ett exempel på konfiguration för 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>

I den här JAR-filen måste klassnamnen för de faktiska test som ska köras sluta med IT.

En klass med namnet com.myco.tests.aem.it.ExampleIT skulle till exempel köras, men inte en klass med namnet com.myco.tests.aem.it.ExampleTest.

Om du vill utesluta testkod från disponeringskontrollen för kodskanningen måste testkoden dessutom finnas under ett paket med namnet it (disponeringsfiltret är **/it/**/*.java).

Testklasserna ska vara normala JUnit-tester. Testinfrastrukturen är utformad och konfigurerad för att vara kompatibel med konventionerna som används av testbiblioteket aem-testing-clients. Utvecklare uppmuntras att använda det här biblioteket och följa sina bästa rutiner.

Mer information finns i aem-testing-clients GitHub-repo.

TIPS
Titta på den här videon om hur du kan använda anpassade funktionstester för att förbättra ditt förtroende för CI/CD-pipelines.