Rust-RDKafka 项目教程

Rust-RDKafka 项目教程

rust-rdkafkaA fully asynchronous, futures-based Kafka client library for Rust based on librdkafka项目地址:https://gitcode.com/gh_mirrors/ru/rust-rdkafka

1. 项目的目录结构及介绍

Rust-RDKafka 项目的目录结构如下：

rust-rdkafka/
├── examples/
│   └── simple_consumer.rs
├── rdkafka-sys/
│   └── ...
├── src/
│   └── ...
├── tests/
│   └── ...
├── .gitattributes
├── .gitignore
├── .gitmodules
├── CONTRIBUTING.md
├── Cargo.lock
├── Cargo.toml
├── Dockerfile
├── LICENSE
├── README.md
├── changelog.md
├── coverage.sh
├── docker-compose.yaml
├── generate_readme.py
├── rdkafka.suppressions
├── readme_template
└── test_suite.sh

目录结构介绍

• examples/: 包含项目的示例代码，如 simple_consumer.rs。
• rdkafka-sys/: 包含与底层 C 库 librdkafka 交互的 Rust 绑定。
• src/: 包含项目的主要源代码。
• tests/: 包含项目的测试代码。
• .gitattributes, .gitignore, .gitmodules: Git 配置文件。
• CONTRIBUTING.md: 贡献指南。
• Cargo.lock, Cargo.toml: Rust 包管理文件。
• Dockerfile: Docker 配置文件。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• changelog.md: 变更日志。
• coverage.sh: 代码覆盖率脚本。
• docker-compose.yaml: Docker Compose 配置文件。
• generate_readme.py: 生成 README 文件的脚本。
• rdkafka.suppressions: 抑制警告的配置文件。
• readme_template: README 模板文件。
• test_suite.sh: 测试套件脚本。

2. 项目的启动文件介绍

项目的启动文件通常位于 examples/ 目录下，例如 simple_consumer.rs。这个文件展示了如何使用 Rust-RDKafka 库来创建一个简单的 Kafka 消费者。

// examples/simple_consumer.rs

use rdkafka::consumer::{Consumer, BaseConsumer};
use rdkafka::Message;

fn main() {
    let consumer: BaseConsumer = ...; // 初始化消费者
    consumer.subscribe(&["topic_name"]).unwrap();

    loop {
        match consumer.poll(Duration::from_secs(1)) {
            Some(message) => {
                if let Some(payload) = message.payload() {
                    println!("Received message: {}", String::from_utf8_lossy(payload));
                }
            },
            None => (),
        }
    }
}

3. 项目的配置文件介绍

项目的配置文件主要包括 Cargo.toml 和 Dockerfile。

Cargo.toml

Cargo.toml 是 Rust 项目的包管理文件，定义了项目的依赖、版本、特性等信息。

[package]
name = "rust-rdkafka"
version = "0.36.2"
edition = "2018"

[dependencies]
futures-channel = "0.3.0"
futures-executor = "0.3.0"
futures-util = "0.3.0"
libc = "0.2.0"
log = "0.4.8"
rdkafka-sys = "4.7.0"
serde = "1.0.0"
serde_derive = "1.0.0"
serde_json = "1.0.0"
slab = "0.4"
tokio = "1.18"
tracing = "0.1.30"

[dev-dependencies]
async-std = "1.9.0"
backoff = "0.1.5"
chrono = "0.4.0"
clap = "2.18.0"
env_logger = "0.9.0"
futures = "0.3.0"
hdrhistogram = "7.0.0"
maplit = "1.0.2"
rand = "

rust-rdkafkaA fully asynchronous, futures-based Kafka client library for Rust based on librdkafka项目地址:https://gitcode.com/gh_mirrors/ru/rust-rdkafka