Apache Sling Testing PaxExam 指南

1. 项目目录结构及介绍

在Apache Sling Testing PaxExam项目中，主要的源代码位于src/main/java目录下，其中org.apache.sling.testing.paxexam包包含了核心测试支持类。项目的目录结构大致如下：

.
├── pom.xml        // Maven 构建文件
└── src
    └── main
        └── java
            └── org
                └── apache
                    └── sling
                        └── testing
                            └── paxexam
                                ├── TestSupport.java      // 主要的测试支持类
                                ...

TestSupport.java是关键文件，它提供了一套用于在Pax Exam环境中进行Sling集成测试的支持。

2. 项目的启动文件介绍

由于该项目是一个库，没有独立的可执行文件。启动测试通常是在其他依赖于Apache Sling Testing PaxExam的项目中通过运行Maven或类似的构建工具来实现。例如，在一个使用这个库进行集成测试的Sling应用中，你会创建一个JUnit测试类并继承自TestSupport，然后调用相关方法来配置和启动Sling实例。

以下是一个简化版的测试类示例：

import org.apache.sling.testing.paxexam.TestSupport;

public class MySlingIntegrationTest extends TestSupport {

    @Override
    protected void setUp() throws Exception {
        super.setUp();
        // 在这里添加特定的测试设置
    }

    @Override
    protected void tearDown() throws Exception {
        super.tearDown();
        // 清理工作
    }

    @Test
    public void myTest() {
        // 进行实际的测试
    }
}

setUp()和tearDown()方法会被Pax Exam自动调用以准备和清理测试环境。

3. 项目的配置文件介绍

Apache Sling Testing PaxExam项目本身并不包含特定的配置文件，因为它是一个库，它的配置主要发生在使用它的项目中。配置通常包括定义Pax Exam选项（如Karaf特征、系统属性等）以及在测试类中设定Sling的启动参数。

例如，你可以使用以下Maven插件配置Pax Exam运行时的行为：

<build>
    <plugins>
        <plugin>
            <groupId>org.ops4j.pax.exam</groupId>
            <artifactId>maven-paxexam-plugin</artifactId>
            <version>${pax.exam.version}</version>
            <configuration>
                <!-- 配置你的选项 -->
                <options>
                    <option>
                        <name>bootDelegationPackages</name>
                        <value>com.example.packagetoinclude</value>
                    </option>
                </options>
            </configuration>
        </plugin>
    </plugins>
</build>

或者，在测试类中通过重写configureExamContainer方法来定制容器配置：

@Override
protected Option[] configure() {
    return options(
        karafFeature("sling", "your.sling.feature.version"),
        systemProperty("sling.launchpad").value("path/to/launchpad")
    );
}

这些配置将决定如何启动Sling实例以及它的行为。

请注意，上述代码示例仅作为概念性说明，你需要根据具体需求调整配置。完整的配置选项和用法应参照官方文档。