# os-core-nacos

**Repository Path**: os-core/os-core-nacos

## Basic Information

- **Project Name**: os-core-nacos
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-18
- **Last Updated**: 2025-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 使用说明

### 概述

此 SDK 提供了与 Nacos 集成的便捷方式，包含了配置管理和服务发现功能。通过集成该 SDK，可以轻松地在 Spring Boot 应用中使用 Nacos 进行配置管理和服务注册与发现。

### 特性

#### Nacos 配置管理
- 通过 `nacos-config` 轻松管理配置
- 支持动态刷新配置项

#### Nacos 服务发现
- 通过 `nacos-discovery` 进行服务注册与发现
- 支持健康检查与负载均衡

### 快速开始

#### 1. 添加依赖

确保在您的项目 `pom.xml` 文件中包含以下依赖项：

```xml
<dependencies>
    <!-- os-core-nacos -->
    <dependency>
        <groupId>com.evision.os</groupId>
        <artifactId>os-core-nacos</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
</dependencies>
```

#### 2. 配置 Nacos

在应用的配置文件中（如 `application.properties`），添加 Nacos 的相关配置：

```properties
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.server-addr=127.0.0.1:8848
spring.cloud.nacos.config.file-extension=properties
```

#### 3. 使用 Nacos 配置管理

通过 `@RefreshScope` 注解，可以让 Spring Bean 支持动态刷新配置：

```java
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.beans.factory.annotation.Value;

@RestController
@RefreshScope
public class ConfigController {
    @Value("${example.property}")
    private String exampleProperty;

    @GetMapping("/property")
    public String getProperty() {
        return exampleProperty;
    }
}
```

#### 4. 服务注册与发现

确保您的应用可以注册到 Nacos 注册中心，并发现其他服务。可以在主类中添加以下注解：

```java
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@EnableDiscoveryClient
@SpringBootApplication
public class NacosApplication {
    public static void main(String[] args) {
        SpringApplication.run(NacosApplication.class, args);
    }
}
```

### 运行应用程序

完成上述配置后，您可以运行 Spring Boot 应用程序。应用启动后，将会自动注册到 Nacos 服务中心，同时从 Nacos 配置中心获取配置。这将有助于您在分布式环境中实现服务治理和配置管理。