使用端点（Endpoint）处理请求

02-server_routes_endpoints/02-endpoints.md
commit - 759c39d68f63e06b83bedd812f2a4a3a770879f9 - 2021.02.17

为了使服务器（Server）返回 HTTP 404 回应以外的任何内容，我们需要告诉服务器如何对请求作出反应。我们通过添加一个或多个端点（Endpoint）来实现；

#[async_std::main]
async fn main() -> tide::Result<()> {
    let mut server = tide::new();
    server.at("*").get(|_| async { Ok("Hello, world!") });
    server.listen("127.0.0.1:8080").await?;
    Ok(())
}

我们使用 at 方法指定到达端点（Endpoint）的路由（我们稍后再讨论路由）。目前，我们仅使用 "*" 通配符路由，它与任何路径都可以匹配。示例中，我们添加了一个异步闭包作为端点（Endpoint）。Tide 期望路由后添加的端点（Endpoint）函数的参数都实现 Endpoint trait。但当前实例中的闭包也是有效的，因为 Tide 使用如下签名实现了某些异步函数的 Endpoint trait；

async fn endpoint(request: tide::Request) -> tide::Result<impl Into<Response>>

如上示例中，&str 实现了 Into<Response>，因此我们的闭包是一个有效的端点（Endpoint）。这是因为，Into<Response> 是为其它几种可以快捷设定端点（Endpoint）的类型实现的。例如，下述实例中，端点（Endpoint）使用由 use tide::prelude::* 提供的 json! 宏，返回 serde_json::Value。

use tide::prelude::*;
#[async_std::main]
async fn main() -> tide::Result<()> {
    let mut server = tide::new();
    server.at("*").get(|_| async {
        Ok(json!({
            "meta": { "count": 2 },
            "animals": [
                { "type": "cat", "name": "chashu" },
                { "type": "cat", "name": "nori" }
            ]
        }))
    });
    server.listen("127.0.0.1:8080").await?;
    Ok(())
}

示例中，响应会返回字符串或 json 结果，对于获得能运作的端点（Endpoint）而言，这些用法很便捷。下面示例中，我们返回完整的响应结构体 Response。

server.at("*").get(|_| async {
    Ok(Response::new(StatusCode::Ok).set_body("Hello world".into()))
});

下一章中，将更详细地描述 Response 类型。

可以通过方法链添加多个端点（Endpoint）。例如，如果我们想回应一个 delete 请求以及一个 get 请求，那么可以为两者各自添加端点（Endpoint）；

server.at("*")
    .get(|_| async { Ok("Hello, world!") })
    .delete(|_| async { Ok("Goodbye, cruel world!") });

最后，当我们的端点（Endpoint）方法一点点增长时，路由的定义将变得拥挤。我们可以将端点（Endpoint）实现转移到它们自己的函数中；

#[async_std::main]
async fn main() -> tide::Result<()> {
    let mut server = tide::new();
    server.at("*").get(endpoint);
    server.listen("127.0.0.1:8080").await?;
    Ok(())
}

async fn endpoint(_req: tide::Request<()>) -> Result<Response> {
    Ok(Response::new(StatusCode::Ok).set_body("Hello world".into()))
}