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 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
#![deny(missing_docs)]
#![doc(html_root_url = "https://docs.rs/lapin-futures-openssl/0.5.4/")]
//! lapin-futures-openssl
//!
//! This library offers a nice integration of `openssl` with the `lapin-futures` library.
//! It uses `amq-protocol` URI parsing feature and adds the `connect` and `connect_cancellable`
//! methods to `AMQPUri` which will provide you with a `lapin_futures::client::Client` and
//! optionally a `lapin_futures::client::HeartbeatHandle` wrapped in a `Future`.
//!
//! It autodetects whether you're using `amqp` or `amqps` and opens either a raw `TcpStream`
//! or a `SslStream` using `openssl` as the SSL engine.
//!
//! ## Connecting and opening a channel
//!
//! ```rust,no_run
//! extern crate env_logger;
//! extern crate futures;
//! extern crate lapin_futures_openssl;
//! extern crate tokio;
//!
//! use lapin_futures_openssl::lapin;
//!
//! use futures::future::Future;
//! use lapin::channel::ConfirmSelectOptions;
//! use lapin_futures_openssl::AMQPConnectionOpensslExt;
//!
//! fn main() {
//! env_logger::init();
//!
//! tokio::run(
//! "amqps://user:pass@host/vhost?heartbeat=10".connect_cancellable(|err| {
//! eprintln!("heartbeat error: {:?}", err);
//! }).and_then(|(client, heartbeat_handle)| {
//! println!("Connected!");
//! client.create_confirm_channel(ConfirmSelectOptions::default()).map(|channel| (channel, heartbeat_handle))
//! }).and_then(|(channel, heartbeat_handle)| {
//! println!("Stopping heartbeat.");
//! heartbeat_handle.stop();
//! println!("Closing channel.");
//! channel.close(200, "Bye")
//! }).map_err(|err| {
//! eprintln!("amqp error: {:?}", err);
//! })
//! );
//! }
//! ```
extern crate futures;
extern crate lapin_futures_tls_internal;
extern crate openssl;
extern crate tokio_openssl;
/// Reexport of the `lapin_futures` crate
pub mod lapin;
/// Reexport of the `uri` module from the `amq_protocol` crate
pub mod uri;
/// Reexport of `AMQPStream`
pub type AMQPStream = lapin_futures_tls_internal::AMQPStream<SslStream<TcpStream>>;
use std::io;
use futures::future::Future;
use lapin_futures_tls_internal::{AMQPConnectionTlsExt, TcpStream};
use openssl::ssl::{SslConnector, SslMethod};
use tokio_openssl::{SslConnectorExt, SslStream};
use uri::AMQPUri;
fn connector(host: String, stream: TcpStream) -> Box<Future<Item = Box<SslStream<TcpStream>>, Error = io::Error> + Send + 'static> {
Box::new(futures::future::result(SslConnector::builder(SslMethod::tls()).map_err(|_| io::Error::new(io::ErrorKind::Other, "Failed to create connector"))).and_then(move |connector| {
connector.build().connect_async(&host, stream).map_err(|_| io::Error::new(io::ErrorKind::Other, "Failed to connect")).map(Box::new)
}))
}
/// Add a connect method providing a `lapin_futures::client::Client` wrapped in a `Future`.
pub trait AMQPConnectionOpensslExt<F: FnOnce(io::Error) + Send + 'static> : AMQPConnectionTlsExt<SslStream<TcpStream>, F> where Self: Sized {
/// Method providing a `lapin_futures::client::Client` wrapped in a `Future`
fn connect(self, heartbeat_error_handler: F) -> Box<Future<Item = lapin::client::Client<AMQPStream>, Error = io::Error> + Send + 'static> {
AMQPConnectionTlsExt::connect(self, heartbeat_error_handler, connector)
}
/// Method providing a `lapin_futures::client::Client` and `lapin_futures::client::HeartbeatHandle` wrapped in a `Future`
fn connect_cancellable(self, heartbeat_error_handler: F) -> Box<Future<Item = (lapin::client::Client<AMQPStream>, lapin::client::HeartbeatHandle), Error = io::Error> + Send + 'static> {
AMQPConnectionTlsExt::connect_cancellable(self, heartbeat_error_handler, connector)
}
}
impl<F: FnOnce(io::Error) + Send + 'static> AMQPConnectionOpensslExt<F> for AMQPUri {}
impl<'a, F: FnOnce(io::Error) + Send + 'static> AMQPConnectionOpensslExt<F> for &'a str {}