| <!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="A boxed `Service + Send` trait object."><meta name="keywords" content="rust, rustlang, rust-lang, BoxService"><title>BoxService in tower::util - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../../normalize.css"><link rel="stylesheet" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../../ayu.css" disabled><link rel="stylesheet" href="../../dark.css" disabled><link rel="stylesheet" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../main.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">☰</button><a class="sidebar-logo" href="../../tower/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2></h2></nav><nav class="sidebar"><a class="sidebar-logo" href="../../tower/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2 class="location"><a href="#">BoxService</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Methods</a></h3><ul class="block"><li><a href="#method.layer">layer</a></li><li><a href="#method.new">new</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Debug-for-BoxService%3CT%2C%20U%2C%20E%3E">Debug</a></li><li><a href="#impl-Service%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">Service<T></a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E">!RefUnwindSafe</a></li><li><a href="#impl-Send-for-BoxService%3CT%2C%20U%2C%20E%3E">Send</a></li><li><a href="#impl-Sync-for-BoxService%3CT%2C%20U%2C%20E%3E">!Sync</a></li><li><a href="#impl-Unpin-for-BoxService%3CT%2C%20U%2C%20E%3E">Unpin</a></li><li><a href="#impl-UnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E">!UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-BoxService%3CT%2C%20U%2C%20E%3E">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">Borrow<T></a></li><li><a href="#impl-BorrowMut%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">BorrowMut<T></a></li><li><a href="#impl-From%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">From<T></a></li><li><a href="#impl-Instrument-for-BoxService%3CT%2C%20U%2C%20E%3E">Instrument</a></li><li><a href="#impl-Into%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">Into<U></a></li><li><a href="#impl-ServiceExt%3CRequest%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">ServiceExt<Request></a></li><li><a href="#impl-TryFrom%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">TryFrom<U></a></li><li><a href="#impl-TryInto%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">TryInto<U></a></li><li><a href="#impl-VZip%3CV%3E-for-BoxService%3CT%2C%20U%2C%20E%3E">VZip<V></a></li><li><a href="#impl-WithSubscriber-for-BoxService%3CT%2C%20U%2C%20E%3E">WithSubscriber</a></li></ul></section><h2><a href="index.html">In tower::util</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1 class="fqn">Struct <a href="../index.html">tower</a>::<wbr><a href="index.html">util</a>::<wbr><a class="struct" href="#">BoxService</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../../src/tower/util/boxed/sync.rs.html#22-24">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">−</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code>pub struct BoxService<T, U, E> { /* private fields */ }</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A boxed <code>Service + Send</code> trait object.</p> |
| <p><a href="struct.BoxService.html" title="BoxService"><code>BoxService</code></a> turns a service into a trait object, allowing the response |
| future type to be dynamic. This type requires both the service and the |
| response future to be [<code>Send</code>].</p> |
| <p>If you need a boxed <a href="../trait.Service.html" title="Service"><code>Service</code></a> that implements [<code>Clone</code>] consider using |
| <a href="struct.BoxCloneService.html"><code>BoxCloneService</code></a>.</p> |
| <p>See module level documentation for more details.</p> |
| </div></details><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><div id="implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#32-54">source</a><a href="#impl-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section></summary><div class="impl-items"><section id="method.new" class="method has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#34-41">source</a><h4 class="code-header">pub fn <a href="#method.new" class="fnname">new</a><S>(inner: S) -> Self<span class="where fmt-newline">where<br> S: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><T, Response = U, Error = E> + Send + 'static,<br> S::<a class="associatedtype" href="../trait.Service.html#associatedtype.Future" title="type tower::Service::Future">Future</a>: Send + 'static,</span></h4></section><details class="rustdoc-toggle method-toggle" open><summary><section id="method.layer" class="method has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#47-53">source</a><h4 class="code-header">pub fn <a href="#method.layer" class="fnname">layer</a><S>() -> <a class="struct" href="../layer/struct.LayerFn.html" title="struct tower::layer::LayerFn">LayerFn</a><fn(_: S) -> Self><span class="where fmt-newline">where<br> S: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><T, Response = U, Error = E> + Send + 'static,<br> S::<a class="associatedtype" href="../trait.Service.html#associatedtype.Future" title="type tower::Service::Future">Future</a>: Send + 'static,</span></h4></section></summary><div class="docblock"><p>Returns a <a href="../trait.Layer.html"><code>Layer</code></a> for wrapping a <a href="../trait.Service.html" title="Service"><code>Service</code></a> in a <a href="struct.BoxService.html" title="BoxService"><code>BoxService</code></a> |
| middleware.</p> |
| </div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#70-74">source</a><a href="#impl-Debug-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> Debug for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#71-73">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&self, fmt: &mut Formatter<'_>) -> Result</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Service%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#56-68">source</a><a href="#impl-Service%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><T> for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Response" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Response" class="anchor"></a><h4 class="code-header">type <a href="../trait.Service.html#associatedtype.Response" class="associatedtype">Response</a> = U</h4></section></summary><div class='docblock'>Responses given by the service.</div></details><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a href="../trait.Service.html#associatedtype.Error" class="associatedtype">Error</a> = E</h4></section></summary><div class='docblock'>Errors produced by the service.</div></details><details class="rustdoc-toggle" open><summary><section id="associatedtype.Future" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Future" class="anchor"></a><h4 class="code-header">type <a href="../trait.Service.html#associatedtype.Future" class="associatedtype">Future</a> = Pin<Box<dyn Future<Output = Result<U, E>> + Send + 'static, Global>></h4></section></summary><div class='docblock'>The future response value.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.poll_ready" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#61-63">source</a><a href="#method.poll_ready" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Service.html#tymethod.poll_ready" class="fnname">poll_ready</a>(&mut self, cx: &mut Context<'_>) -> Poll<Result<(), E>></h4></section></summary><div class='docblock'>Returns <code>Poll::Ready(Ok(()))</code> when the service is able to process requests. <a href="../trait.Service.html#tymethod.poll_ready">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.call" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/boxed/sync.rs.html#65-67">source</a><a href="#method.call" class="anchor"></a><h4 class="code-header">fn <a href="../trait.Service.html#tymethod.call" class="fnname">call</a>(<br> &mut self,<br> request: T<br>) -> Pin<Box<dyn Future<Output = Result<U, E>> + Send>></h4></section></summary><div class='docblock'>Process the request and return the response asynchronously. <a href="../trait.Service.html#tymethod.call">Read more</a></div></details></div></details></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> !RefUnwindSafe for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section><section id="impl-Send-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Send-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> Send for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section><section id="impl-Sync-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Sync-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> !Sync for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section><section id="impl-Unpin-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Unpin-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> Unpin for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section><section id="impl-UnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-UnwindSafe-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U, E> !UnwindSafe for <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><T, U, E></h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Any-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Any-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> Any for T<span class="where fmt-newline">where<br> T: 'static + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><a href="#method.type_id" class="anchor"></a><h4 class="code-header">fn <a class="fnname">type_id</a>(&self) -> TypeId</h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> Borrow<T> for T<span class="where fmt-newline">where<br> T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&self) -> &T</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> BorrowMut<T> for T<span class="where fmt-newline">where<br> T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow_mut</a>(&mut self) -> &mut T</h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> From<T> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(t: T) -> T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Instrument-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#276">source</a><a href="#impl-Instrument-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> <a class="trait" href="../../tracing/instrument/trait.Instrument.html" title="trait tracing::instrument::Instrument">Instrument</a> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.instrument" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#82">source</a><a href="#method.instrument" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.instrument" class="fnname">instrument</a>(self, span: <a class="struct" href="../../tracing/span/struct.Span.html" title="struct tracing::span::Span">Span</a>) -> <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a><Self></h4></section></summary><div class='docblock'>Instruments this type with the provided <a href="../../tracing/span/struct.Span.html" title="Span"><code>Span</code></a>, returning an |
| <code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.instrument">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.in_current_span" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#121">source</a><a href="#method.in_current_span" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span" class="fnname">in_current_span</a>(self) -> <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a><Self></h4></section></summary><div class='docblock'>Instruments this type with the <a href="../../tracing/span/struct.Span.html#method.current">current</a> <a href="../../tracing/span/struct.Span.html"><code>Span</code></a>, returning an |
| <code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span">Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U> Into<U> for T<span class="where fmt-newline">where<br> U: From<T>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">into</a>(self) -> U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p> |
| <p>That is, this conversion is whatever the implementation of |
| <code>[From]<T> for U</code> chooses to do.</p> |
| </div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-ServiceExt%3CRequest%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#1055">source</a><a href="#impl-ServiceExt%3CRequest%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, Request> <a class="trait" href="../trait.ServiceExt.html" title="trait tower::ServiceExt">ServiceExt</a><Request> for T<span class="where fmt-newline">where<br> T: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><Request> + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ready" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#67-72">source</a><a href="#method.ready" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.ready" class="fnname">ready</a>(&mut self) -> <a class="struct" href="struct.Ready.html" title="struct tower::util::Ready">Ready</a><'_, Self, Request><span class="notable-traits"><span class="notable-traits-tooltip">ⓘ<span class="notable-traits-tooltiptext"><span class="docblock"><span class="notable">Notable traits for <a class="struct" href="struct.Ready.html" title="struct tower::util::Ready">Ready</a><'a, T, Request></span><code class="content"><span class="where fmt-newline">impl<'a, T, Request> Future for <a class="struct" href="struct.Ready.html" title="struct tower::util::Ready">Ready</a><'a, T, Request><span class="where fmt-newline">where<br> T: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><Request>,</span></span><span class="where fmt-newline"> type <a class="associatedtype">Output</a> = Result<&'a mut T, T::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>;</span></code></span></span></span></span><span class="where fmt-newline">where<br> Self: Sized,</span></h4></section></summary><div class='docblock'>Yields a mutable reference to the service when it is ready to accept a request.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ready_and" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#80-85">source</a><a href="#method.ready_and" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.ready_and" class="fnname">ready_and</a>(&mut self) -> <a class="type" href="type.ReadyAnd.html" title="type tower::util::ReadyAnd">ReadyAnd</a><'_, Self, Request><span class="where fmt-newline">where<br> Self: Sized,</span></h4></section></summary><span class="item-info"><div class="stab deprecated"><span class="emoji">👎</span><span>Deprecated since 0.4.6: please use the <code>ServiceExt::ready</code> method instead</span></div></span><div class='docblock'>Yields a mutable reference to the service when it is ready to accept a request.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ready_oneshot" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#88-93">source</a><a href="#method.ready_oneshot" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.ready_oneshot" class="fnname">ready_oneshot</a>(self) -> <a class="struct" href="struct.ReadyOneshot.html" title="struct tower::util::ReadyOneshot">ReadyOneshot</a><Self, Request><span class="notable-traits"><span class="notable-traits-tooltip">ⓘ<span class="notable-traits-tooltiptext"><span class="docblock"><span class="notable">Notable traits for <a class="struct" href="struct.ReadyOneshot.html" title="struct tower::util::ReadyOneshot">ReadyOneshot</a><T, Request></span><code class="content"><span class="where fmt-newline">impl<T, Request> Future for <a class="struct" href="struct.ReadyOneshot.html" title="struct tower::util::ReadyOneshot">ReadyOneshot</a><T, Request><span class="where fmt-newline">where<br> T: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><Request>,</span></span><span class="where fmt-newline"> type <a class="associatedtype">Output</a> = Result<T, T::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>;</span></code></span></span></span></span><span class="where fmt-newline">where<br> Self: Sized,</span></h4></section></summary><div class='docblock'>Yields the service when it is ready to accept a request.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.oneshot" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#96-101">source</a><a href="#method.oneshot" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.oneshot" class="fnname">oneshot</a>(self, req: Request) -> <a class="struct" href="struct.Oneshot.html" title="struct tower::util::Oneshot">Oneshot</a><Self, Request><span class="notable-traits"><span class="notable-traits-tooltip">ⓘ<span class="notable-traits-tooltiptext"><span class="docblock"><span class="notable">Notable traits for <a class="struct" href="struct.Oneshot.html" title="struct tower::util::Oneshot">Oneshot</a><S, Req></span><code class="content"><span class="where fmt-newline">impl<S, Req> Future for <a class="struct" href="struct.Oneshot.html" title="struct tower::util::Oneshot">Oneshot</a><S, Req><span class="where fmt-newline">where<br> S: <a class="trait" href="../trait.Service.html" title="trait tower::Service">Service</a><Req>,</span></span><span class="where fmt-newline"> type <a class="associatedtype">Output</a> = Result<S::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>, S::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>;</span></code></span></span></span></span><span class="where fmt-newline">where<br> Self: Sized,</span></h4></section></summary><div class='docblock'>Consume this <code>Service</code>, calling with the providing request once it is ready.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.call_all" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#111-118">source</a><a href="#method.call_all" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.call_all" class="fnname">call_all</a><S>(self, reqs: S) -> <a class="struct" href="struct.CallAll.html" title="struct tower::util::CallAll">CallAll</a><Self, S><span class="where fmt-newline">where<br> Self: Sized,<br> Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>: Into<<a class="type" href="../type.BoxError.html" title="type tower::BoxError">BoxError</a>>,<br> S: <a class="trait" href="../../futures_core/stream/trait.Stream.html" title="trait futures_core::stream::Stream">Stream</a><Item = Request>,</span></h4></section></summary><div class='docblock'>Process all requests from the given <a href="https://docs.rs/futures/latest/futures/stream/trait.Stream.html"><code>Stream</code></a>, and produce a <a href="https://docs.rs/futures/latest/futures/stream/trait.Stream.html"><code>Stream</code></a> of their responses. <a href="../trait.ServiceExt.html#method.call_all">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.and_then" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#180-186">source</a><a href="#method.and_then" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.and_then" class="fnname">and_then</a><F>(self, f: F) -> <a class="struct" href="struct.AndThen.html" title="struct tower::util::AndThen">AndThen</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> F: Clone,</span></h4></section></summary><div class='docblock'>Executes a new future after this service’s future resolves. This does |
| not alter the behaviour of the <a href="../trait.Service.html#tymethod.poll_ready"><code>poll_ready</code></a> method. <a href="../trait.ServiceExt.html#method.and_then">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.map_response" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#249-255">source</a><a href="#method.map_response" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.map_response" class="fnname">map_response</a><F, Response>(self, f: F) -> <a class="struct" href="struct.MapResponse.html" title="struct tower::util::MapResponse">MapResponse</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> F: FnOnce(Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>) -> Response + Clone,</span></h4></section></summary><div class='docblock'>Maps this service’s response value to a different value. This does not |
| alter the behaviour of the <a href="../trait.Service.html#tymethod.poll_ready"><code>poll_ready</code></a> method. <a href="../trait.ServiceExt.html#method.map_response">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.map_err" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#317-323">source</a><a href="#method.map_err" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.map_err" class="fnname">map_err</a><F, Error>(self, f: F) -> <a class="struct" href="struct.MapErr.html" title="struct tower::util::MapErr">MapErr</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> F: FnOnce(Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>) -> Error + Clone,</span></h4></section></summary><div class='docblock'>Maps this service’s error value to a different value. This does not |
| alter the behaviour of the <a href="../trait.Service.html#tymethod.poll_ready"><code>poll_ready</code></a> method. <a href="../trait.ServiceExt.html#method.map_err">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.map_result" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#546-553">source</a><a href="#method.map_result" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.map_result" class="fnname">map_result</a><F, Response, Error>(self, f: F) -> <a class="struct" href="struct.MapResult.html" title="struct tower::util::MapResult">MapResult</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> Error: From<Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>,<br> F: FnOnce(Result<Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>) -> Result<Response, Error> + Clone,</span></h4></section></summary><div class='docblock'>Maps this service’s result type (<code>Result<Self::Response, Self::Error></code>) |
| to a different value, regardless of whether the future succeeds or |
| fails. <a href="../trait.ServiceExt.html#method.map_result">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.map_request" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#606-612">source</a><a href="#method.map_request" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.map_request" class="fnname">map_request</a><F, NewRequest>(self, f: F) -> <a class="struct" href="struct.MapRequest.html" title="struct tower::util::MapRequest">MapRequest</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> F: FnMut(NewRequest) -> Request,</span></h4></section></summary><div class='docblock'>Composes a function <em>in front of</em> the service. <a href="../trait.ServiceExt.html#method.map_request">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.then" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#873-881">source</a><a href="#method.then" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.then" class="fnname">then</a><F, Response, Error, Fut>(self, f: F) -> <a class="struct" href="struct.Then.html" title="struct tower::util::Then">Then</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> Error: From<Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>,<br> F: FnOnce(Result<Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>) -> Fut + Clone,<br> Fut: Future<Output = Result<Response, Error>>,</span></h4></section></summary><div class='docblock'>Composes an asynchronous function <em>after</em> this service. <a href="../trait.ServiceExt.html#method.then">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.map_future" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#947-955">source</a><a href="#method.map_future" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.map_future" class="fnname">map_future</a><F, Fut, Response, Error>(self, f: F) -> <a class="struct" href="struct.MapFuture.html" title="struct tower::util::MapFuture">MapFuture</a><Self, F><span class="where fmt-newline">where<br> Self: Sized,<br> F: FnMut(Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Future" title="type tower::Service::Future">Future</a>) -> Fut,<br> Error: From<Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>>,<br> Fut: Future<Output = Result<Response, Error>>,</span></h4></section></summary><div class='docblock'>Composes a function that transforms futures produced by the service. <a href="../trait.ServiceExt.html#method.map_future">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.boxed" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#997-1003">source</a><a href="#method.boxed" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.boxed" class="fnname">boxed</a>(self) -> <a class="struct" href="struct.BoxService.html" title="struct tower::util::BoxService">BoxService</a><Request, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>><span class="where fmt-newline">where<br> Self: Sized + Send + 'static,<br> Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Future" title="type tower::Service::Future">Future</a>: Send + 'static,</span></h4></section></summary><div class='docblock'>Convert the service into a <a href="../trait.Service.html"><code>Service</code></a> + [<code>Send</code>] trait object. <a href="../trait.ServiceExt.html#method.boxed">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.boxed_clone" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tower/util/mod.rs.html#1046-1052">source</a><a href="#method.boxed_clone" class="anchor"></a><h4 class="code-header">fn <a href="../trait.ServiceExt.html#method.boxed_clone" class="fnname">boxed_clone</a>(self) -> <a class="struct" href="struct.BoxCloneService.html" title="struct tower::util::BoxCloneService">BoxCloneService</a><Request, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Response" title="type tower::Service::Response">Response</a>, Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Error" title="type tower::Service::Error">Error</a>><span class="where fmt-newline">where<br> Self: Clone + Sized + Send + 'static,<br> Self::<a class="associatedtype" href="../trait.Service.html#associatedtype.Future" title="type tower::Service::Future">Future</a>: Send + 'static,</span></h4></section></summary><div class='docblock'>Convert the service into a <a href="../trait.Service.html"><code>Service</code></a> + [<code>Clone</code>] + [<code>Send</code>] trait object. <a href="../trait.ServiceExt.html#method.boxed_clone">Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U> TryFrom<U> for T<span class="where fmt-newline">where<br> U: Into<T>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-2" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-2" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = Infallible</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(value: U) -> Result<T, <T as TryFrom<U>>::Error></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T, U> TryInto<U> for T<span class="where fmt-newline">where<br> U: TryFrom<T>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = <U as TryFrom<T>>::Error</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_into</a>(self) -> Result<U, <U as TryFrom<T>>::Error></h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-VZip%3CV%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/ppv_lite86/types.rs.html#221">source</a><a href="#impl-VZip%3CV%3E-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<V, T> <a class="trait" href="../../ppv_lite86/types/trait.VZip.html" title="trait ppv_lite86::types::VZip">VZip</a><V> for T<span class="where fmt-newline">where<br> V: <a class="trait" href="../../ppv_lite86/types/trait.MultiLane.html" title="trait ppv_lite86::types::MultiLane">MultiLane</a><T>,</span></h3></section></summary><div class="impl-items"><section id="method.vzip" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/ppv_lite86/types.rs.html#226">source</a><a href="#method.vzip" class="anchor"></a><h4 class="code-header">fn <a href="../../ppv_lite86/types/trait.VZip.html#tymethod.vzip" class="fnname">vzip</a>(self) -> V</h4></section></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-WithSubscriber-for-BoxService%3CT%2C%20U%2C%20E%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#334">source</a><a href="#impl-WithSubscriber-for-BoxService%3CT%2C%20U%2C%20E%3E" class="anchor"></a><h3 class="code-header">impl<T> <a class="trait" href="../../tracing/instrument/trait.WithSubscriber.html" title="trait tracing::instrument::WithSubscriber">WithSubscriber</a> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#169-171">source</a><a href="#method.with_subscriber" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber" class="fnname">with_subscriber</a><S>(self, subscriber: S) -> <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a><Self><span class="where fmt-newline">where<br> S: Into<<a class="struct" href="../../tracing_core/dispatcher/struct.Dispatch.html" title="struct tracing_core::dispatcher::Dispatch">Dispatch</a>>,</span></h4></section></summary><div class='docblock'>Attaches the provided <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a |
| <a href="../../tracing/instrument/struct.WithDispatch.html" title="WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_current_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#221">source</a><a href="#method.with_current_subscriber" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber" class="fnname">with_current_subscriber</a>(self) -> <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a><Self></h4></section></summary><div class='docblock'>Attaches the current <a href="../../tracing/dispatcher/index.html#setting-the-default-subscriber">default</a> <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a |
| <a href="../../tracing/instrument/struct.WithDispatch.html" title="WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber">Read more</a></div></details></div></details></div></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="tower" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.66.0-nightly (5c8bff74b 2022-10-21)" ></div></body></html> |
