请求指导：在AEM 6.3中使用OSGi R6注解实现ResourceChangeListener处理事件

嘿，我来帮你搞定在AEM 6.3里用OSGi R6注解实现ResourceChangeListener这件事！之前那个没得到解答的帖子我也留意到了，下面给你一套完整的实操指南，跟着走就能顺利实现~

一、先搞懂核心逻辑 #

ResourceChangeListener是Sling提供的服务，用来监听JCR资源的增删改事件；而OSGi R6注解可以让我们摆脱繁琐的XML配置，用注解直接完成服务注册和参数配置，AEM 6.3对R6注解是完全支持的。

二、第一步：配置Maven依赖 #

如果用Maven构建项目，确保你的pom.xml里包含以下核心依赖（版本根据你的AEM实例调整）：

<dependencies>
    <!-- AEM API依赖 -->
    <dependency>
        <groupId>com.adobe.aem</groupId>
        <artifactId>aem-api</artifactId>
        <version>6.3.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- OSGi R6组件注解依赖 -->
    <dependency>
        <groupId>org.osgi</groupId>
        <artifactId>osgi.cmpn</artifactId>
        <version>6.0.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- Sling资源API依赖 -->
    <dependency>
        <groupId>org.apache.sling</groupId>
        <artifactId>org.apache.sling.api</artifactId>
        <version>2.14.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

三、第二步：编写监听器核心代码 #

这是最关键的部分，直接上可运行的代码，每一步都给你标注清楚：

import org.apache.sling.api.resource.observation.ResourceChange;
import org.apache.sling.api.resource.observation.ResourceChangeListener;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Property;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.util.List;

// 用R6注解注册为ResourceChangeListener服务，immediate=true表示bundle激活后立即启动
@Component(service = ResourceChangeListener.class, immediate = true)
// 配置要监听的资源路径，支持数组配置多个路径，也可以用通配符（比如/content/my-site/**匹配所有后代节点）
@Property(name = ResourceChangeListener.PATHS, value = "/content/my-site", propertyPrivate = false)
// 配置要监听的事件类型：新增、修改、删除
@Property(name = ResourceChangeListener.CHANGES, value = {
        ResourceChange.Type.ADDED.name(),
        ResourceChange.Type.CHANGED.name(),
        ResourceChange.Type.REMOVED.name()
}, propertyPrivate = false)
public class MyCustomResourceChangeListener implements ResourceChangeListener {

    private static final Logger log = LoggerFactory.getLogger(MyCustomResourceChangeListener.class);

    // 核心方法：处理收到的资源变化事件
    @Override
    public void onChange(List<ResourceChange> changes) {
        // 遍历所有事件，逐个处理
        for (ResourceChange change : changes) {
            log.info("检测到资源变化：类型={}, 路径={}, 资源类型={}",
                    change.getType(), change.getPath(), change.getResourceType());
            
            // 根据事件类型分情况处理
            switch (change.getType()) {
                case ADDED:
                    handleAddedResource(change);
                    break;
                case CHANGED:
                    handleChangedResource(change);
                    break;
                case REMOVED:
                    handleRemovedResource(change);
                    break;
                default:
                    log.warn("不支持的资源变化类型：{}", change.getType());
            }
        }
    }

    // 处理资源新增事件的自定义逻辑
    private void handleAddedResource(ResourceChange change) {
        log.info("正在处理新增资源：{}", change.getPath());
        // 这里可以加你的业务逻辑：比如同步数据到外部系统、更新搜索索引等
    }

    // 处理资源修改事件的自定义逻辑
    private void handleChangedResource(ResourceChange change) {
        log.info("正在处理修改资源：{}", change.getPath());
        // 这里可以加你的业务逻辑：比如清除页面缓存、触发工作流等
    }

    // 处理资源删除事件的自定义逻辑
    private void handleRemovedResource(ResourceChange change) {
        log.info("正在处理删除资源：{}", change.getPath());
        // 这里可以加你的业务逻辑：比如删除关联的历史数据、清理索引等
    }
}

关键注解说明 #

• @Component(service = ResourceChangeListener.class)：把当前类注册为ResourceChangeListener类型的OSGi服务
• immediate = true：确保服务在bundle激活后立即启动，不会错过初始的资源变化事件
• @Property(name = ResourceChangeListener.PATHS)：指定要监听的资源路径，支持数组（比如value = {"/content/my-site", "/content/another-site"}）和通配符
• @Property(name = ResourceChangeListener.CHANGES)：指定要监听的事件类型，可选值对应ResourceChange.Type里的枚举

四、必看的注意事项 #

• 路径通配符规则：/content/my-site/*只匹配直接子节点，/content/my-site/**匹配所有后代节点
• 避免耗时操作：onChange方法是同步执行的，不要在这里做远程调用、大文件处理等耗时操作，建议用Sling Jobs或者Quartz转异步处理
• 权限问题：监听器默认以系统权限运行，但如果要操作资源，最好用系统用户的ResourceResolver，避免权限不足
• 事件去重：有时候会收到重复的事件，建议根据事件的getTimestamp()或者路径做去重处理

五、部署和测试 #

1. 把代码打包成OSGi bundle，部署到AEM 6.3实例
2. 打开CRXDE Lite，在/content/my-site下添加、修改或删除任意节点
3. 查看AEM的日志文件（比如crx-quickstart/logs/error.log），如果看到监听器输出的日志，就说明成功了！

内容的提问来源于stack exchange，提问作者Smrithi