如何用Rocket框架安全地讀取HTTP標頭中的Accept-Language欄位？

在實作多國語言的Web服務時，會需要去讀取客戶端傳送來的HTTP請求標頭中的Accept-Language欄位，來判斷客戶端偏好使用的語言。然而，Rocket框架並未內建解析Accept-Language欄位的功能，開發者只能自行去撰寫程式來想辦法用Accept-Language欄位的原始資料去做客戶端的語言判斷，不但麻煩又很不安全。

一個Accept-Language欄位的值可能如以下這樣：

zh-TW,zh;q=0.7,en-US;q=0.6,en;q=0.5

以上的值，代表客戶端想要優先使用台灣的繁體中文，如果沒有的話就使用任意地區的中文，如果還是沒有的話就使用美國的英文，如果又沒有的話就使用任意地區的英文。

accept-language Request Guard for Rocket Framework

「accept-language Request Guard for Rocket Framework」是筆者開發出來的套件，將可以讀取Accept-Language欄位並且進行語言判斷的功能寫成請求守衛，一勞永逸。使用accept-language這個crate來進行Accept-Language欄位值的解析，並轉成unic-langid這個crate提供的LanguageIdentifier結構體的實體來儲存。

Crates.io

Cargo.toml

使用方法

在Rocket框架啟動前，先建立出LanguageIdentifier結構實體的陣列，用來表示這個Rocket應用程式支援的語言。接著再把這個LanguageIdentifier陣列，註冊成Rocket的應用程式狀態。language_region_pairs巨集能以很小的開支(overhead)來建立Vec<LanguageIdentifier>結構實體。

在Rocket框架的路由處理程序中，藉由放置rocket_accept_language這個crate所提供的AcceptLanguage請求守衛，來解析HTTP請求標頭中的Accept-Language欄位。AcceptLanguage的結構實體提供了get_appropriate_language_region方法，可以傳入一個LanguageIdentifier陣列切片，根據Rocket應用程式有支援的語言來判斷出最符合HTTP請求的語言。

get_appropriate_language_region方法會回傳unic-langid這個crate提供的提供的Language和Region結構體的實體。透過language巨集和region巨集，可以用常數建立出Language和Region結構實體並儲存起來，方便重用。

以下是一個使用範例：

#[macro_use]
extern crate rocket;

use rocket::State;
use rocket_accept_language::{
    language, language_region_pairs, region,
    unic_langid::subtags::{Language, Region},
    AcceptLanguage, LanguageIdentifier,
};

const LANGUAGE_ZH: Language = language!("zh");
const LANGUAGE_EN: Language = language!("en");
const LANGUAGE_JP: Language = language!("jp");
const REGION_CN: Region = region!("cn");
const REGION_TW: Region = region!("tw");

struct SupportLanguages {
    language_identifiers: Vec<LanguageIdentifier>,
}

impl SupportLanguages {
    fn as_language_identifiers(&self) -> &[LanguageIdentifier] {
        &self.language_identifiers
    }
}

#[get("/")]
fn hello(
    accept_language: &AcceptLanguage,
    support_languages: &State<SupportLanguages>,
) -> &'static str {
    let (language, region) = accept_language
        .get_appropriate_language_region(support_languages.as_language_identifiers())
        .unwrap_or((LANGUAGE_EN, None));

    match language {
        LANGUAGE_ZH => match region.unwrap_or(REGION_TW) {
            REGION_CN => "哈罗！",
            _ => "哈囉！",
        },
        LANGUAGE_JP => "ハロー",
        _ => "Hello!",
    }
}

#[launch]
fn rocket() -> _ {
    let support_languages = SupportLanguages {
        language_identifiers: language_region_pairs!["zh-TW", "zh_CN", "jp", "en"],
    };

    rocket::build().manage(support_languages).mount("/", routes![hello])
}