本文同步與Rust中文社群
時間：2018-11-27，作者：krircc， 簡介：天青色

歡迎向Rust中文社群投稿,投稿地址,好文將在以下地方直接展示

更新我們的CARGO.TOML

Rust生態系統正在快速發展，在幾個星期內，我們的許多箱子都在上游更新，包括我的sparkpost箱子（稍後會詳細介紹）。沒有任何延遲，我們只需更新cargo.toml檔案中的以下條件箱。

[dependencies]
actix = "0.7.7"
actix-web = "0.7.14"
env_logger = "0.6.0"
r2d2 = "0.8.3"
sparkpost = "0.5.2"

使用SPARKPOST傳送註冊電子郵件

請隨意使用您喜歡的任何電子郵件服務（除個人使用外，我與sparkpost沒有關聯），只要您能夠複製已傳送的電子郵件即可。現在，您需要在.env檔案中新增以下內容。

SPARKPOST_API_KEY='yourapikey'
SENDING_EMAIL_ADDRESS='[email protected]'

Api金鑰是從sparkpost帳戶獲得的，只要您擁有可以控制的域名，就可以免費建立一個。要處理電子郵件，我們建立一個檔案email_service.rs並新增以下內容。

use models::Invitation;
use sparkpost::transmission::{
    EmailAddress, Message, Options, Recipient, Transmission, TransmissionResponse,
};

fn get_api_key() -> String {
    std::env::var("SPARKPOST_API_KEY").expect("SPARKPOST_API_KEY must be set")
}

#[allow(unused)]
pub fn send_invitation(invitation: &Invitation) {
    let tm = Transmission::new_eu(get_api_key());
    let sending_email =
        std::env::var("SENDING_EMAIL_ADDRESS").expect("SENDING_EMAIL_ADDRESS must be set");
    // new email message with sender name and email
    let mut email = Message::new(EmailAddress::new(sending_email, "Let's Organise"));

    // set options for a transactional email for now
    let options = Options {
        open_tracking: false,
        click_tracking: false,
        transactional: true,
        sandbox: false,
        inline_css: false,
        start_time: None,
    };

    // recipient from the invitation email
    let recipient: Recipient = invitation.email.as_str().into();

    let email_body = format!(
        "Please click on the link below to complete registration. <br/>
         <a href=\"http://localhost:3000/register.html?id={}&email={}\">
         http://localhost:3030/register</a> <br>
         your Invitation expires on <strong>{}</strong>",
        invitation.id,
        invitation.email,
        invitation
            .expires_at
            .format("%I:%M %p %A, %-d %B, %C%y")
            .to_string()
    );


    // complete the email message with details
    email
        .add_recipient(recipient)
        .options(options)
        .subject("You have been invited to join Simple-Auth-Server Rust")
        .html(email_body);

    let result = tm.send(&email);

    match result {
        Ok(res) => {
            // println!("{:?}", &res);
            match res {
                TransmissionResponse::ApiResponse(api_res) => {
                    println!("API Response: \n {:#?}", api_res);
                    //   assert_eq!(1, api_res.total_accepted_recipients);
                    //   assert_eq!(0, api_res.total_rejected_recipients);
                }
                TransmissionResponse::ApiError(errors) => {
                    println!("Response Errors: \n {:#?}", &errors);
                }
            }
        }
        Err(error) => {
            println!("error \n {:#?}", error);
        }
    }
}
 

為了能夠在我們的應用程式中使用此服務，我們在main.js檔案中新增extern crate sparkpost;和mod email_service;。請注意，我們不會從send_invitation函式返回任何內容。這取決於您在真實應用中想要做什麼，現在我們只需登入終端。

調整您的邀請處理

在上一個教程中，我們以一種返回物件本身的方式實現了我們的邀請。讓我們改變它並將電子郵件傳送給使用者。在我們invitation_routes.rs中我們邀請通過呼叫send_invitation函式。程式碼如下所示。

use actix_web::{AsyncResponder, FutureResponse, HttpResponse, Json, ResponseError, State};
use futures::future::Future;

use app::AppState;
use email_service::send_invitation;
use invitation_handler::CreateInvitation;

pub fn register_email(
 (signup_invitation, state): (Json<CreateInvitation>, State<AppState>),
) -> FutureResponse<HttpResponse> {
 state
     .db
     .send(signup_invitation.into_inner())
     .from_err()
     .and_then(|db_response| match db_response {
         Ok(invitation) => {
             send_invitation(&invitation);
             Ok(HttpResponse::Ok().into())
         }
         Err(err) => Ok(err.error_response()),
     }).responder()
}
 

設定模擬前端進行測試

我不打算詳細介紹前端設定。在本教程中，我建立用以作為靜態檔案的一些HTML / CSS / JS檔案的目的為了方便。你可以簡單地將這個資料夾複製到你的程式碼的根目錄作為'static /'，或者狂野地做一個react / vue / angular前端。

我們將稍微改變我們的路由以滿足我們的需求，並將靜態檔案路由從業務邏輯路由中分離出來。我決定使用在根級別提供的靜態檔案，並將所有應用程式路徑移動到/api字首。為此，我們將app.rs檔案修改為以下內容。

use actix::prelude::*;
use actix_web::middleware::identity::{CookieIdentityPolicy, IdentityService};
use actix_web::{fs, http::Method, middleware::Logger, App};
use auth_routes::{get_me, login, logout};
use chrono::Duration;
use invitation_routes::register_email;
use models::DbExecutor;
use register_routes::register_user;

pub struct AppState {
    pub db: Addr<DbExecutor>,
}

/// creates and returns the app after mounting all routes/resources
pub fn create_app(db: Addr<DbExecutor>) -> App<AppState> {
    // secret is a random minimum 32 bytes long base 64 string
    let secret: String = std::env::var("SECRET_KEY").unwrap_or_else(|_| "0123".repeat(8));
    let domain: String = std::env::var("DOMAIN").unwrap_or_else(|_| "localhost".to_string());

    App::with_state(AppState { db })
        .middleware(Logger::default())
        .middleware(IdentityService::new(
            CookieIdentityPolicy::new(secret.as_bytes())
                .name("auth")
                .path("/")
                .domain(domain.as_str())
                .max_age(Duration::days(1))
                .secure(false), // this can only be true if you have https
        ))
        // everything under '/api/' route
        .scope("/api", |api| {
            // routes for authentication
            api.resource("/auth", |r| {
                r.method(Method::POST).with(login);
                r.method(Method::DELETE).with(logout);
                r.method(Method::GET).with(get_me);
            })
            // routes to invitation
            .resource("/invitation", |r| {
                r.method(Method::POST).with(register_email);
            })
            // routes to register as a user after the
            .resource("/register/{invitation_id}", |r| {
                r.method(Method::POST).with(register_user);
            })
        })
        // serve static files
        .handler(
            "/",
            fs::StaticFiles::new("./static/")
                .unwrap()
                .index_file("index.html"),
        )
}

請注意封閉所有路由的scope方法。這就是設定電子郵件驗證和簡單前端所需的全部內容。

英文原文