Struct salvo_core::Service

pub struct Service {
    pub router: Arc<Router>,
    pub catcher: Option<Arc<Catcher>>,
    pub allowed_media_types: Arc<Vec<Mime>>,
}

Service http request.

Fields

router: Arc<Router>

The router of this service.

catcher: Option<Arc<Catcher>>

The catcher of this service.

allowed_media_types: Arc<Vec<Mime>>

The allowed media types of this service.

Implementations

impl Service

pub fn new<T>(router: T) -> Servicewhere T: Into<Arc<Router>>,

Create a new Service with a Router.

pub fn router(&self) -> Arc<Router>

Get router in this Service.

pub fn catcher(self, catcher: impl Into<Arc<Catcher>>) -> Self

When the response code is 400-600 and the body is empty, capture and set the error page content. If catchers is not set, the default error page will be used.

Example

#[handler]
async fn handle404(&self, _req: &Request, _depot: &Depot, res: &mut Response, ctrl: &mut FlowCtrl) {
    if let Some(StatusCode::NOT_FOUND) = res.status_code {
        res.render("Custom 404 Error Page");
        ctrl.skip_rest();
    }
}

#[tokio::main]
async fn main() {
    Service::new(Router::new()).catcher(Catcher::default().hoop(handle404));
}

pub fn allowed_media_types<T>(self, allowed_media_types: T) -> Selfwhere T: Into<Arc<Vec<Mime>>>,

Sets allowed media types list and returns Self for write code chained.

Example

let service = Service::new(Router::new()).allowed_media_types(vec![mime::TEXT_PLAIN]);

pub async fn handle(&self, request: impl Into<Request> + Send) -> Response

Handle new request, this function only used for test.

Trait Implementations

impl<T> From<T> for Servicewhere T: Into<Arc<Router>>,

fn from(router: T) -> Self

Converts to this type from the input type.