mirror of
https://github.com/fafhrd91/actix-web
synced 2024-11-24 08:22:59 +01:00
142 lines
3.8 KiB
Rust
142 lines
3.8 KiB
Rust
//! Actix web is a small, pragmatic, and extremely fast web framework
|
|
//! for Rust.
|
|
//!
|
|
//! ```rust,ignore
|
|
//! use actix_web::{server, App, Path, Responder};
|
|
//! # use std::thread;
|
|
//!
|
|
//! fn index(info: Path<(String, u32)>) -> impl Responder {
|
|
//! format!("Hello {}! id:{}", info.0, info.1)
|
|
//! }
|
|
//!
|
|
//! fn main() {
|
|
//! # thread::spawn(|| {
|
|
//! server::new(|| {
|
|
//! App::new().resource("/{name}/{id}/index.html", |r| r.with(index))
|
|
//! }).bind("127.0.0.1:8080")
|
|
//! .unwrap()
|
|
//! .run();
|
|
//! # });
|
|
//! }
|
|
//! ```
|
|
//!
|
|
//! ## Documentation & community resources
|
|
//!
|
|
//! Besides the API documentation (which you are currently looking
|
|
//! at!), several other resources are available:
|
|
//!
|
|
//! * [User Guide](https://actix.rs/docs/)
|
|
//! * [Chat on gitter](https://gitter.im/actix/actix)
|
|
//! * [GitHub repository](https://github.com/actix/actix-web)
|
|
//! * [Cargo package](https://crates.io/crates/actix-web)
|
|
//!
|
|
//! To get started navigating the API documentation you may want to
|
|
//! consider looking at the following pages:
|
|
//!
|
|
//! * [App](struct.App.html): This struct represents an actix-web
|
|
//! application and is used to configure routes and other common
|
|
//! settings.
|
|
//!
|
|
//! * [HttpServer](server/struct.HttpServer.html): This struct
|
|
//! represents an HTTP server instance and is used to instantiate and
|
|
//! configure servers.
|
|
//!
|
|
//! * [Request](struct.Request.html) and
|
|
//! [Response](struct.Response.html): These structs
|
|
//! represent HTTP requests and responses and expose various methods
|
|
//! for inspecting, creating and otherwise utilizing them.
|
|
//!
|
|
//! ## Features
|
|
//!
|
|
//! * Supported *HTTP/1.x* protocol
|
|
//! * Streaming and pipelining
|
|
//! * Keep-alive and slow requests handling
|
|
//! * `WebSockets` server/client
|
|
//! * Supported Rust version: 1.26 or later
|
|
//!
|
|
//! ## Package feature
|
|
//!
|
|
//! * `session` - enables session support, includes `ring` crate as
|
|
//! dependency
|
|
//!
|
|
#![allow(
|
|
clippy::type_complexity,
|
|
clippy::new_without_default,
|
|
clippy::new_without_default_derive
|
|
)]
|
|
|
|
#[macro_use]
|
|
extern crate log;
|
|
|
|
pub mod body;
|
|
mod builder;
|
|
pub mod client;
|
|
mod config;
|
|
mod extensions;
|
|
mod header;
|
|
mod helpers;
|
|
mod httpcodes;
|
|
pub mod httpmessage;
|
|
mod json;
|
|
mod message;
|
|
mod payload;
|
|
mod request;
|
|
mod response;
|
|
mod service;
|
|
|
|
pub mod error;
|
|
pub mod h1;
|
|
pub mod h2;
|
|
pub mod test;
|
|
pub mod ws;
|
|
|
|
pub use self::builder::HttpServiceBuilder;
|
|
pub use self::config::{KeepAlive, ServiceConfig};
|
|
pub use self::error::{Error, ResponseError, Result};
|
|
pub use self::extensions::Extensions;
|
|
pub use self::httpmessage::HttpMessage;
|
|
pub use self::message::{Head, Message, RequestHead, ResponseHead};
|
|
pub use self::payload::{Payload, PayloadStream};
|
|
pub use self::request::Request;
|
|
pub use self::response::Response;
|
|
pub use self::service::{HttpService, SendError, SendResponse};
|
|
|
|
pub mod dev {
|
|
//! The `actix-web` prelude for library developers
|
|
//!
|
|
//! The purpose of this module is to alleviate imports of many common actix
|
|
//! traits by adding a glob import to the top of actix heavy modules:
|
|
//!
|
|
//! ```
|
|
//! # #![allow(unused_imports)]
|
|
//! use actix_http::dev::*;
|
|
//! ```
|
|
|
|
pub use crate::httpmessage::{MessageBody, Readlines, UrlEncoded};
|
|
pub use crate::json::JsonBody;
|
|
pub use crate::response::ResponseBuilder;
|
|
}
|
|
|
|
pub mod http {
|
|
//! Various HTTP related types
|
|
|
|
// re-exports
|
|
pub use http::header::{HeaderName, HeaderValue};
|
|
pub use http::{Method, StatusCode, Version};
|
|
|
|
#[doc(hidden)]
|
|
pub use http::{uri, Error, HeaderMap, HttpTryFrom, Uri};
|
|
|
|
#[doc(hidden)]
|
|
pub use http::uri::PathAndQuery;
|
|
|
|
pub use cookie::{Cookie, CookieBuilder};
|
|
|
|
/// Various http headers
|
|
pub mod header {
|
|
pub use crate::header::*;
|
|
}
|
|
pub use crate::header::ContentEncoding;
|
|
pub use crate::message::ConnectionType;
|
|
}
|