1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
//! A full-featured connection pool, designed for asynchronous connections //! (using tokio). Originally based on [r2d2](https://github.com/sfackler/r2d2). //! //! Opening a new database connection every time one is needed is both //! inefficient and can lead to resource exhaustion under high traffic //! conditions. A connection pool maintains a set of open connections to a //! database, handing them out for repeated use. //! //! bb8 is agnostic to the connection type it is managing. Implementors of the //! `ManageConnection` trait provide the database-specific logic to create and //! check the health of connections. //! //! # Example //! //! Using an imaginary "foodb" database. //! //! ```ignore //! #[tokio::main] //! async fn main() { //! let manager = bb8_foodb::FooConnectionManager::new("localhost:1234"); //! let pool = bb8::Pool::builder().build(manager).await.unwrap(); //! //! for _ in 0..20 { //! let pool = pool.clone(); //! tokio::spawn(async move { //! let conn = pool.get().await.unwrap(); //! // use the connection //! // it will be returned to the pool when it falls out of scope. //! }); //! } //! } //! ``` #![allow(clippy::needless_doctest_main)] #![deny(missing_docs, missing_debug_implementations)] mod api; pub use api::{ Builder, CustomizeConnection, ErrorSink, ManageConnection, NopErrorSink, Pool, PooledConnection, RunError, State, }; mod inner; mod internals;