Step-by-step setup support

[gudaoxuri]

Normally the configuration information for web is loaded from the configuration file, like the example below.

But I'm getting a lot of ownership errors, and as a rust newbie, I don't know how to fix it.

I would like to know how this customization of services and routes based on configuration files should be implemented. thanks.

use std::fmt::Debug;

use poem::{listener::TcpListener, middleware::Cors, EndpointExt, Result, Route, Server};
use poem_openapi::param::Query;
use poem_openapi::{payload::PlainText, OpenApi, OpenApiService, ServerObject};
use serde::{Deserialize, Serialize};

// Simplified configuration file
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct WebServerConfig {
    pub address: String,
    pub allowed_origin: Option<String>,
    pub title: String,
    pub version: String,
    // [(Environment, Document address)]
    pub doc_urls: Vec<(String, String)>,
    pub ui_path: Option<String>,
    pub spec_path: Option<String>,
}

#[tokio::test]
async fn test_web_server() -> Result<(), Box<dyn std::error::Error>> {
    // Actually fetch from the configuration file
    let config = WebServerConfig {
        address: "".to_string(),
        allowed_origin: None,
        title: "".to_string(),
        version: "".to_string(),
        doc_urls: vec![],
        ui_path: None,
        spec_path: None,
    };
    let serv = OpenApiService::new((Api), &config.title, &config.version);
    // Add multiple environments and corresponding document addresses
    &config.doc_urls.iter().for_each(|doc| {
        // ERROR
        // move occurs because `serv` has type `OpenApiService<Api, ()>`, which does not implement the `Copy` trait
        serv.server(ServerObject::new(&doc.1).description(&doc.0));
    });
    // ERROR
    // value used here after move
    let route = Route::new().nest(format!("/api"), serv);
    // Add UI address only when configuration is exists
    if let Some(ui_path) = &config.ui_path {
        // ERROR
        // creates a temporary which is freed while still in use
        route.nest(format!("/{}", ui_path), &serv.rapidoc());
    }
    // Add spec address only when configuration is exists
    if let Some(spec_path) = &config.spec_path {
        // ERROR
        // value used here after move
        route.at(format!("/{}", spec_path), poem::endpoint::make_sync(move |_| serv.spec().clone()));
    }
    // Add cors only when configuration is exists
    if let Some(allowed_origin) = &config.allowed_origin {
        // ERROR
        // value used here after move
        route.with(Cors::new().allow_origin(allowed_origin));
    }
    // ERROR
    // value used here after move
    Server::new(TcpListener::bind("127.0.0.1:3000")).run(route).await?;
    Ok(())
}

struct Api;

#[OpenApi]
impl Api {
    #[oai(path = "/hello", method = "get")]
    async fn index(&self, name: Query<Option<String>>) -> PlainText<String> {
        match name.0 {
            Some(name) => PlainText(format!("hello, {}!", name)),
            None => PlainText("hello!".to_string()),
        }
    }
}

[sunli829]

You should do it like this:

let mut route = Route::new();

if let Some(ui_path) = &config.ui_path {
    route = route.nest(format!("/{}", ui_path), &serv.rapidoc());
}
 if let Some(spec_path) = &config.spec_path {
    route = route.at(format!("/{}", spec_path), poem::endpoint::make_sync(move |_| serv.spec().clone()));
}

[gudaoxuri]

Thanks, this works. We are going to use rust to replace some java systems.

We compared actix&paperclip, rocket&okapi , rweb and poem, in these web frameworks that include openapi ,we feel poem is the most user-friendly .

In the future, we hope to increase the comparison with these frameworks in terms of ease of use, performance, and stability, and hope that the Poem community can have more contributors.

很高兴可以看到中国的rust开源项目。

[auula]

Poem yyds！