2020-11-29 16:33:45 +00:00
|
|
|
//! Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust.
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-06-17 16:57:58 +00:00
|
|
|
//! # Examples
|
2021-03-25 08:45:52 +00:00
|
|
|
//! ```no_run
|
2020-07-05 00:16:53 +00:00
|
|
|
//! use actix_web::{get, web, App, HttpServer, Responder};
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2020-07-05 00:16:53 +00:00
|
|
|
//! #[get("/{id}/{name}/index.html")]
|
2021-01-09 13:17:19 +00:00
|
|
|
//! async fn index(path: web::Path<(u32, String)>) -> impl Responder {
|
|
|
|
//! let (id, name) = path.into_inner();
|
2020-07-20 23:54:26 +00:00
|
|
|
//! format!("Hello {}! id:{}", name, id)
|
2019-03-24 18:47:23 +00:00
|
|
|
//! }
|
|
|
|
//!
|
2020-06-22 19:09:48 +00:00
|
|
|
//! #[actix_web::main]
|
2019-12-08 06:31:16 +00:00
|
|
|
//! async fn main() -> std::io::Result<()> {
|
2020-07-05 00:16:53 +00:00
|
|
|
//! HttpServer::new(|| App::new().service(index))
|
2019-03-24 18:47:23 +00:00
|
|
|
//! .bind("127.0.0.1:8080")?
|
2019-12-22 13:12:22 +00:00
|
|
|
//! .run()
|
2019-12-08 06:31:16 +00:00
|
|
|
//! .await
|
2019-03-24 18:47:23 +00:00
|
|
|
//! }
|
|
|
|
//! ```
|
|
|
|
//!
|
2021-06-17 16:57:58 +00:00
|
|
|
//! # Documentation & Community Resources
|
2020-07-05 00:16:53 +00:00
|
|
|
//! In addition to this API documentation, several other resources are available:
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * [Website & User Guide](https://actix.rs/)
|
|
|
|
//! * [Examples Repository](https://github.com/actix/examples)
|
2021-06-04 01:54:40 +00:00
|
|
|
//! * [Community Chat on Discord](https://discord.gg/NWpN5mmg3x)
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2020-07-05 00:16:53 +00:00
|
|
|
//! To get started navigating the API docs, you may consider looking at the following pages first:
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-04-20 18:57:27 +00:00
|
|
|
//! * [`App`]: This struct represents an Actix Web application and is used to
|
2020-07-05 00:16:53 +00:00
|
|
|
//! configure routes and other common application settings.
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-04-20 18:57:27 +00:00
|
|
|
//! * [`HttpServer`]: This struct represents an HTTP server instance and is
|
2020-07-05 00:16:53 +00:00
|
|
|
//! used to instantiate and configure servers.
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-04-20 18:57:27 +00:00
|
|
|
//! * [`web`]: This module provides essential types for route registration as well as
|
2020-07-05 00:16:53 +00:00
|
|
|
//! common utilities for request handlers.
|
2019-03-30 17:04:38 +00:00
|
|
|
//!
|
2021-04-20 18:57:27 +00:00
|
|
|
//! * [`HttpRequest`] and [`HttpResponse`]: These
|
2020-07-05 00:16:53 +00:00
|
|
|
//! structs represent HTTP requests and responses and expose methods for creating, inspecting,
|
|
|
|
//! and otherwise utilizing them.
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-06-17 16:57:58 +00:00
|
|
|
//! # Features
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * Supports *HTTP/1.x* and *HTTP/2*
|
2019-03-24 18:47:23 +00:00
|
|
|
//! * Streaming and pipelining
|
|
|
|
//! * Keep-alive and slow requests handling
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * Client/server [WebSockets](https://actix.rs/docs/websockets/) support
|
2021-06-19 19:21:13 +00:00
|
|
|
//! * Transparent content compression/decompression (br, gzip, deflate, zstd)
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * Powerful [request routing](https://actix.rs/docs/url-dispatch/)
|
2019-03-24 18:47:23 +00:00
|
|
|
//! * Multipart streams
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * Static assets
|
|
|
|
//! * SSL support using OpenSSL or Rustls
|
|
|
|
//! * Middlewares ([Logger, Session, CORS, etc](https://actix.rs/docs/middleware/))
|
2021-04-20 18:57:27 +00:00
|
|
|
//! * Includes an async [HTTP client](https://docs.rs/awc/)
|
2021-12-29 08:59:15 +00:00
|
|
|
//! * Runs on stable Rust 1.54+
|
2019-03-24 18:47:23 +00:00
|
|
|
//!
|
2021-06-17 16:57:58 +00:00
|
|
|
//! # Crate Features
|
2021-02-13 15:08:43 +00:00
|
|
|
//! * `cookies` - cookies support (enabled by default)
|
2021-06-19 19:23:06 +00:00
|
|
|
//! * `compress-brotli` - brotli content encoding compression support (enabled by default)
|
|
|
|
//! * `compress-gzip` - gzip and deflate content encoding compression support (enabled by default)
|
|
|
|
//! * `compress-zstd` - zstd content encoding compression support (enabled by default)
|
2020-07-05 00:16:53 +00:00
|
|
|
//! * `openssl` - HTTPS support via `openssl` crate, supports `HTTP/2`
|
|
|
|
//! * `rustls` - HTTPS support via `rustls` crate, supports `HTTP/2`
|
|
|
|
//! * `secure-cookies` - secure cookies support
|
2017-11-24 18:03:13 +00:00
|
|
|
|
2020-12-28 00:44:15 +00:00
|
|
|
#![deny(rust_2018_idioms, nonstandard_style)]
|
2021-12-08 06:09:56 +00:00
|
|
|
#![warn(future_incompatible)]
|
2020-09-13 02:24:44 +00:00
|
|
|
#![doc(html_logo_url = "https://actix.rs/img/logo.png")]
|
|
|
|
#![doc(html_favicon_url = "https://actix.rs/favicon.ico")]
|
|
|
|
|
2019-03-02 06:51:32 +00:00
|
|
|
mod app;
|
2019-03-09 17:49:11 +00:00
|
|
|
mod app_service;
|
2019-03-06 23:47:15 +00:00
|
|
|
mod config;
|
2019-03-17 03:17:27 +00:00
|
|
|
mod data;
|
2021-06-27 06:44:56 +00:00
|
|
|
pub mod dev;
|
2019-03-09 15:39:34 +00:00
|
|
|
pub mod error;
|
2019-03-09 22:06:24 +00:00
|
|
|
mod extract;
|
2019-03-03 20:09:38 +00:00
|
|
|
pub mod guard;
|
2019-03-09 22:06:24 +00:00
|
|
|
mod handler;
|
2021-06-17 16:57:58 +00:00
|
|
|
mod helpers;
|
2021-04-01 15:42:18 +00:00
|
|
|
pub mod http;
|
2019-03-09 22:06:24 +00:00
|
|
|
mod info;
|
2017-12-27 03:59:41 +00:00
|
|
|
pub mod middleware;
|
2019-03-02 06:51:32 +00:00
|
|
|
mod request;
|
2020-10-24 17:49:50 +00:00
|
|
|
mod request_data;
|
2019-03-02 06:51:32 +00:00
|
|
|
mod resource;
|
2021-04-09 17:07:10 +00:00
|
|
|
mod response;
|
2019-03-09 15:39:34 +00:00
|
|
|
mod rmap;
|
2019-03-02 06:51:32 +00:00
|
|
|
mod route;
|
2019-03-04 05:02:01 +00:00
|
|
|
mod scope;
|
2019-03-05 00:29:03 +00:00
|
|
|
mod server;
|
2019-03-02 06:51:32 +00:00
|
|
|
mod service;
|
2019-03-03 00:24:14 +00:00
|
|
|
pub mod test;
|
2021-01-09 13:17:19 +00:00
|
|
|
pub(crate) mod types;
|
2019-03-30 17:04:38 +00:00
|
|
|
pub mod web;
|
2019-03-02 06:51:32 +00:00
|
|
|
|
2021-06-17 16:57:58 +00:00
|
|
|
pub use actix_http::{body, HttpMessage};
|
2021-04-08 19:51:16 +00:00
|
|
|
#[doc(inline)]
|
2020-07-05 00:16:53 +00:00
|
|
|
pub use actix_rt as rt;
|
|
|
|
pub use actix_web_codegen::*;
|
2021-04-09 17:07:10 +00:00
|
|
|
#[cfg(feature = "cookies")]
|
|
|
|
pub use cookie;
|
2019-03-02 06:51:32 +00:00
|
|
|
|
2019-03-06 06:10:08 +00:00
|
|
|
pub use crate::app::App;
|
2021-06-17 16:57:58 +00:00
|
|
|
pub use crate::error::{Error, ResponseError, Result};
|
2019-03-07 19:43:46 +00:00
|
|
|
pub use crate::extract::FromRequest;
|
2021-12-25 04:43:59 +00:00
|
|
|
pub use crate::handler::Handler;
|
2019-03-02 06:51:32 +00:00
|
|
|
pub use crate::request::HttpRequest;
|
|
|
|
pub use crate::resource::Resource;
|
2021-12-13 16:08:08 +00:00
|
|
|
pub use crate::response::{CustomizeResponder, HttpResponse, HttpResponseBuilder, Responder};
|
2019-03-03 03:19:56 +00:00
|
|
|
pub use crate::route::Route;
|
2019-03-24 18:59:35 +00:00
|
|
|
pub use crate::scope::Scope;
|
2019-03-05 00:29:03 +00:00
|
|
|
pub use crate::server::HttpServer;
|
2021-12-13 16:08:08 +00:00
|
|
|
pub use crate::types::Either;
|
2021-12-04 19:40:47 +00:00
|
|
|
|
|
|
|
pub(crate) type BoxError = Box<dyn std::error::Error>;
|