Rust AWS SDK翻译库aws-sdk-translate的使用：实现多语言文本翻译与AWS服务集成

介绍

aws-sdk-translate提供了将输入内容从源语言翻译到目标语言的功能。

开始使用

SDK为每个AWS服务提供一个crate。您必须在Rust项目中添加Tokio作为依赖项来执行异步代码。要将aws-sdk-translate添加到您的项目中，请在Cargo.toml文件中添加以下内容：

[dependencies]
aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
aws-sdk-translate = "1.79.0"
tokio = { version = "1", features = ["full"] }

然后在代码中，可以创建客户端如下：

use aws_sdk_translate as translate;

#[::tokio::main]
async fn main() -> Result<(), translate::Error> {
    let config = aws_config::load_from_env().await;
    let client = aws_sdk_translate::Client::new(&config);

    // ... 使用客户端进行调用

    Ok(())
}

完整示例

以下是使用aws-sdk-translate进行文本翻译的完整示例：

use aws_sdk_translate as translate;
use aws_sdk_translate::types::TranslationSettings;

#[tokio::main]
async fn main() -> Result<(), translate::Error> {
    // 加载AWS配置
    let config = aws_config::load_from_env().await;
    
    // 创建Translate客户端
    let client = translate::Client::new(&config);
    
    // 要翻译的文本
    let text = "Hello, world!";
    
    // 翻译请求
    let resp = client
        .translate_text()
        .source_language_code("en")  // 源语言: 英语
        .target_language_code("es")  // 目标语言: 西班牙语
        .text(text)  // 要翻译的文本
        .send()
        .await?;
    
    // 输出翻译结果
    println!("翻译结果: {}", resp.translated_text.unwrap());
    
    Ok(())
}

高级用法

您还可以使用翻译设置来定制翻译行为：

use aws_sdk_translate as translate;
use aws_sdk_translate::types::TranslationSettings;

#[tokio::main]
async fn main() -> Result<(), translate::Error> {
    let config = aws_config::load_from_env().await;
    let client = translate::Client::new(&config);
    
    // 创建翻译设置
    let settings = TranslationSettings::builder()
        .formality("FORMAL")  // 正式语气
        .profanity("MASK")    // 屏蔽不雅内容
        .build();
    
    let resp = client
        .translate_text()
        .source_language_code("en")
        .target_language_code("fr")  // 目标语言: 法语
        .text("How are you doing today?")
        .settings(settings)  // 应用翻译设置
        .send()
        .await?;
    
    println!("正式翻译结果: {}", resp.translated_text.unwrap());
    
    Ok(())
}

许可证

该项目使用Apache-2.0许可证。

完整示例代码

以下是一个更完整的示例，展示如何批量翻译多个文本并处理结果：

use aws_sdk_translate as translate;
use aws_sdk_translate::types::TranslationSettings;

#[tokio::main]
async fn main() -> Result<(), translate::Error> {
    // 加载AWS配置
    let config = aws_config::load_from_env().await;
    
    // 创建Translate客户端
    let client = translate::Client::new(&config);
    
    // 要翻译的文本列表
    let texts = vec![
        "Hello, world!",
        "How are you today?",
        "This is a test translation.",
    ];
    
    // 目标语言列表
    let target_languages = ["es", "fr", "de", "ja"];
    
    // 遍历每种目标语言
    for lang in target_languages {
        println!("翻译到 {}:", lang);
        
        // 遍历每个文本
        for text in &texts {
            // 发送翻译请求
            let resp = client
                .translate_text()
                .source_language_code("en")
                .target_language_code(lang)
                .text(text)
                .send()
                .await?;
            
            // 输出结果
            if let Some(translated) = resp.translated_text {
                println!("原始: {} -> 翻译: {}", text, translated);
            }
        }
        println!(); // 空行分隔不同语言
    }
    
    Ok(())
}

错误处理示例

以下是一个包含更完善错误处理的示例：

use aws_sdk_translate as translate;
use aws_sdk_translate::error::TranslateTextError;
use aws_sdk_translate::types::SdkError;

#[tokio::main]
async fn main() {
    // 加载AWS配置
    let config = aws_config::load_from_env().await;
    
    // 创建Translate客户端
    let client = translate::Client::new(&config);
    
    // 要翻译的文本
    let text = "Hello, world!";
    
    // 发送翻译请求并处理可能的错误
    match client
        .translate_text()
        .source_language_code("en")
        .target_language_code("es")
        .text(text)
        .send()
        .await
    {
        Ok(resp) => {
            if let Some(translated) = resp.translated_text {
                println!("成功翻译: {}", translated);
            } else {
                eprintln!("错误: 响应中没有翻译文本");
            }
        }
        Err(SdkError::ServiceError { err, .. }) => {
            match err {
                TranslateTextError::TextSizeLimitExceededException(_) => {
                    eprintln!("错误: 文本长度超过限制");
                }
                TranslateTextError::UnsupportedLanguagePairException(_) => {
                    eprintln!("错误: 不支持的语言对");
                }
                _ => {
                    eprintln!("AWS翻译服务错误: {}", err);
                }
            }
        }
        Err(e) => {
            eprintln!("请求错误: {}", e);
        }
    }
}