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

文章目录

前言

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

一、lazy_static介绍

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

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

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

rust 复制代码
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 库的基本操作示例:

rust 复制代码
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

yaml 复制代码
redis_path: "redis://127.0.0.1:6379/1"  #redis路径
http_web_addr: "0.0.0.0:6003"    #  s300server监听地址

引入依赖

rust 复制代码
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"

编写代码

rust 复制代码
//注意字段要匹配文件当中的
#[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);
}

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

相关推荐
我学上瘾了4 小时前
Spring Cloud的前世今生
后端·spring·spring cloud
波波0075 小时前
ASP.NET Core 健康检查实战:不只是一个 /health 接口
后端·asp.net
小码哥_常5 小时前
Spring Boot 搭建邮件发送系统:开启你的邮件自动化之旅
后端
石榴树下的七彩鱼6 小时前
图片修复 API 接入实战:网站如何自动去除图片水印(Python / PHP / C# 示例)
图像处理·后端·python·c#·php·api·图片去水印
我叫黑大帅6 小时前
为什么TCP是三次握手?
后端·网络协议·面试
我叫黑大帅6 小时前
如何排查 MySQL 慢查询
后端·sql·面试
techdashen6 小时前
Rust项目公开征测:Cargo 构建目录新布局方案
开发语言·后端·rust
消失的旧时光-19437 小时前
Spring Boot 实战(五):接口工程化升级(统一返回 + 异常处理 + 错误码体系 + 异常流转机制)
java·spring boot·后端·解耦
Rust研习社7 小时前
Rust 智能指针 Cell 与 RefCell 的内部可变性
开发语言·后端·rust
夕颜1117 小时前
Skill 机器人 vs Hermes Agent:两种「AI 越用越聪明」的路径
后端