docs/versioned_docs/version-2.17/developer-guide/plugin/api-reference/server/setting-fetcher.md

title	description
获取插件配置	了解如何获取插件定义的设置表单对应的配置数据，以及如何在插件中使用配置数据。

插件的 plugin.yaml 中允许配置 settingName 和 configMapName 字段，用于定义插件的个性化设置。 本文介绍如何获取插件定义的设置表单对应的配置数据，以及如何在插件中使用配置数据。

概述

Halo 提供了两个 Bean 用于获取插件配置数据：SettingFetcher 和 ReactiveSettingFetcher，分别用于同步和异步获取配置数据。

以 ReactiveSettingFetcher 为例，提供了以下方法：

public interface ReactiveSettingFetcher {

    <T> Mono<T> fetch(String group, Class<T> clazz);

    @NonNull
    Mono<JsonNode> get(String group);

    @NonNull
    Mono<Map<String, JsonNode>> getValues();
}

• fetch 方法用于获取指定分组的配置数据，并将其转换为指定的 Java 类型。
• get 方法用于获取指定分组的配置数据，返回 JsonNode 类型。
• getValues 方法用于获取所有配置数据，返回 Map<String, JsonNode> 类型，其中键为分组名称，值为配置对象。

ReactiveSettingFetcher 和 SettingFetcher 底层都对配置数据进行了缓存，以提高性能，并且在配置变更时会自动刷新缓存，所以直接调用这些方法即可获取最新的配置数据。

监听配置变更

当用户修改插件配置时，可以通过监听 PluginConfigUpdatedEvent 事件，执行相应的操作。PluginConfigUpdatedEvent 包含了配置变更前后的数据，使插件能够对变化做出响应。

public class PluginConfigUpdatedEvent extends ApplicationEvent {
    private final Map<String, JsonNode> oldConfig;
    private final Map<String, JsonNode> newConfig;

    // ...
}

使用示例

定义设置表单

假设插件定义了一个名为 setting-seo 的设置表单，其中包含了 blockSpiders、keywords 和 description 三个字段：

apiVersion: v1alpha1
kind: Setting
metadata:
  name: setting-seo
spec:
  forms:
    - group: seo  
      label: SEO 设置  
      formSchema:  
        - $formkit: checkbox  
          name: blockSpiders  
          label: "屏蔽搜索引擎"  
          value: false  
        - $formkit: textarea  
          name: keywords  
          label: "站点关键词"  
        - $formkit: textarea  
          name: description  
          label: "站点描述"

配置 plugin.yaml

在 plugin.yaml 中配置 settingName 和 configMapName 字段：

apiVersion: plugin.halo.run/v1alpha1
kind: Plugin
metadata:
  name: fake-plugin
spec:
  displayName: "Fake Plugin"
  # ...
  configMapName: setting-seo-configmap
  settingName: setting-seo

定义值类

为了方便使用，定义一个值类存储配置数据：

public record SeoSetting(boolean blockSpiders, String keywords, String description) {
  public static final String GROUP = "seo";
}

获取配置数据

通过依赖注入 ReactiveSettingFetcher 并使用 fetch(group, type) 方法查询配置：

@Service
@RequiredArgsConstructor
public class SeoService {
    private final ReactiveSettingFetcher settingFetcher;

    public Mono<Void> checkSeo() {
        return settingFetcher.fetch(SeoSetting.GROUP, SeoSetting.class)
                .doOnNext(seoSetting -> {
                    if (seoSetting.blockSpiders()) {
                        // do something
                    }
                })
                .then();
    }
}

监听配置变更

通过监听 PluginConfigUpdatedEvent 事件来处理配置变更：

@Component
public class SeoConfigListener {
    @EventListener
    public void onConfigUpdated(PluginConfigUpdatedEvent event) {
        if (event.getNewConfig().containsKey(SeoSetting.GROUP)) {
            // do something
        }
    }
}

通过以上示例，可以看到如何使用 ReactiveSettingFetcher 获取配置数据，并通过监听 PluginConfigUpdatedEvent 来处理配置变更事件，确保系统能及时响应配置的变化。