[−][src]Struct tokio_postgres::Connection

[+] Show declaration

[+] Expand attributes
#[must_use = "futures do nothing unless polled"]
pub struct Connection<S, T> { /* fields omitted */ }

[−]

A connection to a PostgreSQL database.

This is one half of what is returned when a new connection is established. It performs the actual IO with the server, and should generally be spawned off onto an executor to run in the background.

Connection implements Future, and only resolves when the connection is closed, either because a fatal error has occurred, or because its associated Client has dropped and all outstanding work has completed.

Methods

`impl<S, T> Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin,` [src][−]

`pub fn parameter(&self, name: &str) -> Option<&str>`[src][−]

Returns the value of a runtime parameter for this connection.

`pub fn poll_message( &mut self, cx: &mut Context ) -> Poll<Option<Result<AsyncMessage, Error>>>`[src][−]

Polls for asynchronous messages from the server.

The server can send notices as well as notifications asynchronously to the client. Applications that wish to examine those messages should use this method to drive the connection rather than its Future implementation.

Trait Implementations

`impl<S, T> Future for Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin,` [src][+]

[+] Show hidden undocumented items

`type Output = Result<(), Error>`

The type of value produced on completion.

`fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Result<(), Error>>`[src][−]

Auto Trait Implementations

`impl<S, T> Send for Connection<S, T> where S: Send, T: Send,`

`impl<S, T> !Sync for Connection<S, T>`

`impl<S, T> Unpin for Connection<S, T> where S: Unpin, T: Unpin,`

`impl<S, T> !UnwindSafe for Connection<S, T>`

`impl<S, T> !RefUnwindSafe for Connection<S, T>`

Blanket Implementations

`impl<T, U> Into for T where U: From<T>,` [src][+]

[+] Show hidden undocumented items

`fn into(self) -> U`[src][−]

`impl<T> From<T> for T`[src][+]

[+] Show hidden undocumented items

`fn from(t: T) -> T`[src][−]

`impl<T, U> TryFrom for T where U: Into<T>,` [src][+]

[+] Show hidden undocumented items

`type Error = Infallible`

The type returned in the event of a conversion error.

`fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>`[src][−]

`impl<T, U> TryInto for T where U: TryFrom<T>,` [src][+]

[+] Show hidden undocumented items

`type Error = >::Error`

The type returned in the event of a conversion error.

`fn try_into(self) -> Result<U, >::Error>`[src][−]

`impl<T> Borrow<T> for T where T: ?Sized,` [src][+]

[+] Show hidden undocumented items

`fn borrow(&self) -> &T`[src][−]

`impl<T> BorrowMut<T> for T where T: ?Sized,` [src][+]

[+] Show hidden undocumented items

`fn borrow_mut(&mut self) -> &mut T`[src][−]

`impl<T> Any for T where T: 'static + ?Sized,` [src][+]

[+] Show hidden undocumented items

`fn type_id(&self) -> TypeId`[src][−]

`impl<T> Same<T> for T`

`type Output = T`

Should always be Self

`impl<T> FutureExt for T where T: Future + ?Sized,` [src][+]

[+] Show hidden undocumented items

`fn timeout(self, timeout: Duration) -> Timeout<Self>`[src][−]

`impl<T> FutureExt for T where T: Future + ?Sized,` [src][+]

[+] Show hidden undocumented items

`fn map<U, F>(self, f: F) -> Map<Self, F> where F: FnOnce(Self::Output) -> U,` [src][−]

`fn then<Fut, F>(self, f: F) -> Then<Self, Fut, F> where F: FnOnce(Self::Output) -> Fut, Fut: Future,` [src][−]

`fn left_future(self) -> Either<Self, B> where B: Future<Output = Self::Output>,` [src][−]

`fn right_future<A>(self) -> Either<A, Self> where A: Future<Output = Self::Output>,` [src][−]

`fn into_stream(self) -> IntoStream<Self>`[src][−]

`fn flatten(self) -> Flatten<Self> where Self::Output: Future,` [src][−]

`fn flatten_stream(self) -> FlattenStream<Self> where Self::Output: Stream,` [src][−]

`fn fuse(self) -> Fuse<Self>`[src][−]

`fn inspect<F>(self, f: F) -> Inspect<Self, F> where F: FnOnce(&Self::Output),` [src][−]

`fn catch_unwind(self) -> CatchUnwind<Self> where Self: UnwindSafe,` [src][−]

`fn shared(self) -> Shared<Self> where Self::Output: Clone,` [src][−]

`fn remote_handle(self) -> (Remote<Self>, RemoteHandle<Self::Output>)`[src][−]

`fn boxed<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a + Send>> where Self: Send + 'a,` [src][−]

`fn boxed_local<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a>> where Self: 'a,` [src][−]

`fn unit_error(self) -> UnitError<Self>`[src][−]

`fn never_error(self) -> NeverError<Self>`[src][−]

`fn poll_unpin(&mut self, cx: &mut Context) -> Poll<Self::Output> where Self: Unpin,` [src][−]

`fn now_or_never(self) -> Option<Self::Output>`[src][−]

`impl<F, T, E> TryFuture for F where F: Future<Output = Result<T, E>> + ?Sized,` [src][+]

[+] Show hidden undocumented items

`type Ok = T`

The type of successful values yielded by this future

`type Error = E`

The type of failures yielded by this future

`fn try_poll(self: Pin<&mut F>, cx: &mut Context) -> Poll<<F as Future>::Output>`[src][−]

`impl<Fut> TryFutureExt for Fut where Fut: TryFuture + ?Sized,` [src][+]

[+] Show hidden undocumented items

[−][src]Struct tokio_postgres::Connection

Methods

impl<S, T> Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin, [src][−]

pub fn parameter(&self, name: &str) -> Option<&str>[src][−]

pub fn poll_message( &mut self, cx: &mut Context) -> Poll<Option<Result<AsyncMessage, Error>>>[src][−]

Trait Implementations

impl<S, T> Future for Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin, [src][+]

type Output = Result<(), Error>

fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Result<(), Error>>[src][−]

Auto Trait Implementations

impl<S, T> Send for Connection<S, T> where S: Send, T: Send,

impl<S, T> !Sync for Connection<S, T>

impl<S, T> Unpin for Connection<S, T> where S: Unpin, T: Unpin,

impl<S, T> !UnwindSafe for Connection<S, T>

impl<S, T> !RefUnwindSafe for Connection<S, T>

Blanket Implementations

impl<T, U> Into<U> for T where U: From<T>, [src][+]

fn into(self) -> U[src][−]

impl<T> From<T> for T[src][+]

fn from(t: T) -> T[src][−]

impl<T, U> TryFrom<U> for T where U: Into<T>, [src][+]

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src][−]

impl<T, U> TryInto<U> for T where U: TryFrom<T>, [src][+]

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src][−]

impl<T> Borrow<T> for T where T: ?Sized, [src][+]

fn borrow(&self) -> &T[src][−]

impl<T> BorrowMut<T> for T where T: ?Sized, [src][+]

fn borrow_mut(&mut self) -> &mut T[src][−]

impl<T> Any for T where T: 'static + ?Sized, [src][+]

fn type_id(&self) -> TypeId[src][−]

impl<T> Same<T> for T

type Output = T

impl<T> FutureExt for T where T: Future + ?Sized, [src][+]

fn timeout(self, timeout: Duration) -> Timeout<Self>[src][−]

impl<T> FutureExt for T where T: Future + ?Sized, [src][+]

fn map<U, F>(self, f: F) -> Map<Self, F> where F: FnOnce(Self::Output) -> U, [src][−]

fn then<Fut, F>(self, f: F) -> Then<Self, Fut, F> where F: FnOnce(Self::Output) -> Fut, Fut: Future, [src][−]

fn left_future<B>(self) -> Either<Self, B> where B: Future<Output = Self::Output>, [src][−]

fn right_future<A>(self) -> Either<A, Self> where A: Future<Output = Self::Output>, [src][−]

fn into_stream(self) -> IntoStream<Self>[src][−]

fn flatten(self) -> Flatten<Self> where Self::Output: Future, [src][−]

fn flatten_stream(self) -> FlattenStream<Self> where Self::Output: Stream, [src][−]

fn fuse(self) -> Fuse<Self>[src][−]

fn inspect<F>(self, f: F) -> Inspect<Self, F> where F: FnOnce(&Self::Output), [src][−]

fn catch_unwind(self) -> CatchUnwind<Self> where Self: UnwindSafe, [src][−]

fn shared(self) -> Shared<Self> where Self::Output: Clone, [src][−]

fn remote_handle(self) -> (Remote<Self>, RemoteHandle<Self::Output>)[src][−]

fn boxed<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a + Send>> where Self: Send + 'a, [src][−]

fn boxed_local<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a>> where Self: 'a, [src][−]

fn unit_error(self) -> UnitError<Self>[src][−]

fn never_error(self) -> NeverError<Self>[src][−]

fn poll_unpin(&mut self, cx: &mut Context) -> Poll<Self::Output> where Self: Unpin, [src][−]

fn now_or_never(self) -> Option<Self::Output>[src][−]

impl<F, T, E> TryFuture for F where F: Future<Output = Result<T, E>> + ?Sized, [src][+]

type Ok = T

type Error = E

fn try_poll(self: Pin<&mut F>, cx: &mut Context) -> Poll<<F as Future>::Output>[src][−]

impl<Fut> TryFutureExt for Fut where Fut: TryFuture + ?Sized, [src][+]

fn flatten_sink<Item>(self) -> FlattenSink<Self, Self::Ok> where Self::Ok: Sink<Item>, <Self::Ok as Sink<Item>>::Error == Self::Error, [src][−]

fn map_ok<T, F>(self, f: F) -> MapOk<Self, F> where F: FnOnce(Self::Ok) -> T, [src][−]

fn map_err<E, F>(self, f: F) -> MapErr<Self, F> where F: FnOnce(Self::Error) -> E, [src][−]

fn err_into<E>(self) -> ErrInto<Self, E> where Self::Error: Into<E>, [src][−]

fn and_then<Fut, F>(self, f: F) -> AndThen<Self, Fut, F> where F: FnOnce(Self::Ok) -> Fut, Fut: TryFuture<Error = Self::Error>, [src][−]

fn or_else<Fut, F>(self, f: F) -> OrElse<Self, Fut, F> where F: FnOnce(Self::Error) -> Fut, Fut: TryFuture<Ok = Self::Ok>, [src][−]

fn inspect_ok<F>(self, f: F) -> InspectOk<Self, F> where F: FnOnce(&Self::Ok), [src][−]

fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where F: FnOnce(&Self::Error), [src][−]

fn try_flatten_stream(self) -> TryFlattenStream<Self> where Self::Ok: TryStream, <Self::Ok as TryStream>::Error == Self::Error, [src][−]

fn unwrap_or_else<F>(self, f: F) -> UnwrapOrElse<Self, F> where F: FnOnce(Self::Error) -> Self::Ok, [src][−]

fn into_future(self) -> IntoFuture<Self>[src][−]

fn try_poll_unpin( &mut self, cx: &mut Context) -> Poll<Result<Self::Ok, Self::Error>> where Self: Unpin, [src][−]

`impl<S, T> Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin,` [src][−]

`pub fn parameter(&self, name: &str) -> Option<&str>`[src][−]

`pub fn poll_message( &mut self, cx: &mut Context ) -> Poll<Option<Result<AsyncMessage, Error>>>`[src][−]

`impl<S, T> Future for Connection<S, T> where S: AsyncRead + AsyncWrite + Unpin, T: AsyncRead + AsyncWrite + Unpin,` [src][+]

`type Output = Result<(), Error>`

`fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Result<(), Error>>`[src][−]

`impl<S, T> Send for Connection<S, T> where S: Send, T: Send,`

`impl<S, T> !Sync for Connection<S, T>`

`impl<S, T> Unpin for Connection<S, T> where S: Unpin, T: Unpin,`

`impl<S, T> !UnwindSafe for Connection<S, T>`

`impl<S, T> !RefUnwindSafe for Connection<S, T>`

`impl<T, U> Into<U> for T where U: From<T>,` [src][+]

`fn into(self) -> U`[src][−]

`impl<T> From<T> for T`[src][+]

`fn from(t: T) -> T`[src][−]

`impl<T, U> TryFrom<U> for T where U: Into<T>,` [src][+]

`type Error = Infallible`

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src][−]

`impl<T, U> TryInto<U> for T where U: TryFrom<T>,` [src][+]

`type Error = <U as TryFrom<T>>::Error`

`fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src][−]

`impl<T> Borrow<T> for T where T: ?Sized,` [src][+]

`fn borrow(&self) -> &T`[src][−]

`impl<T> BorrowMut<T> for T where T: ?Sized,` [src][+]

`fn borrow_mut(&mut self) -> &mut T`[src][−]

`impl<T> Any for T where T: 'static + ?Sized,` [src][+]

`fn type_id(&self) -> TypeId`[src][−]

`impl<T> Same<T> for T`

`type Output = T`

`impl<T> FutureExt for T where T: Future + ?Sized,` [src][+]

`fn timeout(self, timeout: Duration) -> Timeout<Self>`[src][−]

`impl<T> FutureExt for T where T: Future + ?Sized,` [src][+]

`fn map<U, F>(self, f: F) -> Map<Self, F> where F: FnOnce(Self::Output) -> U,` [src][−]

`fn then<Fut, F>(self, f: F) -> Then<Self, Fut, F> where F: FnOnce(Self::Output) -> Fut, Fut: Future,` [src][−]

`fn left_future<B>(self) -> Either<Self, B> where B: Future<Output = Self::Output>,` [src][−]

`fn right_future<A>(self) -> Either<A, Self> where A: Future<Output = Self::Output>,` [src][−]

`fn into_stream(self) -> IntoStream<Self>`[src][−]

`fn flatten(self) -> Flatten<Self> where Self::Output: Future,` [src][−]

`fn flatten_stream(self) -> FlattenStream<Self> where Self::Output: Stream,` [src][−]

`fn fuse(self) -> Fuse<Self>`[src][−]

`fn inspect<F>(self, f: F) -> Inspect<Self, F> where F: FnOnce(&Self::Output),` [src][−]

`fn catch_unwind(self) -> CatchUnwind<Self> where Self: UnwindSafe,` [src][−]

`fn shared(self) -> Shared<Self> where Self::Output: Clone,` [src][−]

`fn remote_handle(self) -> (Remote<Self>, RemoteHandle<Self::Output>)`[src][−]

`fn boxed<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a + Send>> where Self: Send + 'a,` [src][−]

`fn boxed_local<'a>(self) -> Pin<Box<dyn Future<Output = Self::Output> + 'a>> where Self: 'a,` [src][−]

`fn unit_error(self) -> UnitError<Self>`[src][−]

`fn never_error(self) -> NeverError<Self>`[src][−]

`fn poll_unpin(&mut self, cx: &mut Context) -> Poll<Self::Output> where Self: Unpin,` [src][−]

`fn now_or_never(self) -> Option<Self::Output>`[src][−]

`impl<F, T, E> TryFuture for F where F: Future<Output = Result<T, E>> + ?Sized,` [src][+]

`type Ok = T`

`type Error = E`

`fn try_poll(self: Pin<&mut F>, cx: &mut Context) -> Poll<<F as Future>::Output>`[src][−]

`impl<Fut> TryFutureExt for Fut where Fut: TryFuture + ?Sized,` [src][+]

`fn flatten_sink<Item>(self) -> FlattenSink<Self, Self::Ok> where Self::Ok: Sink<Item>, <Self::Ok as Sink<Item>>::Error == Self::Error,` [src][−]

`fn map_ok<T, F>(self, f: F) -> MapOk<Self, F> where F: FnOnce(Self::Ok) -> T,` [src][−]

`fn map_err<E, F>(self, f: F) -> MapErr<Self, F> where F: FnOnce(Self::Error) -> E,` [src][−]

`fn err_into<E>(self) -> ErrInto<Self, E> where Self::Error: Into<E>,` [src][−]

`fn and_then<Fut, F>(self, f: F) -> AndThen<Self, Fut, F> where F: FnOnce(Self::Ok) -> Fut, Fut: TryFuture<Error = Self::Error>,` [src][−]

`fn or_else<Fut, F>(self, f: F) -> OrElse<Self, Fut, F> where F: FnOnce(Self::Error) -> Fut, Fut: TryFuture<Ok = Self::Ok>,` [src][−]

`fn inspect_ok<F>(self, f: F) -> InspectOk<Self, F> where F: FnOnce(&Self::Ok),` [src][−]

`fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where F: FnOnce(&Self::Error),` [src][−]

`fn try_flatten_stream(self) -> TryFlattenStream<Self> where Self::Ok: TryStream, <Self::Ok as TryStream>::Error == Self::Error,` [src][−]

`fn unwrap_or_else<F>(self, f: F) -> UnwrapOrElse<Self, F> where F: FnOnce(Self::Error) -> Self::Ok,` [src][−]

`fn into_future(self) -> IntoFuture<Self>`[src][−]

`fn try_poll_unpin( &mut self, cx: &mut Context ) -> Poll<Result<Self::Ok, Self::Error>> where Self: Unpin,` [src][−]