Rust高性能API开发库dragonfly-api的使用，打造高效稳定的后端服务

Dragonfly API定义的标准位置。该项目包括dragonfly服务的API定义和接口模拟。

开发者注意事项

如果开发者需要更改dragonfly API定义，请联系dragonfly维护者。

社区

加入讨论并帮助社区。

• Slack频道: #dragonfly
• Github讨论: Dragonfly讨论论坛
• 开发者群: dragonfly-developers@googlegroups.com
• 维护者群: dragonfly-maintainers@googlegroups.com
• Twitter: @dragonfly_oss
• 钉钉: 22880028764

贡献

你应该查看我们的贡献指南并一起开发项目。

行为准则

请参考我们的行为准则。

完整示例代码

use dragonfly_api::client::Client;
use dragonfly_api::models::{Task, TaskRequest};
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // 创建客户端实例
    let client = Client::new("https://api.dragonfly.example.com")?;
    
    // 创建任务请求
    let task_request = TaskRequest {
        url: "https://example.com/file.zip".to_string(),
        filter: Some("*.zip".to_string()),
        headers: None,
        md5: None,
        identifier: None,
        call_system: Some("rust-example".to_string()),
    };
    
    // 发送创建任务请求
    let task: Task = client.create_task(&task_request).await?;
    
    println!("Created task: {:?}", task);
    
    // 获取任务状态
    let task_id = task.id;
    let task_status = client.get_task(&task_id).await?;
    
    println!("Task status: {:?}", task_status);
    
    Ok(())
}

完整示例demo

以下是一个更完整的示例，展示了如何使用dragonfly-api进行文件下载任务管理:

use dragonfly_api::client::Client;
use dragonfly_api::models::{Task, TaskRequest, TaskStatus};
use std::error::Error;
use tokio::time::{sleep, Duration};

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // 初始化客户端，连接到Dragonfly API服务器
    let api_url = "https://api.dragonfly.example.com";
    let client = Client::new(api_url)?;
    println!("已连接到Dragonfly API服务器: {}", api_url);

    // 准备下载任务参数
    let task_request = TaskRequest {
        url: "https://example.com/large-file.iso".to_string(),
        filter: Some("*.iso".to_string()),
        headers: None,
        md5: Some("a1b2c3d4e5f6g7h8i9j0".to_string()), // 可选的文件校验MD5
        identifier: Some("unique-task-123".to_string()), // 自定义任务标识符
        call_system: Some("rust-downloader".to_string()),
    };

    // 创建下载任务
    println!("正在创建下载任务...");
    let task: Task = client.create_task(&task_request).await?;
    println!("任务创建成功: {:?}", task);

    // 轮询任务状态直到完成
    let task_id = task.id;
    loop {
        let task_status = client.get_task(&task_id).await?;
        println!("当前任务状态: {:?}", task_status);

        match task_status.status {
            TaskStatus::Success => {
                println!("下载任务已完成!");
                break;
            }
            TaskStatus::Failed => {
                println!("下载任务失败!");
                break;
            }
            _ => {
                // 任务还在进行中，等待5秒后再次检查
                sleep(Duration::from_secs(5)).await;
            }
        }
    }

    Ok(())
}

安装

在项目目录中运行以下Cargo命令:

cargo add dragonfly-api

或者将以下行添加到你的Cargo.toml中:

dragonfly-api = "2.1.53"

项目信息

• 版本: 2.1.53
• 许可证: Apache-2.0
• 大小: 360 KiB
• 主页: d7y.io
• 仓库: github.com/dragonflyoss/api

所有者

• Gaius (gaius-qi)