Eric Coissac
d81e7a9413
- Add `async_trait` as an optional依赖ency in pmoapp/Cargo.toml - Enable usage of `#[async_trait]` on WebAppExt trait and its impl for Server - Guard async-related code with `#[cfg(feature = "pmoserver")]`
84 lines
2.7 KiB
Rust
84 lines
2.7 KiB
Rust
//! Implémentation du trait WebAppExt pour le serveur pmoserver
|
|
//!
|
|
//! Ce module enrichit `pmoserver::Server` avec les fonctionnalités webapp en
|
|
//! implémentant le trait [`WebAppExt`](crate::WebAppExt). Cette implémentation
|
|
//! permet d'enregistrer facilement des webapps embarquées sur le serveur.
|
|
//!
|
|
//! ## Architecture
|
|
//!
|
|
//! `pmoapp` étend `pmoserver::Server` sans que `pmoserver` connaisse `pmoapp`.
|
|
//! C'est le pattern d'extension : `pmoapp` ajoute des fonctionnalités à un type
|
|
//! externe via un trait, similaire au pattern utilisé par `pmoupnp` pour `UpnpServer`.
|
|
//!
|
|
//! ## Exemple d'utilisation
|
|
//!
|
|
//! ```rust,ignore
|
|
//! use pmoapp::{Webapp, WebAppExt};
|
|
//! use pmoserver::ServerBuilder;
|
|
//!
|
|
//! # async fn example() {
|
|
//! let mut server = ServerBuilder::new("MyApp", "http://localhost", 8080).build();
|
|
//!
|
|
//! // Le trait WebAppExt est automatiquement disponible
|
|
//! server.add_webapp::<Webapp>("/app").await;
|
|
//!
|
|
//! // Ou avec redirection
|
|
//! server.add_webapp_with_redirect::<Webapp>("/app").await;
|
|
//! # }
|
|
//! ```
|
|
|
|
#[cfg(feature = "pmoserver")]
|
|
use async_trait::async_trait;
|
|
use crate::WebAppExt;
|
|
use pmoserver::Server;
|
|
use rust_embed::RustEmbed;
|
|
|
|
#[cfg(feature = "pmoserver")]
|
|
#[async_trait]
|
|
impl WebAppExt for Server {
|
|
async fn add_webapp<W>(&mut self, path: &str)
|
|
where
|
|
W: RustEmbed + Clone + Send + Sync + 'static,
|
|
{
|
|
let mount_path = normalize_mount_path(path);
|
|
mount_spa_with_trailing_slash_redirect::<W>(self, &mount_path).await;
|
|
}
|
|
|
|
async fn add_webapp_with_redirect<W>(&mut self, path: &str)
|
|
where
|
|
W: RustEmbed + Clone + Send + Sync + 'static,
|
|
{
|
|
let mount_path = normalize_mount_path(path);
|
|
|
|
mount_spa_with_trailing_slash_redirect::<W>(self, &mount_path).await;
|
|
self.add_redirect("/", &mount_path).await;
|
|
}
|
|
}
|
|
|
|
/// S'assure que les chemins SPA sont cohérents : `"/app"` devient `"/app"`,
|
|
/// tandis que `"/"` reste tel quel. Les espaces ou slashs multiples sont
|
|
/// nettoyés pour éviter des routes dupliquées.
|
|
fn normalize_mount_path(path: &str) -> String {
|
|
let trimmed = path.trim();
|
|
|
|
if trimmed.is_empty() || trimmed == "/" {
|
|
"/".to_string()
|
|
} else {
|
|
format!("/{}", trimmed.trim_matches('/'))
|
|
}
|
|
}
|
|
|
|
/// Monte la SPA et ajoute automatiquement une redirection `"/app/" -> "/app"`
|
|
/// afin que les URLs avec slash final servent également l'application.
|
|
async fn mount_spa_with_trailing_slash_redirect<W>(server: &mut Server, path: &str)
|
|
where
|
|
W: RustEmbed + Clone + Send + Sync + 'static,
|
|
{
|
|
server.add_spa::<W>(path).await;
|
|
|
|
if path != "/" {
|
|
let trailing = format!("{}/", path.trim_end_matches('/'));
|
|
server.add_redirect(&trailing, path).await;
|
|
}
|
|
}
|