引入 Karing 依赖

需要在项目中引入 Karing 的依赖，根据你的项目类型（Maven 或 Gradle），添加相应的依赖项。

Maven项目：

<dependency>
    <groupId>com.karing</groupId>
    <artifactId>karing</artifactId>
    <version>最新版本</version>
</dependency>

Gradle项目：

dependencies {
    implementation 'com.karing:karing:最新版本'
}

启用 Karing 配置

在你的主类或配置类中,启用 Karing 的配置支持，通常在 @Configuration 类上使用 @KaringConfiguration 注解。

import com.karing.configuration.KaringConfiguration;
@Configuration
@KaringConfiguration
public class ApplicationConfiguration {
    // 其他配置...
}

使用 Karing 配置文件

Karing 支持多种配置文件格式，如 properties、yaml、json 等，以下是如何在应用程序中使用这些文件的示例。

使用 Properties 文件

在 application.properties 中添加配置：

app.name=Karing Demo
app.version=1..
app.env=开发环境

在代码中使用：

import com.karing.configuration.annotations.Configuration;
import com.karing.configuration.annotations.Value;
@Configuration
public class ApplicationConfiguration {
    @Configuration("app")
    public class AppSettings {
        @Value("${app.name}")
        private String appName;
        @Value("${app.version}")
        private String appVersion;
        @Value("${app.env}")
        private String appEnv;
    }
}

使用 YAML 文件

在 application.yaml 中添加配置：

app:
  name: Karing Demo
  version: 1..
  env: 开发环境

在代码中使用：

import com.karing.configuration.annotations.Configuration;
import com.karing.configuration.annotations.Value;
@Configuration
public class ApplicationConfiguration {
    @Configuration("app")
    public class AppSettings {
        @Value("${app.name}")
        private String appName;
        @Value("${app.version}")
        private String appVersion;
        @Value("${app.env}")
        private String appEnv;
    }
}

配置文件环境相关配置

Karing 支持通过环境变量或外部参数动态配置，可以在 application.properties 中添加环境相关配置：

app.env=${ENVIRONMENT}

在代码中使用：

import com.karing.configuration.annotations.Value;
@Configuration
public class ApplicationConfiguration {
    @Configuration("app")
    public class AppSettings {
        @Value("${app.env}")
        private String appEnv;
    }
}

使用 Karing API

除了通过注解加载配置文件,Karing 还提供了丰富的 API 来获取配置值，以下是如何通过 API 获取配置的示例：

import com.karing.configuration.api.KaringConfig;
// 获取配置值
String appName = KaringConfig.get("app.name");
// 获取配置文件路径
String configPath = KaringConfig.getConfigurationPath();
// 获取配置文件内容
String configContent = KaringConfig.getConfigurationContent();

多个配置文件的加载

Karing 支持多个配置文件的合并加载，你可以在 application.properties 中指定多个配置文件路径：

karing.configs=app1.properties,app2.yaml,app3.json

版本控制配置

Karing 支持 Git 提供的环境变量（如 GIT_BRANCH、GIT_COMMIT_ID 等）和其他版本控制工具集成，你可以在配置文件中添加自定义逻辑来处理版本信息。

高级配置管理

Karing 提供了多种高级功能，如配置文件的继承、配置文件的合并、动态配置更新等，你可以参考 Karing 的官方文档或示例项目来了解更多用法。

安全配置

为了确保配置文件的安全性,Karing 提供了多种方法来保护敏感配置信息，你可以选择使用加密或环境变量来加载敏感配置。

通过以上步骤,你可以轻松地使用 Karing 来管理和配置你的 Spring Boot 应用程序，Karing 提供了灵活且强大的配置管理功能，能够满足不同项目的需求。