【从零开始的rust web开发之路 五】rust语言lazy_static加serde_yaml实现读取外部yaml配置

文章目录

• 前言
• 一、lazy_static介绍
• 二、serde_yaml介绍
• 二、正文实战

前言

web开发离不开外部配置。之前一直用的java springboot开发web。rust有读取yaml的库，可以实现类似的效果

一、lazy_static介绍

lazy_static 是 Rust 语言中一个非常有用的第三方库，它的主要作用是允许开发者在程序中声明并初始化那些需要延迟求值（late initialization）的静态变量。在 Rust 中，通常情况下，静态变量（static）要求在编译时就能确定其值，并且一旦初始化后就不能更改。然而，有些场景下我们可能希望静态变量的初始化过程涉及到复杂的计算或者依赖于运行时环境，这在标准 Rust 中是不允许直接做到的。

lazy_static 宏提供了一种机制，使得我们可以定义这样的静态变量，它们会在第一次被访问时执行初始化逻辑，之后对所有线程可见并保持其初始值不变。这种行为类似于全局单例模式（Global Singleton），确保了初始化仅执行一次，同时解决了编译时不可知初始化值的问题。

下面是一个使用 lazy_static 库来声明和初始化可变静态变量的简单示例：

use lazy_static::lazy_static;

// 使用 lazy_static 宏声明一个可变的静态字符串
lazy_static! {
    static ref COMPLEX_STRING: String = {
        // 这个初始化表达式会在首次使用时执行
        let mut s = String::new();
        s.push_str("Hello, ");
        s.push_str("world!");
        s
    };
}

fn main() {
    // 第一次调用时会初始化 COMPLEX_STRING
    println!("{}", COMPLEX_STRING);
    // 后续调用时不再执行初始化逻辑，而是直接使用已初始化的值
    println!("{}", COMPLEX_STRING);
}

二、serde_yaml介绍

serde_yaml 是 Rust 语言中的一个第三方库，它基于强大的序列化和反序列化框架 Serde（Serialize/Deserialize），专门用于处理 YAML（YAML Ain't Markup Language）格式的数据。Serde 提供了一套泛化的数据结构序列化与反序列化的接口，而 serde_yaml 则是针对 YAML 格式实现的 Serde 的支持库。

YAML 是一种常用的数据序列化格式，以其可读性强、编写方便的特点在配置文件、数据交换等领域广泛应用。通过使用 serde_yaml 库，Rust 程序员可以轻松地将自定义的 Rust 数据结构转换为 YAML 字符串表示，或者从 YAML 字符串解析回对应的 Rust 数据结构。

以下是一些使用 serde_yaml 库的基本操作示例：

use serde::{Deserialize, Serialize};
use serde_yaml;

#[derive(Debug, Serialize, Deserialize)]
struct Person {
    name: String,
    age: u8,
    address: Address,
}

#[derive(Debug, Serialize, Deserialize)]
struct Address {
    street: String,
    city: String,
    zip: String,
}

fn main() {
    // 序列化：将 Rust 数据结构转换为 YAML 字符串
    let person = Person {
        name: "Alice".to_string(),
        age: 30,
        address: Address {
            street: "123 Main St.".to_string(),
            city: "Anytown".to_string(),
            zip: "12345".to_string(),
        },
    };

    let yaml_str = serde_yaml::to_string(&person).unwrap();
    println!("Serialized YAML: {}", yaml_str);

    // 反序列化：从 YAML 字符串解析回 Rust 数据结构
    let deserialized_person: Person = serde_yaml::from_str(yaml_str.as_str()).unwrap();
    println!("Deserialized Person: {:?}", deserialized_person);
}

二、正文实战

实现在项目文件夹下创建yaml格式的文件 config.yaml

redis_path: "redis://127.0.0.1:6379/1"  #redis路径
http_web_addr: "0.0.0.0:6003"    #  s300server监听地址

引入依赖

tokio = { version = "1.35.1", features = ["full"] }
axum = {version = "0.7.4",features = ["ws"]}
lazy_static = "1.4.0"
serde = { version = "1.0.195", features = ["derive"] }
serde_yaml = "0.9.30"

编写代码

//注意字段要匹配文件当中的
#[derive(Debug, Deserialize, Serialize)]
pub struct AppConfig {
    pub redis_path: String,
    pub http_web_addr: String,
}

lazy_static! {
    pub static ref APP_CONFIG: AppConfig = {
        let mut file = File::open("config.yaml").unwrap();
        let mut contents = String::new();
        file.read_to_string(&mut contents).unwrap();
        let config: AppConfig = serde_yaml::from_str(&contents).unwrap();
        println!("配置文件加载成功-------------");
        config
    };
}

#[tokio::main]
async  fn main() {
	println!("{}", APP_CONFIG.redis_path);
	println!("{}", APP_CONFIG.http_web_addr);
}

后续就可以在程序当中全局获取配置数据