https://github.com/sfackler/r2d2
A generic connection pool for Rust
https://github.com/sfackler/r2d2
Last synced: 6 months ago
JSON representation
A generic connection pool for Rust
- Host: GitHub
- URL: https://github.com/sfackler/r2d2
- Owner: sfackler
- License: apache-2.0
- Created: 2014-08-05T03:25:09.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-10-10T01:01:52.000Z (about 1 year ago)
- Last Synced: 2025-04-01T20:18:48.116Z (7 months ago)
- Language: Rust
- Homepage:
- Size: 309 KB
- Stars: 1,561
- Watchers: 16
- Forks: 83
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-rust-cn - sfackler/r2d2 - ci.org/sfackler/r2d2.svg?branch=master">](https://travis-ci.org/sfackler/r2d2) (Libraries / Database)
- awesome-rust - sfackler/r2d2 - ci.org/sfackler/r2d2.svg?branch=master">](https://travis-ci.org/sfackler/r2d2) (Libraries / Database)
- awesome-rust - sfackler/r2d2
- awesome-rust-cn - sfackler/r2d2
- awesome-rust-zh - sfackler/r2d2 - 通用连接池 [<img src="https://api.travis-ci.org/sfackler/r2d2.svg?branch=master">](https://travis-ci.org/sfackler/r2d2) (库 / 数据库)
- awesome-rust - sfackler/r2d2 - generic connection pool (Libraries / Database)
- my-awesome - sfackler/r2d2 - 10 star:1.6k fork:0.1k A generic connection pool for Rust (Rust)
- awesome-rust - sfackler/r2d2 - ci.org/sfackler/r2d2.svg?branch=master">](https://travis-ci.org/sfackler/r2d2) (库 Libraries / 数据库 Database)
- fucking-awesome-rust - sfackler/r2d2 - generic connection pool (Libraries / Database)
- fucking-awesome-rust - sfackler/r2d2 - generic connection pool (Libraries / Database)
README
# r2d2
[](https://circleci.com/gh/sfackler/r2d2)
A generic connection pool for Rust.
[Documentation](https://docs.rs/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.
r2d2 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.
A (possibly not exhaustive) list of adaptors for different backends:
Backend | Adaptor Crate
---------------------------------------------------------------------- | -------------
[rust-postgres](https://github.com/sfackler/rust-postgres) | [r2d2-postgres](https://github.com/sfackler/r2d2-postgres)
[redis-rs](https://github.com/mitsuhiko/redis-rs) | use `r2d2` feature of [redis-rs](https://github.com/mitsuhiko/redis-rs)
[rust-memcache](https://github.com/aisk/rust-memcache) | [r2d2-memcache](https://github.com/megumish/r2d2-memcache)
[rust-mysql-simple](https://github.com/blackbeam/rust-mysql-simple) | [r2d2-mysql](https://github.com/outersky/r2d2-mysql)
[rusqlite](https://github.com/jgallagher/rusqlite) | [r2d2-sqlite](https://github.com/ivanceras/r2d2-sqlite)
[rsfbclient](https://github.com/fernandobatels/rsfbclient) | [r2d2-firebird](https://crates.io/crates/r2d2_firebird/)
[rusted-cypher](https://github.com/livioribeiro/rusted-cypher) | [r2d2-cypher](https://github.com/flosse/r2d2-cypher)
[diesel](https://github.com/sgrif/diesel) | [diesel::r2d2](https://github.com/diesel-rs/diesel/blob/master/diesel/src/r2d2.rs) ([docs](https://docs.rs/diesel/latest/diesel/r2d2/index.html))
[couchdb](https://github.com/chill-rs/chill) | [r2d2-couchdb](https://github.com/scorphus/r2d2-couchdb)
[mongodb (archived)](https://github.com/mongodb-labs/mongo-rust-driver-prototype)
use official [mongodb](https://github.com/mongodb/mongo-rust-driver) driver instead | [r2d2-mongodb](https://gitlab.com/petoknm/r2d2-mongodb)
(deprecated: official driver handles pooling internally)
[odbc](https://github.com/Koka/odbc-rs) | [r2d2-odbc](https://github.com/Koka/r2d2-odbc)
[jfs](https://github.com/flosse/rust-json-file-store) | [r2d2-jfs](https://github.com/flosse/r2d2-jfs)
[oracle](https://github.com/kubo/rust-oracle) | [r2d2-oracle](https://github.com/rursprung/r2d2-oracle)
[ldap3](https://github.com/inejge/ldap3) | [r2d2-ldap](https://github.com/c0dearm/r2d2-ldap)
[duckdb-rs](https://github.com/wangfenjin/duckdb-rs) | use `r2d2` feature of [duckdb-rs](https://github.com/wangfenjin/duckdb-rs)
# Example
Using an imaginary "foodb" database.
```rust
use std::thread;
extern crate r2d2;
extern crate r2d2_foodb;
fn main() {
let manager = r2d2_foodb::FooConnectionManager::new("localhost:1234");
let pool = r2d2::Pool::builder()
.max_size(15)
.build(manager)
.unwrap();
for _ in 0..20 {
let pool = pool.clone();
thread::spawn(move || {
let conn = pool.get().unwrap();
// use the connection
// it will be returned to the pool when it falls out of scope.
})
}
}
```
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you shall be dual licensed as above, without any
additional terms or conditions.