Java™ 功能测试

了解如何为 AEM as a Cloud Service 编写 Java™ 功能测试

功能测试快速入门 getting-started-functional-tests

在 Cloud Manager 中创建新的代码存储库后，系统会使用示例测试案例自动创建 it.tests 文件夹。

在 it.tests 文件夹中包含内容后，您可以基于该内容创建自己的测试，然后：

编写自定义功能测试 writing-functional-tests

Adobe 用来编写产品功能测试的工具也可以用来编写自定义功能测试。 使用 GitHub 中的产品功能测试作为如何编写测试的示例。

自定义功能测试的代码是位于 it.tests 文件夹中的 Java™ 代码。 它应该生成一个包含所有功能测试的 JAR。 如果构建生成多个测试 JAR，那么选择哪个 JAR 是不确定的。 如果它生成零个测试 JAR，则默认通过测试步骤。 有关样本测试，请参阅 AEM 项目原型。

测试在 Adobe 维护的测试基础设施上运行，其中包括至少两个作者实例、两个发布实例和一个 Dispatcher 配置。这种设置意味着您的自定义功能测试将针对整个 AEM 堆栈运行。

功能测试结构 functional-tests-structure

自定义功能测试必须打包为一个单独的 JAR 文件，该文件由与要部署到 AEM 的工件相同的 Maven 构建生成。 通常这种版本是一个单独的 Maven 模块。 生成的 JAR 文件必须包含所有必需的依赖项，通常使用 jar-with-dependencies 描述符的 maven-assembly-plugin 创建。

此外，JAR 必须将 Cloud-Manager-TestType 清单头设置为 integration-test。

以下是 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>

在这个 JAR 文件中，要执行的实际测试的类名必须以 IT 结尾。

例如，名为 com.myco.tests.aem.it.ExampleIT 类将被执行，但名为 com.myco.tests.aem.it.ExampleTest 的类将不会执行。

此外，要从代码扫描的覆盖率检查中排除测试代码，测试代码必须位于名为 it 的程序包下面（覆盖排除过滤器是 **/it/**/*.java）。

测试类必须是正常的 JUnit 测试。 测试基础设施的设计和配置与 aem-testing-clients 测试库使用的约定兼容。建议开发人员使用此库并遵循其最佳实践。

有关更多信息，请参阅aem-testing-clients GitHub repo。

前提条件 prerequisites

依赖项

即将对用于执行功能测试的容器化基础架构所做的更改将要求自定义功能测试中使用的库aem-cloud-testing-clients至少更新为版本​ 1.2.1
确保已更新it.tests/pom.xml中的依赖项。

<dependency>
   <groupId>com.adobe.cq</groupId>
   <artifactId>aem-cloud-testing-clients</artifactId>
   <version>1.2.1</version>
</dependency>

本地测试执行 local-test-execution

在 Cloud Manager 管道中激活功能测试之前，建议使用 AEM as a Cloud Service SDK 或实际的 AEM as a Cloud Service 实例本地运行功能测试。

在 IDE 中运行 running-in-an-ide

由于测试类是 JUnit 测试，因此，它们可以从主流 Java™ IDE（如 Eclipse、IntelliJ 和 NetBeans）运行。由于产品功能测试和自定义功能测试都基于相同的技术，因此可以通过将产品测试复制到自定义测试中来在本地运行这两个测试。

但是，在运行这些测试时，需要设置 aem-testing-clients（和底层 Sling 测试客户端）库所需的各种系统属性。

系统属性如下。

使用 Maven 运行所有测试 using-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>