2025-10-06 20:24:04 +02:00
|
|
|
//! 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
|
|
|
|
|
//!
|
2025-10-09 22:36:33 +02:00
|
|
|
//! ```rust,ignore
|
2025-10-06 20:24:04 +02:00
|
|
|
//! use pmoapp::{Webapp, WebAppExt};
|
|
|
|
|
//! use pmoserver::ServerBuilder;
|
|
|
|
|
//!
|
|
|
|
|
//! # async fn example() {
|
2025-10-09 22:36:33 +02:00
|
|
|
//! let mut server = ServerBuilder::new("MyApp", "http://localhost", 8080).build();
|
2025-10-06 20:24:04 +02:00
|
|
|
//!
|
|
|
|
|
//! // Le trait WebAppExt est automatiquement disponible
|
|
|
|
|
//! server.add_webapp::<Webapp>("/app").await;
|
|
|
|
|
//!
|
|
|
|
|
//! // Ou avec redirection
|
|
|
|
|
//! server.add_webapp_with_redirect::<Webapp>("/app").await;
|
|
|
|
|
//! # }
|
|
|
|
|
//! ```
|
|
|
|
|
|
|
|
|
|
use crate::WebAppExt;
|
|
|
|
|
use pmoserver::Server;
|
|
|
|
|
use rust_embed::RustEmbed;
|
|
|
|
|
|
|
|
|
|
impl WebAppExt for Server {
|
2025-10-09 07:00:48 +02:00
|
|
|
async fn add_webapp<W>(&mut self, path: &str)
|
2025-10-06 20:24:04 +02:00
|
|
|
where
|
|
|
|
|
W: RustEmbed + Clone + Send + Sync + 'static,
|
|
|
|
|
{
|
|
|
|
|
let path = path.to_string();
|
2025-10-09 07:00:48 +02:00
|
|
|
|
|
|
|
|
self.add_spa::<W>(&path).await;
|
2025-10-06 20:24:04 +02:00
|
|
|
}
|
|
|
|
|
|
2025-10-09 07:00:48 +02:00
|
|
|
async fn add_webapp_with_redirect<W>(&mut self, path: &str)
|
2025-10-06 20:24:04 +02:00
|
|
|
where
|
|
|
|
|
W: RustEmbed + Clone + Send + Sync + 'static,
|
|
|
|
|
{
|
|
|
|
|
let path = path.to_string();
|
2025-10-09 07:00:48 +02:00
|
|
|
|
|
|
|
|
self.add_spa::<W>(&path).await;
|
|
|
|
|
self.add_redirect("/", &path).await;
|
2025-10-06 20:24:04 +02:00
|
|
|
}
|
|
|
|
|
}
|