actix/actix-website
1
0
Fork 0
mirror of https://github.com/actix/actix-website synced 2025-06-30 16:54:27 +02:00
Code Issues Releases Wiki Activity

update actix-web api docs

Browse Source
This commit is contained in:
Nikolay Kim
2018-10-10 08:38:33 -07:00
parent 29977f4930
commit bf8faa455d
2298 changed files with 129471 additions and 17241 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
static/api/actix-web/stable/src/actix_web/application.rs.html
View File

@ -877,8 +877,6 @@
<span id="877">877</span>
<span id="878">878</span>
<span id="879">879</span>
<span id="880">880</span>
<span id="881">881</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
@ -894,6 +892,7 @@
<span class="kw">use</span> <span class="ident">router</span>::{<span class="ident">ResourceDef</span>, <span class="ident">Router</span>};
<span class="kw">use</span> <span class="ident">scope</span>::<span class="ident">Scope</span>;
<span class="kw">use</span> <span class="ident">server</span>::{<span class="ident">HttpHandler</span>, <span class="ident">HttpHandlerTask</span>, <span class="ident">IntoHttpHandler</span>, <span class="ident">Request</span>};
<span class="kw">use</span> <span class="ident">with</span>::<span class="ident">WithFactory</span>;
<span class="doccomment">/// Application</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">HttpApplication</span><span class="op">&lt;</span><span class="ident">S</span> <span class="op">=</span> ()<span class="op">&gt;</span> {
@ -1016,13 +1015,13 @@
<span class="doccomment">/// instance for each thread, thus application state must be constructed</span>
<span class="doccomment">/// multiple times. If you want to share state between different</span>
<span class="doccomment">/// threads, a shared object should be used, e.g. `Arc`. Application</span>
<span class="doccomment">/// state does not need to be `Send` and `Sync`.</span>
<span class="doccomment">/// state does not need to be `Send` or `Sync`.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_state</span>(<span class="ident">state</span>: <span class="ident">S</span>) <span class="op">-&gt;</span> <span class="ident">App</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="ident">App</span> {
<span class="ident">parts</span>: <span class="prelude-val">Some</span>(<span class="ident">ApplicationParts</span> {
<span class="ident">state</span>,
<span class="ident">prefix</span>: <span class="string">&quot;&quot;</span>.<span class="ident">to_owned</span>(),
<span class="ident">router</span>: <span class="ident">Router</span>::<span class="ident">new</span>(),
<span class="ident">router</span>: <span class="ident">Router</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="string">&quot;&quot;</span>)),
<span class="ident">middlewares</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">filters</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">encoding</span>: <span class="ident">ContentEncoding</span>::<span class="ident">Auto</span>,
@ -1080,6 +1079,7 @@
<span class="kw">if</span> <span class="op">!</span><span class="ident">prefix</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">prefix</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>)
}
<span class="ident">parts</span>.<span class="ident">router</span>.<span class="ident">set_prefix</span>(<span class="kw-2">&amp;</span><span class="ident">prefix</span>);
<span class="ident">parts</span>.<span class="ident">prefix</span> <span class="op">=</span> <span class="ident">prefix</span>;
}
<span class="self">self</span>
@ -1130,7 +1130,7 @@
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">route</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">method</span>: <span class="ident">Method</span>, <span class="ident">f</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">App</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
@ -1327,11 +1327,8 @@
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">path</span>.<span class="ident">trim</span>().<span class="ident">trim_right_matches</span>(<span class="string">&#39;/&#39;</span>).<span class="ident">to_owned</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">is_empty</span>() <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>)
}
<span class="kw">if</span> <span class="ident">path</span>.<span class="ident">len</span>() <span class="op">&gt;</span> <span class="number">1</span> <span class="op">&amp;&amp;</span> <span class="ident">path</span>.<span class="ident">ends_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">pop</span>();
}
<span class="ident">path</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>);
};
<span class="self">self</span>.<span class="ident">parts</span>
.<span class="ident">as_mut</span>()
.<span class="ident">expect</span>(<span class="string">&quot;Use after finish&quot;</span>)
@ -1656,8 +1653,7 @@
.<span class="ident">route</span>(<span class="string">&quot;/test&quot;</span>, <span class="ident">Method</span>::<span class="ident">GET</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>())
.<span class="ident">route</span>(<span class="string">&quot;/test&quot;</span>, <span class="ident">Method</span>::<span class="ident">POST</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">|</span> {
<span class="ident">HttpResponse</span>::<span class="ident">Created</span>()
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/test&quot;</span>).<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">GET</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);

742
static/api/actix-web/stable/src/actix_web/client/connector.rs.html
View File

@ -1148,6 +1148,200 @@
<span id="1148">1148</span>
<span id="1149">1149</span>
<span id="1150">1150</span>
<span id="1151">1151</span>
<span id="1152">1152</span>
<span id="1153">1153</span>
<span id="1154">1154</span>
<span id="1155">1155</span>
<span id="1156">1156</span>
<span id="1157">1157</span>
<span id="1158">1158</span>
<span id="1159">1159</span>
<span id="1160">1160</span>
<span id="1161">1161</span>
<span id="1162">1162</span>
<span id="1163">1163</span>
<span id="1164">1164</span>
<span id="1165">1165</span>
<span id="1166">1166</span>
<span id="1167">1167</span>
<span id="1168">1168</span>
<span id="1169">1169</span>
<span id="1170">1170</span>
<span id="1171">1171</span>
<span id="1172">1172</span>
<span id="1173">1173</span>
<span id="1174">1174</span>
<span id="1175">1175</span>
<span id="1176">1176</span>
<span id="1177">1177</span>
<span id="1178">1178</span>
<span id="1179">1179</span>
<span id="1180">1180</span>
<span id="1181">1181</span>
<span id="1182">1182</span>
<span id="1183">1183</span>
<span id="1184">1184</span>
<span id="1185">1185</span>
<span id="1186">1186</span>
<span id="1187">1187</span>
<span id="1188">1188</span>
<span id="1189">1189</span>
<span id="1190">1190</span>
<span id="1191">1191</span>
<span id="1192">1192</span>
<span id="1193">1193</span>
<span id="1194">1194</span>
<span id="1195">1195</span>
<span id="1196">1196</span>
<span id="1197">1197</span>
<span id="1198">1198</span>
<span id="1199">1199</span>
<span id="1200">1200</span>
<span id="1201">1201</span>
<span id="1202">1202</span>
<span id="1203">1203</span>
<span id="1204">1204</span>
<span id="1205">1205</span>
<span id="1206">1206</span>
<span id="1207">1207</span>
<span id="1208">1208</span>
<span id="1209">1209</span>
<span id="1210">1210</span>
<span id="1211">1211</span>
<span id="1212">1212</span>
<span id="1213">1213</span>
<span id="1214">1214</span>
<span id="1215">1215</span>
<span id="1216">1216</span>
<span id="1217">1217</span>
<span id="1218">1218</span>
<span id="1219">1219</span>
<span id="1220">1220</span>
<span id="1221">1221</span>
<span id="1222">1222</span>
<span id="1223">1223</span>
<span id="1224">1224</span>
<span id="1225">1225</span>
<span id="1226">1226</span>
<span id="1227">1227</span>
<span id="1228">1228</span>
<span id="1229">1229</span>
<span id="1230">1230</span>
<span id="1231">1231</span>
<span id="1232">1232</span>
<span id="1233">1233</span>
<span id="1234">1234</span>
<span id="1235">1235</span>
<span id="1236">1236</span>
<span id="1237">1237</span>
<span id="1238">1238</span>
<span id="1239">1239</span>
<span id="1240">1240</span>
<span id="1241">1241</span>
<span id="1242">1242</span>
<span id="1243">1243</span>
<span id="1244">1244</span>
<span id="1245">1245</span>
<span id="1246">1246</span>
<span id="1247">1247</span>
<span id="1248">1248</span>
<span id="1249">1249</span>
<span id="1250">1250</span>
<span id="1251">1251</span>
<span id="1252">1252</span>
<span id="1253">1253</span>
<span id="1254">1254</span>
<span id="1255">1255</span>
<span id="1256">1256</span>
<span id="1257">1257</span>
<span id="1258">1258</span>
<span id="1259">1259</span>
<span id="1260">1260</span>
<span id="1261">1261</span>
<span id="1262">1262</span>
<span id="1263">1263</span>
<span id="1264">1264</span>
<span id="1265">1265</span>
<span id="1266">1266</span>
<span id="1267">1267</span>
<span id="1268">1268</span>
<span id="1269">1269</span>
<span id="1270">1270</span>
<span id="1271">1271</span>
<span id="1272">1272</span>
<span id="1273">1273</span>
<span id="1274">1274</span>
<span id="1275">1275</span>
<span id="1276">1276</span>
<span id="1277">1277</span>
<span id="1278">1278</span>
<span id="1279">1279</span>
<span id="1280">1280</span>
<span id="1281">1281</span>
<span id="1282">1282</span>
<span id="1283">1283</span>
<span id="1284">1284</span>
<span id="1285">1285</span>
<span id="1286">1286</span>
<span id="1287">1287</span>
<span id="1288">1288</span>
<span id="1289">1289</span>
<span id="1290">1290</span>
<span id="1291">1291</span>
<span id="1292">1292</span>
<span id="1293">1293</span>
<span id="1294">1294</span>
<span id="1295">1295</span>
<span id="1296">1296</span>
<span id="1297">1297</span>
<span id="1298">1298</span>
<span id="1299">1299</span>
<span id="1300">1300</span>
<span id="1301">1301</span>
<span id="1302">1302</span>
<span id="1303">1303</span>
<span id="1304">1304</span>
<span id="1305">1305</span>
<span id="1306">1306</span>
<span id="1307">1307</span>
<span id="1308">1308</span>
<span id="1309">1309</span>
<span id="1310">1310</span>
<span id="1311">1311</span>
<span id="1312">1312</span>
<span id="1313">1313</span>
<span id="1314">1314</span>
<span id="1315">1315</span>
<span id="1316">1316</span>
<span id="1317">1317</span>
<span id="1318">1318</span>
<span id="1319">1319</span>
<span id="1320">1320</span>
<span id="1321">1321</span>
<span id="1322">1322</span>
<span id="1323">1323</span>
<span id="1324">1324</span>
<span id="1325">1325</span>
<span id="1326">1326</span>
<span id="1327">1327</span>
<span id="1328">1328</span>
<span id="1329">1329</span>
<span id="1330">1330</span>
<span id="1331">1331</span>
<span id="1332">1332</span>
<span id="1333">1333</span>
<span id="1334">1334</span>
<span id="1335">1335</span>
<span id="1336">1336</span>
<span id="1337">1337</span>
<span id="1338">1338</span>
<span id="1339">1339</span>
<span id="1340">1340</span>
<span id="1341">1341</span>
<span id="1342">1342</span>
<span id="1343">1343</span>
<span id="1344">1344</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::{<span class="ident">HashMap</span>, <span class="ident">VecDeque</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::<span class="ident">Shutdown</span>;
@ -1167,18 +1361,46 @@
<span class="kw">use</span> <span class="ident">tokio_io</span>::{<span class="ident">AsyncRead</span>, <span class="ident">AsyncWrite</span>};
<span class="kw">use</span> <span class="ident">tokio_timer</span>::<span class="ident">Delay</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">openssl</span>::<span class="ident">ssl</span>::{<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">OpensslError</span>, <span class="ident">SslConnector</span>, <span class="ident">SslMethod</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_openssl</span>::<span class="ident">SslConnectorExt</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="kw">use</span> {
<span class="ident">openssl</span>::<span class="ident">ssl</span>::{<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">SslError</span>, <span class="ident">SslConnector</span>, <span class="ident">SslMethod</span>},
<span class="ident">tokio_openssl</span>::<span class="ident">SslConnectorExt</span>,
};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
<span class="kw">use</span> <span class="ident">native_tls</span>::{<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">TlsError</span>, <span class="ident">TlsConnector</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
<span class="kw">use</span> <span class="ident">tokio_tls</span>::<span class="ident">TlsConnectorExt</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>))
))]</span>
<span class="kw">use</span> {
<span class="ident">native_tls</span>::{<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">SslError</span>, <span class="ident">TlsConnector</span> <span class="kw">as</span> <span class="ident">NativeTlsConnector</span>},
<span class="ident">tokio_tls</span>::<span class="ident">TlsConnector</span> <span class="kw">as</span> <span class="ident">SslConnector</span>,
};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))
))]</span>
<span class="kw">use</span> {
<span class="ident">rustls</span>::<span class="ident">ClientConfig</span>, <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">SslError</span>, <span class="ident">std</span>::<span class="ident">sync</span>::<span class="ident">Arc</span>,
<span class="ident">tokio_rustls</span>::<span class="ident">ClientConfigExt</span>, <span class="ident">webpki</span>::<span class="ident">DNSNameRef</span>, <span class="ident">webpki_roots</span>,
};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))
))]</span>
<span class="kw">type</span> <span class="ident">SslConnector</span> <span class="op">=</span> <span class="ident">Arc</span><span class="op">&lt;</span><span class="ident">ClientConfig</span><span class="op">&gt;</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>
)))]</span>
<span class="kw">type</span> <span class="ident">SslConnector</span> <span class="op">=</span> ();
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">IoStream</span>;
<span class="kw">use</span> {<span class="ident">HAS_OPENSSL</span>, <span class="ident">HAS_TLS</span>};
<span class="kw">use</span> {<span class="ident">HAS_OPENSSL</span>, <span class="ident">HAS_RUSTLS</span>, <span class="ident">HAS_TLS</span>};
<span class="doccomment">/// Client connector usage stats</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Default</span>, <span class="ident">Message</span>)]</span>
@ -1281,14 +1503,14 @@
<span class="ident">SslIsNotSupported</span>,
<span class="doccomment">/// SSL error</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
))]</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;{}&quot;</span>, <span class="ident">_0</span>)]</span>
<span class="ident">SslError</span>(<span class="attribute">#[<span class="ident">cause</span>]</span> <span class="ident">OpensslError</span>),
<span class="doccomment">/// SSL error</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;{}&quot;</span>, <span class="ident">_0</span>)]</span>
<span class="ident">SslError</span>(<span class="attribute">#[<span class="ident">cause</span>]</span> <span class="ident">TlsError</span>),
<span class="ident">SslError</span>(<span class="attribute">#[<span class="ident">cause</span>]</span> <span class="ident">SslError</span>),
<span class="doccomment">/// Resolver error</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;{}&quot;</span>, <span class="ident">_0</span>)]</span>
@ -1340,10 +1562,8 @@
<span class="doccomment">/// `ClientConnector` type is responsible for transport layer of a</span>
<span class="doccomment">/// client connection.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ClientConnector</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
<span class="attribute">#[<span class="ident">allow</span>(<span class="ident">dead_code</span>)]</span>
<span class="ident">connector</span>: <span class="ident">SslConnector</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
<span class="ident">connector</span>: <span class="ident">TlsConnector</span>,
<span class="ident">stats</span>: <span class="ident">ClientConnectorStats</span>,
<span class="ident">subscriber</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Recipient</span><span class="op">&lt;</span><span class="ident">ClientConnectorStats</span><span class="op">&gt;&gt;</span>,
@ -1384,63 +1604,47 @@
<span class="kw">impl</span> <span class="ident">Default</span> <span class="kw">for</span> <span class="ident">ClientConnector</span> {
<span class="kw">fn</span> <span class="ident">default</span>() <span class="op">-&gt;</span> <span class="ident">ClientConnector</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
{
<span class="kw">let</span> <span class="ident">builder</span> <span class="op">=</span> <span class="ident">SslConnector</span>::<span class="ident">builder</span>(<span class="ident">SslMethod</span>::<span class="ident">tls</span>()).<span class="ident">unwrap</span>();
<span class="ident">ClientConnector</span>::<span class="ident">with_connector</span>(<span class="ident">builder</span>.<span class="ident">build</span>())
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
{
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">mpsc</span>::<span class="ident">unbounded</span>();
<span class="kw">let</span> <span class="ident">builder</span> <span class="op">=</span> <span class="ident">TlsConnector</span>::<span class="ident">builder</span>().<span class="ident">unwrap</span>();
<span class="ident">ClientConnector</span> {
<span class="ident">stats</span>: <span class="ident">ClientConnectorStats</span>::<span class="ident">default</span>(),
<span class="ident">subscriber</span>: <span class="prelude-val">None</span>,
<span class="ident">acq_tx</span>: <span class="ident">tx</span>,
<span class="ident">acq_rx</span>: <span class="prelude-val">Some</span>(<span class="ident">rx</span>),
<span class="ident">resolver</span>: <span class="prelude-val">None</span>,
<span class="ident">connector</span>: <span class="ident">builder</span>.<span class="ident">build</span>().<span class="ident">unwrap</span>(),
<span class="ident">conn_lifetime</span>: <span class="ident">Duration</span>::<span class="ident">from_secs</span>(<span class="number">75</span>),
<span class="ident">conn_keep_alive</span>: <span class="ident">Duration</span>::<span class="ident">from_secs</span>(<span class="number">15</span>),
<span class="ident">limit</span>: <span class="number">100</span>,
<span class="ident">limit_per_host</span>: <span class="number">0</span>,
<span class="ident">acquired</span>: <span class="number">0</span>,
<span class="ident">acquired_per_host</span>: <span class="ident">HashMap</span>::<span class="ident">new</span>(),
<span class="ident">available</span>: <span class="ident">HashMap</span>::<span class="ident">new</span>(),
<span class="ident">to_close</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">waiters</span>: <span class="prelude-val">Some</span>(<span class="ident">HashMap</span>::<span class="ident">new</span>()),
<span class="ident">wait_timeout</span>: <span class="prelude-val">None</span>,
<span class="ident">paused</span>: <span class="ident">Paused</span>::<span class="ident">No</span>,
<span class="kw">let</span> <span class="ident">connector</span> <span class="op">=</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>)))]</span>
{
<span class="ident">SslConnector</span>::<span class="ident">builder</span>(<span class="ident">SslMethod</span>::<span class="ident">tls</span>()).<span class="ident">unwrap</span>().<span class="ident">build</span>()
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)))]</span>
{
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">mpsc</span>::<span class="ident">unbounded</span>();
<span class="ident">ClientConnector</span> {
<span class="ident">stats</span>: <span class="ident">ClientConnectorStats</span>::<span class="ident">default</span>(),
<span class="ident">subscriber</span>: <span class="prelude-val">None</span>,
<span class="ident">acq_tx</span>: <span class="ident">tx</span>,
<span class="ident">acq_rx</span>: <span class="prelude-val">Some</span>(<span class="ident">rx</span>),
<span class="ident">resolver</span>: <span class="prelude-val">None</span>,
<span class="ident">conn_lifetime</span>: <span class="ident">Duration</span>::<span class="ident">from_secs</span>(<span class="number">75</span>),
<span class="ident">conn_keep_alive</span>: <span class="ident">Duration</span>::<span class="ident">from_secs</span>(<span class="number">15</span>),
<span class="ident">limit</span>: <span class="number">100</span>,
<span class="ident">limit_per_host</span>: <span class="number">0</span>,
<span class="ident">acquired</span>: <span class="number">0</span>,
<span class="ident">acquired_per_host</span>: <span class="ident">HashMap</span>::<span class="ident">new</span>(),
<span class="ident">available</span>: <span class="ident">HashMap</span>::<span class="ident">new</span>(),
<span class="ident">to_close</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">waiters</span>: <span class="prelude-val">Some</span>(<span class="ident">HashMap</span>::<span class="ident">new</span>()),
<span class="ident">wait_timeout</span>: <span class="prelude-val">None</span>,
<span class="ident">paused</span>: <span class="ident">Paused</span>::<span class="ident">No</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>))
))]</span>
{
<span class="ident">NativeTlsConnector</span>::<span class="ident">builder</span>().<span class="ident">build</span>().<span class="ident">unwrap</span>().<span class="ident">into</span>()
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))
))]</span>
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">config</span> <span class="op">=</span> <span class="ident">ClientConfig</span>::<span class="ident">new</span>();
<span class="ident">config</span>
.<span class="ident">root_store</span>
.<span class="ident">add_server_trust_anchors</span>(<span class="kw-2">&amp;</span><span class="ident">webpki_roots</span>::<span class="ident">TLS_SERVER_ROOTS</span>);
<span class="ident">Arc</span>::<span class="ident">new</span>(<span class="ident">config</span>)
}
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">rustfmt</span>, <span class="ident">rustfmt_skip</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)))]</span>
{
()
}
};
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">let_unit_value</span>))]</span>
<span class="ident">ClientConnector</span>::<span class="ident">with_connector_impl</span>(<span class="ident">connector</span>)
}
}
<span class="kw">impl</span> <span class="ident">ClientConnector</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="doccomment">/// Create `ClientConnector` actor with custom `SslConnector` instance.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default `ClientConnector` uses very a simple SSL configuration.</span>
@ -1453,7 +1657,6 @@
<span class="doccomment">/// # extern crate futures;</span>
<span class="doccomment">/// # use futures::{future, Future};</span>
<span class="doccomment">/// # use std::io::Write;</span>
<span class="doccomment">/// # use std::process;</span>
<span class="doccomment">/// # use actix_web::actix::Actor;</span>
<span class="doccomment">/// extern crate openssl;</span>
<span class="doccomment">/// use actix_web::{actix, client::ClientConnector, client::Connect};</span>
@ -1476,10 +1679,112 @@
<span class="doccomment">/// # actix::System::current().stop();</span>
<span class="doccomment">/// Ok(())</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// );</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_connector</span>(<span class="ident">connector</span>: <span class="ident">SslConnector</span>) <span class="op">-&gt;</span> <span class="ident">ClientConnector</span> {
<span class="comment">// keep level of indirection for docstrings matching featureflags</span>
<span class="self">Self</span>::<span class="ident">with_connector_impl</span>(<span class="ident">connector</span>)
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>))
))]</span>
<span class="doccomment">/// Create `ClientConnector` actor with custom `SslConnector` instance.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default `ClientConnector` uses very a simple SSL configuration.</span>
<span class="doccomment">/// With `with_connector` method it is possible to use a custom</span>
<span class="doccomment">/// `SslConnector` object.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # #![cfg(feature = &quot;rust-tls&quot;)]</span>
<span class="doccomment">/// # extern crate actix_web;</span>
<span class="doccomment">/// # extern crate futures;</span>
<span class="doccomment">/// # use futures::{future, Future};</span>
<span class="doccomment">/// # use std::io::Write;</span>
<span class="doccomment">/// # use actix_web::actix::Actor;</span>
<span class="doccomment">/// extern crate rustls;</span>
<span class="doccomment">/// extern crate webpki_roots;</span>
<span class="doccomment">/// use actix_web::{actix, client::ClientConnector, client::Connect};</span>
<span class="doccomment">///</span>
<span class="doccomment">/// use rustls::ClientConfig;</span>
<span class="doccomment">/// use std::sync::Arc;</span>
<span class="doccomment">///</span>
<span class="doccomment">/// fn main() {</span>
<span class="doccomment">/// actix::run(|| {</span>
<span class="doccomment">/// // Start `ClientConnector` with custom `ClientConfig`</span>
<span class="doccomment">/// let mut config = ClientConfig::new();</span>
<span class="doccomment">/// config</span>
<span class="doccomment">/// .root_store</span>
<span class="doccomment">/// .add_server_trust_anchors(&amp;webpki_roots::TLS_SERVER_ROOTS);</span>
<span class="doccomment">/// let conn = ClientConnector::with_connector(Arc::new(config)).start();</span>
<span class="doccomment">///</span>
<span class="doccomment">/// conn.send(</span>
<span class="doccomment">/// Connect::new(&quot;https://www.rust-lang.org&quot;).unwrap()) // &lt;- connect to host</span>
<span class="doccomment">/// .map_err(|_| ())</span>
<span class="doccomment">/// .and_then(|res| {</span>
<span class="doccomment">/// if let Ok(mut stream) = res {</span>
<span class="doccomment">/// stream.write_all(b&quot;GET / HTTP/1.0\r\n\r\n&quot;).unwrap();</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// # actix::System::current().stop();</span>
<span class="doccomment">/// Ok(())</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_connector</span>(<span class="ident">connector</span>: <span class="ident">ClientConfig</span>) <span class="op">-&gt;</span> <span class="ident">ClientConnector</span> {
<span class="comment">// keep level of indirection for docstrings matching featureflags</span>
<span class="self">Self</span>::<span class="ident">with_connector_impl</span>(<span class="ident">Arc</span>::<span class="ident">new</span>(<span class="ident">connector</span>))
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>))
))]</span>
<span class="doccomment">/// Create `ClientConnector` actor with custom `SslConnector` instance.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default `ClientConnector` uses very a simple SSL configuration.</span>
<span class="doccomment">/// With `with_connector` method it is possible to use a custom</span>
<span class="doccomment">/// `SslConnector` object.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # #![cfg(feature = &quot;tls&quot;)]</span>
<span class="doccomment">/// # extern crate actix_web;</span>
<span class="doccomment">/// # extern crate futures;</span>
<span class="doccomment">/// # use futures::{future, Future};</span>
<span class="doccomment">/// # use std::io::Write;</span>
<span class="doccomment">/// # use actix_web::actix::Actor;</span>
<span class="doccomment">/// extern crate native_tls;</span>
<span class="doccomment">/// extern crate webpki_roots;</span>
<span class="doccomment">/// use native_tls::TlsConnector;</span>
<span class="doccomment">/// use actix_web::{actix, client::ClientConnector, client::Connect};</span>
<span class="doccomment">///</span>
<span class="doccomment">/// fn main() {</span>
<span class="doccomment">/// actix::run(|| {</span>
<span class="doccomment">/// let connector = TlsConnector::new().unwrap();</span>
<span class="doccomment">/// let conn = ClientConnector::with_connector(connector.into()).start();</span>
<span class="doccomment">///</span>
<span class="doccomment">/// conn.send(</span>
<span class="doccomment">/// Connect::new(&quot;https://www.rust-lang.org&quot;).unwrap()) // &lt;- connect to host</span>
<span class="doccomment">/// .map_err(|_| ())</span>
<span class="doccomment">/// .and_then(|res| {</span>
<span class="doccomment">/// if let Ok(mut stream) = res {</span>
<span class="doccomment">/// stream.write_all(b&quot;GET / HTTP/1.0\r\n\r\n&quot;).unwrap();</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// # actix::System::current().stop();</span>
<span class="doccomment">/// Ok(())</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_connector</span>(<span class="ident">connector</span>: <span class="ident">SslConnector</span>) <span class="op">-&gt;</span> <span class="ident">ClientConnector</span> {
<span class="comment">// keep level of indirection for docstrings matching featureflags</span>
<span class="self">Self</span>::<span class="ident">with_connector_impl</span>(<span class="ident">connector</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">with_connector_impl</span>(<span class="ident">connector</span>: <span class="ident">SslConnector</span>) <span class="op">-&gt;</span> <span class="ident">ClientConnector</span> {
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">mpsc</span>::<span class="ident">unbounded</span>();
<span class="ident">ClientConnector</span> {
@ -1772,118 +2077,164 @@
).<span class="ident">map_err</span>(<span class="kw">move</span> <span class="op">|</span><span class="kw">_</span>, <span class="ident">act</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="ident">act</span>.<span class="ident">release_key</span>(<span class="kw-2">&amp;</span><span class="ident">key2</span>);
()
})
.<span class="ident">and_then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="ident">act</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">err</span>(()))
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">A</span>(
<span class="ident">act</span>.<span class="ident">connector</span>
.<span class="ident">connect_async</span>(<span class="kw-2">&amp;</span><span class="ident">key</span>.<span class="ident">host</span>, <span class="ident">stream</span>)
.<span class="ident">into_actor</span>(<span class="ident">act</span>)
.<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="kw">_</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(
<span class="ident">ClientConnectorError</span>::<span class="ident">SslError</span>(<span class="ident">e</span>),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span>
<span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
}
}).<span class="ident">and_then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="ident">act</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">err</span>(()))
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">A</span>(
<span class="ident">act</span>.<span class="ident">connector</span>
.<span class="ident">connect_async</span>(<span class="kw-2">&amp;</span><span class="ident">key</span>.<span class="ident">host</span>, <span class="ident">stream</span>)
.<span class="ident">into_actor</span>(<span class="ident">act</span>)
.<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="kw">_</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(
<span class="ident">ClientConnectorError</span>::<span class="ident">SslError</span>(<span class="ident">e</span>),
));
}
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}),
)
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">ok</span>(()))
}
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">err</span>(()))
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">A</span>(
<span class="ident">act</span>.<span class="ident">connector</span>
.<span class="ident">connect_async</span>(<span class="kw-2">&amp;</span><span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">host</span>, <span class="ident">stream</span>)
.<span class="ident">into_actor</span>(<span class="ident">act</span>)
.<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="kw">_</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(
<span class="ident">ClientConnectorError</span>::<span class="ident">SslError</span>(<span class="ident">e</span>),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span>
<span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
}
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}),
)
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">ok</span>(()))
}
}
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}),
)
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">ok</span>(()))
}
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">err</span>(())
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>
.<span class="ident">tx</span>
.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">ClientConnectorError</span>::<span class="ident">SslIsNotSupported</span>));
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
};
<span class="ident">fut</span>::<span class="ident">ok</span>(())
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">err</span>(()))
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">A</span>(
<span class="ident">act</span>.<span class="ident">connector</span>
.<span class="ident">connect</span>(<span class="kw-2">&amp;</span><span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">host</span>, <span class="ident">stream</span>)
.<span class="ident">into_actor</span>(<span class="ident">act</span>)
.<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="kw">_</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(
<span class="ident">ClientConnectorError</span>::<span class="ident">SslError</span>(<span class="ident">e</span>),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
}
}
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}),
)
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">ok</span>(()))
}
}
})
.<span class="ident">spawn</span>(<span class="ident">ctx</span>);
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>))
))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">err</span>(()))
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="kw">let</span> <span class="ident">host</span> <span class="op">=</span> <span class="ident">DNSNameRef</span>::<span class="ident">try_from_ascii_str</span>(<span class="kw-2">&amp;</span><span class="ident">key</span>.<span class="ident">host</span>).<span class="ident">unwrap</span>();
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">A</span>(
<span class="ident">act</span>.<span class="ident">connector</span>
.<span class="ident">connect_async</span>(<span class="ident">host</span>, <span class="ident">stream</span>)
.<span class="ident">into_actor</span>(<span class="ident">act</span>)
.<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span>, <span class="kw">_</span>, <span class="kw">_</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(
<span class="ident">ClientConnectorError</span>::<span class="ident">SslError</span>(<span class="ident">e</span>),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
}
}
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}),
)
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
<span class="ident">fut</span>::<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">fut</span>::<span class="ident">ok</span>(()))
}
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>,
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>
)))]</span>
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()));
<span class="ident">fut</span>::<span class="ident">err</span>(())
}
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">act</span>.<span class="ident">stats</span>.<span class="ident">opened</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="kw">if</span> <span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">ssl</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span>
<span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Err</span>(<span class="ident">ClientConnectorError</span>::<span class="ident">SslIsNotSupported</span>));
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">waiter</span>.<span class="ident">tx</span>.<span class="ident">send</span>(<span class="prelude-val">Ok</span>(<span class="ident">Connection</span>::<span class="ident">new</span>(
<span class="ident">conn</span>.<span class="number">0</span>.<span class="ident">clone</span>(),
<span class="prelude-val">Some</span>(<span class="ident">conn</span>),
<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">stream</span>),
)));
};
<span class="ident">fut</span>::<span class="ident">ok</span>(())
}
}
}).<span class="ident">spawn</span>(<span class="ident">ctx</span>);
}
}
@ -1935,7 +2286,7 @@
};
<span class="comment">// check ssl availability</span>
<span class="kw">if</span> <span class="ident">proto</span>.<span class="ident">is_secure</span>() <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">HAS_OPENSSL</span> <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">HAS_TLS</span> {
<span class="kw">if</span> <span class="ident">proto</span>.<span class="ident">is_secure</span>() <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">HAS_OPENSSL</span> <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">HAS_TLS</span> <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">HAS_RUSTLS</span> {
<span class="kw">return</span> <span class="ident">ActorResponse</span>::<span class="ident">reply</span>(<span class="prelude-val">Err</span>(<span class="ident">ClientConnectorError</span>::<span class="ident">SslIsNotSupported</span>));
}
@ -2241,6 +2592,10 @@
}
<span class="doccomment">/// Create a new connection from an IO Stream</span>
<span class="doccomment">///</span>
<span class="doccomment">/// The stream can be a `UnixStream` if the Unix-only &quot;uds&quot; feature is enabled.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// See also `ClientRequestBuilder::with_connection()`.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">from_stream</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IoStream</span> <span class="op">+</span> <span class="ident">Send</span><span class="op">&gt;</span>(<span class="ident">io</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">Connection</span> {
<span class="ident">Connection</span>::<span class="ident">new</span>(<span class="ident">Key</span>::<span class="ident">empty</span>(), <span class="prelude-val">None</span>, <span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">io</span>))
}
@ -2274,6 +2629,11 @@
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="ident">IoStream</span>::<span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span><span class="self">self</span>.<span class="ident">stream</span>, <span class="ident">dur</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="ident">IoStream</span>::<span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span><span class="self">self</span>.<span class="ident">stream</span>, <span class="ident">dur</span>)
}
}
<span class="kw">impl</span> <span class="ident">io</span>::<span class="ident">Read</span> <span class="kw">for</span> <span class="ident">Connection</span> {
@ -2299,5 +2659,33 @@
<span class="self">self</span>.<span class="ident">stream</span>.<span class="ident">shutdown</span>()
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_tls</span>::<span class="ident">TlsStream</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="doccomment">/// This is temp solution untile actix-net migration</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">Io</span>: <span class="ident">IoStream</span><span class="op">&gt;</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">TlsStream</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">shutdown</span>();
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_nodelay</span>(<span class="ident">nodelay</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_linger</span>(<span class="ident">dur</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_keepalive</span>(<span class="ident">dur</span>)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

106
static/api/actix-web/stable/src/actix_web/client/parser.rs.html
View File

@ -220,6 +220,22 @@
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">mem</span>;
@ -243,6 +259,7 @@
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Default</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">HttpResponseParser</span> {
<span class="ident">decoder</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">EncodingDecoder</span><span class="op">&gt;</span>,
<span class="ident">eof</span>: <span class="ident">bool</span>, <span class="comment">// indicate that we read payload until stream eof</span>
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>, <span class="ident">Fail</span>)]</span>
@ -261,43 +278,42 @@
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
{
<span class="comment">// if buf is empty parse_message will always return NotReady, let&#39;s avoid that</span>
<span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">is_empty</span>() {
<span class="kw">loop</span> {
<span class="comment">// Don&#39;t call parser until we have data to parse.</span>
<span class="kw">if</span> <span class="op">!</span><span class="ident">buf</span>.<span class="ident">is_empty</span>() {
<span class="kw">match</span> <span class="ident">HttpResponseParser</span>::<span class="ident">parse_message</span>(<span class="ident">buf</span>)
.<span class="ident">map_err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>)<span class="question-mark">?</span>
{
<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="ident">msg</span>, <span class="ident">info</span>)) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>((<span class="ident">decoder</span>, <span class="ident">eof</span>)) <span class="op">=</span> <span class="ident">info</span> {
<span class="self">self</span>.<span class="ident">eof</span> <span class="op">=</span> <span class="ident">eof</span>;
<span class="self">self</span>.<span class="ident">decoder</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">decoder</span>);
} <span class="kw">else</span> {
<span class="self">self</span>.<span class="ident">eof</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="self">self</span>.<span class="ident">decoder</span> <span class="op">=</span> <span class="prelude-val">None</span>;
}
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">msg</span>));
}
<span class="ident">Async</span>::<span class="ident">NotReady</span> <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">capacity</span>() <span class="op">&gt;=</span> <span class="ident">MAX_BUFFER_SIZE</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>(
<span class="ident">ParseError</span>::<span class="ident">TooLarge</span>,
));
}
<span class="comment">// Parser needs more data.</span>
}
}
}
<span class="comment">// Read some more data into the buffer for the parser.</span>
<span class="kw">match</span> <span class="ident">io</span>.<span class="ident">read_available</span>(<span class="ident">buf</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">true</span>)) <span class="op">=&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="bool-val">false</span>, <span class="bool-val">true</span>))) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Disconnect</span>)
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">false</span>)) <span class="op">=&gt;</span> (),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> (),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>(<span class="ident">err</span>.<span class="ident">into</span>())),
}
}
<span class="kw">loop</span> {
<span class="kw">match</span> <span class="ident">HttpResponseParser</span>::<span class="ident">parse_message</span>(<span class="ident">buf</span>)
.<span class="ident">map_err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>)<span class="question-mark">?</span>
{
<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="ident">msg</span>, <span class="ident">decoder</span>)) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">decoder</span> <span class="op">=</span> <span class="ident">decoder</span>;
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">msg</span>));
}
<span class="ident">Async</span>::<span class="ident">NotReady</span> <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">capacity</span>() <span class="op">&gt;=</span> <span class="ident">MAX_BUFFER_SIZE</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>(<span class="ident">ParseError</span>::<span class="ident">TooLarge</span>));
}
<span class="kw">match</span> <span class="ident">io</span>.<span class="ident">read_available</span>(<span class="ident">buf</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">true</span>)) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Disconnect</span>)
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">false</span>)) <span class="op">=&gt;</span> (),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpResponseParserError</span>::<span class="ident">Error</span>(<span class="ident">err</span>.<span class="ident">into</span>()))
}
}
}
}
}
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">parse_payload</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>(
@ -310,8 +326,8 @@
<span class="kw">loop</span> {
<span class="comment">// read payload</span>
<span class="kw">let</span> (<span class="ident">not_ready</span>, <span class="ident">stream_finished</span>) <span class="op">=</span> <span class="kw">match</span> <span class="ident">io</span>.<span class="ident">read_available</span>(<span class="ident">buf</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">true</span>)) <span class="op">=&gt;</span> (<span class="bool-val">false</span>, <span class="bool-val">true</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">false</span>)) <span class="op">=&gt;</span> (<span class="bool-val">false</span>, <span class="bool-val">false</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="kw">_</span>, <span class="bool-val">true</span>))) <span class="op">=&gt;</span> (<span class="bool-val">false</span>, <span class="bool-val">true</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="kw">_</span>, <span class="bool-val">false</span>))) <span class="op">=&gt;</span> (<span class="bool-val">false</span>, <span class="bool-val">false</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (<span class="bool-val">true</span>, <span class="bool-val">false</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()),
};
@ -327,7 +343,12 @@
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
}
<span class="kw">if</span> <span class="ident">stream_finished</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">PayloadError</span>::<span class="ident">Incomplete</span>);
<span class="comment">// read untile eof?</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">eof</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="prelude-val">None</span>));
} <span class="kw">else</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">PayloadError</span>::<span class="ident">Incomplete</span>);
}
}
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()),
@ -340,7 +361,7 @@
<span class="kw">fn</span> <span class="ident">parse_message</span>(
<span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>,
) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(<span class="ident">ClientResponse</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">EncodingDecoder</span><span class="op">&gt;</span>), <span class="ident">ParseError</span><span class="op">&gt;</span> {
) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(<span class="ident">ClientResponse</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span>(<span class="ident">EncodingDecoder</span>, <span class="ident">bool</span>)<span class="op">&gt;</span>), <span class="ident">ParseError</span><span class="op">&gt;</span> {
<span class="comment">// Unsafe: we read only this data only after httparse parses headers into.</span>
<span class="comment">// performance bump for pipeline benchmarks.</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">headers</span>: [<span class="ident">HeaderIndex</span>; <span class="ident">MAX_HEADERS</span>] <span class="op">=</span> <span class="kw">unsafe</span> { <span class="ident">mem</span>::<span class="ident">uninitialized</span>() };
@ -386,12 +407,12 @@
}
<span class="kw">let</span> <span class="ident">decoder</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">status</span> <span class="op">==</span> <span class="ident">StatusCode</span>::<span class="ident">SWITCHING_PROTOCOLS</span> {
<span class="prelude-val">Some</span>(<span class="ident">EncodingDecoder</span>::<span class="ident">eof</span>())
<span class="prelude-val">Some</span>((<span class="ident">EncodingDecoder</span>::<span class="ident">eof</span>(), <span class="bool-val">true</span>))
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">len</span>) <span class="op">=</span> <span class="ident">hdrs</span>.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>) {
<span class="comment">// Content-Length</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Ok</span>(<span class="ident">s</span>) <span class="op">=</span> <span class="ident">len</span>.<span class="ident">to_str</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Ok</span>(<span class="ident">len</span>) <span class="op">=</span> <span class="ident">s</span>.<span class="ident">parse</span>::<span class="op">&lt;</span><span class="ident">u64</span><span class="op">&gt;</span>() {
<span class="prelude-val">Some</span>(<span class="ident">EncodingDecoder</span>::<span class="ident">length</span>(<span class="ident">len</span>))
<span class="prelude-val">Some</span>((<span class="ident">EncodingDecoder</span>::<span class="ident">length</span>(<span class="ident">len</span>), <span class="bool-val">false</span>))
} <span class="kw">else</span> {
<span class="macro">debug</span><span class="macro">!</span>(<span class="string">&quot;illegal Content-Length: {:?}&quot;</span>, <span class="ident">len</span>);
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">ParseError</span>::<span class="ident">Header</span>);
@ -402,7 +423,18 @@
}
} <span class="kw">else</span> <span class="kw">if</span> <span class="ident">chunked</span>(<span class="kw-2">&amp;</span><span class="ident">hdrs</span>)<span class="question-mark">?</span> {
<span class="comment">// Chunked encoding</span>
<span class="prelude-val">Some</span>(<span class="ident">EncodingDecoder</span>::<span class="ident">chunked</span>())
<span class="prelude-val">Some</span>((<span class="ident">EncodingDecoder</span>::<span class="ident">chunked</span>(), <span class="bool-val">false</span>))
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">value</span>) <span class="op">=</span> <span class="ident">hdrs</span>.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">CONNECTION</span>) {
<span class="kw">let</span> <span class="ident">close</span> <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Ok</span>(<span class="ident">s</span>) <span class="op">=</span> <span class="ident">value</span>.<span class="ident">to_str</span>() {
<span class="ident">s</span> <span class="op">==</span> <span class="string">&quot;close&quot;</span>
} <span class="kw">else</span> {
<span class="bool-val">false</span>
};
<span class="kw">if</span> <span class="ident">close</span> {
<span class="prelude-val">Some</span>((<span class="ident">EncodingDecoder</span>::<span class="ident">eof</span>(), <span class="bool-val">true</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
};

68
static/api/actix-web/stable/src/actix_web/client/request.rs.html
View File

@ -763,6 +763,23 @@
<span id="763">763</span>
<span id="764">764</span>
<span id="765">765</span>
<span id="766">766</span>
<span id="767">767</span>
<span id="768">768</span>
<span id="769">769</span>
<span id="770">770</span>
<span id="771">771</span>
<span id="772">772</span>
<span id="773">773</span>
<span id="774">774</span>
<span id="775">775</span>
<span id="776">776</span>
<span id="777">777</span>
<span id="778">778</span>
<span id="779">779</span>
<span id="780">780</span>
<span id="781">781</span>
<span id="782">782</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>::<span class="ident">Write</span> <span class="kw">as</span> <span class="ident">FmtWrite</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">Write</span>;
@ -1020,16 +1037,16 @@
<span class="kw">impl</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">ClientRequest</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(
<span class="macro">writeln</span><span class="macro">!</span>(
<span class="ident">f</span>,
<span class="string">&quot;\nClientRequest {:?} {}:{}&quot;</span>,
<span class="self">self</span>.<span class="ident">version</span>, <span class="self">self</span>.<span class="ident">method</span>, <span class="self">self</span>.<span class="ident">uri</span>
);
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>);
)<span class="question-mark">?</span>;
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="self">self</span>.<span class="ident">headers</span>.<span class="ident">iter</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="ident">res</span>
<span class="prelude-val">Ok</span>(())
}
}
@ -1057,10 +1074,6 @@
<span class="kw">fn</span> <span class="ident">_uri</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">url</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">Self</span> {
<span class="kw">match</span> <span class="ident">Uri</span>::<span class="ident">try_from</span>(<span class="ident">url</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">uri</span>) <span class="op">=&gt;</span> {
<span class="comment">// set request host header</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">host</span>) <span class="op">=</span> <span class="ident">uri</span>.<span class="ident">host</span>() {
<span class="self">self</span>.<span class="ident">set_header</span>(<span class="ident">header</span>::<span class="ident">HOST</span>, <span class="ident">host</span>);
}
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">parts</span>) <span class="op">=</span> <span class="ident">parts</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">request</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">err</span>) {
<span class="ident">parts</span>.<span class="ident">uri</span> <span class="op">=</span> <span class="ident">uri</span>;
}
@ -1082,8 +1095,7 @@
<span class="doccomment">/// Set HTTP method of this request.</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">get_method</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">Method</span> {
<span class="kw">let</span> <span class="ident">parts</span> <span class="op">=</span>
<span class="ident">parts</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">request</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">err</span>).<span class="ident">expect</span>(<span class="string">&quot;cannot reuse request builder&quot;</span>);
<span class="kw">let</span> <span class="ident">parts</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">request</span>.<span class="ident">as_ref</span>().<span class="ident">expect</span>(<span class="string">&quot;cannot reuse request builder&quot;</span>);
<span class="kw-2">&amp;</span><span class="ident">parts</span>.<span class="ident">method</span>
}
@ -1396,9 +1408,31 @@
<span class="self">self</span>.<span class="ident">set_header_if_none</span>(<span class="ident">header</span>::<span class="ident">ACCEPT_ENCODING</span>, <span class="string">&quot;gzip, deflate&quot;</span>);
}
<span class="comment">// set request host header</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">parts</span>) <span class="op">=</span> <span class="ident">parts</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">request</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">err</span>) {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">host</span>) <span class="op">=</span> <span class="ident">parts</span>.<span class="ident">uri</span>.<span class="ident">host</span>() {
<span class="kw">if</span> <span class="op">!</span><span class="ident">parts</span>.<span class="ident">headers</span>.<span class="ident">contains_key</span>(<span class="ident">header</span>::<span class="ident">HOST</span>) {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">wrt</span> <span class="op">=</span> <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="ident">host</span>.<span class="ident">len</span>() <span class="op">+</span> <span class="number">5</span>).<span class="ident">writer</span>();
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">parts</span>.<span class="ident">uri</span>.<span class="ident">port</span>() {
<span class="prelude-val">None</span> <span class="op">|</span> <span class="prelude-val">Some</span>(<span class="number">80</span>) <span class="op">|</span> <span class="prelude-val">Some</span>(<span class="number">443</span>) <span class="op">=&gt;</span> <span class="macro">write</span><span class="macro">!</span>(<span class="ident">wrt</span>, <span class="string">&quot;{}&quot;</span>, <span class="ident">host</span>),
<span class="prelude-val">Some</span>(<span class="ident">port</span>) <span class="op">=&gt;</span> <span class="macro">write</span><span class="macro">!</span>(<span class="ident">wrt</span>, <span class="string">&quot;{}:{}&quot;</span>, <span class="ident">host</span>, <span class="ident">port</span>),
};
<span class="kw">match</span> <span class="ident">wrt</span>.<span class="ident">get_mut</span>().<span class="ident">take</span>().<span class="ident">freeze</span>().<span class="ident">try_into</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">value</span>) <span class="op">=&gt;</span> {
<span class="ident">parts</span>.<span class="ident">headers</span>.<span class="ident">insert</span>(<span class="ident">header</span>::<span class="ident">HOST</span>, <span class="ident">value</span>);
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="self">self</span>.<span class="ident">err</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">e</span>.<span class="ident">into</span>()),
}
}
}
}
<span class="comment">// user agent</span>
<span class="self">self</span>.<span class="ident">set_header_if_none</span>(
<span class="ident">header</span>::<span class="ident">USER_AGENT</span>,
<span class="macro">concat</span><span class="macro">!</span>(<span class="string">&quot;Actix-web/&quot;</span>, <span class="macro">env</span><span class="macro">!</span>(<span class="string">&quot;CARGO_PKG_VERSION&quot;</span>)),
<span class="macro">concat</span><span class="macro">!</span>(<span class="string">&quot;actix-web/&quot;</span>, <span class="macro">env</span><span class="macro">!</span>(<span class="string">&quot;CARGO_PKG_VERSION&quot;</span>)),
);
}
@ -1499,16 +1533,16 @@
<span class="kw">impl</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">ClientRequestBuilder</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">parts</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">request</span> {
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(
<span class="macro">writeln</span><span class="macro">!</span>(
<span class="ident">f</span>,
<span class="string">&quot;\nClientRequestBuilder {:?} {}:{}&quot;</span>,
<span class="ident">parts</span>.<span class="ident">version</span>, <span class="ident">parts</span>.<span class="ident">method</span>, <span class="ident">parts</span>.<span class="ident">uri</span>
);
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>);
)<span class="question-mark">?</span>;
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="ident">parts</span>.<span class="ident">headers</span>.<span class="ident">iter</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="ident">res</span>
<span class="prelude-val">Ok</span>(())
} <span class="kw">else</span> {
<span class="macro">write</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;ClientRequestBuilder(Consumed)&quot;</span>)
}

8
static/api/actix-web/stable/src/actix_web/client/response.rs.html
View File

@ -220,12 +220,12 @@
<span class="kw">impl</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">ClientResponse</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;\nClientResponse {:?} {}&quot;</span>, <span class="self">self</span>.<span class="ident">version</span>(), <span class="self">self</span>.<span class="ident">status</span>());
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;\nClientResponse {:?} {}&quot;</span>, <span class="self">self</span>.<span class="ident">version</span>(), <span class="self">self</span>.<span class="ident">status</span>())<span class="question-mark">?</span>;
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="self">self</span>.<span class="ident">headers</span>().<span class="ident">iter</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="ident">res</span>
<span class="prelude-val">Ok</span>(())
}
}

18
static/api/actix-web/stable/src/actix_web/client/writer.rs.html
View File

@ -408,8 +408,13 @@
<span id="408">408</span>
<span id="409">409</span>
<span id="410">410</span>
<span id="411">411</span>
<span id="412">412</span>
</pre><pre class="rust ">
<span class="attribute">#![<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">redundant_field_names</span>))]</span>
<span class="attribute">#![<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">redundant_field_names</span>)
)]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::<span class="ident">RefCell</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>::<span class="ident">Write</span> <span class="kw">as</span> <span class="ident">FmtWrite</span>;
@ -419,7 +424,7 @@
<span class="kw">use</span> <span class="ident">brotli2</span>::<span class="ident">write</span>::<span class="ident">BrotliEncoder</span>;
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">BufMut</span>, <span class="ident">BytesMut</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::{<span class="ident">DeflateEncoder</span>, <span class="ident">GzEncoder</span>};
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::{<span class="ident">GzEncoder</span>, <span class="ident">ZlibEncoder</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">Compression</span>;
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>};
@ -643,7 +648,7 @@
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">enc</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">encoding</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(
<span class="ident">DeflateEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">default</span>()),
<span class="ident">ZlibEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">default</span>()),
),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Gzip</span>(<span class="ident">GzEncoder</span>::<span class="ident">new</span>(
@ -713,10 +718,9 @@
<span class="ident">req</span>.<span class="ident">replace_body</span>(<span class="ident">body</span>);
<span class="kw">let</span> <span class="ident">enc</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">encoding</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(<span class="ident">DeflateEncoder</span>::<span class="ident">new</span>(
<span class="ident">transfer</span>,
<span class="ident">Compression</span>::<span class="ident">default</span>(),
)),
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> {
<span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(<span class="ident">ZlibEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">default</span>()))
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> {
<span class="ident">ContentEncoder</span>::<span class="ident">Gzip</span>(<span class="ident">GzEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">default</span>()))

2
static/api/actix-web/stable/src/actix_web/de.rs.html
View File

@ -619,7 +619,7 @@
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_bool</span>, <span class="ident">visit_bool</span>, <span class="string">&quot;bool&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_i8</span>, <span class="ident">visit_i8</span>, <span class="string">&quot;i8&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_i16</span>, <span class="ident">visit_i16</span>, <span class="string">&quot;i16&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_i32</span>, <span class="ident">visit_i32</span>, <span class="string">&quot;i16&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_i32</span>, <span class="ident">visit_i32</span>, <span class="string">&quot;i32&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_i64</span>, <span class="ident">visit_i64</span>, <span class="string">&quot;i64&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_u8</span>, <span class="ident">visit_u8</span>, <span class="string">&quot;u8&quot;</span>);
<span class="macro">parse_single_value</span><span class="macro">!</span>(<span class="ident">deserialize_u16</span>, <span class="ident">visit_u16</span>, <span class="string">&quot;u16&quot;</span>);

28
static/api/actix-web/stable/src/actix_web/error.rs.html
View File

@ -1108,17 +1108,6 @@
<span id="1108">1108</span>
<span id="1109">1109</span>
<span id="1110">1110</span>
<span id="1111">1111</span>
<span id="1112">1112</span>
<span id="1113">1113</span>
<span id="1114">1114</span>
<span id="1115">1115</span>
<span id="1116">1116</span>
<span id="1117">1117</span>
<span id="1118">1118</span>
<span id="1119">1119</span>
<span id="1120">1120</span>
<span id="1121">1121</span>
</pre><pre class="rust ">
<span class="doccomment">//! Error and Result module</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">IoError</span>;
@ -1174,7 +1163,8 @@
<span class="kw">impl</span> <span class="ident">Error</span> {
<span class="doccomment">/// Deprecated way to reference the underlying response error.</span>
<span class="attribute">#[<span class="ident">deprecated</span>(
<span class="ident">since</span> <span class="op">=</span> <span class="string">&quot;0.6.0&quot;</span>, <span class="ident">note</span> <span class="op">=</span> <span class="string">&quot;please use `Error::as_response_error()` instead&quot;</span>
<span class="ident">since</span> <span class="op">=</span> <span class="string">&quot;0.6.0&quot;</span>,
<span class="ident">note</span> <span class="op">=</span> <span class="string">&quot;please use `Error::as_response_error()` instead&quot;</span>
)]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">cause</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">ResponseError</span> {
<span class="self">self</span>.<span class="ident">cause</span>.<span class="ident">as_ref</span>()
@ -1219,21 +1209,9 @@
<span class="comment">//</span>
<span class="comment">// So we first downcast into that compat, to then further downcast through</span>
<span class="comment">// the failure&#39;s Error downcasting system into the original failure.</span>
<span class="comment">//</span>
<span class="comment">// This currently requires a transmute. This could be avoided if failure</span>
<span class="comment">// provides a deref: https://github.com/rust-lang-nursery/failure/pull/213</span>
<span class="kw">let</span> <span class="ident">compat</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="ident">failure</span>::<span class="ident">Compat</span><span class="op">&lt;</span><span class="ident">failure</span>::<span class="ident">Error</span><span class="op">&gt;&gt;</span> <span class="op">=</span>
<span class="ident">Fail</span>::<span class="ident">downcast_ref</span>(<span class="self">self</span>.<span class="ident">cause</span>.<span class="ident">as_fail</span>());
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">compat</span>) <span class="op">=</span> <span class="ident">compat</span> {
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">CompatWrappedError</span> {
<span class="ident">error</span>: <span class="ident">failure</span>::<span class="ident">Error</span>,
}
<span class="kw">let</span> <span class="ident">compat</span>: <span class="kw-2">&amp;</span><span class="ident">CompatWrappedError</span> <span class="op">=</span>
<span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">*</span>(<span class="ident">compat</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="ident">CompatWrappedError</span>) };
<span class="ident">compat</span>.<span class="ident">error</span>.<span class="ident">downcast_ref</span>()
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
<span class="ident">compat</span>.<span class="ident">and_then</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">get_ref</span>().<span class="ident">downcast_ref</span>())
}
}

4
static/api/actix-web/stable/src/actix_web/extensions.rs.html
View File

@ -111,6 +111,7 @@
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">any</span>::{<span class="ident">Any</span>, <span class="ident">TypeId</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::<span class="ident">HashMap</span>;
@ -145,6 +146,7 @@
<span class="kw">type</span> <span class="ident">AnyMap</span> <span class="op">=</span> <span class="ident">HashMap</span><span class="op">&lt;</span><span class="ident">TypeId</span>, <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Any</span><span class="op">&gt;</span>, <span class="ident">BuildHasherDefault</span><span class="op">&lt;</span><span class="ident">IdHasher</span><span class="op">&gt;&gt;</span>;
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Default</span>)]</span>
<span class="doccomment">/// A type map of request extensions.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">Extensions</span> {
<span class="ident">map</span>: <span class="ident">AnyMap</span>,
@ -153,7 +155,7 @@
<span class="kw">impl</span> <span class="ident">Extensions</span> {
<span class="doccomment">/// Create an empty `Extensions`.</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>() <span class="op">-&gt;</span> <span class="ident">Extensions</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>() <span class="op">-&gt;</span> <span class="ident">Extensions</span> {
<span class="ident">Extensions</span> {
<span class="ident">map</span>: <span class="ident">HashMap</span>::<span class="ident">default</span>(),
}

60
static/api/actix-web/stable/src/actix_web/extractor.rs.html
View File

@ -1008,6 +1008,20 @@
<span id="1008">1008</span>
<span id="1009">1009</span>
<span id="1010">1010</span>
<span id="1011">1011</span>
<span id="1012">1012</span>
<span id="1013">1013</span>
<span id="1014">1014</span>
<span id="1015">1015</span>
<span id="1016">1016</span>
<span id="1017">1017</span>
<span id="1018">1018</span>
<span id="1019">1019</span>
<span id="1020">1020</span>
<span id="1021">1021</span>
<span id="1022">1022</span>
<span id="1023">1023</span>
<span id="1024">1024</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::{<span class="ident">Deref</span>, <span class="ident">DerefMut</span>};
@ -1112,6 +1126,12 @@
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">From</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Path</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">inner</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">Path</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">Path</span> { <span class="ident">inner</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span><span class="op">&gt;</span> <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Path</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">DeserializeOwned</span>,
@ -1337,7 +1357,7 @@
<span class="doccomment">/// |r| {</span>
<span class="doccomment">/// r.method(http::Method::GET)</span>
<span class="doccomment">/// // register form handler and change form extractor configuration</span>
<span class="doccomment">/// .with_config(index, |cfg| {cfg.limit(4096);})</span>
<span class="doccomment">/// .with_config(index, |cfg| {cfg.0.limit(4096);})</span>
<span class="doccomment">/// },</span>
<span class="doccomment">/// );</span>
<span class="doccomment">/// }</span>
@ -1432,7 +1452,7 @@
<span class="doccomment">/// let app = App::new().resource(&quot;/index.html&quot;, |r| {</span>
<span class="doccomment">/// r.method(http::Method::GET)</span>
<span class="doccomment">/// .with_config(index, |cfg| { // &lt;- register handler with extractor params</span>
<span class="doccomment">/// cfg.limit(4096); // &lt;- limit size of the payload</span>
<span class="doccomment">/// cfg.0.limit(4096); // &lt;- limit size of the payload</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
@ -1701,6 +1721,12 @@
}
});
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> () {
<span class="kw">type</span> <span class="ident">Config</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> <span class="self">Self</span>;
<span class="kw">fn</span> <span class="ident">from_request</span>(<span class="ident">_req</span>: <span class="kw-2">&amp;</span><span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>, <span class="ident">_cfg</span>: <span class="kw-2">&amp;</span><span class="self">Self</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="prelude-ty">Result</span> {}
}
<span class="macro">tuple_from_req</span><span class="macro">!</span>(<span class="ident">TupleFromRequest1</span>, (<span class="number">0</span>, <span class="ident">A</span>));
<span class="macro">tuple_from_req</span><span class="macro">!</span>(<span class="ident">TupleFromRequest2</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>));
<span class="macro">tuple_from_req</span><span class="macro">!</span>(<span class="ident">TupleFromRequest3</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>), (<span class="number">2</span>, <span class="ident">C</span>));
@ -1801,8 +1827,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;11&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">cfg</span> <span class="op">=</span> <span class="ident">FormConfig</span>::<span class="ident">default</span>();
<span class="ident">cfg</span>.<span class="ident">limit</span>(<span class="number">4096</span>);
@ -1836,8 +1862,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;9&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">match</span> <span class="prelude-ty">Option</span>::<span class="op">&lt;</span><span class="ident">Form</span><span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;&gt;</span>::<span class="ident">from_request</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="ident">cfg</span>)
.<span class="ident">poll</span>()
@ -1856,8 +1882,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;9&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;bye=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;bye=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">match</span> <span class="prelude-ty">Option</span>::<span class="op">&lt;</span><span class="ident">Form</span><span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;&gt;</span>::<span class="ident">from_request</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="ident">cfg</span>)
.<span class="ident">poll</span>()
@ -1874,8 +1900,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;11&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">match</span> <span class="prelude-ty">Result</span>::<span class="op">&lt;</span><span class="ident">Form</span><span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>::<span class="ident">from_request</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="ident">FormConfig</span>::<span class="ident">default</span>())
.<span class="ident">poll</span>()
@ -1894,8 +1920,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;9&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;bye=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;bye=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">match</span> <span class="prelude-ty">Result</span>::<span class="op">&lt;</span><span class="ident">Form</span><span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>::<span class="ident">from_request</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="ident">FormConfig</span>::<span class="ident">default</span>())
.<span class="ident">poll</span>()
@ -1945,7 +1971,7 @@
<span class="kw">fn</span> <span class="ident">test_request_extract</span>() {
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/name/user1/?id=test&quot;</span>).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{key}/{value}/&quot;</span>)));
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">recognize</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span>(), <span class="number">0</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">with_route_info</span>(<span class="ident">info</span>);
@ -1961,7 +1987,7 @@
<span class="kw">let</span> <span class="ident">s</span> <span class="op">=</span> <span class="ident">Query</span>::<span class="op">&lt;</span><span class="ident">Id</span><span class="op">&gt;</span>::<span class="ident">from_request</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span>()).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">s</span>.<span class="ident">id</span>, <span class="string">&quot;test&quot;</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{key}/{value}/&quot;</span>)));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/name/32/&quot;</span>).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">recognize</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span>(), <span class="number">0</span>);
@ -1982,7 +2008,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_extract_path_single</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{value}/&quot;</span>)));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/32/&quot;</span>).<span class="ident">finish</span>();
@ -1993,7 +2019,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_tuple_extract</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{key}/{value}/&quot;</span>)));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/name/user1/?id=test&quot;</span>).<span class="ident">finish</span>();
@ -2017,6 +2043,8 @@
<span class="macro">assert_eq</span><span class="macro">!</span>((<span class="ident">res</span>.<span class="number">0</span>).<span class="number">1</span>, <span class="string">&quot;user1&quot;</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>((<span class="ident">res</span>.<span class="number">1</span>).<span class="number">0</span>, <span class="string">&quot;name&quot;</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>((<span class="ident">res</span>.<span class="number">1</span>).<span class="number">1</span>, <span class="string">&quot;user1&quot;</span>);
<span class="kw">let</span> () <span class="op">=</span> <span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">extract</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);
}
}
</pre>

36
static/api/actix-web/stable/src/actix_web/fs.rs.html
View File

@ -1784,18 +1784,6 @@
<span id="1784">1784</span>
<span id="1785">1785</span>
<span id="1786">1786</span>
<span id="1787">1787</span>
<span id="1788">1788</span>
<span id="1789">1789</span>
<span id="1790">1790</span>
<span id="1791">1791</span>
<span id="1792">1792</span>
<span id="1793">1793</span>
<span id="1794">1794</span>
<span id="1795">1795</span>
<span id="1796">1796</span>
<span id="1797">1797</span>
<span id="1798">1798</span>
</pre><pre class="rust ">
<span class="doccomment">//! Static files support</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>::<span class="ident">Write</span>;
@ -1963,11 +1951,7 @@
<span class="kw">let</span> <span class="ident">disposition_type</span> <span class="op">=</span> <span class="ident">C</span>::<span class="ident">content_disposition_map</span>(<span class="ident">ct</span>.<span class="ident">type_</span>());
<span class="kw">let</span> <span class="ident">cd</span> <span class="op">=</span> <span class="ident">ContentDisposition</span> {
<span class="ident">disposition</span>: <span class="ident">disposition_type</span>,
<span class="ident">parameters</span>: <span class="macro">vec</span><span class="macro">!</span>[<span class="ident">DispositionParam</span>::<span class="ident">Filename</span>(
<span class="ident">header</span>::<span class="ident">Charset</span>::<span class="ident">Ext</span>(<span class="string">&quot;UTF-8&quot;</span>.<span class="ident">to_owned</span>()),
<span class="prelude-val">None</span>,
<span class="ident">filename</span>.<span class="ident">as_bytes</span>().<span class="ident">to_vec</span>(),
)],
<span class="ident">parameters</span>: <span class="macro">vec</span><span class="macro">!</span>[<span class="ident">DispositionParam</span>::<span class="ident">Filename</span>(<span class="ident">filename</span>.<span class="ident">into_owned</span>())],
};
(<span class="ident">ct</span>, <span class="ident">cd</span>)
};
@ -2172,11 +2156,7 @@
.<span class="ident">body</span>(<span class="string">&quot;This resource only supports GET and HEAD.&quot;</span>));
}
<span class="kw">let</span> <span class="ident">etag</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">C</span>::<span class="ident">is_use_etag</span>() {
<span class="self">self</span>.<span class="ident">etag</span>()
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
};
<span class="kw">let</span> <span class="ident">etag</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">C</span>::<span class="ident">is_use_etag</span>() { <span class="self">self</span>.<span class="ident">etag</span>() } <span class="kw">else</span> { <span class="prelude-val">None</span> };
<span class="kw">let</span> <span class="ident">last_modified</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">C</span>::<span class="ident">is_use_last_modifier</span>() {
<span class="self">self</span>.<span class="ident">last_modified</span>()
} <span class="kw">else</span> {
@ -2321,7 +2301,8 @@
<span class="ident">max_bytes</span> <span class="op">=</span> <span class="ident">cmp</span>::<span class="ident">min</span>(<span class="ident">size</span>.<span class="ident">saturating_sub</span>(<span class="ident">counter</span>), <span class="number">65_536</span>) <span class="kw">as</span> <span class="ident">usize</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">with_capacity</span>(<span class="ident">max_bytes</span>);
<span class="ident">file</span>.<span class="ident">seek</span>(<span class="ident">io</span>::<span class="ident">SeekFrom</span>::<span class="ident">Start</span>(<span class="ident">offset</span>))<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">nbytes</span> <span class="op">=</span> <span class="ident">file</span>.<span class="ident">by_ref</span>().<span class="ident">take</span>(<span class="ident">max_bytes</span> <span class="kw">as</span> <span class="ident">u64</span>).<span class="ident">read_to_end</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf</span>)<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">nbytes</span> <span class="op">=</span>
<span class="ident">file</span>.<span class="ident">by_ref</span>().<span class="ident">take</span>(<span class="ident">max_bytes</span> <span class="kw">as</span> <span class="ident">u64</span>).<span class="ident">read_to_end</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf</span>)<span class="question-mark">?</span>;
<span class="kw">if</span> <span class="ident">nbytes</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">UnexpectedEof</span>.<span class="ident">into</span>());
}
@ -2672,8 +2653,7 @@
<span class="ident">length</span>: <span class="ident">length</span> <span class="kw">as</span> <span class="ident">u64</span>,
}))
}
})
.<span class="ident">collect</span>::<span class="op">&lt;</span><span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="kw">_</span>, <span class="kw">_</span><span class="op">&gt;&gt;</span>()<span class="question-mark">?</span>;
}).<span class="ident">collect</span>::<span class="op">&lt;</span><span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="kw">_</span>, <span class="kw">_</span><span class="op">&gt;&gt;</span>()<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">ranges</span>: <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">HttpRange</span><span class="op">&gt;</span> <span class="op">=</span> <span class="ident">all_ranges</span>.<span class="ident">into_iter</span>().<span class="ident">filter_map</span>(<span class="op">|</span><span class="ident">x</span><span class="op">|</span> <span class="ident">x</span>).<span class="ident">collect</span>();
@ -2789,11 +2769,7 @@
<span class="kw">use</span> <span class="ident">header</span>::{<span class="ident">ContentDisposition</span>, <span class="ident">DispositionParam</span>, <span class="ident">DispositionType</span>};
<span class="kw">let</span> <span class="ident">cd</span> <span class="op">=</span> <span class="ident">ContentDisposition</span> {
<span class="ident">disposition</span>: <span class="ident">DispositionType</span>::<span class="ident">Attachment</span>,
<span class="ident">parameters</span>: <span class="macro">vec</span><span class="macro">!</span>[<span class="ident">DispositionParam</span>::<span class="ident">Filename</span>(
<span class="ident">header</span>::<span class="ident">Charset</span>::<span class="ident">Ext</span>(<span class="string">&quot;UTF-8&quot;</span>.<span class="ident">to_owned</span>()),
<span class="prelude-val">None</span>,
<span class="string">&quot;test.png&quot;</span>.<span class="ident">as_bytes</span>().<span class="ident">to_vec</span>(),
)],
<span class="ident">parameters</span>: <span class="macro">vec</span><span class="macro">!</span>[<span class="ident">DispositionParam</span>::<span class="ident">Filename</span>(<span class="ident">String</span>::<span class="ident">from</span>(<span class="string">&quot;test.png&quot;</span>))],
};
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">file</span> <span class="op">=</span> <span class="ident">NamedFile</span>::<span class="ident">open</span>(<span class="string">&quot;tests/test.png&quot;</span>)
.<span class="ident">unwrap</span>()

18
static/api/actix-web/stable/src/actix_web/handler.rs.html
View File

@ -557,6 +557,9 @@
<span id="557">557</span>
<span id="558">558</span>
<span id="559">559</span>
<span id="560">560</span>
<span id="561">561</span>
<span id="562">562</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::<span class="ident">Deref</span>;
@ -913,13 +916,17 @@
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;&gt;</span> <span class="ident">From</span><span class="op">&lt;</span><span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span>, <span class="ident">E</span><span class="op">&gt;&gt;</span>
<span class="kw">for</span> <span class="ident">AsyncResult</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">From</span><span class="op">&lt;</span><span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;&gt;</span>, <span class="ident">E</span><span class="op">&gt;&gt;</span> <span class="kw">for</span> <span class="ident">AsyncResult</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span>, <span class="ident">E</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;&gt;</span>, <span class="ident">E</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Ok</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> <span class="ident">AsyncResult</span>(<span class="prelude-val">Some</span>(<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="ident">fut</span>))),
<span class="prelude-val">Ok</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> <span class="ident">AsyncResult</span>(<span class="prelude-val">Some</span>(<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="ident">Box</span>::<span class="ident">new</span>(
<span class="ident">fut</span>.<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">into</span>()),
)))),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="ident">AsyncResult</span>(<span class="prelude-val">Some</span>(<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()))),
}
}
@ -1086,8 +1093,7 @@
<span class="doccomment">/// }</span>
<span class="doccomment">///</span>
<span class="doccomment">/// /// extract path info using serde</span>
<span class="doccomment">/// fn index(data: (State&lt;MyApp&gt;, Path&lt;Info&gt;)) -&gt; String {</span>
<span class="doccomment">/// let (state, path) = data;</span>
<span class="doccomment">/// fn index(state: State&lt;MyApp&gt;, path: Path&lt;Info&gt;) -&gt; String {</span>
<span class="doccomment">/// format!(&quot;{} {}!&quot;, state.msg, path.username)</span>
<span class="doccomment">/// }</span>
<span class="doccomment">///</span>

1546
static/api/actix-web/stable/src/actix_web/header/common/content_disposition.rs.html
View File

File diff suppressed because it is too large Load Diff

10
static/api/actix-web/stable/src/actix_web/header/mod.rs.html
View File

@ -468,6 +468,7 @@
<span id="468">468</span>
<span id="469">469</span>
<span id="470">470</span>
<span id="471">471</span>
</pre><pre class="rust ">
<span class="doccomment">//! Various http headers</span>
<span class="comment">// This is mostly copy of [hyper](https://github.com/hyperium/hyper/tree/master/src/header)</span>
@ -694,8 +695,7 @@
.<span class="ident">filter_map</span>(<span class="op">|</span><span class="ident">x</span><span class="op">|</span> <span class="kw">match</span> <span class="ident">x</span>.<span class="ident">trim</span>() {
<span class="string">&quot;&quot;</span> <span class="op">=&gt;</span> <span class="prelude-val">None</span>,
<span class="ident">y</span> <span class="op">=&gt;</span> <span class="prelude-val">Some</span>(<span class="ident">y</span>),
})
.<span class="ident">filter_map</span>(<span class="op">|</span><span class="ident">x</span><span class="op">|</span> <span class="ident">x</span>.<span class="ident">trim</span>().<span class="ident">parse</span>().<span class="ident">ok</span>()),
}).<span class="ident">filter_map</span>(<span class="op">|</span><span class="ident">x</span><span class="op">|</span> <span class="ident">x</span>.<span class="ident">trim</span>().<span class="ident">parse</span>().<span class="ident">ok</span>()),
)
}
<span class="prelude-val">Ok</span>(<span class="ident">result</span>)
@ -734,8 +734,10 @@
<span class="comment">// From hyper v0.11.27 src/header/parsing.rs</span>
<span class="doccomment">/// An extended header parameter value (i.e., tagged with a character set and optionally,</span>
<span class="doccomment">/// a language), as defined in [RFC 5987](https://tools.ietf.org/html/rfc5987#section-3.2).</span>
<span class="doccomment">/// The value part of an extended parameter consisting of three parts:</span>
<span class="doccomment">/// the REQUIRED character set name (`charset`), the OPTIONAL language information (`language_tag`),</span>
<span class="doccomment">/// and a character sequence representing the actual value (`value`), separated by single quote</span>
<span class="doccomment">/// characters. It is defined in [RFC 5987](https://tools.ietf.org/html/rfc5987#section-3.2).</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Clone</span>, <span class="ident">Debug</span>, <span class="ident">PartialEq</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ExtendedValue</span> {
<span class="doccomment">/// The character set that is used to encode the `value` to a string.</span>

4
static/api/actix-web/stable/src/actix_web/helpers.rs.html
View File

@ -569,7 +569,6 @@
<span id="569">569</span>
<span id="570">570</span>
<span id="571">571</span>
<span id="572">572</span>
</pre><pre class="rust ">
<span class="doccomment">//! Various helpers</span>
@ -852,8 +851,7 @@
<span class="bool-val">true</span>,
<span class="ident">StatusCode</span>::<span class="ident">MOVED_PERMANENTLY</span>,
))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="comment">// trailing slashes</span>
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[

28
static/api/actix-web/stable/src/actix_web/httpmessage.rs.html
View File

@ -852,10 +852,6 @@
<span id="852">852</span>
<span id="853">853</span>
<span id="854">854</span>
<span id="855">855</span>
<span id="856">856</span>
<span id="857">857</span>
<span id="858">858</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">encoding</span>::<span class="ident">all</span>::<span class="ident">UTF_8</span>;
@ -1338,8 +1334,7 @@
<span class="ident">body</span>.<span class="ident">extend_from_slice</span>(<span class="kw-2">&amp;</span><span class="ident">chunk</span>);
<span class="prelude-val">Ok</span>(<span class="ident">body</span>)
}
})
.<span class="ident">map</span>(<span class="op">|</span><span class="ident">body</span><span class="op">|</span> <span class="ident">body</span>.<span class="ident">freeze</span>()),
}).<span class="ident">map</span>(<span class="op">|</span><span class="ident">body</span><span class="op">|</span> <span class="ident">body</span>.<span class="ident">freeze</span>()),
));
<span class="self">self</span>.<span class="ident">poll</span>()
}
@ -1447,8 +1442,7 @@
<span class="ident">body</span>.<span class="ident">extend_from_slice</span>(<span class="kw-2">&amp;</span><span class="ident">chunk</span>);
<span class="prelude-val">Ok</span>(<span class="ident">body</span>)
}
})
.<span class="ident">and_then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">body</span><span class="op">|</span> {
}).<span class="ident">and_then</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">body</span><span class="op">|</span> {
<span class="kw">if</span> (<span class="ident">encoding</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="ident">Encoding</span>) <span class="op">==</span> <span class="ident">UTF_8</span> {
<span class="ident">serde_urlencoded</span>::<span class="ident">from_bytes</span>::<span class="op">&lt;</span><span class="ident">U</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="ident">body</span>)
.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">UrlencodedError</span>::<span class="ident">Parse</span>)
@ -1553,8 +1547,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">TRANSFER_ENCODING</span>,
<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;some va\xadscc\xacas0xsdasdlue&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">req</span>.<span class="ident">chunked</span>().<span class="ident">is_err</span>());
}
@ -1593,7 +1586,7 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;xxxx&quot;</span>)
.<span class="ident">finish</span>();
.<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">req</span>.<span class="ident">urlencoded</span>::<span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;</span>().<span class="ident">poll</span>().<span class="ident">err</span>().<span class="ident">unwrap</span>(),
<span class="ident">UrlencodedError</span>::<span class="ident">UnknownLength</span>
@ -1603,7 +1596,7 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;1000000&quot;</span>)
.<span class="ident">finish</span>();
.<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">req</span>.<span class="ident">urlencoded</span>::<span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;</span>().<span class="ident">poll</span>().<span class="ident">err</span>().<span class="ident">unwrap</span>(),
<span class="ident">UrlencodedError</span>::<span class="ident">Overflow</span>
@ -1624,8 +1617,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;11&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">urlencoded</span>::<span class="op">&lt;</span><span class="ident">Info</span><span class="op">&gt;</span>().<span class="ident">poll</span>().<span class="ident">ok</span>().<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
@ -1639,8 +1632,8 @@
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="string">&quot;application/x-www-form-urlencoded; charset=utf-8&quot;</span>,
).<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>, <span class="string">&quot;11&quot;</span>)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;hello=world&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">urlencoded</span>().<span class="ident">poll</span>().<span class="ident">ok</span>().<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
@ -1689,8 +1682,7 @@
<span class="string">b&quot;Lorem Ipsum is simply dummy text of the printing and typesetting\n\
industry. Lorem Ipsum has been the industry&#39;s standard dummy\n\
Contrary to popular belief, Lorem Ipsum is not simply random text.&quot;</span>,
))
.<span class="ident">finish</span>();
)).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">r</span> <span class="op">=</span> <span class="ident">Readlines</span>::<span class="ident">new</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);
<span class="kw">match</span> <span class="ident">r</span>.<span class="ident">poll</span>().<span class="ident">ok</span>().<span class="ident">unwrap</span>() {
<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="prelude-val">Some</span>(<span class="ident">s</span>)) <span class="op">=&gt;</span> <span class="macro">assert_eq</span><span class="macro">!</span>(

50
static/api/actix-web/stable/src/actix_web/httprequest.rs.html
View File

@ -531,6 +531,18 @@
<span id="531">531</span>
<span id="532">532</span>
<span id="533">533</span>
<span id="534">534</span>
<span id="535">535</span>
<span id="536">536</span>
<span id="537">537</span>
<span id="538">538</span>
<span id="539">539</span>
<span id="540">540</span>
<span id="541">541</span>
<span id="542">542</span>
<span id="543">543</span>
<span id="544">544</span>
<span id="545">545</span>
</pre><pre class="rust ">
<span class="doccomment">//! HTTP Request message related code.</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::{<span class="ident">Ref</span>, <span class="ident">RefMut</span>};
@ -615,6 +627,15 @@
}
}
<span class="doccomment">/// Construct new http request with empty state.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">drop_state</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">HttpRequest</span> {
<span class="ident">HttpRequest</span> {
<span class="ident">state</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(()),
<span class="ident">req</span>: <span class="self">self</span>.<span class="ident">req</span>.<span class="ident">as_ref</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">clone</span>()),
<span class="ident">resource</span>: <span class="self">self</span>.<span class="ident">resource</span>.<span class="ident">clone</span>(),
}
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="doccomment">/// Construct new http request with new RouteInfo.</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">with_route_info</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="kw-2">mut</span> <span class="ident">resource</span>: <span class="ident">ResourceInfo</span>) <span class="op">-&gt;</span> <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
@ -789,7 +810,8 @@
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">extensions</span>().<span class="ident">get</span>::<span class="op">&lt;</span><span class="ident">Cookies</span><span class="op">&gt;</span>().<span class="ident">is_none</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">cookies</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">new</span>();
<span class="kw">for</span> <span class="ident">hdr</span> <span class="kw">in</span> <span class="self">self</span>.<span class="ident">request</span>().<span class="ident">inner</span>.<span class="ident">headers</span>.<span class="ident">get_all</span>(<span class="ident">header</span>::<span class="ident">COOKIE</span>) {
<span class="kw">let</span> <span class="ident">s</span> <span class="op">=</span> <span class="ident">str</span>::<span class="ident">from_utf8</span>(<span class="ident">hdr</span>.<span class="ident">as_bytes</span>()).<span class="ident">map_err</span>(<span class="ident">CookieParseError</span>::<span class="ident">from</span>)<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">s</span> <span class="op">=</span>
<span class="ident">str</span>::<span class="ident">from_utf8</span>(<span class="ident">hdr</span>.<span class="ident">as_bytes</span>()).<span class="ident">map_err</span>(<span class="ident">CookieParseError</span>::<span class="ident">from</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> <span class="ident">cookie_str</span> <span class="kw">in</span> <span class="ident">s</span>.<span class="ident">split</span>(<span class="string">&#39;;&#39;</span>).<span class="ident">map</span>(<span class="op">|</span><span class="ident">s</span><span class="op">|</span> <span class="ident">s</span>.<span class="ident">trim</span>()) {
<span class="kw">if</span> <span class="op">!</span><span class="ident">cookie_str</span>.<span class="ident">is_empty</span>() {
<span class="ident">cookies</span>.<span class="ident">push</span>(<span class="ident">Cookie</span>::<span class="ident">parse_encoded</span>(<span class="ident">cookie_str</span>)<span class="question-mark">?</span>.<span class="ident">into_owned</span>());
@ -878,24 +900,24 @@
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(
<span class="macro">writeln</span><span class="macro">!</span>(
<span class="ident">f</span>,
<span class="string">&quot;\nHttpRequest {:?} {}:{}&quot;</span>,
<span class="self">self</span>.<span class="ident">version</span>(),
<span class="self">self</span>.<span class="ident">method</span>(),
<span class="self">self</span>.<span class="ident">path</span>()
);
)<span class="question-mark">?</span>;
<span class="kw">if</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">query_string</span>().<span class="ident">is_empty</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; query: ?{:?}&quot;</span>, <span class="self">self</span>.<span class="ident">query_string</span>());
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; query: ?{:?}&quot;</span>, <span class="self">self</span>.<span class="ident">query_string</span>())<span class="question-mark">?</span>;
}
<span class="kw">if</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">match_info</span>().<span class="ident">is_empty</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; params: {:?}&quot;</span>, <span class="self">self</span>.<span class="ident">match_info</span>());
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; params: {:?}&quot;</span>, <span class="self">self</span>.<span class="ident">match_info</span>())<span class="question-mark">?</span>;
}
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="self">self</span>.<span class="ident">headers</span>().<span class="ident">iter</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="ident">res</span>
<span class="prelude-val">Ok</span>(())
}
}
@ -954,7 +976,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_request_match_info</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{key}/&quot;</span>)));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/value/?id=test&quot;</span>).<span class="ident">finish</span>();
@ -964,7 +986,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_url_for</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/user/{name}.{ext}&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;index&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
@ -998,7 +1020,8 @@
<span class="kw">fn</span> <span class="ident">test_url_for_with_prefix</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/user/{name}.html&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;index&quot;</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">set_prefix</span>(<span class="string">&quot;/prefix&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">default_route_info</span>();
@ -1024,7 +1047,8 @@
<span class="kw">fn</span> <span class="ident">test_url_for_static</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/index.html&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;index&quot;</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">set_prefix</span>(<span class="string">&quot;/prefix&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">default_route_info</span>();
@ -1047,7 +1071,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_url_for_external</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_external</span>(
<span class="string">&quot;youtube&quot;</span>,
<span class="ident">ResourceDef</span>::<span class="ident">external</span>(<span class="string">&quot;https://youtube.com/watch/{video_id}&quot;</span>),

72
static/api/actix-web/stable/src/actix_web/httpresponse.rs.html
View File

@ -1334,6 +1334,35 @@
<span id="1334">1334</span>
<span id="1335">1335</span>
<span id="1336">1336</span>
<span id="1337">1337</span>
<span id="1338">1338</span>
<span id="1339">1339</span>
<span id="1340">1340</span>
<span id="1341">1341</span>
<span id="1342">1342</span>
<span id="1343">1343</span>
<span id="1344">1344</span>
<span id="1345">1345</span>
<span id="1346">1346</span>
<span id="1347">1347</span>
<span id="1348">1348</span>
<span id="1349">1349</span>
<span id="1350">1350</span>
<span id="1351">1351</span>
<span id="1352">1352</span>
<span id="1353">1353</span>
<span id="1354">1354</span>
<span id="1355">1355</span>
<span id="1356">1356</span>
<span id="1357">1357</span>
<span id="1358">1358</span>
<span id="1359">1359</span>
<span id="1360">1360</span>
<span id="1361">1361</span>
<span id="1362">1362</span>
<span id="1363">1363</span>
<span id="1364">1364</span>
<span id="1365">1365</span>
</pre><pre class="rust ">
<span class="doccomment">//! Http response</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::<span class="ident">RefCell</span>;
@ -1479,8 +1508,7 @@
<span class="ident">HeaderValue</span>::<span class="ident">from_str</span>(<span class="kw-2">&amp;</span><span class="ident">cookie</span>.<span class="ident">to_string</span>())
.<span class="ident">map</span>(<span class="op">|</span><span class="ident">c</span><span class="op">|</span> {
<span class="ident">h</span>.<span class="ident">append</span>(<span class="ident">header</span>::<span class="ident">SET_COOKIE</span>, <span class="ident">c</span>);
})
.<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">into</span>())
}).<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">into</span>())
}
<span class="doccomment">/// Remove all cookies with the given name from this response. Returns</span>
@ -1610,7 +1638,7 @@
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">response_size</span> <span class="op">=</span> <span class="ident">size</span>;
}
<span class="doccomment">/// Set write buffer capacity</span>
<span class="doccomment">/// Get write buffer capacity</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">write_buffer_capacity</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">usize</span> {
<span class="self">self</span>.<span class="ident">get_ref</span>().<span class="ident">write_capacity</span>
}
@ -1987,7 +2015,14 @@
<span class="doccomment">///</span>
<span class="doccomment">/// `HttpResponseBuilder` can not be used after this call.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">json</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Serialize</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">HttpResponse</span> {
<span class="kw">match</span> <span class="ident">serde_json</span>::<span class="ident">to_string</span>(<span class="kw-2">&amp;</span><span class="ident">value</span>) {
<span class="self">self</span>.<span class="ident">json2</span>(<span class="kw-2">&amp;</span><span class="ident">value</span>)
}
<span class="doccomment">/// Set a json body and generate `HttpResponse`</span>
<span class="doccomment">///</span>
<span class="doccomment">/// `HttpResponseBuilder` can not be used after this call.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">json2</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Serialize</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">HttpResponse</span> {
<span class="kw">match</span> <span class="ident">serde_json</span>::<span class="ident">to_string</span>(<span class="ident">value</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">body</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">contains</span> <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">parts</span>) <span class="op">=</span> <span class="ident">parts</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">response</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">err</span>)
{
@ -2025,7 +2060,7 @@
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">borrowed_box</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">borrowed_box</span>))]</span>
<span class="kw">fn</span> <span class="ident">parts</span><span class="op">&lt;</span><span class="lifetime">&#39;a</span><span class="op">&gt;</span>(
<span class="ident">parts</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;a</span> <span class="kw-2">mut</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">InnerHttpResponse</span><span class="op">&gt;&gt;</span>, <span class="ident">err</span>: <span class="kw-2">&amp;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">HttpError</span><span class="op">&gt;</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;a</span> <span class="kw-2">mut</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">InnerHttpResponse</span><span class="op">&gt;&gt;</span> {
@ -2409,8 +2444,7 @@
.<span class="ident">http_only</span>(<span class="bool-val">true</span>)
.<span class="ident">max_age</span>(<span class="ident">Duration</span>::<span class="ident">days</span>(<span class="number">1</span>))
.<span class="ident">finish</span>(),
)
.<span class="ident">del_cookie</span>(<span class="kw-2">&amp;</span><span class="ident">cookies</span>[<span class="number">0</span>])
).<span class="ident">del_cookie</span>(<span class="kw-2">&amp;</span><span class="ident">cookies</span>[<span class="number">0</span>])
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">val</span>: <span class="ident">Vec</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span> <span class="op">=</span> <span class="ident">resp</span>
@ -2523,6 +2557,30 @@
);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_json2</span>() {
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">HttpResponse</span>::<span class="ident">build</span>(<span class="ident">StatusCode</span>::<span class="ident">OK</span>).<span class="ident">json2</span>(<span class="kw-2">&amp;</span><span class="macro">vec</span><span class="macro">!</span>[<span class="string">&quot;v1&quot;</span>, <span class="string">&quot;v2&quot;</span>, <span class="string">&quot;v3&quot;</span>]);
<span class="kw">let</span> <span class="ident">ct</span> <span class="op">=</span> <span class="ident">resp</span>.<span class="ident">headers</span>().<span class="ident">get</span>(<span class="ident">CONTENT_TYPE</span>).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ct</span>, <span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;application/json&quot;</span>));
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw-2">*</span><span class="ident">resp</span>.<span class="ident">body</span>(),
<span class="ident">Body</span>::<span class="ident">from</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;[\&quot;v1\&quot;,\&quot;v2\&quot;,\&quot;v3\&quot;]&quot;</span>))
);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_json2_ct</span>() {
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">HttpResponse</span>::<span class="ident">build</span>(<span class="ident">StatusCode</span>::<span class="ident">OK</span>)
.<span class="ident">header</span>(<span class="ident">CONTENT_TYPE</span>, <span class="string">&quot;text/json&quot;</span>)
.<span class="ident">json2</span>(<span class="kw-2">&amp;</span><span class="macro">vec</span><span class="macro">!</span>[<span class="string">&quot;v1&quot;</span>, <span class="string">&quot;v2&quot;</span>, <span class="string">&quot;v3&quot;</span>]);
<span class="kw">let</span> <span class="ident">ct</span> <span class="op">=</span> <span class="ident">resp</span>.<span class="ident">headers</span>().<span class="ident">get</span>(<span class="ident">CONTENT_TYPE</span>).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">ct</span>, <span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;text/json&quot;</span>));
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw-2">*</span><span class="ident">resp</span>.<span class="ident">body</span>(),
<span class="ident">Body</span>::<span class="ident">from</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;[\&quot;v1\&quot;,\&quot;v2\&quot;,\&quot;v3\&quot;]&quot;</span>))
);
}
<span class="kw">impl</span> <span class="ident">Body</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">bin_ref</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">Binary</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {

10
static/api/actix-web/stable/src/actix_web/info.rs.html
View File

@ -216,6 +216,8 @@
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{<span class="self">self</span>, <span class="ident">HeaderName</span>};
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">Request</span>;
@ -235,7 +237,10 @@
<span class="kw">impl</span> <span class="ident">ConnectionInfo</span> {
<span class="doccomment">/// Create *ConnectionInfo* instance for a request.</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">cyclomatic_complexity</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">cyclomatic_complexity</span>)
)]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">update</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="kw-2">&amp;</span><span class="ident">Request</span>) {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">host</span> <span class="op">=</span> <span class="prelude-val">None</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">scheme</span> <span class="op">=</span> <span class="prelude-val">None</span>;
@ -393,8 +398,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">FORWARDED</span>,
<span class="string">&quot;for=192.0.2.60; proto=https; by=203.0.113.43; host=rust-lang.org&quot;</span>,
)
.<span class="ident">request</span>();
).<span class="ident">request</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">ConnectionInfo</span>::<span class="ident">default</span>();
<span class="ident">info</span>.<span class="ident">update</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);

32
static/api/actix-web/stable/src/actix_web/json.rs.html
View File

@ -441,13 +441,6 @@
<span id="441">441</span>
<span id="442">442</span>
<span id="443">443</span>
<span id="444">444</span>
<span id="445">445</span>
<span id="446">446</span>
<span id="447">447</span>
<span id="448">448</span>
<span id="449">449</span>
<span id="450">450</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">bytes</span>::<span class="ident">BytesMut</span>;
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Future</span>, <span class="ident">Poll</span>, <span class="ident">Stream</span>};
@ -623,7 +616,7 @@
<span class="doccomment">/// let app = App::new().resource(&quot;/index.html&quot;, |r| {</span>
<span class="doccomment">/// r.method(http::Method::POST)</span>
<span class="doccomment">/// .with_config(index, |cfg| {</span>
<span class="doccomment">/// cfg.limit(4096) // &lt;- change json extractor configuration</span>
<span class="doccomment">/// cfg.0.limit(4096) // &lt;- change json extractor configuration</span>
<span class="doccomment">/// .error_handler(|err, req| { // &lt;- create custom error response</span>
<span class="doccomment">/// error::InternalError::from_response(</span>
<span class="doccomment">/// err, HttpResponse::Conflict().finish()).into()</span>
@ -778,8 +771,7 @@
<span class="ident">body</span>.<span class="ident">extend_from_slice</span>(<span class="kw-2">&amp;</span><span class="ident">chunk</span>);
<span class="prelude-val">Ok</span>(<span class="ident">body</span>)
}
})
.<span class="ident">and_then</span>(<span class="op">|</span><span class="ident">body</span><span class="op">|</span> <span class="prelude-val">Ok</span>(<span class="ident">serde_json</span>::<span class="ident">from_slice</span>::<span class="op">&lt;</span><span class="ident">U</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="ident">body</span>)<span class="question-mark">?</span>));
}).<span class="ident">and_then</span>(<span class="op">|</span><span class="ident">body</span><span class="op">|</span> <span class="prelude-val">Ok</span>(<span class="ident">serde_json</span>::<span class="ident">from_slice</span>::<span class="op">&lt;</span><span class="ident">U</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="ident">body</span>)<span class="question-mark">?</span>));
<span class="self">self</span>.<span class="ident">fut</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">fut</span>));
<span class="self">self</span>.<span class="ident">poll</span>()
}
@ -839,8 +831,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;application/text&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">json</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">json</span>::<span class="op">&lt;</span><span class="ident">MyObject</span><span class="op">&gt;</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">json</span>.<span class="ident">poll</span>().<span class="ident">err</span>().<span class="ident">unwrap</span>(), <span class="ident">JsonPayloadError</span>::<span class="ident">ContentType</span>);
@ -848,12 +839,10 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;application/json&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;10000&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">json</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">json</span>::<span class="op">&lt;</span><span class="ident">MyObject</span><span class="op">&gt;</span>().<span class="ident">limit</span>(<span class="number">100</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">json</span>.<span class="ident">poll</span>().<span class="ident">err</span>().<span class="ident">unwrap</span>(), <span class="ident">JsonPayloadError</span>::<span class="ident">Overflow</span>);
@ -861,12 +850,10 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;application/json&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;16&quot;</span>),
)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;{\&quot;name\&quot;: \&quot;test\&quot;}&quot;</span>))
).<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;{\&quot;name\&quot;: \&quot;test\&quot;}&quot;</span>))
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">json</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">json</span>::<span class="op">&lt;</span><span class="ident">MyObject</span><span class="op">&gt;</span>();
@ -893,9 +880,8 @@
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONTENT_LENGTH</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;16&quot;</span>),
)
.<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;{\&quot;name\&quot;: \&quot;test\&quot;}&quot;</span>))
.<span class="ident">finish</span>();
).<span class="ident">set_payload</span>(<span class="ident">Bytes</span>::<span class="ident">from_static</span>(<span class="string">b&quot;{\&quot;name\&quot;: \&quot;test\&quot;}&quot;</span>))
.<span class="ident">finish</span>();
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">handler</span>.<span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">as_err</span>().<span class="ident">is_none</span>())
}
}

60
static/api/actix-web/stable/src/actix_web/lib.rs.html
View File

@ -271,6 +271,27 @@
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
<span id="285">285</span>
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
</pre><pre class="rust ">
<span class="doccomment">//! Actix web is a small, pragmatic, and extremely fast web framework</span>
<span class="doccomment">//! for Rust.</span>
@ -338,8 +359,10 @@
<span class="doccomment">//! ## Package feature</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! * `tls` - enables ssl support via `native-tls` crate</span>
<span class="doccomment">//! * `alpn` - enables ssl support via `openssl` crate, require for `http/2`</span>
<span class="doccomment">//! support</span>
<span class="doccomment">//! * `ssl` - enables ssl support via `openssl` crate, supports `http/2`</span>
<span class="doccomment">//! * `rust-tls` - enables ssl support via `rustls` crate, supports `http/2`</span>
<span class="doccomment">//! * `uds` - enables support for making client requests via Unix Domain Sockets.</span>
<span class="doccomment">//! Unix only. Not necessary for *serving* requests.</span>
<span class="doccomment">//! * `session` - enables session support, includes `ring` crate as</span>
<span class="doccomment">//! dependency</span>
<span class="doccomment">//! * `brotli` - enables `brotli` compression support, requires `c`</span>
@ -352,11 +375,8 @@
<span class="attribute">#![<span class="ident">cfg_attr</span>(<span class="ident">actix_nightly</span>, <span class="ident">feature</span>(
<span class="ident">specialization</span>, <span class="comment">// for impl ErrorResponse for std::error::Error</span>
<span class="ident">extern_prelude</span>,
<span class="ident">tool_lints</span>,
))]</span>
<span class="attribute">#![<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">decimal_literal_representation</span>, <span class="ident">suspicious_arithmetic_impl</span>)
)]</span>
<span class="attribute">#![<span class="ident">warn</span>(<span class="ident">missing_docs</span>)]</span>
<span class="attribute">#[<span class="ident">macro_use</span>]</span>
@ -390,10 +410,13 @@
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">rand</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">slab</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_current_thread</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_io</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_reactor</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_tcp</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_timer</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">unix</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;uds&quot;</span>))]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_uds</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">url</span>;
<span class="attribute">#[<span class="ident">macro_use</span>]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">serde</span>;
@ -404,10 +427,13 @@
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">flate2</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">h2</span> <span class="kw">as</span> <span class="ident">http2</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">num_cpus</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">serde_urlencoded</span>;
<span class="attribute">#[<span class="ident">macro_use</span>]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">percent_encoding</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">serde_json</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">smallvec</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">actix_net</span>;
<span class="attribute">#[<span class="ident">macro_use</span>]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">actix</span> <span class="kw">as</span> <span class="ident">actix_inner</span>;
@ -425,6 +451,15 @@
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;openssl&quot;</span>)]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_openssl</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">rustls</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">tokio_rustls</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">webpki</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">webpki_roots</span>;
<span class="kw">mod</span> <span class="ident">application</span>;
<span class="kw">mod</span> <span class="ident">body</span>;
<span class="kw">mod</span> <span class="ident">context</span>;
@ -447,7 +482,6 @@
<span class="kw">mod</span> <span class="ident">route</span>;
<span class="kw">mod</span> <span class="ident">router</span>;
<span class="kw">mod</span> <span class="ident">scope</span>;
<span class="kw">mod</span> <span class="ident">serde_urlencoded</span>;
<span class="kw">mod</span> <span class="ident">uri</span>;
<span class="kw">mod</span> <span class="ident">with</span>;
@ -498,6 +532,11 @@
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>))]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">const</span> <span class="ident">HAS_TLS</span>: <span class="ident">bool</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">const</span> <span class="ident">HAS_RUSTLS</span>: <span class="ident">bool</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>))]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">const</span> <span class="ident">HAS_RUSTLS</span>: <span class="ident">bool</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">pub</span> <span class="kw">mod</span> <span class="ident">dev</span> {
<span class="doccomment">//! The `actix-web` prelude for library developers</span>
<span class="doccomment">//!</span>
@ -513,12 +552,13 @@
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">context</span>::<span class="ident">Drain</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">extractor</span>::{<span class="ident">FormConfig</span>, <span class="ident">PayloadConfig</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">handler</span>::{<span class="ident">AsyncResult</span>, <span class="ident">Handler</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">httpmessage</span>::{<span class="ident">MessageBody</span>, <span class="ident">UrlEncoded</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">httpmessage</span>::{<span class="ident">MessageBody</span>, <span class="ident">Readlines</span>, <span class="ident">UrlEncoded</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponseBuilder</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">info</span>::<span class="ident">ConnectionInfo</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">json</span>::{<span class="ident">JsonBody</span>, <span class="ident">JsonConfig</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">param</span>::{<span class="ident">FromParam</span>, <span class="ident">Params</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">payload</span>::{<span class="ident">Payload</span>, <span class="ident">PayloadBuffer</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">pipeline</span>::<span class="ident">Pipeline</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">resource</span>::<span class="ident">Resource</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">route</span>::<span class="ident">Route</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">router</span>::{<span class="ident">ResourceDef</span>, <span class="ident">ResourceInfo</span>, <span class="ident">ResourceType</span>, <span class="ident">Router</span>};
@ -540,7 +580,9 @@
<span class="doccomment">/// Various http headers</span>
<span class="kw">pub</span> <span class="kw">mod</span> <span class="ident">header</span> {
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">header</span>::<span class="kw-2">*</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">header</span>::{<span class="ident">ContentDisposition</span>, <span class="ident">DispositionType</span>, <span class="ident">DispositionParam</span>, <span class="ident">Charset</span>, <span class="ident">LanguageTag</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">header</span>::{
<span class="ident">Charset</span>, <span class="ident">ContentDisposition</span>, <span class="ident">DispositionParam</span>, <span class="ident">DispositionType</span>, <span class="ident">LanguageTag</span>,
};
}
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">header</span>::<span class="ident">ContentEncoding</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">ConnectionType</span>;

98
static/api/actix-web/stable/src/actix_web/middleware/cors.rs.html
View File

@ -1157,6 +1157,30 @@
<span id="1157">1157</span>
<span id="1158">1158</span>
<span id="1159">1159</span>
<span id="1160">1160</span>
<span id="1161">1161</span>
<span id="1162">1162</span>
<span id="1163">1163</span>
<span id="1164">1164</span>
<span id="1165">1165</span>
<span id="1166">1166</span>
<span id="1167">1167</span>
<span id="1168">1168</span>
<span id="1169">1169</span>
<span id="1170">1170</span>
<span id="1171">1171</span>
<span id="1172">1172</span>
<span id="1173">1173</span>
<span id="1174">1174</span>
<span id="1175">1175</span>
<span id="1176">1176</span>
<span id="1177">1177</span>
<span id="1178">1178</span>
<span id="1179">1179</span>
<span id="1180">1180</span>
<span id="1181">1181</span>
<span id="1182">1182</span>
<span id="1183">1183</span>
</pre><pre class="rust ">
<span class="doccomment">//! Cross-origin resource sharing (CORS) for Actix applications</span>
<span class="doccomment">//!</span>
@ -1547,12 +1571,10 @@
<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_MAX_AGE</span>,
<span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">max_age</span>).<span class="ident">as_str</span>(),
);
})
.<span class="ident">if_some</span>(<span class="ident">headers</span>, <span class="op">|</span><span class="ident">headers</span>, <span class="ident">resp</span><span class="op">|</span> {
}).<span class="ident">if_some</span>(<span class="ident">headers</span>, <span class="op">|</span><span class="ident">headers</span>, <span class="ident">resp</span><span class="op">|</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span>
<span class="ident">resp</span>.<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_HEADERS</span>, <span class="ident">headers</span>);
})
.<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">origins</span>.<span class="ident">is_all</span>(), <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
}).<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">origins</span>.<span class="ident">is_all</span>(), <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">send_wildcard</span> {
<span class="ident">resp</span>.<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_ORIGIN</span>, <span class="string">&quot;*&quot;</span>);
} <span class="kw">else</span> {
@ -1562,17 +1584,14 @@
<span class="ident">origin</span>.<span class="ident">clone</span>(),
);
}
})
.<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">origins</span>.<span class="ident">is_some</span>(), <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
}).<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">origins</span>.<span class="ident">is_some</span>(), <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
<span class="ident">resp</span>.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_ORIGIN</span>,
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">origins_str</span>.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">clone</span>(),
);
})
.<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">supports_credentials</span>, <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
}).<span class="ident">if_true</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">supports_credentials</span>, <span class="op">|</span><span class="ident">resp</span><span class="op">|</span> {
<span class="ident">resp</span>.<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_CREDENTIALS</span>, <span class="string">&quot;true&quot;</span>);
})
.<span class="ident">header</span>(
}).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_METHODS</span>,
<span class="kw-2">&amp;</span><span class="self">self</span>
.<span class="ident">inner</span>
@ -1580,8 +1599,7 @@
.<span class="ident">iter</span>()
.<span class="ident">fold</span>(<span class="ident">String</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="ident">s</span>, <span class="ident">v</span><span class="op">|</span> <span class="ident">s</span> <span class="op">+</span> <span class="string">&quot;,&quot;</span> <span class="op">+</span> <span class="ident">v</span>.<span class="ident">as_str</span>())
.<span class="ident">as_str</span>()[<span class="number">1</span>..],
)
.<span class="ident">finish</span>(),
).<span class="ident">finish</span>(),
))
} <span class="kw">else</span> {
<span class="comment">// Only check requests with a origin header.</span>
@ -1992,15 +2010,15 @@
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">AllOrSome</span>::<span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">origins</span>) <span class="op">=</span> <span class="ident">cors</span>.<span class="ident">origins</span> {
<span class="kw">let</span> <span class="ident">s</span> <span class="op">=</span> <span class="ident">origins</span>
.<span class="ident">iter</span>()
.<span class="ident">fold</span>(<span class="ident">String</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="ident">s</span>, <span class="ident">v</span><span class="op">|</span> <span class="ident">s</span> <span class="op">+</span> <span class="kw-2">&amp;</span><span class="ident">v</span>.<span class="ident">to_string</span>());
<span class="ident">cors</span>.<span class="ident">origins_str</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">HeaderValue</span>::<span class="ident">try_from</span>(<span class="ident">s</span>.<span class="ident">as_str</span>()).<span class="ident">unwrap</span>());
.<span class="ident">fold</span>(<span class="ident">String</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="ident">s</span>, <span class="ident">v</span><span class="op">|</span> <span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;{}, {}&quot;</span>, <span class="ident">s</span>, <span class="ident">v</span>));
<span class="ident">cors</span>.<span class="ident">origins_str</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">HeaderValue</span>::<span class="ident">try_from</span>(<span class="kw-2">&amp;</span><span class="ident">s</span>[<span class="number">2</span>..]).<span class="ident">unwrap</span>());
}
<span class="kw">if</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">expose_hdrs</span>.<span class="ident">is_empty</span>() {
<span class="ident">cors</span>.<span class="ident">expose_hdrs</span> <span class="op">=</span> <span class="prelude-val">Some</span>(
<span class="self">self</span>.<span class="ident">expose_hdrs</span>
.<span class="ident">iter</span>()
.<span class="ident">fold</span>(<span class="ident">String</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="ident">s</span>, <span class="ident">v</span><span class="op">|</span> <span class="ident">s</span> <span class="op">+</span> <span class="ident">v</span>.<span class="ident">as_str</span>())[<span class="number">1</span>..]
.<span class="ident">fold</span>(<span class="ident">String</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="ident">s</span>, <span class="ident">v</span><span class="op">|</span> <span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;{}, {}&quot;</span>, <span class="ident">s</span>, <span class="ident">v</span>.<span class="ident">as_str</span>()))[<span class="number">2</span>..]
.<span class="ident">to_owned</span>(),
);
}
@ -2138,8 +2156,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_REQUEST_HEADERS</span>,
<span class="string">&quot;AUTHORIZATION,ACCEPT&quot;</span>,
)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">OPTIONS</span>)
).<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">OPTIONS</span>)
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">cors</span>.<span class="ident">start</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">unwrap</span>().<span class="ident">response</span>();
@ -2233,12 +2250,14 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_response</span>() {
<span class="kw">let</span> <span class="ident">exposed_headers</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[<span class="ident">header</span>::<span class="ident">AUTHORIZATION</span>, <span class="ident">header</span>::<span class="ident">ACCEPT</span>];
<span class="kw">let</span> <span class="ident">cors</span> <span class="op">=</span> <span class="ident">Cors</span>::<span class="ident">build</span>()
.<span class="ident">send_wildcard</span>()
.<span class="ident">disable_preflight</span>()
.<span class="ident">max_age</span>(<span class="number">3600</span>)
.<span class="ident">allowed_methods</span>(<span class="macro">vec</span><span class="macro">!</span>[<span class="ident">Method</span>::<span class="ident">GET</span>, <span class="ident">Method</span>::<span class="ident">OPTIONS</span>, <span class="ident">Method</span>::<span class="ident">POST</span>])
.<span class="ident">allowed_headers</span>(<span class="macro">vec</span><span class="macro">!</span>[<span class="ident">header</span>::<span class="ident">AUTHORIZATION</span>, <span class="ident">header</span>::<span class="ident">ACCEPT</span>])
.<span class="ident">allowed_headers</span>(<span class="ident">exposed_headers</span>.<span class="ident">clone</span>())
.<span class="ident">expose_headers</span>(<span class="ident">exposed_headers</span>.<span class="ident">clone</span>())
.<span class="ident">allowed_header</span>(<span class="ident">header</span>::<span class="ident">CONTENT_TYPE</span>)
.<span class="ident">finish</span>();
@ -2260,6 +2279,22 @@
<span class="ident">resp</span>.<span class="ident">headers</span>().<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">VARY</span>).<span class="ident">unwrap</span>().<span class="ident">as_bytes</span>()
);
{
<span class="kw">let</span> <span class="ident">headers</span> <span class="op">=</span> <span class="ident">resp</span>
.<span class="ident">headers</span>()
.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_EXPOSE_HEADERS</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">to_str</span>()
.<span class="ident">unwrap</span>()
.<span class="ident">split</span>(<span class="string">&#39;,&#39;</span>)
.<span class="ident">map</span>(<span class="op">|</span><span class="ident">s</span><span class="op">|</span> <span class="ident">s</span>.<span class="ident">trim</span>())
.<span class="ident">collect</span>::<span class="op">&lt;</span><span class="ident">Vec</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="ident">str</span><span class="op">&gt;&gt;</span>();
<span class="kw">for</span> <span class="ident">h</span> <span class="kw">in</span> <span class="ident">exposed_headers</span> {
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">headers</span>.<span class="ident">contains</span>(<span class="kw-2">&amp;</span><span class="ident">h</span>.<span class="ident">as_str</span>()));
}
}
<span class="kw">let</span> <span class="ident">resp</span>: <span class="ident">HttpResponse</span> <span class="op">=</span>
<span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>().<span class="ident">header</span>(<span class="ident">header</span>::<span class="ident">VARY</span>, <span class="string">&quot;Accept&quot;</span>).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">cors</span>.<span class="ident">response</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="ident">resp</span>).<span class="ident">unwrap</span>().<span class="ident">response</span>();
@ -2271,16 +2306,29 @@
<span class="kw">let</span> <span class="ident">cors</span> <span class="op">=</span> <span class="ident">Cors</span>::<span class="ident">build</span>()
.<span class="ident">disable_vary_header</span>()
.<span class="ident">allowed_origin</span>(<span class="string">&quot;https://www.example.com&quot;</span>)
.<span class="ident">allowed_origin</span>(<span class="string">&quot;https://www.google.com&quot;</span>)
.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">resp</span>: <span class="ident">HttpResponse</span> <span class="op">=</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>().<span class="ident">into</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">cors</span>.<span class="ident">response</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="ident">resp</span>).<span class="ident">unwrap</span>().<span class="ident">response</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw-2">&amp;</span><span class="string">b&quot;https://www.example.com&quot;</span>[..],
<span class="ident">resp</span>.<span class="ident">headers</span>()
.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_ORIGIN</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">as_bytes</span>()
);
<span class="kw">let</span> <span class="ident">origins_str</span> <span class="op">=</span> <span class="ident">resp</span>
.<span class="ident">headers</span>()
.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">ACCESS_CONTROL_ALLOW_ORIGIN</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">to_str</span>()
.<span class="ident">unwrap</span>();
<span class="kw">if</span> <span class="ident">origins_str</span>.<span class="ident">starts_with</span>(<span class="string">&quot;https://www.example.com&quot;</span>) {
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="string">&quot;https://www.example.com, https://www.google.com&quot;</span>,
<span class="ident">origins_str</span>
);
} <span class="kw">else</span> {
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="string">&quot;https://www.google.com, https://www.example.com&quot;</span>,
<span class="ident">origins_str</span>
);
}
}
<span class="attribute">#[<span class="ident">test</span>]</span>

6
static/api/actix-web/stable/src/actix_web/middleware/csrf.rs.html
View File

@ -273,7 +273,6 @@
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
</pre><pre class="rust ">
<span class="doccomment">//! A filter for cross-site request forgery (CSRF).</span>
<span class="doccomment">//!</span>
@ -370,8 +369,7 @@
.<span class="ident">to_str</span>()
.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">CsrfError</span>::<span class="ident">BadOrigin</span>)
.<span class="ident">map</span>(<span class="op">|</span><span class="ident">o</span><span class="op">|</span> <span class="ident">o</span>.<span class="ident">into</span>())
})
.<span class="ident">or_else</span>(<span class="op">||</span> {
}).<span class="ident">or_else</span>(<span class="op">||</span> {
<span class="ident">headers</span>.<span class="ident">get</span>(<span class="ident">header</span>::<span class="ident">REFERER</span>).<span class="ident">map</span>(<span class="op">|</span><span class="ident">referer</span><span class="op">|</span> {
<span class="ident">Uri</span>::<span class="ident">try_from</span>(<span class="ident">Bytes</span>::<span class="ident">from</span>(<span class="ident">referer</span>.<span class="ident">as_bytes</span>()))
.<span class="ident">ok</span>()
@ -528,7 +526,7 @@
<span class="string">&quot;Referer&quot;</span>,
<span class="string">&quot;https://www.example.com/some/path?query=param&quot;</span>,
).<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">POST</span>)
.<span class="ident">finish</span>();
.<span class="ident">finish</span>();
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">csrf</span>.<span class="ident">start</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">is_ok</span>());
}

2
static/api/actix-web/stable/src/actix_web/middleware/defaultheaders.rs.html
View File

@ -169,7 +169,7 @@
<span class="doccomment">/// Set a header.</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">match_wild_err_arm</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">match_wild_err_arm</span>))]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">header</span><span class="op">&lt;</span><span class="ident">K</span>, <span class="ident">V</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="ident">K</span>, <span class="ident">value</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="self">Self</span>
<span class="kw">where</span>
<span class="ident">HeaderName</span>: <span class="ident">HttpTryFrom</span><span class="op">&lt;</span><span class="ident">K</span><span class="op">&gt;</span>,

2
static/api/actix-web/stable/src/actix_web/middleware/errhandlers.rs.html
View File

@ -273,7 +273,7 @@
<span class="ident">ErrorHandlers</span>::<span class="ident">new</span>()
.<span class="ident">handler</span>(<span class="ident">StatusCode</span>::<span class="ident">INTERNAL_SERVER_ERROR</span>, <span class="ident">render_500</span>),
).<span class="ident">middleware</span>(<span class="ident">MiddlewareOne</span>)
.<span class="ident">handler</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>())
.<span class="ident">handler</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>())
});
<span class="kw">let</span> <span class="ident">request</span> <span class="op">=</span> <span class="ident">srv</span>.<span class="ident">get</span>().<span class="ident">finish</span>().<span class="ident">unwrap</span>();

16
static/api/actix-web/stable/src/actix_web/middleware/session.rs.html
View File

@ -613,6 +613,8 @@
<span id="613">613</span>
<span id="614">614</span>
<span id="615">615</span>
<span id="616">616</span>
<span id="617">617</span>
</pre><pre class="rust ">
<span class="doccomment">//! User sessions.</span>
<span class="doccomment">//!</span>
@ -886,14 +888,17 @@
}
<span class="doccomment">/// A simple key-value storage interface that is internally used by `Session`.</span>
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">SessionImpl</span>: <span class="lifetime">&#39;static</span> {
<span class="doccomment">/// Get session value by key</span>
<span class="kw">fn</span> <span class="ident">get</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="ident">str</span><span class="op">&gt;</span>;
<span class="doccomment">/// Set session value</span>
<span class="kw">fn</span> <span class="ident">set</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">value</span>: <span class="ident">String</span>);
<span class="doccomment">/// Remove specific key from session</span>
<span class="kw">fn</span> <span class="ident">remove</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>);
<span class="doccomment">/// Remove all values from session</span>
<span class="kw">fn</span> <span class="ident">clear</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>);
<span class="doccomment">/// Write session to storage backend.</span>
@ -901,9 +906,10 @@
}
<span class="doccomment">/// Session&#39;s storage backend trait definition.</span>
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">SessionBackend</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>: <span class="ident">Sized</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> {
<span class="doccomment">/// Session item</span>
<span class="kw">type</span> <span class="ident">Session</span>: <span class="ident">SessionImpl</span>;
<span class="doccomment">/// Future that reads session</span>
<span class="kw">type</span> <span class="ident">ReadFuture</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="self">Self</span>::<span class="ident">Session</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="doccomment">/// Parse the session from request and load data from a storage backend.</span>
@ -1195,8 +1201,7 @@
<span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">middleware</span>(<span class="ident">SessionStorage</span>::<span class="ident">new</span>(
<span class="ident">CookieSessionBackend</span>::<span class="ident">signed</span>(<span class="kw-2">&amp;</span>[<span class="number">0</span>; <span class="number">32</span>]).<span class="ident">secure</span>(<span class="bool-val">false</span>),
))
.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> {
)).<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> {
<span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="ident">req</span><span class="op">|</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">session</span>().<span class="ident">set</span>(<span class="string">&quot;counter&quot;</span>, <span class="number">100</span>);
<span class="string">&quot;test&quot;</span>
@ -1215,8 +1220,7 @@
<span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">middleware</span>(<span class="ident">SessionStorage</span>::<span class="ident">new</span>(
<span class="ident">CookieSessionBackend</span>::<span class="ident">signed</span>(<span class="kw-2">&amp;</span>[<span class="number">0</span>; <span class="number">32</span>]).<span class="ident">secure</span>(<span class="bool-val">false</span>),
))
.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> {
)).<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> {
<span class="ident">r</span>.<span class="ident">with</span>(<span class="op">|</span><span class="ident">ses</span>: <span class="ident">Session</span><span class="op">|</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">ses</span>.<span class="ident">set</span>(<span class="string">&quot;counter&quot;</span>, <span class="number">100</span>);
<span class="string">&quot;test&quot;</span>

24
static/api/actix-web/stable/src/actix_web/multipart.rs.html
View File

@ -813,10 +813,6 @@
<span id="813">813</span>
<span id="814">814</span>
<span id="815">815</span>
<span id="816">816</span>
<span id="817">817</span>
<span id="818">818</span>
<span id="819">819</span>
</pre><pre class="rust ">
<span class="doccomment">//! Multipart requests support</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::{<span class="ident">RefCell</span>, <span class="ident">UnsafeCell</span>};
@ -1261,13 +1257,13 @@
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">Field</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;\nMultipartField: {}&quot;</span>, <span class="self">self</span>.<span class="ident">ct</span>);
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; boundary: {}&quot;</span>, <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">borrow</span>().<span class="ident">boundary</span>);
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;\nMultipartField: {}&quot;</span>, <span class="self">self</span>.<span class="ident">ct</span>)<span class="question-mark">?</span>;
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; boundary: {}&quot;</span>, <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">borrow</span>().<span class="ident">boundary</span>)<span class="question-mark">?</span>;
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="self">self</span>.<span class="ident">headers</span>.<span class="ident">iter</span>() {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>);
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="ident">res</span>
<span class="prelude-val">Ok</span>(())
}
}
@ -1576,13 +1572,10 @@
{
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{<span class="ident">DispositionParam</span>, <span class="ident">DispositionType</span>};
<span class="kw">let</span> <span class="ident">cd</span> <span class="op">=</span> <span class="ident">field</span>.<span class="ident">content_disposition</span>().<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">cd</span>.<span class="ident">disposition</span>,
<span class="ident">DispositionType</span>::<span class="ident">Ext</span>(<span class="string">&quot;form-data&quot;</span>.<span class="ident">into</span>())
);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">cd</span>.<span class="ident">disposition</span>, <span class="ident">DispositionType</span>::<span class="ident">FormData</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">cd</span>.<span class="ident">parameters</span>[<span class="number">0</span>],
<span class="ident">DispositionParam</span>::<span class="ident">Ext</span>(<span class="string">&quot;name&quot;</span>.<span class="ident">into</span>(), <span class="string">&quot;file&quot;</span>.<span class="ident">into</span>())
<span class="ident">DispositionParam</span>::<span class="ident">Name</span>(<span class="string">&quot;file&quot;</span>.<span class="ident">into</span>())
);
}
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">field</span>.<span class="ident">content_type</span>().<span class="ident">type_</span>(), <span class="ident">mime</span>::<span class="ident">TEXT</span>);
@ -1633,8 +1626,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
}
</pre>

2
static/api/actix-web/stable/src/actix_web/param.rs.html
View File

@ -301,7 +301,6 @@
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::<span class="ident">Index</span>;
@ -541,7 +540,6 @@
(<span class="macro-nonterminal">$</span><span class="kw">type</span>:<span class="macro-nonterminal">ty</span>) <span class="op">=&gt;</span> {
<span class="kw">impl</span> <span class="ident">FromParam</span> <span class="kw">for</span> <span class="macro-nonterminal">$</span><span class="kw">type</span> {
<span class="kw">type</span> <span class="prelude-val">Err</span> <span class="op">=</span> <span class="macro-nonterminal">InternalError</span><span class="op">&lt;&lt;</span><span class="macro-nonterminal">$</span><span class="kw">type</span> <span class="kw">as</span> <span class="macro-nonterminal">FromStr</span><span class="op">&gt;</span>::<span class="prelude-val">Err</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">from_param</span>(<span class="ident">val</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>, <span class="self">Self</span>::<span class="prelude-val">Err</span><span class="op">&gt;</span> {
<span class="op">&lt;</span><span class="macro-nonterminal">$</span><span class="kw">type</span> <span class="kw">as</span> <span class="macro-nonterminal">FromStr</span><span class="op">&gt;</span>::<span class="ident">from_str</span>(<span class="ident">val</span>)
.<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">InternalError</span>::<span class="ident">new</span>(<span class="ident">e</span>, <span class="ident">StatusCode</span>::<span class="ident">BAD_REQUEST</span>))

34
static/api/actix-web/stable/src/actix_web/payload.rs.html
View File

@ -713,16 +713,12 @@
<span id="713">713</span>
<span id="714">714</span>
<span id="715">715</span>
<span id="716">716</span>
<span id="717">717</span>
<span id="718">718</span>
<span id="719">719</span>
<span id="720">720</span>
<span id="721">721</span>
</pre><pre class="rust ">
<span class="doccomment">//! Payload stream</span>
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">task</span>::{<span class="ident">current</span> <span class="kw">as</span> <span class="ident">current_task</span>, <span class="ident">Task</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">test</span>))]</span>
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">task</span>::<span class="ident">current</span> <span class="kw">as</span> <span class="ident">current_task</span>;
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">task</span>::<span class="ident">Task</span>;
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>, <span class="ident">Stream</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::<span class="ident">RefCell</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cmp</span>;
@ -1235,8 +1231,7 @@
.<span class="ident">fold</span>(<span class="ident">BytesMut</span>::<span class="ident">new</span>(), <span class="op">|</span><span class="kw-2">mut</span> <span class="ident">b</span>, <span class="ident">c</span><span class="op">|</span> {
<span class="ident">b</span>.<span class="ident">extend_from_slice</span>(<span class="ident">c</span>);
<span class="ident">b</span>
})
.<span class="ident">freeze</span>()
}).<span class="ident">freeze</span>()
}
}
@ -1275,8 +1270,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1300,8 +1294,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1318,8 +1311,7 @@
<span class="ident">payload</span>.<span class="ident">readany</span>().<span class="ident">err</span>().<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1347,8 +1339,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1381,8 +1372,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1415,8 +1405,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -1437,8 +1426,7 @@
<span class="kw">let</span> <span class="ident">res</span>: <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> <span class="op">=</span> <span class="prelude-val">Ok</span>(());
<span class="ident">result</span>(<span class="ident">res</span>)
}))
.<span class="ident">unwrap</span>();
})).<span class="ident">unwrap</span>();
}
}
</pre>

324
static/api/actix-web/stable/src/actix_web/pipeline.rs.html
View File

@ -770,6 +770,103 @@
<span id="770">770</span>
<span id="771">771</span>
<span id="772">772</span>
<span id="773">773</span>
<span id="774">774</span>
<span id="775">775</span>
<span id="776">776</span>
<span id="777">777</span>
<span id="778">778</span>
<span id="779">779</span>
<span id="780">780</span>
<span id="781">781</span>
<span id="782">782</span>
<span id="783">783</span>
<span id="784">784</span>
<span id="785">785</span>
<span id="786">786</span>
<span id="787">787</span>
<span id="788">788</span>
<span id="789">789</span>
<span id="790">790</span>
<span id="791">791</span>
<span id="792">792</span>
<span id="793">793</span>
<span id="794">794</span>
<span id="795">795</span>
<span id="796">796</span>
<span id="797">797</span>
<span id="798">798</span>
<span id="799">799</span>
<span id="800">800</span>
<span id="801">801</span>
<span id="802">802</span>
<span id="803">803</span>
<span id="804">804</span>
<span id="805">805</span>
<span id="806">806</span>
<span id="807">807</span>
<span id="808">808</span>
<span id="809">809</span>
<span id="810">810</span>
<span id="811">811</span>
<span id="812">812</span>
<span id="813">813</span>
<span id="814">814</span>
<span id="815">815</span>
<span id="816">816</span>
<span id="817">817</span>
<span id="818">818</span>
<span id="819">819</span>
<span id="820">820</span>
<span id="821">821</span>
<span id="822">822</span>
<span id="823">823</span>
<span id="824">824</span>
<span id="825">825</span>
<span id="826">826</span>
<span id="827">827</span>
<span id="828">828</span>
<span id="829">829</span>
<span id="830">830</span>
<span id="831">831</span>
<span id="832">832</span>
<span id="833">833</span>
<span id="834">834</span>
<span id="835">835</span>
<span id="836">836</span>
<span id="837">837</span>
<span id="838">838</span>
<span id="839">839</span>
<span id="840">840</span>
<span id="841">841</span>
<span id="842">842</span>
<span id="843">843</span>
<span id="844">844</span>
<span id="845">845</span>
<span id="846">846</span>
<span id="847">847</span>
<span id="848">848</span>
<span id="849">849</span>
<span id="850">850</span>
<span id="851">851</span>
<span id="852">852</span>
<span id="853">853</span>
<span id="854">854</span>
<span id="855">855</span>
<span id="856">856</span>
<span id="857">857</span>
<span id="858">858</span>
<span id="859">859</span>
<span id="860">860</span>
<span id="861">861</span>
<span id="862">862</span>
<span id="863">863</span>
<span id="864">864</span>
<span id="865">865</span>
<span id="866">866</span>
<span id="867">867</span>
<span id="868">868</span>
<span id="869">869</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
@ -815,13 +912,6 @@
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span>, <span class="ident">H</span>: <span class="ident">PipelineHandler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span> <span class="ident">PipelineState</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">is_response</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="bool-val">true</span>,
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="bool-val">false</span>,
}
}
<span class="kw">fn</span> <span class="ident">poll</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">info</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">PipelineInfo</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>, <span class="ident">mws</span>: <span class="kw-2">&amp;</span>[<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Middleware</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span>],
) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">PipelineState</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;&gt;</span> {
@ -831,9 +921,8 @@
<span class="ident">PipelineState</span>::<span class="ident">RunMiddlewares</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">state</span>) <span class="op">=&gt;</span> <span class="ident">state</span>.<span class="ident">poll</span>(<span class="ident">info</span>, <span class="ident">mws</span>),
<span class="ident">PipelineState</span>::<span class="ident">Finishing</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">state</span>) <span class="op">=&gt;</span> <span class="ident">state</span>.<span class="ident">poll</span>(<span class="ident">info</span>, <span class="ident">mws</span>),
<span class="ident">PipelineState</span>::<span class="ident">Completed</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">state</span>) <span class="op">=&gt;</span> <span class="ident">state</span>.<span class="ident">poll</span>(<span class="ident">info</span>),
<span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="kw">_</span>) <span class="op">|</span> <span class="ident">PipelineState</span>::<span class="prelude-val">None</span> <span class="op">|</span> <span class="ident">PipelineState</span>::<span class="ident">Error</span> <span class="op">=&gt;</span> {
<span class="prelude-val">None</span>
}
<span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">state</span>) <span class="op">=&gt;</span> <span class="ident">state</span>.<span class="ident">poll</span>(<span class="ident">info</span>, <span class="ident">mws</span>),
<span class="ident">PipelineState</span>::<span class="prelude-val">None</span> <span class="op">|</span> <span class="ident">PipelineState</span>::<span class="ident">Error</span> <span class="op">=&gt;</span> <span class="prelude-val">None</span>,
}
}
}
@ -862,7 +951,7 @@
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span>, <span class="ident">H</span>: <span class="ident">PipelineHandler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span> <span class="ident">Pipeline</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">req</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>, <span class="ident">mws</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Middleware</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span><span class="op">&gt;&gt;</span>, <span class="ident">handler</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
) <span class="op">-&gt;</span> <span class="ident">Pipeline</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">PipelineInfo</span> {
@ -903,22 +992,20 @@
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">state</span> <span class="op">=</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="number">1</span>, <span class="ident">PipelineState</span>::<span class="prelude-val">None</span>);
<span class="kw">loop</span> {
<span class="kw">if</span> <span class="ident">state</span>.<span class="ident">is_response</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="ident">st</span>) <span class="op">=</span> <span class="ident">state</span> {
<span class="kw">match</span> <span class="ident">st</span>.<span class="ident">poll_io</span>(<span class="ident">io</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="number">0</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="number">2</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">state</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="number">1</span> <span class="op">=</span> <span class="ident">state</span>;
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">error</span>) <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">error</span>.<span class="ident">take</span>() {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">error</span>);
} <span class="kw">else</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="self">self</span>.<span class="ident">is_done</span>()));
}
}
<span class="prelude-val">Err</span>(<span class="ident">state</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="number">1</span> <span class="op">=</span> <span class="ident">state</span>;
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="ident">st</span>) <span class="op">=</span> <span class="ident">state</span> {
<span class="kw">match</span> <span class="ident">st</span>.<span class="ident">poll_io</span>(<span class="ident">io</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="number">0</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="number">2</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">state</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="number">1</span> <span class="op">=</span> <span class="ident">state</span>;
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">error</span>) <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">error</span>.<span class="ident">take</span>() {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">error</span>);
} <span class="kw">else</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="self">self</span>.<span class="ident">is_done</span>()));
}
}
<span class="prelude-val">Err</span>(<span class="ident">state</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="number">1</span> <span class="op">=</span> <span class="ident">state</span>;
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
}
}
}
<span class="kw">match</span> <span class="ident">state</span> {
@ -1174,7 +1261,7 @@
}
<span class="kw">struct</span> <span class="ident">ProcessResponse</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">resp</span>: <span class="ident">HttpResponse</span>,
<span class="ident">resp</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">HttpResponse</span><span class="op">&gt;</span>,
<span class="ident">iostate</span>: <span class="ident">IOState</span>,
<span class="ident">running</span>: <span class="ident">RunningState</span>,
<span class="ident">drain</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">oneshot</span>::<span class="ident">Sender</span><span class="op">&lt;</span>()<span class="op">&gt;&gt;</span>,
@ -1215,7 +1302,7 @@
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">init</span>(<span class="ident">resp</span>: <span class="ident">HttpResponse</span>) <span class="op">-&gt;</span> <span class="ident">PipelineState</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="ident">ProcessResponse</span> {
<span class="ident">resp</span>,
<span class="ident">resp</span>: <span class="prelude-val">Some</span>(<span class="ident">resp</span>),
<span class="ident">iostate</span>: <span class="ident">IOState</span>::<span class="ident">Response</span>,
<span class="ident">running</span>: <span class="ident">RunningState</span>::<span class="ident">Running</span>,
<span class="ident">drain</span>: <span class="prelude-val">None</span>,
@ -1224,6 +1311,79 @@
})
}
<span class="kw">fn</span> <span class="ident">poll</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">info</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">PipelineInfo</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>, <span class="ident">mws</span>: <span class="kw-2">&amp;</span>[<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Middleware</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span>],
) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">PipelineState</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">H</span><span class="op">&gt;&gt;</span> {
<span class="comment">// connection is dead at this point</span>
<span class="kw">match</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">iostate</span>, <span class="ident">IOState</span>::<span class="ident">Done</span>) {
<span class="ident">IOState</span>::<span class="ident">Response</span> <span class="op">=&gt;</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
)),
<span class="ident">IOState</span>::<span class="ident">Payload</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
)),
<span class="ident">IOState</span>::<span class="ident">Actor</span>(<span class="kw-2">mut</span> <span class="ident">ctx</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">info</span>.<span class="ident">disconnected</span>.<span class="ident">take</span>().<span class="ident">is_some</span>() {
<span class="ident">ctx</span>.<span class="ident">disconnected</span>();
}
<span class="kw">loop</span> {
<span class="kw">match</span> <span class="ident">ctx</span>.<span class="ident">poll</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="prelude-val">Some</span>(<span class="ident">vec</span>))) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">vec</span>.<span class="ident">is_empty</span>() {
<span class="kw">continue</span>;
}
<span class="kw">for</span> <span class="ident">frame</span> <span class="kw">in</span> <span class="ident">vec</span> {
<span class="kw">match</span> <span class="ident">frame</span> {
<span class="ident">Frame</span>::<span class="ident">Chunk</span>(<span class="prelude-val">None</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
<span class="kw">return</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
<span class="ident">Frame</span>::<span class="ident">Chunk</span>(<span class="prelude-val">Some</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> (),
<span class="ident">Frame</span>::<span class="ident">Drain</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">fut</span>.<span class="ident">send</span>(());
}
}
}
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="prelude-val">None</span>)) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
))
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">iostate</span> <span class="op">=</span> <span class="ident">IOState</span>::<span class="ident">Actor</span>(<span class="ident">ctx</span>);
<span class="kw">return</span> <span class="prelude-val">None</span>;
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>);
<span class="kw">return</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
}
}
}
<span class="ident">IOState</span>::<span class="ident">Done</span> <span class="op">=&gt;</span> <span class="prelude-val">Some</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
)),
}
}
<span class="kw">fn</span> <span class="ident">poll_io</span>(
<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>, <span class="ident">info</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">PipelineInfo</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">mws</span>: <span class="kw-2">&amp;</span>[<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Middleware</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span>],
@ -1234,25 +1394,35 @@
<span class="lifetime">&#39;inner</span>: <span class="kw">loop</span> {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">iostate</span>, <span class="ident">IOState</span>::<span class="ident">Done</span>) {
<span class="ident">IOState</span>::<span class="ident">Response</span> <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">encoding</span> <span class="op">=</span>
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">content_encoding</span>().<span class="ident">unwrap_or</span>(<span class="ident">info</span>.<span class="ident">encoding</span>);
<span class="kw">let</span> <span class="ident">encoding</span> <span class="op">=</span> <span class="self">self</span>
.<span class="ident">resp</span>
.<span class="ident">as_ref</span>()
.<span class="ident">unwrap</span>()
.<span class="ident">content_encoding</span>()
.<span class="ident">unwrap_or</span>(<span class="ident">info</span>.<span class="ident">encoding</span>);
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span>
<span class="kw">match</span> <span class="ident">io</span>.<span class="ident">start</span>(<span class="kw-2">&amp;</span><span class="ident">info</span>.<span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">resp</span>, <span class="ident">encoding</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">res</span>) <span class="op">=&gt;</span> <span class="ident">res</span>,
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
));
}
};
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">io</span>.<span class="ident">start</span>(
<span class="kw-2">&amp;</span><span class="ident">info</span>.<span class="ident">req</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>(),
<span class="ident">encoding</span>,
) {
<span class="prelude-val">Ok</span>(<span class="ident">res</span>) <span class="op">=&gt;</span> <span class="ident">res</span>,
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
};
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">error</span>() {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">status</span>().<span class="ident">is_server_error</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">error</span>() {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">status</span>().<span class="ident">is_server_error</span>()
{
<span class="macro">error</span><span class="macro">!</span>(
<span class="string">&quot;Error occured during request handling, status: {} {}&quot;</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">status</span>(), <span class="ident">err</span>
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">status</span>(), <span class="ident">err</span>
);
} <span class="kw">else</span> {
<span class="macro">warn</span><span class="macro">!</span>(
@ -1266,7 +1436,7 @@
}
<span class="comment">// always poll stream or actor for the first time</span>
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">replace_body</span>(<span class="ident">Body</span>::<span class="ident">Empty</span>) {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>().<span class="ident">replace_body</span>(<span class="ident">Body</span>::<span class="ident">Empty</span>) {
<span class="ident">Body</span>::<span class="ident">Streaming</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">iostate</span> <span class="op">=</span> <span class="ident">IOState</span>::<span class="ident">Payload</span>(<span class="ident">stream</span>);
<span class="kw">continue</span> <span class="lifetime">&#39;inner</span>;
@ -1285,7 +1455,9 @@
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=</span> <span class="ident">io</span>.<span class="ident">write_eof</span>() {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
<span class="kw">break</span>;
@ -1296,7 +1468,9 @@
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">result</span>) <span class="op">=&gt;</span> <span class="ident">result</span>,
@ -1309,7 +1483,9 @@
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>);
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
},
@ -1332,26 +1508,30 @@
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(
<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
),
);
}
<span class="kw">break</span> <span class="lifetime">&#39;inner</span>;
}
<span class="ident">Frame</span>::<span class="ident">Chunk</span>(<span class="prelude-val">Some</span>(<span class="ident">chunk</span>)) <span class="op">=&gt;</span> {
<span class="kw">match</span> <span class="ident">io</span>.<span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="ident">chunk</span>) {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(
<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
),
);
}
<span class="prelude-val">Ok</span>(<span class="ident">result</span>) <span class="op">=&gt;</span> <span class="ident">res</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">result</span>),
<span class="ident">Frame</span>::<span class="ident">Chunk</span>(<span class="prelude-val">Some</span>(<span class="ident">chunk</span>)) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">io</span>
.<span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="ident">chunk</span>)
{
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(
<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
),
);
}
}
<span class="prelude-val">Ok</span>(<span class="ident">result</span>) <span class="op">=&gt;</span> <span class="ident">res</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">result</span>),
},
<span class="ident">Frame</span>::<span class="ident">Drain</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> <span class="self">self</span>.<span class="ident">drain</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">fut</span>),
}
}
@ -1371,7 +1551,9 @@
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>);
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>,
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
}
@ -1411,7 +1593,11 @@
<span class="ident">info</span>.<span class="ident">context</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ctx</span>);
}
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>));
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
}
}
@ -1425,11 +1611,19 @@
<span class="prelude-val">Ok</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> (),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">error</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>.<span class="ident">into</span>());
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>));
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
));
}
}
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">set_response_size</span>(<span class="ident">io</span>.<span class="ident">written</span>());
<span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(<span class="ident">info</span>, <span class="ident">mws</span>, <span class="self">self</span>.<span class="ident">resp</span>))
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>().<span class="ident">set_response_size</span>(<span class="ident">io</span>.<span class="ident">written</span>());
<span class="prelude-val">Ok</span>(<span class="ident">FinishingMiddlewares</span>::<span class="ident">init</span>(
<span class="ident">info</span>,
<span class="ident">mws</span>,
<span class="self">self</span>.<span class="ident">resp</span>.<span class="ident">take</span>().<span class="ident">unwrap</span>(),
))
}
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">PipelineState</span>::<span class="ident">Response</span>(<span class="self">self</span>)),
}

4
static/api/actix-web/stable/src/actix_web/pred.rs.html
View File

@ -326,7 +326,6 @@
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
</pre><pre class="rust ">
<span class="doccomment">//! Route match predicates</span>
<span class="attribute">#![<span class="ident">allow</span>(<span class="ident">non_snake_case</span>)]</span>
@ -594,8 +593,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">HOST</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;www.rust-lang.org&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">pred</span> <span class="op">=</span> <span class="ident">Host</span>(<span class="string">&quot;www.rust-lang.org&quot;</span>);
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">pred</span>.<span class="ident">check</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="ident">req</span>.<span class="ident">state</span>()));

4
static/api/actix-web/stable/src/actix_web/resource.rs.html
View File

@ -321,6 +321,7 @@
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::<span class="ident">Deref</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
@ -337,6 +338,7 @@
<span class="kw">use</span> <span class="ident">pred</span>;
<span class="kw">use</span> <span class="ident">route</span>::<span class="ident">Route</span>;
<span class="kw">use</span> <span class="ident">router</span>::<span class="ident">ResourceDef</span>;
<span class="kw">use</span> <span class="ident">with</span>::<span class="ident">WithFactory</span>;
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Copy</span>, <span class="ident">Clone</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">RouteId</span>(<span class="ident">usize</span>);
@ -541,7 +543,7 @@
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">handler</span>: <span class="ident">F</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{

34
static/api/actix-web/stable/src/actix_web/route.rs.html
View File

@ -683,7 +683,7 @@
<span class="ident">Started</span> <span class="kw">as</span> <span class="ident">MiddlewareStarted</span>,
};
<span class="kw">use</span> <span class="ident">pred</span>::<span class="ident">Predicate</span>;
<span class="kw">use</span> <span class="ident">with</span>::{<span class="ident">With</span>, <span class="ident">WithAsync</span>};
<span class="kw">use</span> <span class="ident">with</span>::{<span class="ident">WithAsyncFactory</span>, <span class="ident">WithFactory</span>};
<span class="doccomment">/// Resource route definition</span>
<span class="doccomment">///</span>
@ -801,8 +801,7 @@
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="doccomment">///</span>
<span class="doccomment">/// It is possible to use tuples for specifing multiple extractors for one</span>
<span class="doccomment">/// handler function.</span>
<span class="doccomment">/// It is possible to use multiple extractors for one handler function.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # extern crate bytes;</span>
@ -819,9 +818,9 @@
<span class="doccomment">///</span>
<span class="doccomment">/// /// extract path info using serde</span>
<span class="doccomment">/// fn index(</span>
<span class="doccomment">/// info: (Path&lt;Info&gt;, Query&lt;HashMap&lt;String, String&gt;&gt;, Json&lt;Info&gt;),</span>
<span class="doccomment">/// path: Path&lt;Info&gt;, query: Query&lt;HashMap&lt;String, String&gt;&gt;, body: Json&lt;Info&gt;,</span>
<span class="doccomment">/// ) -&gt; Result&lt;String&gt; {</span>
<span class="doccomment">/// Ok(format!(&quot;Welcome {}!&quot;, info.0.username))</span>
<span class="doccomment">/// Ok(format!(&quot;Welcome {}!&quot;, path.username))</span>
<span class="doccomment">/// }</span>
<span class="doccomment">///</span>
<span class="doccomment">/// fn main() {</span>
@ -833,15 +832,15 @@
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">handler</span>: <span class="ident">F</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">With</span>::<span class="ident">new</span>(<span class="ident">handler</span>, <span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span> <span class="kw">as</span> <span class="ident">Default</span><span class="op">&gt;</span>::<span class="ident">default</span>()));
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">handler</span>.<span class="ident">create</span>());
}
<span class="doccomment">/// Set handler function. Same as `.with()` but it allows to configure</span>
<span class="doccomment">/// extractor.</span>
<span class="doccomment">/// extractor. Configuration closure accepts config objects as tuple.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # extern crate bytes;</span>
@ -859,21 +858,21 @@
<span class="doccomment">/// let app = App::new().resource(&quot;/index.html&quot;, |r| {</span>
<span class="doccomment">/// r.method(http::Method::GET)</span>
<span class="doccomment">/// .with_config(index, |cfg| { // &lt;- register handler</span>
<span class="doccomment">/// cfg.limit(4096); // &lt;- limit size of the payload</span>
<span class="doccomment">/// cfg.0.limit(4096); // &lt;- limit size of the payload</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_config</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">C</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">handler</span>: <span class="ident">F</span>, <span class="ident">cfg_f</span>: <span class="ident">C</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">C</span>: <span class="ident">FnOnce</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">T</span>::<span class="ident">Config</span>),
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">cfg</span> <span class="op">=</span> <span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span> <span class="kw">as</span> <span class="ident">Default</span><span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">cfg_f</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">cfg</span>);
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">With</span>::<span class="ident">new</span>(<span class="ident">handler</span>, <span class="ident">cfg</span>));
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">handler</span>.<span class="ident">create_with_config</span>(<span class="ident">cfg</span>));
}
<span class="doccomment">/// Set async handler function, use request extractor for parameters.</span>
@ -907,17 +906,18 @@
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_async</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">handler</span>: <span class="ident">F</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithAsyncFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">I</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">WithAsync</span>::<span class="ident">new</span>(<span class="ident">handler</span>, <span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span> <span class="kw">as</span> <span class="ident">Default</span><span class="op">&gt;</span>::<span class="ident">default</span>()));
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">handler</span>.<span class="ident">create</span>());
}
<span class="doccomment">/// Set async handler function, use request extractor for parameters.</span>
<span class="doccomment">/// This method allows to configure extractor.</span>
<span class="doccomment">/// This method allows to configure extractor. Configuration closure</span>
<span class="doccomment">/// accepts config objects as tuple.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # extern crate bytes;</span>
@ -942,14 +942,14 @@
<span class="doccomment">/// &quot;/{username}/index.html&quot;, // &lt;- define path parameters</span>
<span class="doccomment">/// |r| r.method(http::Method::GET)</span>
<span class="doccomment">/// .with_async_config(index, |cfg| {</span>
<span class="doccomment">/// cfg.limit(4096);</span>
<span class="doccomment">/// cfg.0.limit(4096);</span>
<span class="doccomment">/// }),</span>
<span class="doccomment">/// ); // &lt;- use `with` extractor</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_async_config</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span>, <span class="ident">C</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">handler</span>: <span class="ident">F</span>, <span class="ident">cfg</span>: <span class="ident">C</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithAsyncFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">I</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
@ -958,7 +958,7 @@
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">extractor_cfg</span> <span class="op">=</span> <span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span> <span class="kw">as</span> <span class="ident">Default</span><span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">cfg</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">extractor_cfg</span>);
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">WithAsync</span>::<span class="ident">new</span>(<span class="ident">handler</span>, <span class="ident">extractor_cfg</span>));
<span class="self">self</span>.<span class="ident">h</span>(<span class="ident">handler</span>.<span class="ident">create_with_config</span>(<span class="ident">extractor_cfg</span>));
}
}

588
static/api/actix-web/stable/src/actix_web/router.rs.html
View File

@ -1089,7 +1089,164 @@
<span id="1089">1089</span>
<span id="1090">1090</span>
<span id="1091">1091</span>
<span id="1092">1092</span>
<span id="1093">1093</span>
<span id="1094">1094</span>
<span id="1095">1095</span>
<span id="1096">1096</span>
<span id="1097">1097</span>
<span id="1098">1098</span>
<span id="1099">1099</span>
<span id="1100">1100</span>
<span id="1101">1101</span>
<span id="1102">1102</span>
<span id="1103">1103</span>
<span id="1104">1104</span>
<span id="1105">1105</span>
<span id="1106">1106</span>
<span id="1107">1107</span>
<span id="1108">1108</span>
<span id="1109">1109</span>
<span id="1110">1110</span>
<span id="1111">1111</span>
<span id="1112">1112</span>
<span id="1113">1113</span>
<span id="1114">1114</span>
<span id="1115">1115</span>
<span id="1116">1116</span>
<span id="1117">1117</span>
<span id="1118">1118</span>
<span id="1119">1119</span>
<span id="1120">1120</span>
<span id="1121">1121</span>
<span id="1122">1122</span>
<span id="1123">1123</span>
<span id="1124">1124</span>
<span id="1125">1125</span>
<span id="1126">1126</span>
<span id="1127">1127</span>
<span id="1128">1128</span>
<span id="1129">1129</span>
<span id="1130">1130</span>
<span id="1131">1131</span>
<span id="1132">1132</span>
<span id="1133">1133</span>
<span id="1134">1134</span>
<span id="1135">1135</span>
<span id="1136">1136</span>
<span id="1137">1137</span>
<span id="1138">1138</span>
<span id="1139">1139</span>
<span id="1140">1140</span>
<span id="1141">1141</span>
<span id="1142">1142</span>
<span id="1143">1143</span>
<span id="1144">1144</span>
<span id="1145">1145</span>
<span id="1146">1146</span>
<span id="1147">1147</span>
<span id="1148">1148</span>
<span id="1149">1149</span>
<span id="1150">1150</span>
<span id="1151">1151</span>
<span id="1152">1152</span>
<span id="1153">1153</span>
<span id="1154">1154</span>
<span id="1155">1155</span>
<span id="1156">1156</span>
<span id="1157">1157</span>
<span id="1158">1158</span>
<span id="1159">1159</span>
<span id="1160">1160</span>
<span id="1161">1161</span>
<span id="1162">1162</span>
<span id="1163">1163</span>
<span id="1164">1164</span>
<span id="1165">1165</span>
<span id="1166">1166</span>
<span id="1167">1167</span>
<span id="1168">1168</span>
<span id="1169">1169</span>
<span id="1170">1170</span>
<span id="1171">1171</span>
<span id="1172">1172</span>
<span id="1173">1173</span>
<span id="1174">1174</span>
<span id="1175">1175</span>
<span id="1176">1176</span>
<span id="1177">1177</span>
<span id="1178">1178</span>
<span id="1179">1179</span>
<span id="1180">1180</span>
<span id="1181">1181</span>
<span id="1182">1182</span>
<span id="1183">1183</span>
<span id="1184">1184</span>
<span id="1185">1185</span>
<span id="1186">1186</span>
<span id="1187">1187</span>
<span id="1188">1188</span>
<span id="1189">1189</span>
<span id="1190">1190</span>
<span id="1191">1191</span>
<span id="1192">1192</span>
<span id="1193">1193</span>
<span id="1194">1194</span>
<span id="1195">1195</span>
<span id="1196">1196</span>
<span id="1197">1197</span>
<span id="1198">1198</span>
<span id="1199">1199</span>
<span id="1200">1200</span>
<span id="1201">1201</span>
<span id="1202">1202</span>
<span id="1203">1203</span>
<span id="1204">1204</span>
<span id="1205">1205</span>
<span id="1206">1206</span>
<span id="1207">1207</span>
<span id="1208">1208</span>
<span id="1209">1209</span>
<span id="1210">1210</span>
<span id="1211">1211</span>
<span id="1212">1212</span>
<span id="1213">1213</span>
<span id="1214">1214</span>
<span id="1215">1215</span>
<span id="1216">1216</span>
<span id="1217">1217</span>
<span id="1218">1218</span>
<span id="1219">1219</span>
<span id="1220">1220</span>
<span id="1221">1221</span>
<span id="1222">1222</span>
<span id="1223">1223</span>
<span id="1224">1224</span>
<span id="1225">1225</span>
<span id="1226">1226</span>
<span id="1227">1227</span>
<span id="1228">1228</span>
<span id="1229">1229</span>
<span id="1230">1230</span>
<span id="1231">1231</span>
<span id="1232">1232</span>
<span id="1233">1233</span>
<span id="1234">1234</span>
<span id="1235">1235</span>
<span id="1236">1236</span>
<span id="1237">1237</span>
<span id="1238">1238</span>
<span id="1239">1239</span>
<span id="1240">1240</span>
<span id="1241">1241</span>
<span id="1242">1242</span>
<span id="1243">1243</span>
<span id="1244">1244</span>
<span id="1245">1245</span>
<span id="1246">1246</span>
<span id="1247">1247</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::<span class="ident">RefCell</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cmp</span>::<span class="ident">min</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::<span class="ident">HashMap</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">hash</span>::{<span class="ident">Hash</span>, <span class="ident">Hasher</span>};
@ -1108,6 +1265,7 @@
<span class="kw">use</span> <span class="ident">resource</span>::{<span class="ident">DefaultResource</span>, <span class="ident">Resource</span>};
<span class="kw">use</span> <span class="ident">scope</span>::<span class="ident">Scope</span>;
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">Request</span>;
<span class="kw">use</span> <span class="ident">with</span>::<span class="ident">WithFactory</span>;
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>, <span class="ident">Copy</span>, <span class="ident">Clone</span>, <span class="ident">PartialEq</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">ResourceId</span> {
@ -1203,9 +1361,14 @@
<span class="ident">U</span>: <span class="ident">IntoIterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">pattern</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">rmap</span>.<span class="ident">named</span>.<span class="ident">get</span>(<span class="ident">name</span>) {
<span class="kw">let</span> <span class="ident">path</span> <span class="op">=</span>
<span class="ident">pattern</span>.<span class="ident">resource_path</span>(<span class="ident">elements</span>, <span class="kw-2">&amp;</span><span class="ident">req</span>.<span class="ident">path</span>()[..(<span class="self">self</span>.<span class="ident">prefix</span> <span class="kw">as</span> <span class="ident">usize</span>)])<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">elements</span> <span class="op">=</span> <span class="ident">elements</span>.<span class="ident">into_iter</span>();
<span class="kw">if</span> <span class="self">self</span>
.<span class="ident">rmap</span>
.<span class="ident">patterns_for</span>(<span class="ident">name</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">path</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">elements</span>)<span class="question-mark">?</span>
.<span class="ident">is_some</span>()
{
<span class="kw">if</span> <span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="kw">let</span> <span class="ident">conn</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">connection_info</span>();
<span class="prelude-val">Ok</span>(<span class="ident">Url</span>::<span class="ident">parse</span>(<span class="kw-2">&amp;</span><span class="macro">format</span><span class="macro">!</span>(
@ -1252,12 +1415,15 @@
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ResourceMap</span> {
<span class="ident">root</span>: <span class="ident">ResourceDef</span>,
<span class="ident">parent</span>: <span class="ident">RefCell</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">ResourceMap</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
<span class="ident">named</span>: <span class="ident">HashMap</span><span class="op">&lt;</span><span class="ident">String</span>, <span class="ident">ResourceDef</span><span class="op">&gt;</span>,
<span class="ident">patterns</span>: <span class="ident">Vec</span><span class="op">&lt;</span>(<span class="ident">ResourceDef</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">ResourceMap</span><span class="op">&gt;&gt;</span>)<span class="op">&gt;</span>,
<span class="ident">nested</span>: <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">ResourceMap</span><span class="op">&gt;&gt;</span>,
}
<span class="kw">impl</span> <span class="ident">ResourceMap</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">has_resource</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="kw">fn</span> <span class="ident">has_resource</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="kw">let</span> <span class="ident">path</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">path</span>.<span class="ident">is_empty</span>() { <span class="string">&quot;/&quot;</span> } <span class="kw">else</span> { <span class="ident">path</span> };
<span class="kw">for</span> (<span class="ident">pattern</span>, <span class="ident">rmap</span>) <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">patterns</span> {
@ -1271,20 +1437,91 @@
}
<span class="bool-val">false</span>
}
<span class="kw">fn</span> <span class="ident">patterns_for</span><span class="op">&lt;</span><span class="ident">U</span>, <span class="ident">I</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">name</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">String</span>, <span class="ident">elements</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">U</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span>()<span class="op">&gt;</span>, <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">U</span>: <span class="ident">Iterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">pattern_for</span>(<span class="ident">name</span>, <span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>.<span class="ident">is_some</span>() {
<span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(()))
} <span class="kw">else</span> {
<span class="self">self</span>.<span class="ident">parent_pattern_for</span>(<span class="ident">name</span>, <span class="ident">path</span>, <span class="ident">elements</span>)
}
}
<span class="kw">fn</span> <span class="ident">pattern_for</span><span class="op">&lt;</span><span class="ident">U</span>, <span class="ident">I</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">name</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">String</span>, <span class="ident">elements</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">U</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span>()<span class="op">&gt;</span>, <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">U</span>: <span class="ident">Iterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">pattern</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">named</span>.<span class="ident">get</span>(<span class="ident">name</span>) {
<span class="self">self</span>.<span class="ident">fill_root</span>(<span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>;
<span class="ident">pattern</span>.<span class="ident">resource_path</span>(<span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>;
<span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(()))
} <span class="kw">else</span> {
<span class="kw">for</span> <span class="ident">rmap</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">nested</span> {
<span class="kw">if</span> <span class="ident">rmap</span>.<span class="ident">pattern_for</span>(<span class="ident">name</span>, <span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>.<span class="ident">is_some</span>() {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(()));
}
}
<span class="prelude-val">Ok</span>(<span class="prelude-val">None</span>)
}
}
<span class="kw">fn</span> <span class="ident">fill_root</span><span class="op">&lt;</span><span class="ident">U</span>, <span class="ident">I</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">String</span>, <span class="ident">elements</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">U</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">U</span>: <span class="ident">Iterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">parent</span>) <span class="op">=</span> <span class="kw-2">*</span><span class="self">self</span>.<span class="ident">parent</span>.<span class="ident">borrow</span>() {
<span class="ident">parent</span>.<span class="ident">fill_root</span>(<span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>;
}
<span class="self">self</span>.<span class="ident">root</span>.<span class="ident">resource_path</span>(<span class="ident">path</span>, <span class="ident">elements</span>)
}
<span class="kw">fn</span> <span class="ident">parent_pattern_for</span><span class="op">&lt;</span><span class="ident">U</span>, <span class="ident">I</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">name</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">String</span>, <span class="ident">elements</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">U</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span>()<span class="op">&gt;</span>, <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">U</span>: <span class="ident">Iterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">parent</span>) <span class="op">=</span> <span class="kw-2">*</span><span class="self">self</span>.<span class="ident">parent</span>.<span class="ident">borrow</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">pattern</span>) <span class="op">=</span> <span class="ident">parent</span>.<span class="ident">named</span>.<span class="ident">get</span>(<span class="ident">name</span>) {
<span class="self">self</span>.<span class="ident">fill_root</span>(<span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>;
<span class="ident">pattern</span>.<span class="ident">resource_path</span>(<span class="ident">path</span>, <span class="ident">elements</span>)<span class="question-mark">?</span>;
<span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(()))
} <span class="kw">else</span> {
<span class="ident">parent</span>.<span class="ident">parent_pattern_for</span>(<span class="ident">name</span>, <span class="ident">path</span>, <span class="ident">elements</span>)
}
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="prelude-val">None</span>)
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Default</span> <span class="kw">for</span> <span class="ident">Router</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">default</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Router</span>::<span class="ident">new</span>()
<span class="ident">Router</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;&quot;</span>))
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Router</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">root</span>: <span class="ident">ResourceDef</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Router</span> {
<span class="ident">rmap</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">ResourceMap</span> {
<span class="ident">root</span>,
<span class="ident">parent</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="prelude-val">None</span>),
<span class="ident">named</span>: <span class="ident">HashMap</span>::<span class="ident">new</span>(),
<span class="ident">patterns</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">nested</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
}),
<span class="ident">resources</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">patterns</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
@ -1302,19 +1539,6 @@
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">test</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">route_info</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="kw-2">&amp;</span><span class="ident">Request</span>, <span class="ident">prefix</span>: <span class="ident">u16</span>) <span class="op">-&gt;</span> <span class="ident">ResourceInfo</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">params</span> <span class="op">=</span> <span class="ident">Params</span>::<span class="ident">with_url</span>(<span class="ident">req</span>.<span class="ident">url</span>());
<span class="ident">params</span>.<span class="ident">set_tail</span>(<span class="ident">prefix</span>);
<span class="ident">ResourceInfo</span> {
<span class="ident">params</span>,
<span class="ident">prefix</span>: <span class="number">0</span>,
<span class="ident">rmap</span>: <span class="self">self</span>.<span class="ident">rmap</span>.<span class="ident">clone</span>(),
<span class="ident">resource</span>: <span class="ident">ResourceId</span>::<span class="ident">Default</span>,
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">test</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">default_route_info</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">ResourceInfo</span> {
<span class="ident">ResourceInfo</span> {
@ -1325,6 +1549,10 @@
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">set_prefix</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) {
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">rmap</span>).<span class="ident">unwrap</span>().<span class="ident">root</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="ident">path</span>);
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">register_resource</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">resource</span>: <span class="ident">Resource</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) {
{
<span class="kw">let</span> <span class="ident">rmap</span> <span class="op">=</span> <span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">rmap</span>).<span class="ident">unwrap</span>();
@ -1350,6 +1578,11 @@
.<span class="ident">unwrap</span>()
.<span class="ident">patterns</span>
.<span class="ident">push</span>((<span class="ident">scope</span>.<span class="ident">rdef</span>().<span class="ident">clone</span>(), <span class="prelude-val">Some</span>(<span class="ident">scope</span>.<span class="ident">router</span>().<span class="ident">rmap</span>.<span class="ident">clone</span>())));
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">rmap</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">nested</span>
.<span class="ident">push</span>(<span class="ident">scope</span>.<span class="ident">router</span>().<span class="ident">rmap</span>.<span class="ident">clone</span>());
<span class="kw">let</span> <span class="ident">filters</span> <span class="op">=</span> <span class="ident">scope</span>.<span class="ident">take_filters</span>();
<span class="self">self</span>.<span class="ident">patterns</span>
.<span class="ident">push</span>(<span class="ident">ResourcePattern</span>::<span class="ident">Scope</span>(<span class="ident">scope</span>.<span class="ident">rdef</span>().<span class="ident">clone</span>(), <span class="ident">filters</span>));
@ -1378,22 +1611,25 @@
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">finish</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">default</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">default</span> {
<span class="kw">for</span> <span class="ident">resource</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">resources</span> {
<span class="kw">match</span> <span class="ident">resource</span> {
<span class="ident">ResourceItem</span>::<span class="ident">Resource</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> (),
<span class="ident">ResourceItem</span>::<span class="ident">Scope</span>(<span class="ident">scope</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">scope</span>.<span class="ident">has_default_resource</span>() {
<span class="kw">for</span> <span class="ident">resource</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">resources</span> {
<span class="kw">match</span> <span class="ident">resource</span> {
<span class="ident">ResourceItem</span>::<span class="ident">Resource</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> (),
<span class="ident">ResourceItem</span>::<span class="ident">Scope</span>(<span class="ident">scope</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">scope</span>.<span class="ident">has_default_resource</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">default</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">default</span> {
<span class="ident">scope</span>.<span class="ident">default_resource</span>(<span class="ident">default</span>.<span class="ident">clone</span>());
}
<span class="ident">scope</span>.<span class="ident">finish</span>()
}
<span class="ident">ResourceItem</span>::<span class="ident">Handler</span>(<span class="ident">hnd</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">hnd</span>.<span class="ident">has_default_resource</span>() {
<span class="kw-2">*</span><span class="ident">scope</span>.<span class="ident">router</span>().<span class="ident">rmap</span>.<span class="ident">parent</span>.<span class="ident">borrow_mut</span>() <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">rmap</span>.<span class="ident">clone</span>());
<span class="ident">scope</span>.<span class="ident">finish</span>();
}
<span class="ident">ResourceItem</span>::<span class="ident">Handler</span>(<span class="ident">hnd</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">hnd</span>.<span class="ident">has_default_resource</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">default</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">default</span> {
<span class="ident">hnd</span>.<span class="ident">default_resource</span>(<span class="ident">default</span>.<span class="ident">clone</span>());
}
<span class="ident">hnd</span>.<span class="ident">finish</span>()
}
<span class="ident">hnd</span>.<span class="ident">finish</span>()
}
}
}
@ -1411,7 +1647,7 @@
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">register_route</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">method</span>: <span class="ident">Method</span>, <span class="ident">f</span>: <span class="ident">F</span>)
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
@ -1551,35 +1787,38 @@
}
<span class="kw">impl</span> <span class="ident">ResourceDef</span> {
<span class="doccomment">/// Parse path pattern and create new `Resource` instance.</span>
<span class="doccomment">/// Parse path pattern and create new `ResourceDef` instance.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Panics if path pattern is wrong.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="kw">if</span> <span class="ident">path</span>.<span class="ident">is_empty</span>() { <span class="string">&quot;&quot;</span> } <span class="kw">else</span> { <span class="string">&quot;/&quot;</span> }, <span class="bool-val">false</span>)
<span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="bool-val">false</span>, <span class="op">!</span><span class="ident">path</span>.<span class="ident">is_empty</span>())
}
<span class="doccomment">/// Parse path pattern and create new `Resource` instance.</span>
<span class="doccomment">/// Parse path pattern and create new `ResourceDef` instance.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Use `prefix` type instead of `static`.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Panics if path regex pattern is wrong.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">prefix</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="string">&quot;/&quot;</span>, <span class="bool-val">true</span>)
<span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="bool-val">true</span>, <span class="op">!</span><span class="ident">path</span>.<span class="ident">is_empty</span>())
}
<span class="doccomment">/// Construct external resource</span>
<span class="doccomment">/// Construct external resource def</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Panics if path pattern is wrong.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">external</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="string">&quot;/&quot;</span>, <span class="bool-val">false</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(<span class="ident">path</span>, <span class="bool-val">false</span>, <span class="bool-val">false</span>);
<span class="ident">resource</span>.<span class="ident">rtp</span> <span class="op">=</span> <span class="ident">ResourceType</span>::<span class="ident">External</span>;
<span class="ident">resource</span>
}
<span class="doccomment">/// Parse path pattern and create new `Resource` instance with custom prefix</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_prefix</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">prefix</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">for_prefix</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> (<span class="ident">pattern</span>, <span class="ident">elements</span>, <span class="ident">is_dynamic</span>, <span class="ident">len</span>) <span class="op">=</span>
<span class="ident">ResourceDef</span>::<span class="ident">parse</span>(<span class="ident">path</span>, <span class="ident">prefix</span>, <span class="ident">for_prefix</span>);
<span class="doccomment">/// Parse path pattern and create new `ResourceDef` instance with custom prefix</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_prefix</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">for_prefix</span>: <span class="ident">bool</span>, <span class="ident">slash</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">path</span>.<span class="ident">to_owned</span>();
<span class="kw">if</span> <span class="ident">slash</span> <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>);
}
<span class="kw">let</span> (<span class="ident">pattern</span>, <span class="ident">elements</span>, <span class="ident">is_dynamic</span>, <span class="ident">len</span>) <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">parse</span>(<span class="kw-2">&amp;</span><span class="ident">path</span>, <span class="ident">for_prefix</span>);
<span class="kw">let</span> <span class="ident">tp</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">is_dynamic</span> {
<span class="kw">let</span> <span class="ident">re</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">Regex</span>::<span class="ident">new</span>(<span class="kw-2">&amp;</span><span class="ident">pattern</span>) {
@ -1797,23 +2036,21 @@
<span class="doccomment">/// Build resource path.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">resource_path</span><span class="op">&lt;</span><span class="ident">U</span>, <span class="ident">I</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">elements</span>: <span class="ident">U</span>, <span class="ident">prefix</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">String</span>, <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">String</span>, <span class="ident">elements</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">U</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">UrlGenerationError</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">U</span>: <span class="ident">IntoIterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">U</span>: <span class="ident">Iterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">AsRef</span><span class="op">&lt;</span><span class="ident">str</span><span class="op">&gt;</span>,
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">self</span>.<span class="ident">tp</span> {
<span class="ident">PatternType</span>::<span class="ident">Prefix</span>(<span class="kw-2">ref</span> <span class="ident">p</span>) <span class="op">=&gt;</span> <span class="ident">p</span>.<span class="ident">to_owned</span>(),
<span class="ident">PatternType</span>::<span class="ident">Static</span>(<span class="kw-2">ref</span> <span class="ident">p</span>) <span class="op">=&gt;</span> <span class="ident">p</span>.<span class="ident">to_owned</span>(),
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">tp</span> {
<span class="ident">PatternType</span>::<span class="ident">Prefix</span>(<span class="kw-2">ref</span> <span class="ident">p</span>) <span class="op">=&gt;</span> <span class="ident">path</span>.<span class="ident">push_str</span>(<span class="ident">p</span>),
<span class="ident">PatternType</span>::<span class="ident">Static</span>(<span class="kw-2">ref</span> <span class="ident">p</span>) <span class="op">=&gt;</span> <span class="ident">path</span>.<span class="ident">push_str</span>(<span class="ident">p</span>),
<span class="ident">PatternType</span>::<span class="ident">Dynamic</span>(..) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">iter</span> <span class="op">=</span> <span class="ident">elements</span>.<span class="ident">into_iter</span>();
<span class="kw">for</span> <span class="ident">el</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">elements</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="ident">el</span> {
<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="kw-2">ref</span> <span class="ident">s</span>) <span class="op">=&gt;</span> <span class="ident">path</span>.<span class="ident">push_str</span>(<span class="ident">s</span>),
<span class="ident">PatternElement</span>::<span class="ident">Var</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">val</span>) <span class="op">=</span> <span class="ident">iter</span>.<span class="ident">next</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">val</span>) <span class="op">=</span> <span class="ident">elements</span>.<span class="ident">next</span>() {
<span class="ident">path</span>.<span class="ident">push_str</span>(<span class="ident">val</span>.<span class="ident">as_ref</span>())
} <span class="kw">else</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">UrlGenerationError</span>::<span class="ident">NotEnoughElements</span>);
@ -1821,99 +2058,75 @@
}
}
}
<span class="ident">path</span>
}
};
<span class="prelude-val">Ok</span>(())
}
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">rtp</span> <span class="op">!=</span> <span class="ident">ResourceType</span>::<span class="ident">External</span> {
<span class="kw">if</span> <span class="ident">prefix</span>.<span class="ident">ends_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="kw">if</span> <span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">insert_str</span>(<span class="number">0</span>, <span class="kw-2">&amp;</span><span class="ident">prefix</span>[..<span class="ident">prefix</span>.<span class="ident">len</span>() <span class="op">-</span> <span class="number">1</span>]);
} <span class="kw">else</span> {
<span class="ident">path</span>.<span class="ident">insert_str</span>(<span class="number">0</span>, <span class="ident">prefix</span>);
<span class="kw">fn</span> <span class="ident">parse_param</span>(<span class="ident">pattern</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> (<span class="ident">PatternElement</span>, <span class="ident">String</span>, <span class="kw-2">&amp;</span><span class="ident">str</span>) {
<span class="kw">const</span> <span class="ident">DEFAULT_PATTERN</span>: <span class="kw-2">&amp;</span><span class="ident">str</span> <span class="op">=</span> <span class="string">&quot;[^/]+&quot;</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">params_nesting</span> <span class="op">=</span> <span class="number">0usize</span>;
<span class="kw">let</span> <span class="ident">close_idx</span> <span class="op">=</span> <span class="ident">pattern</span>
.<span class="ident">find</span>(<span class="op">|</span><span class="ident">c</span><span class="op">|</span> <span class="kw">match</span> <span class="ident">c</span> {
<span class="string">&#39;{&#39;</span> <span class="op">=&gt;</span> {
<span class="ident">params_nesting</span> <span class="op">+=</span> <span class="number">1</span>;
<span class="bool-val">false</span>
}
} <span class="kw">else</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>);
<span class="string">&#39;}&#39;</span> <span class="op">=&gt;</span> {
<span class="ident">params_nesting</span> <span class="op">-=</span> <span class="number">1</span>;
<span class="ident">params_nesting</span> <span class="op">==</span> <span class="number">0</span>
}
<span class="ident">path</span>.<span class="ident">insert_str</span>(<span class="number">0</span>, <span class="ident">prefix</span>);
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="bool-val">false</span>,
}).<span class="ident">expect</span>(<span class="string">&quot;malformed param&quot;</span>);
<span class="kw">let</span> (<span class="kw-2">mut</span> <span class="ident">param</span>, <span class="ident">rem</span>) <span class="op">=</span> <span class="ident">pattern</span>.<span class="ident">split_at</span>(<span class="ident">close_idx</span> <span class="op">+</span> <span class="number">1</span>);
<span class="ident">param</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="ident">param</span>[<span class="number">1</span>..<span class="ident">param</span>.<span class="ident">len</span>() <span class="op">-</span> <span class="number">1</span>]; <span class="comment">// Remove outer brackets</span>
<span class="kw">let</span> (<span class="ident">name</span>, <span class="ident">pattern</span>) <span class="op">=</span> <span class="kw">match</span> <span class="ident">param</span>.<span class="ident">find</span>(<span class="string">&#39;:&#39;</span>) {
<span class="prelude-val">Some</span>(<span class="ident">idx</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> (<span class="ident">name</span>, <span class="ident">pattern</span>) <span class="op">=</span> <span class="ident">param</span>.<span class="ident">split_at</span>(<span class="ident">idx</span>);
(<span class="ident">name</span>, <span class="kw-2">&amp;</span><span class="ident">pattern</span>[<span class="number">1</span>..])
}
}
<span class="prelude-val">Ok</span>(<span class="ident">path</span>)
<span class="prelude-val">None</span> <span class="op">=&gt;</span> (<span class="ident">param</span>, <span class="ident">DEFAULT_PATTERN</span>),
};
(
<span class="ident">PatternElement</span>::<span class="ident">Var</span>(<span class="ident">name</span>.<span class="ident">to_string</span>()),
<span class="macro">format</span><span class="macro">!</span>(<span class="string">r&quot;(?P&lt;{}&gt;{})&quot;</span>, <span class="kw-2">&amp;</span><span class="ident">name</span>, <span class="kw-2">&amp;</span><span class="ident">pattern</span>),
<span class="ident">rem</span>,
)
}
<span class="kw">fn</span> <span class="ident">parse</span>(
<span class="ident">pattern</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">prefix</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">for_prefix</span>: <span class="ident">bool</span>,
<span class="kw-2">mut</span> <span class="ident">pattern</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">for_prefix</span>: <span class="ident">bool</span>,
) <span class="op">-&gt;</span> (<span class="ident">String</span>, <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">PatternElement</span><span class="op">&gt;</span>, <span class="ident">bool</span>, <span class="ident">usize</span>) {
<span class="kw">const</span> <span class="ident">DEFAULT_PATTERN</span>: <span class="kw-2">&amp;</span><span class="ident">str</span> <span class="op">=</span> <span class="string">&quot;[^/]+&quot;</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">re1</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">from</span>(<span class="string">&quot;^&quot;</span>) <span class="op">+</span> <span class="ident">prefix</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">re2</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">prefix</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">el</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">in_param</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">in_param_pattern</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">param_name</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">param_pattern</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">DEFAULT_PATTERN</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">is_dynamic</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">elems</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">len</span> <span class="op">=</span> <span class="number">0</span>;
<span class="kw">for</span> (<span class="ident">index</span>, <span class="ident">ch</span>) <span class="kw">in</span> <span class="ident">pattern</span>.<span class="ident">chars</span>().<span class="ident">enumerate</span>() {
<span class="comment">// All routes must have a leading slash so its optional to have one</span>
<span class="kw">if</span> <span class="ident">index</span> <span class="op">==</span> <span class="number">0</span> <span class="op">&amp;&amp;</span> <span class="ident">ch</span> <span class="op">==</span> <span class="string">&#39;/&#39;</span> {
<span class="kw">continue</span>;
}
<span class="kw">if</span> <span class="ident">in_param</span> {
<span class="comment">// In parameter segment: `{....}`</span>
<span class="kw">if</span> <span class="ident">ch</span> <span class="op">==</span> <span class="string">&#39;}&#39;</span> {
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">PatternElement</span>::<span class="ident">Var</span>(<span class="ident">param_name</span>.<span class="ident">clone</span>()));
<span class="ident">re1</span>.<span class="ident">push_str</span>(<span class="kw-2">&amp;</span><span class="macro">format</span><span class="macro">!</span>(<span class="string">r&quot;(?P&lt;{}&gt;{})&quot;</span>, <span class="kw-2">&amp;</span><span class="ident">param_name</span>, <span class="kw-2">&amp;</span><span class="ident">param_pattern</span>));
<span class="ident">param_name</span>.<span class="ident">clear</span>();
<span class="ident">param_pattern</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">DEFAULT_PATTERN</span>);
<span class="ident">len</span> <span class="op">=</span> <span class="number">0</span>;
<span class="ident">in_param_pattern</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="ident">in_param</span> <span class="op">=</span> <span class="bool-val">false</span>;
} <span class="kw">else</span> <span class="kw">if</span> <span class="ident">ch</span> <span class="op">==</span> <span class="string">&#39;:&#39;</span> {
<span class="comment">// The parameter name has been determined; custom pattern land</span>
<span class="ident">in_param_pattern</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="ident">param_pattern</span>.<span class="ident">clear</span>();
} <span class="kw">else</span> <span class="kw">if</span> <span class="ident">in_param_pattern</span> {
<span class="comment">// Ignore leading whitespace for pattern</span>
<span class="kw">if</span> <span class="op">!</span>(<span class="ident">ch</span> <span class="op">==</span> <span class="string">&#39; &#39;</span> <span class="op">&amp;&amp;</span> <span class="ident">param_pattern</span>.<span class="ident">is_empty</span>()) {
<span class="ident">param_pattern</span>.<span class="ident">push</span>(<span class="ident">ch</span>);
}
} <span class="kw">else</span> {
<span class="ident">param_name</span>.<span class="ident">push</span>(<span class="ident">ch</span>);
}
} <span class="kw">else</span> <span class="kw">if</span> <span class="ident">ch</span> <span class="op">==</span> <span class="string">&#39;{&#39;</span> {
<span class="ident">in_param</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="ident">is_dynamic</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="ident">el</span>.<span class="ident">clone</span>()));
<span class="ident">el</span>.<span class="ident">clear</span>();
} <span class="kw">else</span> {
<span class="ident">re1</span>.<span class="ident">push_str</span>(<span class="ident">escape</span>(<span class="kw-2">&amp;</span><span class="ident">ch</span>.<span class="ident">to_string</span>()).<span class="ident">as_str</span>());
<span class="ident">re2</span>.<span class="ident">push</span>(<span class="ident">ch</span>);
<span class="ident">el</span>.<span class="ident">push</span>(<span class="ident">ch</span>);
<span class="ident">len</span> <span class="op">+=</span> <span class="number">1</span>;
}
}
<span class="kw">if</span> <span class="op">!</span><span class="ident">el</span>.<span class="ident">is_empty</span>() {
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="ident">el</span>.<span class="ident">clone</span>()));
}
<span class="kw">let</span> <span class="ident">re</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">is_dynamic</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">for_prefix</span> {
<span class="ident">re1</span>.<span class="ident">push</span>(<span class="string">&#39;$&#39;</span>);
}
<span class="ident">re1</span>
} <span class="kw">else</span> {
<span class="ident">re2</span>
<span class="kw">if</span> <span class="ident">pattern</span>.<span class="ident">find</span>(<span class="string">&#39;{&#39;</span>).<span class="ident">is_none</span>() {
<span class="kw">return</span> (
<span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">pattern</span>),
<span class="macro">vec</span><span class="macro">!</span>[<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">pattern</span>))],
<span class="bool-val">false</span>,
<span class="ident">pattern</span>.<span class="ident">chars</span>().<span class="ident">count</span>(),
);
};
(<span class="ident">re</span>, <span class="ident">elems</span>, <span class="ident">is_dynamic</span>, <span class="ident">len</span>)
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">elems</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">re</span> <span class="op">=</span> <span class="ident">String</span>::<span class="ident">from</span>(<span class="string">&quot;^&quot;</span>);
<span class="kw">while</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">idx</span>) <span class="op">=</span> <span class="ident">pattern</span>.<span class="ident">find</span>(<span class="string">&#39;{&#39;</span>) {
<span class="kw">let</span> (<span class="ident">prefix</span>, <span class="ident">rem</span>) <span class="op">=</span> <span class="ident">pattern</span>.<span class="ident">split_at</span>(<span class="ident">idx</span>);
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">prefix</span>)));
<span class="ident">re</span>.<span class="ident">push_str</span>(<span class="kw-2">&amp;</span><span class="ident">escape</span>(<span class="ident">prefix</span>));
<span class="kw">let</span> (<span class="ident">param_pattern</span>, <span class="ident">re_part</span>, <span class="ident">rem</span>) <span class="op">=</span> <span class="self">Self</span>::<span class="ident">parse_param</span>(<span class="ident">rem</span>);
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">param_pattern</span>);
<span class="ident">re</span>.<span class="ident">push_str</span>(<span class="kw-2">&amp;</span><span class="ident">re_part</span>);
<span class="ident">pattern</span> <span class="op">=</span> <span class="ident">rem</span>;
}
<span class="ident">elems</span>.<span class="ident">push</span>(<span class="ident">PatternElement</span>::<span class="ident">Str</span>(<span class="ident">String</span>::<span class="ident">from</span>(<span class="ident">pattern</span>)));
<span class="ident">re</span>.<span class="ident">push_str</span>(<span class="kw-2">&amp;</span><span class="ident">escape</span>(<span class="ident">pattern</span>));
<span class="kw">if</span> <span class="op">!</span><span class="ident">for_prefix</span> {
<span class="ident">re</span>.<span class="ident">push_str</span>(<span class="string">&quot;$&quot;</span>);
}
(<span class="ident">re</span>, <span class="ident">elems</span>, <span class="bool-val">true</span>, <span class="ident">pattern</span>.<span class="ident">chars</span>().<span class="ident">count</span>())
}
}
@ -1938,7 +2151,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_recognizer10</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name/{val}&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(
@ -1950,7 +2163,7 @@
)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/v/{tail:.*}&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/test2/{test}.html&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;{test}/index.html&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{test}/index.html&quot;</span>)));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/name&quot;</span>).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">recognize</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span>(), <span class="number">0</span>);
@ -2001,7 +2214,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_recognizer_2</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/index.json&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{source}.json&quot;</span>)));
@ -2016,7 +2229,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_recognizer_with_prefix</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name/{val}&quot;</span>)));
@ -2035,7 +2248,7 @@
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw-2">&amp;</span><span class="ident">info</span>.<span class="ident">match_info</span>()[<span class="string">&quot;val&quot;</span>], <span class="string">&quot;value&quot;</span>);
<span class="comment">// same patterns</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/name/{val}&quot;</span>)));
@ -2104,6 +2317,16 @@
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">re</span>.<span class="ident">match_with_params</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="number">0</span>).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">info</span>.<span class="ident">get</span>(<span class="string">&quot;version&quot;</span>).<span class="ident">unwrap</span>(), <span class="string">&quot;151&quot;</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">info</span>.<span class="ident">get</span>(<span class="string">&quot;id&quot;</span>).<span class="ident">unwrap</span>(), <span class="string">&quot;adahg32&quot;</span>);
<span class="kw">let</span> <span class="ident">re</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{id:[[:digit:]]{6}}&quot;</span>);
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">re</span>.<span class="ident">is_match</span>(<span class="string">&quot;/012345&quot;</span>));
<span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">re</span>.<span class="ident">is_match</span>(<span class="string">&quot;/012&quot;</span>));
<span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">re</span>.<span class="ident">is_match</span>(<span class="string">&quot;/01234567&quot;</span>));
<span class="macro">assert</span><span class="macro">!</span>(<span class="op">!</span><span class="ident">re</span>.<span class="ident">is_match</span>(<span class="string">&quot;/XXXXXX&quot;</span>));
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/012345&quot;</span>).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">re</span>.<span class="ident">match_with_params</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="number">0</span>).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">info</span>.<span class="ident">get</span>(<span class="string">&quot;id&quot;</span>).<span class="ident">unwrap</span>(), <span class="string">&quot;012345&quot;</span>);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
@ -2141,7 +2364,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_request_resource</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/index.json&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;r1&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
@ -2163,7 +2386,7 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_has_resource</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span>::<span class="ident">new</span>(<span class="string">&quot;/test&quot;</span>).<span class="ident">resource</span>(<span class="string">&quot;/name&quot;</span>, <span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="string">&quot;done&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_scope</span>(<span class="ident">scope</span>);
@ -2180,6 +2403,95 @@
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">default_route_info</span>();
<span class="macro">assert</span><span class="macro">!</span>(<span class="ident">info</span>.<span class="ident">has_resource</span>(<span class="string">&quot;/test2/test10/name&quot;</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_url_for</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="string">&quot;&quot;</span>));
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/tttt&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;r0&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span>::<span class="ident">new</span>(<span class="string">&quot;/test&quot;</span>).<span class="ident">resource</span>(<span class="string">&quot;/name&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> {
<span class="ident">r</span>.<span class="ident">name</span>(<span class="string">&quot;r1&quot;</span>);
});
<span class="ident">router</span>.<span class="ident">register_scope</span>(<span class="ident">scope</span>);
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span>::<span class="ident">new</span>(<span class="string">&quot;/test2&quot;</span>)
.<span class="ident">nested</span>(<span class="string">&quot;/test10&quot;</span>, <span class="op">|</span><span class="ident">s</span><span class="op">|</span> <span class="ident">s</span>.<span class="ident">resource</span>(<span class="string">&quot;/name&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">name</span>(<span class="string">&quot;r2&quot;</span>)));
<span class="ident">router</span>.<span class="ident">register_scope</span>(<span class="ident">scope</span>);
<span class="ident">router</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/test&quot;</span>).<span class="ident">request</span>();
{
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">default_route_info</span>();
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r0&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/tttt&quot;</span>);
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r1&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/test/name&quot;</span>);
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r2&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/test2/test10/name&quot;</span>);
}
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/test/name&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">recognize</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="kw-2">&amp;</span>(), <span class="number">0</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">info</span>.<span class="ident">resource</span>, <span class="ident">ResourceId</span>::<span class="ident">Normal</span>(<span class="number">1</span>));
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r0&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/tttt&quot;</span>);
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r1&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/test/name&quot;</span>);
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r2&quot;</span>, <span class="ident">Vec</span>::<span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span><span class="op">&gt;</span>::<span class="ident">new</span>())
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/test2/test10/name&quot;</span>);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_url_for_dynamic</span>() {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="string">&quot;&quot;</span>));
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="string">&quot;/{name}/test/index.{ext}&quot;</span>));
<span class="ident">resource</span>.<span class="ident">name</span>(<span class="string">&quot;r0&quot;</span>);
<span class="ident">router</span>.<span class="ident">register_resource</span>(<span class="ident">resource</span>);
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span>::<span class="ident">new</span>(<span class="string">&quot;/{name1}&quot;</span>).<span class="ident">nested</span>(<span class="string">&quot;/{name2}&quot;</span>, <span class="op">|</span><span class="ident">s</span><span class="op">|</span> {
<span class="ident">s</span>.<span class="ident">resource</span>(<span class="string">&quot;/{name3}/test/index.{ext}&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">name</span>(<span class="string">&quot;r2&quot;</span>))
});
<span class="ident">router</span>.<span class="ident">register_scope</span>(<span class="ident">scope</span>);
<span class="ident">router</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/test&quot;</span>).<span class="ident">request</span>();
{
<span class="kw">let</span> <span class="ident">info</span> <span class="op">=</span> <span class="ident">router</span>.<span class="ident">default_route_info</span>();
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r0&quot;</span>, <span class="macro">vec</span><span class="macro">!</span>[<span class="string">&quot;sec1&quot;</span>, <span class="string">&quot;html&quot;</span>]).<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">res</span>.<span class="ident">as_str</span>(), <span class="string">&quot;http://localhost:8080/sec1/test/index.html&quot;</span>);
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">info</span>
.<span class="ident">url_for</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>, <span class="string">&quot;r2&quot;</span>, <span class="macro">vec</span><span class="macro">!</span>[<span class="string">&quot;sec1&quot;</span>, <span class="string">&quot;sec2&quot;</span>, <span class="string">&quot;sec3&quot;</span>, <span class="string">&quot;html&quot;</span>])
.<span class="ident">unwrap</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">res</span>.<span class="ident">as_str</span>(),
<span class="string">&quot;http://localhost:8080/sec1/sec2/sec3/test/index.html&quot;</span>
);
}
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../";window.currentCrate = "actix_web";</script><script src="../../aliases.js"></script><script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>

304
static/api/actix-web/stable/src/actix_web/scope.rs.html
View File

@ -1141,6 +1141,99 @@
<span id="1141">1141</span>
<span id="1142">1142</span>
<span id="1143">1143</span>
<span id="1144">1144</span>
<span id="1145">1145</span>
<span id="1146">1146</span>
<span id="1147">1147</span>
<span id="1148">1148</span>
<span id="1149">1149</span>
<span id="1150">1150</span>
<span id="1151">1151</span>
<span id="1152">1152</span>
<span id="1153">1153</span>
<span id="1154">1154</span>
<span id="1155">1155</span>
<span id="1156">1156</span>
<span id="1157">1157</span>
<span id="1158">1158</span>
<span id="1159">1159</span>
<span id="1160">1160</span>
<span id="1161">1161</span>
<span id="1162">1162</span>
<span id="1163">1163</span>
<span id="1164">1164</span>
<span id="1165">1165</span>
<span id="1166">1166</span>
<span id="1167">1167</span>
<span id="1168">1168</span>
<span id="1169">1169</span>
<span id="1170">1170</span>
<span id="1171">1171</span>
<span id="1172">1172</span>
<span id="1173">1173</span>
<span id="1174">1174</span>
<span id="1175">1175</span>
<span id="1176">1176</span>
<span id="1177">1177</span>
<span id="1178">1178</span>
<span id="1179">1179</span>
<span id="1180">1180</span>
<span id="1181">1181</span>
<span id="1182">1182</span>
<span id="1183">1183</span>
<span id="1184">1184</span>
<span id="1185">1185</span>
<span id="1186">1186</span>
<span id="1187">1187</span>
<span id="1188">1188</span>
<span id="1189">1189</span>
<span id="1190">1190</span>
<span id="1191">1191</span>
<span id="1192">1192</span>
<span id="1193">1193</span>
<span id="1194">1194</span>
<span id="1195">1195</span>
<span id="1196">1196</span>
<span id="1197">1197</span>
<span id="1198">1198</span>
<span id="1199">1199</span>
<span id="1200">1200</span>
<span id="1201">1201</span>
<span id="1202">1202</span>
<span id="1203">1203</span>
<span id="1204">1204</span>
<span id="1205">1205</span>
<span id="1206">1206</span>
<span id="1207">1207</span>
<span id="1208">1208</span>
<span id="1209">1209</span>
<span id="1210">1210</span>
<span id="1211">1211</span>
<span id="1212">1212</span>
<span id="1213">1213</span>
<span id="1214">1214</span>
<span id="1215">1215</span>
<span id="1216">1216</span>
<span id="1217">1217</span>
<span id="1218">1218</span>
<span id="1219">1219</span>
<span id="1220">1220</span>
<span id="1221">1221</span>
<span id="1222">1222</span>
<span id="1223">1223</span>
<span id="1224">1224</span>
<span id="1225">1225</span>
<span id="1226">1226</span>
<span id="1227">1227</span>
<span id="1228">1228</span>
<span id="1229">1229</span>
<span id="1230">1230</span>
<span id="1231">1231</span>
<span id="1232">1232</span>
<span id="1233">1233</span>
<span id="1234">1234</span>
<span id="1235">1235</span>
<span id="1236">1236</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">mem</span>;
@ -1149,7 +1242,10 @@
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Future</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">handler</span>::{<span class="ident">AsyncResult</span>, <span class="ident">AsyncResultItem</span>, <span class="ident">FromRequest</span>, <span class="ident">Responder</span>, <span class="ident">RouteHandler</span>};
<span class="kw">use</span> <span class="ident">handler</span>::{
<span class="ident">AsyncResult</span>, <span class="ident">AsyncResultItem</span>, <span class="ident">FromRequest</span>, <span class="ident">Handler</span>, <span class="ident">Responder</span>, <span class="ident">RouteHandler</span>,
<span class="ident">WrapHandler</span>,
};
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">Method</span>;
<span class="kw">use</span> <span class="ident">httprequest</span>::<span class="ident">HttpRequest</span>;
<span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponse</span>;
@ -1161,6 +1257,7 @@
<span class="kw">use</span> <span class="ident">resource</span>::{<span class="ident">DefaultResource</span>, <span class="ident">Resource</span>};
<span class="kw">use</span> <span class="ident">router</span>::{<span class="ident">ResourceDef</span>, <span class="ident">Router</span>};
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">Request</span>;
<span class="kw">use</span> <span class="ident">with</span>::<span class="ident">WithFactory</span>;
<span class="doccomment">/// Resources scope</span>
<span class="doccomment">///</span>
@ -1199,14 +1296,17 @@
<span class="ident">middlewares</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Middleware</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span><span class="op">&gt;&gt;</span>,
}
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">new_without_default_derive</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">new_without_default_derive</span>)
)]</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create a new scope</span>
<span class="comment">// TODO: Why is this not exactly the default impl?</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">rdef</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="ident">path</span>);
<span class="ident">Scope</span> {
<span class="ident">rdef</span>: <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="ident">path</span>),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>()),
<span class="ident">rdef</span>: <span class="ident">rdef</span>.<span class="ident">clone</span>(),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>(<span class="ident">rdef</span>)),
<span class="ident">filters</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">middlewares</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Vec</span>::<span class="ident">new</span>()),
}
@ -1276,10 +1376,11 @@
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">FnOnce</span>(<span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>,
{
<span class="kw">let</span> <span class="ident">rdef</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="ident">path</span>);
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span> {
<span class="ident">rdef</span>: <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="ident">path</span>),
<span class="ident">rdef</span>: <span class="ident">rdef</span>.<span class="ident">clone</span>(),
<span class="ident">filters</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>()),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>(<span class="ident">rdef</span>)),
<span class="ident">middlewares</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Vec</span>::<span class="ident">new</span>()),
};
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">f</span>(<span class="ident">scope</span>);
@ -1322,10 +1423,11 @@
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">FnOnce</span>(<span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
{
<span class="kw">let</span> <span class="ident">rdef</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="kw-2">&amp;</span><span class="ident">insert_slash</span>(<span class="ident">path</span>));
<span class="kw">let</span> <span class="ident">scope</span> <span class="op">=</span> <span class="ident">Scope</span> {
<span class="ident">rdef</span>: <span class="ident">ResourceDef</span>::<span class="ident">prefix</span>(<span class="kw-2">&amp;</span><span class="ident">path</span>),
<span class="ident">rdef</span>: <span class="ident">rdef</span>.<span class="ident">clone</span>(),
<span class="ident">filters</span>: <span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>()),
<span class="ident">router</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Router</span>::<span class="ident">new</span>(<span class="ident">rdef</span>)),
<span class="ident">middlewares</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Vec</span>::<span class="ident">new</span>()),
};
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">router</span>)
@ -1364,13 +1466,15 @@
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">route</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">method</span>: <span class="ident">Method</span>, <span class="ident">f</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">router</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">register_route</span>(<span class="ident">path</span>, <span class="ident">method</span>, <span class="ident">f</span>);
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">router</span>).<span class="ident">unwrap</span>().<span class="ident">register_route</span>(
<span class="kw-2">&amp;</span><span class="ident">insert_slash</span>(<span class="ident">path</span>),
<span class="ident">method</span>,
<span class="ident">f</span>,
);
<span class="self">self</span>
}
@ -1402,12 +1506,7 @@
<span class="ident">F</span>: <span class="ident">FnOnce</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Resource</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="comment">// add resource</span>
<span class="kw">let</span> <span class="ident">pattern</span> <span class="op">=</span> <span class="ident">ResourceDef</span>::<span class="ident">with_prefix</span>(
<span class="ident">path</span>,
<span class="kw">if</span> <span class="ident">path</span>.<span class="ident">is_empty</span>() { <span class="string">&quot;&quot;</span> } <span class="kw">else</span> { <span class="string">&quot;/&quot;</span> },
<span class="bool-val">false</span>,
);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">pattern</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resource</span> <span class="op">=</span> <span class="ident">Resource</span>::<span class="ident">new</span>(<span class="ident">ResourceDef</span>::<span class="ident">new</span>(<span class="kw-2">&amp;</span><span class="ident">insert_slash</span>(<span class="ident">path</span>)));
<span class="ident">f</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">resource</span>);
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">router</span>)
@ -1432,6 +1531,35 @@
<span class="self">self</span>
}
<span class="doccomment">/// Configure handler for specific path prefix.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// A path prefix consists of valid path segments, i.e for the</span>
<span class="doccomment">/// prefix `/app` any request with the paths `/app`, `/app/` or</span>
<span class="doccomment">/// `/app/test` would match, but the path `/application` would</span>
<span class="doccomment">/// not.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```rust</span>
<span class="doccomment">/// # extern crate actix_web;</span>
<span class="doccomment">/// use actix_web::{http, App, HttpRequest, HttpResponse};</span>
<span class="doccomment">///</span>
<span class="doccomment">/// fn main() {</span>
<span class="doccomment">/// let app = App::new().scope(&quot;/scope-prefix&quot;, |scope| {</span>
<span class="doccomment">/// scope.handler(&quot;/app&quot;, |req: &amp;HttpRequest| match *req.method() {</span>
<span class="doccomment">/// http::Method::GET =&gt; HttpResponse::Ok(),</span>
<span class="doccomment">/// http::Method::POST =&gt; HttpResponse::MethodNotAllowed(),</span>
<span class="doccomment">/// _ =&gt; HttpResponse::NotFound(),</span>
<span class="doccomment">/// })</span>
<span class="doccomment">/// });</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">handler</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">handler</span>: <span class="ident">H</span>) <span class="op">-&gt;</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">insert_slash</span>(<span class="ident">path</span>.<span class="ident">trim</span>().<span class="ident">trim_right_matches</span>(<span class="string">&#39;/&#39;</span>));
<span class="ident">Rc</span>::<span class="ident">get_mut</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">router</span>)
.<span class="ident">expect</span>(<span class="string">&quot;Multiple copies of scope router&quot;</span>)
.<span class="ident">register_handler</span>(<span class="kw-2">&amp;</span><span class="ident">path</span>, <span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">WrapHandler</span>::<span class="ident">new</span>(<span class="ident">handler</span>)), <span class="prelude-val">None</span>);
<span class="self">self</span>
}
<span class="doccomment">/// Register a scope middleware</span>
<span class="doccomment">///</span>
<span class="doccomment">/// This is similar to `App&#39;s` middlewares, but</span>
@ -1447,6 +1575,14 @@
}
}
<span class="kw">fn</span> <span class="ident">insert_slash</span>(<span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="ident">String</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">path</span> <span class="op">=</span> <span class="ident">path</span>.<span class="ident">to_owned</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">is_empty</span>() <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">path</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="ident">path</span>.<span class="ident">insert</span>(<span class="number">0</span>, <span class="string">&#39;/&#39;</span>);
};
<span class="ident">path</span>
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">RouteHandler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Scope</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="kw-2">&amp;</span><span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">AsyncResult</span><span class="op">&lt;</span><span class="ident">HttpResponse</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">tail</span> <span class="op">=</span> <span class="ident">req</span>.<span class="ident">match_info</span>().<span class="ident">tail</span> <span class="kw">as</span> <span class="ident">usize</span>;
@ -1861,8 +1997,7 @@
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/app&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -1876,8 +2011,7 @@
<span class="ident">scope</span>
.<span class="ident">resource</span>(<span class="string">&quot;&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -1893,8 +2027,7 @@
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/app/&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -1910,8 +2043,7 @@
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/app/&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -1929,12 +2061,38 @@
<span class="ident">scope</span>
.<span class="ident">route</span>(<span class="string">&quot;/path1&quot;</span>, <span class="ident">Method</span>::<span class="ident">GET</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span><span class="op">|</span> {
<span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()
})
.<span class="ident">route</span>(<span class="string">&quot;/path1&quot;</span>, <span class="ident">Method</span>::<span class="ident">DELETE</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span><span class="op">|</span> {
}).<span class="ident">route</span>(<span class="string">&quot;/path1&quot;</span>, <span class="ident">Method</span>::<span class="ident">DELETE</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span><span class="op">|</span> {
<span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">OK</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">DELETE</span>)
.<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">OK</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">POST</span>)
.<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">NOT_FOUND</span>);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_scope_route_without_leading_slash</span>() {
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;app&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>
.<span class="ident">route</span>(<span class="string">&quot;path1&quot;</span>, <span class="ident">Method</span>::<span class="ident">GET</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>())
.<span class="ident">route</span>(<span class="string">&quot;path1&quot;</span>, <span class="ident">Method</span>::<span class="ident">DELETE</span>, <span class="op">|</span><span class="kw">_</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="kw">_</span><span class="op">&gt;</span><span class="op">|</span> {
<span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()
})
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -1960,8 +2118,7 @@
<span class="ident">scope</span>
.<span class="ident">filter</span>(<span class="ident">pred</span>::<span class="ident">Get</span>())
.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path1&quot;</span>)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">POST</span>)
@ -1986,8 +2143,7 @@
.<span class="ident">body</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;project: {}&quot;</span>, <span class="kw-2">&amp;</span><span class="ident">r</span>.<span class="ident">match_info</span>()[<span class="string">&quot;project&quot;</span>]))
})
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/ab-project1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2015,8 +2171,7 @@
<span class="ident">scope</span>.<span class="ident">with_state</span>(<span class="string">&quot;/t1&quot;</span>, <span class="ident">State</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2034,8 +2189,7 @@
.<span class="ident">resource</span>(<span class="string">&quot;&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2055,8 +2209,7 @@
<span class="ident">scope</span>.<span class="ident">with_state</span>(<span class="string">&quot;/t1/&quot;</span>, <span class="ident">State</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2076,8 +2229,7 @@
<span class="ident">scope</span>.<span class="ident">with_state</span>(<span class="string">&quot;/t1/&quot;</span>, <span class="ident">State</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2099,8 +2251,7 @@
.<span class="ident">filter</span>(<span class="ident">pred</span>::<span class="ident">Get</span>())
.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1/path1&quot;</span>)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">POST</span>)
@ -2122,8 +2273,21 @@
<span class="ident">scope</span>.<span class="ident">nested</span>(<span class="string">&quot;/t1&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">CREATED</span>);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_nested_scope_no_slash</span>() {
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/app&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">nested</span>(<span class="string">&quot;t1&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2139,8 +2303,7 @@
.<span class="ident">resource</span>(<span class="string">&quot;&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
.<span class="ident">resource</span>(<span class="string">&quot;/&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">Created</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2160,8 +2323,7 @@
.<span class="ident">filter</span>(<span class="ident">pred</span>::<span class="ident">Get</span>())
.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/t1/path1&quot;</span>)
.<span class="ident">method</span>(<span class="ident">Method</span>::<span class="ident">POST</span>)
@ -2190,8 +2352,7 @@
})
})
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/project_1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2223,8 +2384,7 @@
})
})
})
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/test/1/path1&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2250,8 +2410,7 @@
<span class="ident">scope</span>
.<span class="ident">resource</span>(<span class="string">&quot;/path1&quot;</span>, <span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>()))
.<span class="ident">default_resource</span>(<span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">BadRequest</span>()))
})
.<span class="ident">finish</span>();
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/app/path2&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
@ -2267,8 +2426,7 @@
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/app1&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">default_resource</span>(<span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">BadRequest</span>()))
})
.<span class="ident">scope</span>(<span class="string">&quot;/app2&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> <span class="ident">scope</span>)
}).<span class="ident">scope</span>(<span class="string">&quot;/app2&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> <span class="ident">scope</span>)
.<span class="ident">default_resource</span>(<span class="op">|</span><span class="ident">r</span><span class="op">|</span> <span class="ident">r</span>.<span class="ident">f</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="ident">MethodNotAllowed</span>()))
.<span class="ident">finish</span>();
@ -2284,6 +2442,34 @@
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">METHOD_NOT_ALLOWED</span>);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_handler</span>() {
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">App</span>::<span class="ident">new</span>()
.<span class="ident">scope</span>(<span class="string">&quot;/scope&quot;</span>, <span class="op">|</span><span class="ident">scope</span><span class="op">|</span> {
<span class="ident">scope</span>.<span class="ident">handler</span>(<span class="string">&quot;/test&quot;</span>, <span class="op">|</span><span class="kw">_</span>: <span class="kw-2">&amp;</span><span class="kw">_</span><span class="op">|</span> <span class="ident">HttpResponse</span>::<span class="prelude-val">Ok</span>())
}).<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/scope/test&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">OK</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/scope/test/&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">OK</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/scope/test/app&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">OK</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/scope/testapp&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">NOT_FOUND</span>);
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">TestRequest</span>::<span class="ident">with_uri</span>(<span class="string">&quot;/scope/blah&quot;</span>).<span class="ident">request</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">app</span>.<span class="ident">run</span>(<span class="ident">req</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">resp</span>.<span class="ident">as_msg</span>().<span class="ident">status</span>(), <span class="ident">StatusCode</span>::<span class="ident">NOT_FOUND</span>);
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../";window.currentCrate = "actix_web";</script><script src="../../aliases.js"></script><script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>

613
static/api/actix-web/stable/src/actix_web/serde_urlencoded/de.rs.html
View File

@ -1,613 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/de.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>de.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
<span id="240">240</span>
<span id="241">241</span>
<span id="242">242</span>
<span id="243">243</span>
<span id="244">244</span>
<span id="245">245</span>
<span id="246">246</span>
<span id="247">247</span>
<span id="248">248</span>
<span id="249">249</span>
<span id="250">250</span>
<span id="251">251</span>
<span id="252">252</span>
<span id="253">253</span>
<span id="254">254</span>
<span id="255">255</span>
<span id="256">256</span>
<span id="257">257</span>
<span id="258">258</span>
<span id="259">259</span>
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
<span id="285">285</span>
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
<span id="295">295</span>
<span id="296">296</span>
<span id="297">297</span>
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
</pre><pre class="rust ">
<span class="doccomment">//! Deserialization support for the `application/x-www-form-urlencoded` format.</span>
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">de</span>::<span class="ident">Error</span> <span class="kw">as</span> <span class="ident">de_Error</span>;
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">de</span>::{
<span class="self">self</span>, <span class="ident">DeserializeSeed</span>, <span class="ident">EnumAccess</span>, <span class="ident">IntoDeserializer</span>, <span class="ident">VariantAccess</span>, <span class="ident">Visitor</span>,
};
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">de</span>::<span class="ident">value</span>::<span class="ident">MapDeserializer</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">borrow</span>::<span class="ident">Cow</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">Read</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">parse</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Parse</span> <span class="kw">as</span> <span class="ident">UrlEncodedParse</span>;
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">inline</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">de</span>::<span class="ident">value</span>::<span class="ident">Error</span>;
<span class="doccomment">/// Deserializes a `application/x-wwww-url-encoded` value from a `&amp;[u8]`.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```ignore</span>
<span class="doccomment">/// let meal = vec![</span>
<span class="doccomment">/// (&quot;bread&quot;.to_owned(), &quot;baguette&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;cheese&quot;.to_owned(), &quot;comté&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;meat&quot;.to_owned(), &quot;ham&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;fat&quot;.to_owned(), &quot;butter&quot;.to_owned()),</span>
<span class="doccomment">/// ];</span>
<span class="doccomment">///</span>
<span class="doccomment">/// assert_eq!(</span>
<span class="doccomment">/// serde_urlencoded::from_bytes::&lt;Vec&lt;(String, String)&gt;&gt;(</span>
<span class="doccomment">/// b&quot;bread=baguette&amp;cheese=comt%C3%A9&amp;meat=ham&amp;fat=butter&quot;),</span>
<span class="doccomment">/// Ok(meal));</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">from_bytes</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span>, <span class="ident">T</span><span class="op">&gt;</span>(<span class="ident">input</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;de</span> [<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">de</span>::<span class="ident">Deserialize</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">T</span>::<span class="ident">deserialize</span>(<span class="ident">Deserializer</span>::<span class="ident">new</span>(<span class="ident">parse</span>(<span class="ident">input</span>)))
}
<span class="doccomment">/// Deserializes a `application/x-wwww-url-encoded` value from a `&amp;str`.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```ignore</span>
<span class="doccomment">/// let meal = vec![</span>
<span class="doccomment">/// (&quot;bread&quot;.to_owned(), &quot;baguette&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;cheese&quot;.to_owned(), &quot;comté&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;meat&quot;.to_owned(), &quot;ham&quot;.to_owned()),</span>
<span class="doccomment">/// (&quot;fat&quot;.to_owned(), &quot;butter&quot;.to_owned()),</span>
<span class="doccomment">/// ];</span>
<span class="doccomment">///</span>
<span class="doccomment">/// assert_eq!(</span>
<span class="doccomment">/// serde_urlencoded::from_str::&lt;Vec&lt;(String, String)&gt;&gt;(</span>
<span class="doccomment">/// &quot;bread=baguette&amp;cheese=comt%C3%A9&amp;meat=ham&amp;fat=butter&quot;),</span>
<span class="doccomment">/// Ok(meal));</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">from_str</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span>, <span class="ident">T</span><span class="op">&gt;</span>(<span class="ident">input</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;de</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">de</span>::<span class="ident">Deserialize</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">from_bytes</span>(<span class="ident">input</span>.<span class="ident">as_bytes</span>())
}
<span class="attribute">#[<span class="ident">allow</span>(<span class="ident">dead_code</span>)]</span>
<span class="doccomment">/// Convenience function that reads all bytes from `reader` and deserializes</span>
<span class="doccomment">/// them with `from_bytes`.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">from_reader</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="ident">reader</span>: <span class="ident">R</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">de</span>::<span class="ident">DeserializeOwned</span>,
<span class="ident">R</span>: <span class="ident">Read</span>,
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[];
<span class="ident">reader</span>
.<span class="ident">read_to_end</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf</span>)
.<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">de</span>::<span class="ident">Error</span>::<span class="ident">custom</span>(<span class="macro">format_args</span><span class="macro">!</span>(<span class="string">&quot;could not read input: {}&quot;</span>, <span class="ident">e</span>)))<span class="question-mark">?</span>;
<span class="ident">from_bytes</span>(<span class="kw-2">&amp;</span><span class="ident">buf</span>)
}
<span class="doccomment">/// A deserializer for the `application/x-www-form-urlencoded` format.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Supported top-level outputs are structs, maps and sequences of pairs,</span>
<span class="doccomment">/// with or without a given length.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Main `deserialize` methods defers to `deserialize_map`.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Everything else but `deserialize_seq` and `deserialize_seq_fixed_size`</span>
<span class="doccomment">/// defers to `deserialize`.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">Deserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">MapDeserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span>, <span class="ident">PartIterator</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">Deserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="doccomment">/// Returns a new `Deserializer`.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">parser</span>: <span class="ident">UrlEncodedParse</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Deserializer</span> {
<span class="ident">inner</span>: <span class="ident">MapDeserializer</span>::<span class="ident">new</span>(<span class="ident">PartIterator</span>(<span class="ident">parser</span>)),
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">de</span>::<span class="ident">Deserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Deserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">deserialize_any</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="self">self</span>.<span class="ident">deserialize_map</span>(<span class="ident">visitor</span>)
}
<span class="kw">fn</span> <span class="ident">deserialize_map</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">visitor</span>.<span class="ident">visit_map</span>(<span class="self">self</span>.<span class="ident">inner</span>)
}
<span class="kw">fn</span> <span class="ident">deserialize_seq</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">visitor</span>.<span class="ident">visit_seq</span>(<span class="self">self</span>.<span class="ident">inner</span>)
}
<span class="kw">fn</span> <span class="ident">deserialize_unit</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">end</span>()<span class="question-mark">?</span>;
<span class="ident">visitor</span>.<span class="ident">visit_unit</span>()
}
<span class="macro">forward_to_deserialize_any</span><span class="macro">!</span> {
<span class="ident">bool</span>
<span class="ident">u8</span>
<span class="ident">u16</span>
<span class="ident">u32</span>
<span class="ident">u64</span>
<span class="ident">i8</span>
<span class="ident">i16</span>
<span class="ident">i32</span>
<span class="ident">i64</span>
<span class="ident">f32</span>
<span class="ident">f64</span>
<span class="ident">char</span>
<span class="ident">str</span>
<span class="ident">string</span>
<span class="ident">option</span>
<span class="ident">bytes</span>
<span class="ident">byte_buf</span>
<span class="ident">unit_struct</span>
<span class="ident">newtype_struct</span>
<span class="ident">tuple_struct</span>
<span class="kw">struct</span>
<span class="ident">identifier</span>
<span class="ident">tuple</span>
<span class="kw">enum</span>
<span class="ident">ignored_any</span>
}
}
<span class="kw">struct</span> <span class="ident">PartIterator</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>(<span class="ident">UrlEncodedParse</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>);
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">Iterator</span> <span class="kw">for</span> <span class="ident">PartIterator</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> (<span class="ident">Part</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>, <span class="ident">Part</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>);
<span class="kw">fn</span> <span class="ident">next</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">next</span>().<span class="ident">map</span>(<span class="op">|</span>(<span class="ident">k</span>, <span class="ident">v</span>)<span class="op">|</span> (<span class="ident">Part</span>(<span class="ident">k</span>), <span class="ident">Part</span>(<span class="ident">v</span>)))
}
}
<span class="kw">struct</span> <span class="ident">Part</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>(<span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span>, <span class="ident">str</span><span class="op">&gt;</span>);
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">IntoDeserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Part</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Deserializer</span> <span class="op">=</span> <span class="self">Self</span>;
<span class="kw">fn</span> <span class="ident">into_deserializer</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Deserializer</span> {
<span class="self">self</span>
}
}
<span class="macro">macro_rules</span><span class="macro">!</span> <span class="ident">forward_parsed_value</span> {
($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">ty</span>:<span class="ident">ident</span> <span class="op">=&gt;</span> <span class="macro-nonterminal">$</span><span class="macro-nonterminal">method</span>:<span class="ident">ident</span>,)<span class="kw-2">*</span>) <span class="op">=&gt;</span> {
$(
<span class="kw">fn</span> <span class="macro-nonterminal">$</span><span class="macro-nonterminal">method</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span> <span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>
{
<span class="kw">match</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">parse</span>::<span class="op">&lt;</span><span class="macro-nonterminal">$</span><span class="macro-nonterminal">ty</span><span class="op">&gt;</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">val</span>) <span class="op">=&gt;</span> <span class="ident">val</span>.<span class="ident">into_deserializer</span>().<span class="macro-nonterminal">$</span><span class="macro-nonterminal">method</span>(<span class="ident">visitor</span>),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">de</span>::<span class="ident">Error</span>::<span class="ident">custom</span>(<span class="ident">e</span>))
}
}
)<span class="op">*</span>
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">de</span>::<span class="ident">Deserializer</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Part</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">deserialize_any</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">into_deserializer</span>().<span class="ident">deserialize_any</span>(<span class="ident">visitor</span>)
}
<span class="kw">fn</span> <span class="ident">deserialize_option</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">visitor</span>.<span class="ident">visit_some</span>(<span class="self">self</span>)
}
<span class="kw">fn</span> <span class="ident">deserialize_enum</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variants</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> [<span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>], <span class="ident">visitor</span>: <span class="ident">V</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">de</span>::<span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="ident">visitor</span>.<span class="ident">visit_enum</span>(<span class="ident">ValueEnumAccess</span> { <span class="ident">value</span>: <span class="self">self</span>.<span class="number">0</span> })
}
<span class="macro">forward_to_deserialize_any</span><span class="macro">!</span> {
<span class="ident">char</span>
<span class="ident">str</span>
<span class="ident">string</span>
<span class="ident">unit</span>
<span class="ident">bytes</span>
<span class="ident">byte_buf</span>
<span class="ident">unit_struct</span>
<span class="ident">newtype_struct</span>
<span class="ident">tuple_struct</span>
<span class="kw">struct</span>
<span class="ident">identifier</span>
<span class="ident">tuple</span>
<span class="ident">ignored_any</span>
<span class="ident">seq</span>
<span class="ident">map</span>
}
<span class="macro">forward_parsed_value</span><span class="macro">!</span> {
<span class="ident">bool</span> <span class="op">=&gt;</span> <span class="ident">deserialize_bool</span>,
<span class="ident">u8</span> <span class="op">=&gt;</span> <span class="ident">deserialize_u8</span>,
<span class="ident">u16</span> <span class="op">=&gt;</span> <span class="ident">deserialize_u16</span>,
<span class="ident">u32</span> <span class="op">=&gt;</span> <span class="ident">deserialize_u32</span>,
<span class="ident">u64</span> <span class="op">=&gt;</span> <span class="ident">deserialize_u64</span>,
<span class="ident">i8</span> <span class="op">=&gt;</span> <span class="ident">deserialize_i8</span>,
<span class="ident">i16</span> <span class="op">=&gt;</span> <span class="ident">deserialize_i16</span>,
<span class="ident">i32</span> <span class="op">=&gt;</span> <span class="ident">deserialize_i32</span>,
<span class="ident">i64</span> <span class="op">=&gt;</span> <span class="ident">deserialize_i64</span>,
<span class="ident">f32</span> <span class="op">=&gt;</span> <span class="ident">deserialize_f32</span>,
<span class="ident">f64</span> <span class="op">=&gt;</span> <span class="ident">deserialize_f64</span>,
}
}
<span class="doccomment">/// Provides access to a keyword which can be deserialized into an enum variant. The enum variant</span>
<span class="doccomment">/// must be a unit variant, otherwise deserialization will fail.</span>
<span class="kw">struct</span> <span class="ident">ValueEnumAccess</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="ident">value</span>: <span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span>, <span class="ident">str</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">EnumAccess</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">ValueEnumAccess</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">Variant</span> <span class="op">=</span> <span class="ident">UnitOnlyVariantAccess</span>;
<span class="kw">fn</span> <span class="ident">variant_seed</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">seed</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(<span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Variant</span>), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">DeserializeSeed</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="kw">let</span> <span class="ident">variant</span> <span class="op">=</span> <span class="ident">seed</span>.<span class="ident">deserialize</span>(<span class="self">self</span>.<span class="ident">value</span>.<span class="ident">into_deserializer</span>())<span class="question-mark">?</span>;
<span class="prelude-val">Ok</span>((<span class="ident">variant</span>, <span class="ident">UnitOnlyVariantAccess</span>))
}
}
<span class="doccomment">/// A visitor for deserializing the contents of the enum variant. As we only support</span>
<span class="doccomment">/// `unit_variant`, all other variant types will return an error.</span>
<span class="kw">struct</span> <span class="ident">UnitOnlyVariantAccess</span>;
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="ident">VariantAccess</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">UnitOnlyVariantAccess</span> {
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">unit_variant</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">newtype_variant_seed</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">_seed</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">DeserializeSeed</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">custom</span>(<span class="string">&quot;expected unit variant&quot;</span>))
}
<span class="kw">fn</span> <span class="ident">tuple_variant</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="ident">usize</span>, <span class="ident">_visitor</span>: <span class="ident">V</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">custom</span>(<span class="string">&quot;expected unit variant&quot;</span>))
}
<span class="kw">fn</span> <span class="ident">struct_variant</span><span class="op">&lt;</span><span class="ident">V</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_fields</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> [<span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>], <span class="ident">_visitor</span>: <span class="ident">V</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">V</span>::<span class="ident">Value</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">V</span>: <span class="ident">Visitor</span><span class="op">&lt;</span><span class="lifetime">&#39;de</span><span class="op">&gt;</span>,
{
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">custom</span>(<span class="string">&quot;expected unit variant&quot;</span>))
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

245
static/api/actix-web/stable/src/actix_web/serde_urlencoded/mod.rs.html
View File

@ -1,245 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/mod.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>mod.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
</pre><pre class="rust ">
<span class="doccomment">//! `x-www-form-urlencoded` meets Serde</span>
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">dtoa</span>;
<span class="kw">extern</span> <span class="kw">crate</span> <span class="ident">itoa</span>;
<span class="kw">pub</span> <span class="kw">mod</span> <span class="ident">de</span>;
<span class="kw">pub</span> <span class="kw">mod</span> <span class="ident">ser</span>;
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">inline</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">de</span>::{<span class="ident">from_bytes</span>, <span class="ident">from_reader</span>, <span class="ident">from_str</span>, <span class="ident">Deserializer</span>};
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">inline</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">ser</span>::{<span class="ident">to_string</span>, <span class="ident">Serializer</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">test</span>)]</span>
<span class="kw">mod</span> <span class="ident">tests</span> {
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_bytes</span>() {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[(<span class="string">&quot;first&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">23</span>), (<span class="string">&quot;last&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">42</span>)];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_bytes</span>(<span class="string">b&quot;first=23&amp;last=42&quot;</span>), <span class="prelude-val">Ok</span>(<span class="ident">result</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_str</span>() {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[(<span class="string">&quot;first&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">23</span>), (<span class="string">&quot;last&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">42</span>)];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;first=23&amp;last=42&quot;</span>), <span class="prelude-val">Ok</span>(<span class="ident">result</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_reader</span>() {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[(<span class="string">&quot;first&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">23</span>), (<span class="string">&quot;last&quot;</span>.<span class="ident">to_owned</span>(), <span class="number">42</span>)];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_reader</span>(<span class="string">b&quot;first=23&amp;last=42&quot;</span> <span class="kw">as</span> <span class="kw-2">&amp;</span>[<span class="kw">_</span>]), <span class="prelude-val">Ok</span>(<span class="ident">result</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_option</span>() {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[
(<span class="string">&quot;first&quot;</span>.<span class="ident">to_owned</span>(), <span class="prelude-val">Some</span>(<span class="number">23</span>)),
(<span class="string">&quot;last&quot;</span>.<span class="ident">to_owned</span>(), <span class="prelude-val">Some</span>(<span class="number">42</span>)),
];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;first=23&amp;last=42&quot;</span>), <span class="prelude-val">Ok</span>(<span class="ident">result</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_unit</span>() {
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;&quot;</span>), <span class="prelude-val">Ok</span>(()));
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;&amp;&quot;</span>), <span class="prelude-val">Ok</span>(()));
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;&amp;&amp;&quot;</span>), <span class="prelude-val">Ok</span>(()));
<span class="macro">assert</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>(<span class="string">&quot;first=23&quot;</span>).<span class="ident">is_err</span>());
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Serialize</span>, <span class="ident">Deserialize</span>, <span class="ident">Debug</span>, <span class="ident">PartialEq</span>, <span class="ident">Eq</span>)]</span>
<span class="kw">enum</span> <span class="ident">X</span> {
<span class="ident">A</span>,
<span class="ident">B</span>,
<span class="ident">C</span>,
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">deserialize_unit_enum</span>() {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="macro">vec</span><span class="macro">!</span>[
(<span class="string">&quot;one&quot;</span>.<span class="ident">to_owned</span>(), <span class="ident">X</span>::<span class="ident">A</span>),
(<span class="string">&quot;two&quot;</span>.<span class="ident">to_owned</span>(), <span class="ident">X</span>::<span class="ident">B</span>),
(<span class="string">&quot;three&quot;</span>.<span class="ident">to_owned</span>(), <span class="ident">X</span>::<span class="ident">C</span>),
];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">from_str</span>(<span class="string">&quot;one=A&amp;two=B&amp;three=C&quot;</span>), <span class="prelude-val">Ok</span>(<span class="ident">result</span>));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">serialize_option_map_int</span>() {
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="kw-2">&amp;</span>[(<span class="string">&quot;first&quot;</span>, <span class="prelude-val">Some</span>(<span class="number">23</span>)), (<span class="string">&quot;middle&quot;</span>, <span class="prelude-val">None</span>), (<span class="string">&quot;last&quot;</span>, <span class="prelude-val">Some</span>(<span class="number">42</span>))];
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="kw">super</span>::<span class="ident">to_string</span>(<span class="ident">params</span>), <span class="prelude-val">Ok</span>(<span class="string">&quot;first=23&amp;last=42&quot;</span>.<span class="ident">to_owned</span>()));
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">serialize_option_map_string</span>() {
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="kw-2">&amp;</span>[
(<span class="string">&quot;first&quot;</span>, <span class="prelude-val">Some</span>(<span class="string">&quot;hello&quot;</span>)),
(<span class="string">&quot;middle&quot;</span>, <span class="prelude-val">None</span>),
(<span class="string">&quot;last&quot;</span>, <span class="prelude-val">Some</span>(<span class="string">&quot;world&quot;</span>)),
];
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw">super</span>::<span class="ident">to_string</span>(<span class="ident">params</span>),
<span class="prelude-val">Ok</span>(<span class="string">&quot;first=hello&amp;last=world&quot;</span>.<span class="ident">to_owned</span>())
);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">serialize_option_map_bool</span>() {
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="kw-2">&amp;</span>[(<span class="string">&quot;one&quot;</span>, <span class="prelude-val">Some</span>(<span class="bool-val">true</span>)), (<span class="string">&quot;two&quot;</span>, <span class="prelude-val">Some</span>(<span class="bool-val">false</span>))];
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw">super</span>::<span class="ident">to_string</span>(<span class="ident">params</span>),
<span class="prelude-val">Ok</span>(<span class="string">&quot;one=true&amp;two=false&quot;</span>.<span class="ident">to_owned</span>())
);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">serialize_map_bool</span>() {
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="kw-2">&amp;</span>[(<span class="string">&quot;one&quot;</span>, <span class="bool-val">true</span>), (<span class="string">&quot;two&quot;</span>, <span class="bool-val">false</span>)];
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw">super</span>::<span class="ident">to_string</span>(<span class="ident">params</span>),
<span class="prelude-val">Ok</span>(<span class="string">&quot;one=true&amp;two=false&quot;</span>.<span class="ident">to_owned</span>())
);
}
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">serialize_unit_enum</span>() {
<span class="kw">let</span> <span class="ident">params</span> <span class="op">=</span> <span class="kw-2">&amp;</span>[(<span class="string">&quot;one&quot;</span>, <span class="ident">X</span>::<span class="ident">A</span>), (<span class="string">&quot;two&quot;</span>, <span class="ident">X</span>::<span class="ident">B</span>), (<span class="string">&quot;three&quot;</span>, <span class="ident">X</span>::<span class="ident">C</span>)];
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="kw">super</span>::<span class="ident">to_string</span>(<span class="ident">params</span>),
<span class="prelude-val">Ok</span>(<span class="string">&quot;one=A&amp;two=B&amp;three=C&quot;</span>.<span class="ident">to_owned</span>())
);
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

151
static/api/actix-web/stable/src/actix_web/serde_urlencoded/ser/key.rs.html
View File

@ -1,151 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/ser/key.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>key.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<span id="25">25</span>
<span id="26">26</span>
<span id="27">27</span>
<span id="28">28</span>
<span id="29">29</span>
<span id="30">30</span>
<span id="31">31</span>
<span id="32">32</span>
<span id="33">33</span>
<span id="34">34</span>
<span id="35">35</span>
<span id="36">36</span>
<span id="37">37</span>
<span id="38">38</span>
<span id="39">39</span>
<span id="40">40</span>
<span id="41">41</span>
<span id="42">42</span>
<span id="43">43</span>
<span id="44">44</span>
<span id="45">45</span>
<span id="46">46</span>
<span id="47">47</span>
<span id="48">48</span>
<span id="49">49</span>
<span id="50">50</span>
<span id="51">51</span>
<span id="52">52</span>
<span id="53">53</span>
<span id="54">54</span>
<span id="55">55</span>
<span id="56">56</span>
<span id="57">57</span>
<span id="58">58</span>
<span id="59">59</span>
<span id="60">60</span>
<span id="61">61</span>
<span id="62">62</span>
<span id="63">63</span>
<span id="64">64</span>
<span id="65">65</span>
<span id="66">66</span>
<span id="67">67</span>
<span id="68">68</span>
<span id="69">69</span>
<span id="70">70</span>
<span id="71">71</span>
<span id="72">72</span>
<span id="73">73</span>
<span id="74">74</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">part</span>::<span class="ident">Sink</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">Serialize</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">borrow</span>::<span class="ident">Cow</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ops</span>::<span class="ident">Deref</span>;
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> {
<span class="ident">Static</span>(<span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>),
<span class="ident">Dynamic</span>(<span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="ident">str</span><span class="op">&gt;</span>),
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> <span class="ident">Deref</span> <span class="kw">for</span> <span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Target</span> <span class="op">=</span> <span class="ident">str</span>;
<span class="kw">fn</span> <span class="ident">deref</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">str</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">Key</span>::<span class="ident">Static</span>(<span class="ident">key</span>) <span class="op">=&gt;</span> <span class="ident">key</span>,
<span class="ident">Key</span>::<span class="ident">Dynamic</span>(<span class="kw-2">ref</span> <span class="ident">key</span>) <span class="op">=&gt;</span> <span class="ident">key</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> <span class="ident">From</span><span class="op">&lt;</span><span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;&gt;</span> <span class="kw">for</span> <span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;static</span>, <span class="ident">str</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">key</span>: <span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">match</span> <span class="ident">key</span> {
<span class="ident">Key</span>::<span class="ident">Static</span>(<span class="ident">key</span>) <span class="op">=&gt;</span> <span class="ident">key</span>.<span class="ident">into</span>(),
<span class="ident">Key</span>::<span class="ident">Dynamic</span>(<span class="ident">key</span>) <span class="op">=&gt;</span> <span class="ident">key</span>.<span class="ident">into_owned</span>().<span class="ident">into</span>(),
}
}
}
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">KeySink</span><span class="op">&lt;</span><span class="ident">End</span><span class="op">&gt;</span> {
<span class="ident">end</span>: <span class="ident">End</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">End</span>, <span class="prelude-val">Ok</span><span class="op">&gt;</span> <span class="ident">KeySink</span><span class="op">&lt;</span><span class="ident">End</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">End</span>: <span class="kw">for</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> <span class="ident">FnOnce</span>(<span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">end</span>: <span class="ident">End</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">KeySink</span> { <span class="ident">end</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">End</span>, <span class="prelude-val">Ok</span><span class="op">&gt;</span> <span class="ident">Sink</span> <span class="kw">for</span> <span class="ident">KeySink</span><span class="op">&lt;</span><span class="ident">End</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">End</span>: <span class="kw">for</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span> <span class="ident">FnOnce</span>(<span class="ident">Key</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="prelude-val">Ok</span>;
<span class="kw">fn</span> <span class="ident">serialize_static_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
(<span class="self">self</span>.<span class="ident">end</span>)(<span class="ident">Key</span>::<span class="ident">Static</span>(<span class="ident">value</span>))
}
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
(<span class="self">self</span>.<span class="ident">end</span>)(<span class="ident">Key</span>::<span class="ident">Dynamic</span>(<span class="ident">value</span>.<span class="ident">into</span>()))
}
<span class="kw">fn</span> <span class="ident">serialize_string</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="ident">String</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
(<span class="self">self</span>.<span class="ident">end</span>)(<span class="ident">Key</span>::<span class="ident">Dynamic</span>(<span class="ident">value</span>.<span class="ident">into</span>()))
}
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">Serialize</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">unsupported</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Error</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="string">&quot;unsupported key&quot;</span>.<span class="ident">into</span>())
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

983
static/api/actix-web/stable/src/actix_web/serde_urlencoded/ser/mod.rs.html
View File

@ -1,983 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/ser/mod.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>mod.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
<span id="240">240</span>
<span id="241">241</span>
<span id="242">242</span>
<span id="243">243</span>
<span id="244">244</span>
<span id="245">245</span>
<span id="246">246</span>
<span id="247">247</span>
<span id="248">248</span>
<span id="249">249</span>
<span id="250">250</span>
<span id="251">251</span>
<span id="252">252</span>
<span id="253">253</span>
<span id="254">254</span>
<span id="255">255</span>
<span id="256">256</span>
<span id="257">257</span>
<span id="258">258</span>
<span id="259">259</span>
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
<span id="285">285</span>
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
<span id="295">295</span>
<span id="296">296</span>
<span id="297">297</span>
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
<span id="306">306</span>
<span id="307">307</span>
<span id="308">308</span>
<span id="309">309</span>
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
<span id="365">365</span>
<span id="366">366</span>
<span id="367">367</span>
<span id="368">368</span>
<span id="369">369</span>
<span id="370">370</span>
<span id="371">371</span>
<span id="372">372</span>
<span id="373">373</span>
<span id="374">374</span>
<span id="375">375</span>
<span id="376">376</span>
<span id="377">377</span>
<span id="378">378</span>
<span id="379">379</span>
<span id="380">380</span>
<span id="381">381</span>
<span id="382">382</span>
<span id="383">383</span>
<span id="384">384</span>
<span id="385">385</span>
<span id="386">386</span>
<span id="387">387</span>
<span id="388">388</span>
<span id="389">389</span>
<span id="390">390</span>
<span id="391">391</span>
<span id="392">392</span>
<span id="393">393</span>
<span id="394">394</span>
<span id="395">395</span>
<span id="396">396</span>
<span id="397">397</span>
<span id="398">398</span>
<span id="399">399</span>
<span id="400">400</span>
<span id="401">401</span>
<span id="402">402</span>
<span id="403">403</span>
<span id="404">404</span>
<span id="405">405</span>
<span id="406">406</span>
<span id="407">407</span>
<span id="408">408</span>
<span id="409">409</span>
<span id="410">410</span>
<span id="411">411</span>
<span id="412">412</span>
<span id="413">413</span>
<span id="414">414</span>
<span id="415">415</span>
<span id="416">416</span>
<span id="417">417</span>
<span id="418">418</span>
<span id="419">419</span>
<span id="420">420</span>
<span id="421">421</span>
<span id="422">422</span>
<span id="423">423</span>
<span id="424">424</span>
<span id="425">425</span>
<span id="426">426</span>
<span id="427">427</span>
<span id="428">428</span>
<span id="429">429</span>
<span id="430">430</span>
<span id="431">431</span>
<span id="432">432</span>
<span id="433">433</span>
<span id="434">434</span>
<span id="435">435</span>
<span id="436">436</span>
<span id="437">437</span>
<span id="438">438</span>
<span id="439">439</span>
<span id="440">440</span>
<span id="441">441</span>
<span id="442">442</span>
<span id="443">443</span>
<span id="444">444</span>
<span id="445">445</span>
<span id="446">446</span>
<span id="447">447</span>
<span id="448">448</span>
<span id="449">449</span>
<span id="450">450</span>
<span id="451">451</span>
<span id="452">452</span>
<span id="453">453</span>
<span id="454">454</span>
<span id="455">455</span>
<span id="456">456</span>
<span id="457">457</span>
<span id="458">458</span>
<span id="459">459</span>
<span id="460">460</span>
<span id="461">461</span>
<span id="462">462</span>
<span id="463">463</span>
<span id="464">464</span>
<span id="465">465</span>
<span id="466">466</span>
<span id="467">467</span>
<span id="468">468</span>
<span id="469">469</span>
<span id="470">470</span>
<span id="471">471</span>
<span id="472">472</span>
<span id="473">473</span>
<span id="474">474</span>
<span id="475">475</span>
<span id="476">476</span>
<span id="477">477</span>
<span id="478">478</span>
<span id="479">479</span>
<span id="480">480</span>
<span id="481">481</span>
<span id="482">482</span>
<span id="483">483</span>
<span id="484">484</span>
<span id="485">485</span>
<span id="486">486</span>
<span id="487">487</span>
<span id="488">488</span>
<span id="489">489</span>
<span id="490">490</span>
</pre><pre class="rust ">
<span class="doccomment">//! Serialization support for the `application/x-www-form-urlencoded` format.</span>
<span class="kw">mod</span> <span class="ident">key</span>;
<span class="kw">mod</span> <span class="ident">pair</span>;
<span class="kw">mod</span> <span class="ident">part</span>;
<span class="kw">mod</span> <span class="ident">value</span>;
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">ser</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">borrow</span>::<span class="ident">Cow</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">error</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">str</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Serializer</span> <span class="kw">as</span> <span class="ident">UrlEncodedSerializer</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Target</span> <span class="kw">as</span> <span class="ident">UrlEncodedTarget</span>;
<span class="doccomment">/// Serializes a value into a `application/x-wwww-url-encoded` `String` buffer.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// ```ignore</span>
<span class="doccomment">/// let meal = &amp;[</span>
<span class="doccomment">/// (&quot;bread&quot;, &quot;baguette&quot;),</span>
<span class="doccomment">/// (&quot;cheese&quot;, &quot;comté&quot;),</span>
<span class="doccomment">/// (&quot;meat&quot;, &quot;ham&quot;),</span>
<span class="doccomment">/// (&quot;fat&quot;, &quot;butter&quot;),</span>
<span class="doccomment">/// ];</span>
<span class="doccomment">///</span>
<span class="doccomment">/// assert_eq!(</span>
<span class="doccomment">/// serde_urlencoded::to_string(meal),</span>
<span class="doccomment">/// Ok(&quot;bread=baguette&amp;cheese=comt%C3%A9&amp;meat=ham&amp;fat=butter&quot;.to_owned()));</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">to_string</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(<span class="ident">input</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">String</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">urlencoder</span> <span class="op">=</span> <span class="ident">UrlEncodedSerializer</span>::<span class="ident">new</span>(<span class="string">&quot;&quot;</span>.<span class="ident">to_owned</span>());
<span class="ident">input</span>.<span class="ident">serialize</span>(<span class="ident">Serializer</span>::<span class="ident">new</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">urlencoder</span>))<span class="question-mark">?</span>;
<span class="prelude-val">Ok</span>(<span class="ident">urlencoder</span>.<span class="ident">finish</span>())
}
<span class="doccomment">/// A serializer for the `application/x-www-form-urlencoded` format.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Supported top-level inputs are structs, maps and sequences of pairs,</span>
<span class="doccomment">/// with or without a given length.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Supported keys and values are integers, bytes (if convertible to strings),</span>
<span class="doccomment">/// unit structs and unit variants.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// * Newtype structs defer to their inner values.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">Serializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> <span class="ident">Serializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> {
<span class="doccomment">/// Returns a new `Serializer`.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Serializer</span> { <span class="ident">urlencoder</span> }
}
}
<span class="doccomment">/// Errors returned during serializing to `application/x-www-form-urlencoded`.</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Clone</span>, <span class="ident">Debug</span>, <span class="ident">PartialEq</span>, <span class="ident">Eq</span>)]</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">Error</span> {
<span class="ident">Custom</span>(<span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;static</span>, <span class="ident">str</span><span class="op">&gt;</span>),
<span class="ident">Utf8</span>(<span class="ident">str</span>::<span class="ident">Utf8Error</span>),
}
<span class="kw">impl</span> <span class="ident">fmt</span>::<span class="ident">Display</span> <span class="kw">for</span> <span class="ident">Error</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="kw-2">ref</span> <span class="ident">msg</span>) <span class="op">=&gt;</span> <span class="ident">msg</span>.<span class="ident">fmt</span>(<span class="ident">f</span>),
<span class="ident">Error</span>::<span class="ident">Utf8</span>(<span class="kw-2">ref</span> <span class="ident">err</span>) <span class="op">=&gt;</span> <span class="macro">write</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot;invalid UTF-8: {}&quot;</span>, <span class="ident">err</span>),
}
}
}
<span class="kw">impl</span> <span class="ident">error</span>::<span class="ident">Error</span> <span class="kw">for</span> <span class="ident">Error</span> {
<span class="kw">fn</span> <span class="ident">description</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">str</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="kw-2">ref</span> <span class="ident">msg</span>) <span class="op">=&gt;</span> <span class="ident">msg</span>,
<span class="ident">Error</span>::<span class="ident">Utf8</span>(<span class="kw-2">ref</span> <span class="ident">err</span>) <span class="op">=&gt;</span> <span class="ident">error</span>::<span class="ident">Error</span>::<span class="ident">description</span>(<span class="ident">err</span>),
}
}
<span class="doccomment">/// The lower-level cause of this error, in the case of a `Utf8` error.</span>
<span class="kw">fn</span> <span class="ident">cause</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="ident">error</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="prelude-val">None</span>,
<span class="ident">Error</span>::<span class="ident">Utf8</span>(<span class="kw-2">ref</span> <span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Some</span>(<span class="ident">err</span>),
}
}
}
<span class="kw">impl</span> <span class="ident">ser</span>::<span class="ident">Error</span> <span class="kw">for</span> <span class="ident">Error</span> {
<span class="kw">fn</span> <span class="ident">custom</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">fmt</span>::<span class="ident">Display</span><span class="op">&gt;</span>(<span class="ident">msg</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">msg</span>).<span class="ident">into</span>())
}
}
<span class="doccomment">/// Sequence serializer.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">SeqSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
}
<span class="doccomment">/// Tuple serializer.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Mostly used for arrays.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">TupleSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
}
<span class="doccomment">/// Tuple struct serializer.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Never instantiated, tuple structs are not supported.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">TupleStructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">T</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
}
<span class="doccomment">/// Tuple variant serializer.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Never instantiated, tuple variants are not supported.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">TupleVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">T</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
}
<span class="doccomment">/// Map serializer.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">MapSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
<span class="ident">key</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;static</span>, <span class="ident">str</span><span class="op">&gt;&gt;</span>,
}
<span class="doccomment">/// Struct serializer.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">StructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
}
<span class="doccomment">/// Struct variant serializer.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Never instantiated, struct variants are not supported.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">StructVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">T</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>, <span class="ident">Error</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">Serializer</span> <span class="kw">for</span> <span class="ident">Serializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">SerializeSeq</span> <span class="op">=</span> <span class="ident">SeqSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTuple</span> <span class="op">=</span> <span class="ident">TupleSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleStruct</span> <span class="op">=</span> <span class="ident">TupleStructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleVariant</span> <span class="op">=</span> <span class="ident">TupleVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeMap</span> <span class="op">=</span> <span class="ident">MapSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStruct</span> <span class="op">=</span> <span class="ident">StructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStructVariant</span> <span class="op">=</span> <span class="ident">StructVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>;
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_bool</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_i8</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_i16</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_i32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_i64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_u8</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_u16</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_u32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_u64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_f32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">f32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_f64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">f64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_char</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">char</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_bytes</span>(<span class="self">self</span>, <span class="ident">_value</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_unit</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_unit_struct</span>(<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_unit_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Serializes the inner value, ignoring the newtype name.</span>
<span class="kw">fn</span> <span class="ident">serialize_newtype_struct</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="self">self</span>)
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_newtype_variant</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns `Ok`.</span>
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>)
}
<span class="doccomment">/// Serializes the given value.</span>
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="self">self</span>)
}
<span class="doccomment">/// Serialize a sequence, given length (if any) is ignored.</span>
<span class="kw">fn</span> <span class="ident">serialize_seq</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeSeq</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">SeqSerializer</span> {
<span class="ident">urlencoder</span>: <span class="self">self</span>.<span class="ident">urlencoder</span>,
})
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_tuple</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="ident">usize</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTuple</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">TupleSerializer</span> {
<span class="ident">urlencoder</span>: <span class="self">self</span>.<span class="ident">urlencoder</span>,
})
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_tuple_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTupleStruct</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_tuple_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTupleVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
<span class="doccomment">/// Serializes a map, given length is ignored.</span>
<span class="kw">fn</span> <span class="ident">serialize_map</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeMap</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">MapSerializer</span> {
<span class="ident">urlencoder</span>: <span class="self">self</span>.<span class="ident">urlencoder</span>,
<span class="ident">key</span>: <span class="prelude-val">None</span>,
})
}
<span class="doccomment">/// Serializes a struct, given length is ignored.</span>
<span class="kw">fn</span> <span class="ident">serialize_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStruct</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">StructSerializer</span> {
<span class="ident">urlencoder</span>: <span class="self">self</span>.<span class="ident">urlencoder</span>,
})
}
<span class="doccomment">/// Returns an error.</span>
<span class="kw">fn</span> <span class="ident">serialize_struct_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStructVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">top_level</span>())
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeSeq</span> <span class="kw">for</span> <span class="ident">SeqSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_element</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">pair</span>::<span class="ident">PairSerializer</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>))
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>)
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeTuple</span> <span class="kw">for</span> <span class="ident">TupleSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_element</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">pair</span>::<span class="ident">PairSerializer</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>))
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>)
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeTupleStruct</span>
<span class="kw">for</span> <span class="ident">TupleStructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_field</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">serialize_field</span>(<span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">end</span>()
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeTupleVariant</span>
<span class="kw">for</span> <span class="ident">TupleVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_field</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">serialize_field</span>(<span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">end</span>()
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeMap</span> <span class="kw">for</span> <span class="ident">MapSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_entry</span><span class="op">&lt;</span><span class="ident">K</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span>, <span class="ident">V</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="ident">K</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">V</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">key_sink</span> <span class="op">=</span> <span class="ident">key</span>::<span class="ident">KeySink</span>::<span class="ident">new</span>(<span class="op">|</span><span class="ident">key</span><span class="op">|</span> {
<span class="kw">let</span> <span class="ident">value_sink</span> <span class="op">=</span> <span class="ident">value</span>::<span class="ident">ValueSink</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>, <span class="kw-2">&amp;</span><span class="ident">key</span>);
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">part</span>::<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">value_sink</span>))<span class="question-mark">?</span>;
<span class="self">self</span>.<span class="ident">key</span> <span class="op">=</span> <span class="prelude-val">None</span>;
<span class="prelude-val">Ok</span>(())
});
<span class="kw">let</span> <span class="ident">entry_serializer</span> <span class="op">=</span> <span class="ident">part</span>::<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">key_sink</span>);
<span class="ident">key</span>.<span class="ident">serialize</span>(<span class="ident">entry_serializer</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_key</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">key_sink</span> <span class="op">=</span> <span class="ident">key</span>::<span class="ident">KeySink</span>::<span class="ident">new</span>(<span class="op">|</span><span class="ident">key</span><span class="op">|</span> <span class="prelude-val">Ok</span>(<span class="ident">key</span>.<span class="ident">into</span>()));
<span class="kw">let</span> <span class="ident">key_serializer</span> <span class="op">=</span> <span class="ident">part</span>::<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">key_sink</span>);
<span class="self">self</span>.<span class="ident">key</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">key</span>.<span class="ident">serialize</span>(<span class="ident">key_serializer</span>)<span class="question-mark">?</span>);
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">serialize_value</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
{
<span class="kw">let</span> <span class="ident">key</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">key</span>.<span class="ident">as_ref</span>().<span class="ident">ok_or_else</span>(<span class="ident">Error</span>::<span class="ident">no_key</span>)<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">value_sink</span> <span class="op">=</span> <span class="ident">value</span>::<span class="ident">ValueSink</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>, <span class="kw-2">&amp;</span><span class="ident">key</span>);
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">part</span>::<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">value_sink</span>))<span class="question-mark">?</span>;
}
<span class="self">self</span>.<span class="ident">key</span> <span class="op">=</span> <span class="prelude-val">None</span>;
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>)
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeStruct</span> <span class="kw">for</span> <span class="ident">StructSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_field</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">value_sink</span> <span class="op">=</span> <span class="ident">value</span>::<span class="ident">ValueSink</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>, <span class="ident">key</span>);
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">part</span>::<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">value_sink</span>))
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>)
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeStructVariant</span>
<span class="kw">for</span> <span class="ident">StructVariantSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;output</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;output</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;output</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_field</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">serialize_field</span>(<span class="ident">key</span>, <span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">end</span>()
}
}
<span class="kw">impl</span> <span class="ident">Error</span> {
<span class="kw">fn</span> <span class="ident">top_level</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> <span class="ident">msg</span> <span class="op">=</span> <span class="string">&quot;top-level serializer supports only maps and structs&quot;</span>;
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="ident">msg</span>.<span class="ident">into</span>())
}
<span class="kw">fn</span> <span class="ident">no_key</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> <span class="ident">msg</span> <span class="op">=</span> <span class="string">&quot;tried to serialize a value before serializing key&quot;</span>;
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="ident">msg</span>.<span class="ident">into</span>())
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

481
static/api/actix-web/stable/src/actix_web/serde_urlencoded/ser/pair.rs.html
View File

@ -1,481 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/ser/pair.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>pair.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">key</span>::<span class="ident">KeySink</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">part</span>::<span class="ident">PartSerializer</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">value</span>::<span class="ident">ValueSink</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">ser</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">borrow</span>::<span class="ident">Cow</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">mem</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Serializer</span> <span class="kw">as</span> <span class="ident">UrlEncodedSerializer</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Target</span> <span class="kw">as</span> <span class="ident">UrlEncodedTarget</span>;
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">PairSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span><span class="op">&gt;</span> {
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;target</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
<span class="ident">state</span>: <span class="ident">PairState</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">PairSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;target</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">PairSerializer</span> {
<span class="ident">urlencoder</span>,
<span class="ident">state</span>: <span class="ident">PairState</span>::<span class="ident">WaitingForKey</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">Serializer</span> <span class="kw">for</span> <span class="ident">PairSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">SerializeSeq</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTuple</span> <span class="op">=</span> <span class="self">Self</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleStruct</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleVariant</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeMap</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStruct</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStructVariant</span> <span class="op">=</span> <span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_bool</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_i8</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_i16</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_i32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_i64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">i64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_u8</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_u16</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_u32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_u64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">u64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_f32</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">f32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_f64</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">f64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_char</span>(<span class="self">self</span>, <span class="ident">_v</span>: <span class="ident">char</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_bytes</span>(<span class="self">self</span>, <span class="ident">_value</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_unit</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_unit_struct</span>(<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_unit_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_newtype_struct</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="self">self</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_newtype_variant</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="self">self</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_seq</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeSeq</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_tuple</span>(<span class="self">self</span>, <span class="ident">len</span>: <span class="ident">usize</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="ident">len</span> <span class="op">==</span> <span class="number">2</span> {
<span class="prelude-val">Ok</span>(<span class="self">self</span>)
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
}
<span class="kw">fn</span> <span class="ident">serialize_tuple_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTupleStruct</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_tuple_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTupleVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_map</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeMap</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStruct</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_struct_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStructVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">unsupported_pair</span>())
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ser</span>::<span class="ident">SerializeTuple</span> <span class="kw">for</span> <span class="ident">PairSerializer</span><span class="op">&lt;</span><span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">serialize_element</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">state</span>, <span class="ident">PairState</span>::<span class="ident">Done</span>) {
<span class="ident">PairState</span>::<span class="ident">WaitingForKey</span> <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">key_sink</span> <span class="op">=</span> <span class="ident">KeySink</span>::<span class="ident">new</span>(<span class="op">|</span><span class="ident">key</span><span class="op">|</span> <span class="prelude-val">Ok</span>(<span class="ident">key</span>.<span class="ident">into</span>()));
<span class="kw">let</span> <span class="ident">key_serializer</span> <span class="op">=</span> <span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">key_sink</span>);
<span class="self">self</span>.<span class="ident">state</span> <span class="op">=</span> <span class="ident">PairState</span>::<span class="ident">WaitingForValue</span> {
<span class="ident">key</span>: <span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">key_serializer</span>)<span class="question-mark">?</span>,
};
<span class="prelude-val">Ok</span>(())
}
<span class="ident">PairState</span>::<span class="ident">WaitingForValue</span> { <span class="ident">key</span> } <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> {
<span class="kw">let</span> <span class="ident">value_sink</span> <span class="op">=</span> <span class="ident">ValueSink</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">urlencoder</span>, <span class="kw-2">&amp;</span><span class="ident">key</span>);
<span class="kw">let</span> <span class="ident">value_serializer</span> <span class="op">=</span> <span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="ident">value_sink</span>);
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">value_serializer</span>)
};
<span class="kw">if</span> <span class="ident">result</span>.<span class="ident">is_ok</span>() {
<span class="self">self</span>.<span class="ident">state</span> <span class="op">=</span> <span class="ident">PairState</span>::<span class="ident">Done</span>;
} <span class="kw">else</span> {
<span class="self">self</span>.<span class="ident">state</span> <span class="op">=</span> <span class="ident">PairState</span>::<span class="ident">WaitingForValue</span> { <span class="ident">key</span> };
}
<span class="ident">result</span>
}
<span class="ident">PairState</span>::<span class="ident">Done</span> <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">done</span>()),
}
}
<span class="kw">fn</span> <span class="ident">end</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">PairState</span>::<span class="ident">Done</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">state</span> {
<span class="prelude-val">Ok</span>(())
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">not_done</span>())
}
}
}
<span class="kw">enum</span> <span class="ident">PairState</span> {
<span class="ident">WaitingForKey</span>,
<span class="ident">WaitingForValue</span> { <span class="ident">key</span>: <span class="ident">Cow</span><span class="op">&lt;</span><span class="lifetime">&#39;static</span>, <span class="ident">str</span><span class="op">&gt;</span> },
<span class="ident">Done</span>,
}
<span class="kw">impl</span> <span class="ident">Error</span> {
<span class="kw">fn</span> <span class="ident">done</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="string">&quot;this pair has already been serialized&quot;</span>.<span class="ident">into</span>())
}
<span class="kw">fn</span> <span class="ident">not_done</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="string">&quot;this pair has not yet been serialized&quot;</span>.<span class="ident">into</span>())
}
<span class="kw">fn</span> <span class="ident">unsupported_pair</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="string">&quot;unsupported pair&quot;</span>.<span class="ident">into</span>())
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

405
static/api/actix-web/stable/src/actix_web/serde_urlencoded/ser/part.rs.html
View File

@ -1,405 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/ser/part.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>part.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">serde</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">dtoa</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">itoa</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">str</span>;
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">PartSerializer</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="ident">sink</span>: <span class="ident">S</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="ident">Sink</span><span class="op">&gt;</span> <span class="ident">PartSerializer</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">sink</span>: <span class="ident">S</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">PartSerializer</span> { <span class="ident">sink</span> }
}
}
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">Sink</span>: <span class="ident">Sized</span> {
<span class="kw">type</span> <span class="prelude-val">Ok</span>;
<span class="kw">fn</span> <span class="ident">serialize_static_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_string</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="ident">String</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">unsupported</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Error</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="ident">Sink</span><span class="op">&gt;</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serializer</span> <span class="kw">for</span> <span class="ident">PartSerializer</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> <span class="ident">S</span>::<span class="prelude-val">Ok</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">SerializeSeq</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTuple</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleStruct</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeTupleVariant</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeMap</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStruct</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">SerializeStructVariant</span> <span class="op">=</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Impossible</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">serialize_bool</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>
.<span class="ident">serialize_static_str</span>(<span class="kw">if</span> <span class="ident">v</span> { <span class="string">&quot;true&quot;</span> } <span class="kw">else</span> { <span class="string">&quot;false&quot;</span> })
}
<span class="kw">fn</span> <span class="ident">serialize_i8</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">i8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_i16</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">i16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_i32</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">i32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_i64</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">i64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_u8</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">u8</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_u16</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">u16</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_u32</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">u32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_u64</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">u64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_integer</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_f32</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">f32</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_floating</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_f64</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">f64</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_floating</span>(<span class="ident">v</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_char</span>(<span class="self">self</span>, <span class="ident">v</span>: <span class="ident">char</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_string</span>(<span class="ident">v</span>.<span class="ident">to_string</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_str</span>(<span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_bytes</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="ident">str</span>::<span class="ident">from_utf8</span>(<span class="ident">value</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">value</span>) <span class="op">=&gt;</span> <span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_str</span>(<span class="ident">value</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">Error</span>::<span class="ident">Utf8</span>(<span class="ident">err</span>)),
}
}
<span class="kw">fn</span> <span class="ident">serialize_unit</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_unit_struct</span>(<span class="self">self</span>, <span class="ident">name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_static_str</span>(<span class="ident">name</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_unit_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_static_str</span>(<span class="ident">variant</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_newtype_struct</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="self">self</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_newtype_variant</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_none</span>()
}
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">serialize_some</span>(<span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_seq</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeSeq</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_tuple</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="ident">usize</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTuple</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_tuple_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTuple</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_tuple_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeTupleVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_map</span>(<span class="self">self</span>, <span class="ident">_len</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeMap</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_struct</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStruct</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
<span class="kw">fn</span> <span class="ident">serialize_struct_variant</span>(
<span class="self">self</span>, <span class="ident">_name</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>, <span class="ident">_variant_index</span>: <span class="ident">u32</span>, <span class="ident">_variant</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>,
<span class="ident">_len</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">SerializeStructVariant</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Err</span>(<span class="self">self</span>.<span class="ident">sink</span>.<span class="ident">unsupported</span>())
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="ident">Sink</span><span class="op">&gt;</span> <span class="ident">PartSerializer</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">serialize_integer</span><span class="op">&lt;</span><span class="ident">I</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="ident">I</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">I</span>: <span class="ident">itoa</span>::<span class="ident">Integer</span>,
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> [<span class="string">b&#39;\0&#39;</span>; <span class="number">20</span>];
<span class="kw">let</span> <span class="ident">len</span> <span class="op">=</span> <span class="ident">itoa</span>::<span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf</span>[..], <span class="ident">value</span>).<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">part</span> <span class="op">=</span> <span class="kw">unsafe</span> { <span class="ident">str</span>::<span class="ident">from_utf8_unchecked</span>(<span class="kw-2">&amp;</span><span class="ident">buf</span>[<span class="number">0</span>..<span class="ident">len</span>]) };
<span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serializer</span>::<span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">part</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_floating</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">S</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">dtoa</span>::<span class="ident">Floating</span>,
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> [<span class="string">b&#39;\0&#39;</span>; <span class="number">24</span>];
<span class="kw">let</span> <span class="ident">len</span> <span class="op">=</span> <span class="ident">dtoa</span>::<span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf</span>[..], <span class="ident">value</span>).<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">part</span> <span class="op">=</span> <span class="kw">unsafe</span> { <span class="ident">str</span>::<span class="ident">from_utf8_unchecked</span>(<span class="kw-2">&amp;</span><span class="ident">buf</span>[<span class="number">0</span>..<span class="ident">len</span>]) };
<span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serializer</span>::<span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">part</span>)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

121
static/api/actix-web/stable/src/actix_web/serde_urlencoded/ser/value.rs.html
View File

@ -1,121 +0,0 @@
<!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="Source to the Rust file `src/serde_urlencoded/ser/value.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>value.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<span id="25">25</span>
<span id="26">26</span>
<span id="27">27</span>
<span id="28">28</span>
<span id="29">29</span>
<span id="30">30</span>
<span id="31">31</span>
<span id="32">32</span>
<span id="33">33</span>
<span id="34">34</span>
<span id="35">35</span>
<span id="36">36</span>
<span id="37">37</span>
<span id="38">38</span>
<span id="39">39</span>
<span id="40">40</span>
<span id="41">41</span>
<span id="42">42</span>
<span id="43">43</span>
<span id="44">44</span>
<span id="45">45</span>
<span id="46">46</span>
<span id="47">47</span>
<span id="48">48</span>
<span id="49">49</span>
<span id="50">50</span>
<span id="51">51</span>
<span id="52">52</span>
<span id="53">53</span>
<span id="54">54</span>
<span id="55">55</span>
<span id="56">56</span>
<span id="57">57</span>
<span id="58">58</span>
<span id="59">59</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">part</span>::{<span class="ident">PartSerializer</span>, <span class="ident">Sink</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw">super</span>::<span class="ident">ser</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">serde</span>::<span class="ident">ser</span>::<span class="ident">Serialize</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">str</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Serializer</span> <span class="kw">as</span> <span class="ident">UrlEncodedSerializer</span>;
<span class="kw">use</span> <span class="ident">url</span>::<span class="ident">form_urlencoded</span>::<span class="ident">Target</span> <span class="kw">as</span> <span class="ident">UrlEncodedTarget</span>;
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ValueSink</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;target</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>,
<span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;key</span> <span class="ident">str</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">ValueSink</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">urlencoder</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;target</span> <span class="kw-2">mut</span> <span class="ident">UrlEncodedSerializer</span><span class="op">&lt;</span><span class="ident">Target</span><span class="op">&gt;</span>, <span class="ident">key</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;key</span> <span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ValueSink</span> { <span class="ident">urlencoder</span>, <span class="ident">key</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span> <span class="ident">Sink</span> <span class="kw">for</span> <span class="ident">ValueSink</span><span class="op">&lt;</span><span class="lifetime">&#39;key</span>, <span class="lifetime">&#39;target</span>, <span class="ident">Target</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">Target</span>: <span class="lifetime">&#39;target</span> <span class="op">+</span> <span class="ident">UrlEncodedTarget</span>,
{
<span class="kw">type</span> <span class="prelude-val">Ok</span> <span class="op">=</span> ();
<span class="kw">fn</span> <span class="ident">serialize_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">urlencoder</span>.<span class="ident">append_pair</span>(<span class="self">self</span>.<span class="ident">key</span>, <span class="ident">value</span>);
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">serialize_static_str</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_str</span>(<span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_string</span>(<span class="self">self</span>, <span class="ident">value</span>: <span class="ident">String</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">serialize_str</span>(<span class="kw-2">&amp;</span><span class="ident">value</span>)
}
<span class="kw">fn</span> <span class="ident">serialize_none</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="kw">fn</span> <span class="ident">serialize_some</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="question-mark">?</span><span class="ident">Sized</span> <span class="op">+</span> <span class="ident">Serialize</span><span class="op">&gt;</span>(
<span class="self">self</span>, <span class="ident">value</span>: <span class="kw-2">&amp;</span><span class="ident">T</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="prelude-val">Ok</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="ident">value</span>.<span class="ident">serialize</span>(<span class="ident">PartSerializer</span>::<span class="ident">new</span>(<span class="self">self</span>))
}
<span class="kw">fn</span> <span class="ident">unsupported</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Error</span> {
<span class="ident">Error</span>::<span class="ident">Custom</span>(<span class="string">&quot;unsupported value&quot;</span>.<span class="ident">into</span>())
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

769
static/api/actix-web/stable/src/actix_web/server/acceptor.rs.html Normal file
View File

@ -0,0 +1,769 @@
<!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="Source to the Rust file `src/server/acceptor.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>acceptor.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
<span id="240">240</span>
<span id="241">241</span>
<span id="242">242</span>
<span id="243">243</span>
<span id="244">244</span>
<span id="245">245</span>
<span id="246">246</span>
<span id="247">247</span>
<span id="248">248</span>
<span id="249">249</span>
<span id="250">250</span>
<span id="251">251</span>
<span id="252">252</span>
<span id="253">253</span>
<span id="254">254</span>
<span id="255">255</span>
<span id="256">256</span>
<span id="257">257</span>
<span id="258">258</span>
<span id="259">259</span>
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
<span id="285">285</span>
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
<span id="295">295</span>
<span id="296">296</span>
<span id="297">297</span>
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
<span id="306">306</span>
<span id="307">307</span>
<span id="308">308</span>
<span id="309">309</span>
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
<span id="365">365</span>
<span id="366">366</span>
<span id="367">367</span>
<span id="368">368</span>
<span id="369">369</span>
<span id="370">370</span>
<span id="371">371</span>
<span id="372">372</span>
<span id="373">373</span>
<span id="374">374</span>
<span id="375">375</span>
<span id="376">376</span>
<span id="377">377</span>
<span id="378">378</span>
<span id="379">379</span>
<span id="380">380</span>
<span id="381">381</span>
<span id="382">382</span>
<span id="383">383</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">time</span>::<span class="ident">Duration</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">fmt</span>, <span class="ident">net</span>};
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">server</span>::<span class="ident">ServerMessage</span>;
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">service</span>::{<span class="ident">NewService</span>, <span class="ident">Service</span>};
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">future</span>::{<span class="ident">err</span>, <span class="ident">ok</span>, <span class="ident">Either</span>, <span class="ident">FutureResult</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Future</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">tokio_reactor</span>::<span class="ident">Handle</span>;
<span class="kw">use</span> <span class="ident">tokio_tcp</span>::<span class="ident">TcpStream</span>;
<span class="kw">use</span> <span class="ident">tokio_timer</span>::{<span class="ident">sleep</span>, <span class="ident">Delay</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::<span class="ident">AcceptorError</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">IoStream</span>;
<span class="doccomment">/// This trait indicates types that can create acceptor service for http server.</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">AcceptorServiceFactory</span>: <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> {
<span class="kw">type</span> <span class="ident">Io</span>: <span class="ident">IoStream</span> <span class="op">+</span> <span class="ident">Send</span>;
<span class="kw">type</span> <span class="ident">NewService</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>, <span class="ident">Response</span> <span class="op">=</span> <span class="self">Self</span>::<span class="ident">Io</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">create</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">NewService</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">T</span><span class="op">&gt;</span> <span class="ident">AcceptorServiceFactory</span> <span class="kw">for</span> <span class="ident">F</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">T</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>::<span class="ident">Response</span>: <span class="ident">IoStream</span> <span class="op">+</span> <span class="ident">Send</span>,
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span><span class="op">&gt;</span>,
<span class="ident">T</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="kw">type</span> <span class="ident">Io</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">NewService</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">fn</span> <span class="ident">create</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">T</span> {
(<span class="self">self</span>)()
}
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Clone</span>)]</span>
<span class="doccomment">/// Default acceptor service convert `TcpStream` to a `tokio_tcp::TcpStream`</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">DefaultAcceptor</span>;
<span class="kw">impl</span> <span class="ident">AcceptorServiceFactory</span> <span class="kw">for</span> <span class="ident">DefaultAcceptor</span> {
<span class="kw">type</span> <span class="ident">Io</span> <span class="op">=</span> <span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">NewService</span> <span class="op">=</span> <span class="ident">DefaultAcceptor</span>;
<span class="kw">fn</span> <span class="ident">create</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">NewService</span> {
<span class="ident">DefaultAcceptor</span>
}
}
<span class="kw">impl</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">DefaultAcceptor</span> {
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">DefaultAcceptor</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Service</span>, <span class="self">Self</span>::<span class="ident">InitError</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ok</span>(<span class="ident">DefaultAcceptor</span>)
}
}
<span class="kw">impl</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">DefaultAcceptor</span> {
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Response</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ok</span>(<span class="ident">req</span>)
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">TcpAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">TcpAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;&gt;</span>,
<span class="ident">T</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">inner</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">TcpAcceptor</span> { <span class="ident">inner</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">TcpAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;&gt;</span>,
<span class="ident">T</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">TcpAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">TcpAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">TcpAcceptorResponse</span> {
<span class="ident">fut</span>: <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">new_service</span>(),
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">TcpAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span><span class="op">&gt;</span>,
<span class="ident">T</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="ident">fut</span>: <span class="ident">T</span>::<span class="ident">Future</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">TcpAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span><span class="op">&gt;</span>,
<span class="ident">T</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> <span class="ident">TcpAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">fut</span>.<span class="ident">poll</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">service</span>)) <span class="op">=&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">TcpAcceptorService</span> { <span class="ident">inner</span>: <span class="ident">service</span> }))
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not create accetor service: {:?}&quot;</span>, <span class="ident">e</span>);
<span class="prelude-val">Err</span>(<span class="ident">e</span>)
}
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">TcpAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">TcpAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">Service</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">TcpStream</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;&gt;</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">Either</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Future</span>, <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Response</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">poll_ready</span>()
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="kw">let</span> <span class="ident">stream</span> <span class="op">=</span> <span class="ident">TcpStream</span>::<span class="ident">from_std</span>(<span class="ident">req</span>, <span class="kw-2">&amp;</span><span class="ident">Handle</span>::<span class="ident">default</span>()).<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not convert to an async tcp stream: {}&quot;</span>, <span class="ident">e</span>);
<span class="ident">AcceptorError</span>::<span class="ident">Io</span>(<span class="ident">e</span>)
});
<span class="kw">match</span> <span class="ident">stream</span> {
<span class="prelude-val">Ok</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> <span class="ident">Either</span>::<span class="ident">A</span>(<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">call</span>(<span class="ident">stream</span>)),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">err</span>(<span class="ident">e</span>)),
}
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="doccomment">/// Acceptor timeout middleware</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Applies timeout to request prcoessing.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">AcceptorTimeout</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
<span class="ident">timeout</span>: <span class="ident">Duration</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&gt;</span> <span class="ident">AcceptorTimeout</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create new `AcceptorTimeout` instance. timeout is in milliseconds.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">timeout</span>: <span class="ident">u64</span>, <span class="ident">inner</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">Self</span> {
<span class="ident">inner</span>,
<span class="ident">timeout</span>: <span class="ident">Duration</span>::<span class="ident">from_millis</span>(<span class="ident">timeout</span>),
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">AcceptorTimeout</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Request</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">AcceptorTimeoutService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">AcceptorTimeoutFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">AcceptorTimeoutFut</span> {
<span class="ident">fut</span>: <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">new_service</span>(),
<span class="ident">timeout</span>: <span class="self">self</span>.<span class="ident">timeout</span>,
}
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">AcceptorTimeoutFut</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&gt;</span> {
<span class="ident">fut</span>: <span class="ident">T</span>::<span class="ident">Future</span>,
<span class="ident">timeout</span>: <span class="ident">Duration</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">AcceptorTimeoutFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> <span class="ident">AcceptorTimeoutService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">inner</span> <span class="op">=</span> <span class="macro">try_ready</span><span class="macro">!</span>(<span class="self">self</span>.<span class="ident">fut</span>.<span class="ident">poll</span>());
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">AcceptorTimeoutService</span> {
<span class="ident">inner</span>,
<span class="ident">timeout</span>: <span class="self">self</span>.<span class="ident">timeout</span>,
}))
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="doccomment">/// Acceptor timeout service</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Applies timeout to request prcoessing.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">AcceptorTimeoutService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
<span class="ident">timeout</span>: <span class="ident">Duration</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Service</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">AcceptorTimeoutService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Request</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">AcceptorTimeoutResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">poll_ready</span>().<span class="ident">map_err</span>(<span class="ident">AcceptorError</span>::<span class="ident">Service</span>)
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">AcceptorTimeoutResponse</span> {
<span class="ident">fut</span>: <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">call</span>(<span class="ident">req</span>),
<span class="ident">sleep</span>: <span class="ident">sleep</span>(<span class="self">self</span>.<span class="ident">timeout</span>),
}
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">AcceptorTimeoutResponse</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Service</span><span class="op">&gt;</span> {
<span class="ident">fut</span>: <span class="ident">T</span>::<span class="ident">Future</span>,
<span class="ident">sleep</span>: <span class="ident">Delay</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Service</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">AcceptorTimeoutResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Response</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Error</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">fut</span>.<span class="ident">poll</span>().<span class="ident">map_err</span>(<span class="ident">AcceptorError</span>::<span class="ident">Service</span>)<span class="question-mark">?</span> {
<span class="ident">Async</span>::<span class="ident">NotReady</span> <span class="op">=&gt;</span> <span class="kw">match</span> <span class="self">self</span>.<span class="ident">sleep</span>.<span class="ident">poll</span>() {
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">AcceptorError</span>::<span class="ident">Timeout</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">AcceptorError</span>::<span class="ident">Timeout</span>),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
},
<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">resp</span>)),
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ServerMessageAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">ServerMessageAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
{
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">inner</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ServerMessageAcceptor</span> { <span class="ident">inner</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">ServerMessageAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">ServerMessage</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">ServerMessageAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">ServerMessageAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ServerMessageAcceptorResponse</span> {
<span class="ident">fut</span>: <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">new_service</span>(),
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ServerMessageAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
{
<span class="ident">fut</span>: <span class="ident">T</span>::<span class="ident">Future</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">ServerMessageAcceptorResponse</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">NewService</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
{
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> <span class="ident">ServerMessageAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Service</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">InitError</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">fut</span>.<span class="ident">poll</span>()<span class="question-mark">?</span> {
<span class="ident">Async</span>::<span class="ident">NotReady</span> <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">service</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">ServerMessageAcceptorService</span> {
<span class="ident">inner</span>: <span class="ident">service</span>,
})),
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ServerMessageAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">inner</span>: <span class="ident">T</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">ServerMessageAcceptorService</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">Service</span><span class="op">&lt;</span><span class="ident">Request</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">ServerMessage</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Error</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span>
<span class="ident">Either</span><span class="op">&lt;</span><span class="ident">ServerMessageAcceptorServiceFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>, <span class="ident">FutureResult</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">poll_ready</span>()
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="kw">match</span> <span class="ident">req</span> {
<span class="ident">ServerMessage</span>::<span class="ident">Connect</span>(<span class="ident">stream</span>) <span class="op">=&gt;</span> {
<span class="ident">Either</span>::<span class="ident">A</span>(<span class="ident">ServerMessageAcceptorServiceFut</span> {
<span class="ident">fut</span>: <span class="self">self</span>.<span class="ident">inner</span>.<span class="ident">call</span>(<span class="ident">stream</span>),
})
}
<span class="ident">ServerMessage</span>::<span class="ident">Shutdown</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">ok</span>(())),
<span class="ident">ServerMessage</span>::<span class="ident">ForceShutdown</span> <span class="op">=&gt;</span> {
<span class="comment">// self.settings</span>
<span class="comment">// .head()</span>
<span class="comment">// .traverse(|proto: &amp;mut HttpProtocol&lt;TcpStream, H&gt;| proto.shutdown());</span>
<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">ok</span>(()))
}
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ServerMessageAcceptorServiceFut</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Service</span><span class="op">&gt;</span> {
<span class="ident">fut</span>: <span class="ident">T</span>::<span class="ident">Future</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">ServerMessageAcceptorServiceFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">Service</span>,
{
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">T</span>::<span class="ident">Error</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">fut</span>.<span class="ident">poll</span>()<span class="question-mark">?</span> {
<span class="ident">Async</span>::<span class="ident">NotReady</span> <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(())),
}
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

233
static/api/actix-web/stable/src/actix_web/server/builder.rs.html Normal file
View File

@ -0,0 +1,233 @@
<!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="Source to the Rust file `src/server/builder.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>builder.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">fmt</span>, <span class="ident">net</span>};
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">either</span>::<span class="ident">Either</span>;
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">server</span>::{<span class="ident">Server</span>, <span class="ident">ServiceFactory</span>};
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">service</span>::{<span class="ident">NewService</span>, <span class="ident">NewServiceExt</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">acceptor</span>::{
<span class="ident">AcceptorServiceFactory</span>, <span class="ident">AcceptorTimeout</span>, <span class="ident">ServerMessageAcceptor</span>, <span class="ident">TcpAcceptor</span>,
};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::<span class="ident">AcceptorError</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">handler</span>::<span class="ident">IntoHttpHandler</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">service</span>::<span class="ident">HttpService</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::{<span class="ident">ServerSettings</span>, <span class="ident">ServiceConfig</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">KeepAlive</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">trait</span> <span class="ident">ServiceProvider</span> {
<span class="kw">fn</span> <span class="ident">register</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">server</span>: <span class="ident">Server</span>, <span class="ident">lst</span>: <span class="ident">net</span>::<span class="ident">TcpListener</span>, <span class="ident">host</span>: <span class="ident">String</span>,
<span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>, <span class="ident">secure</span>: <span class="ident">bool</span>, <span class="ident">client_timeout</span>: <span class="ident">u64</span>,
<span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
) <span class="op">-&gt;</span> <span class="ident">Server</span>;
}
<span class="doccomment">/// Utility type that builds complete http pipeline</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">HttpServiceBuilder</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span>, <span class="ident">A</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span>,
{
<span class="ident">factory</span>: <span class="ident">F</span>,
<span class="ident">acceptor</span>: <span class="ident">A</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span>, <span class="ident">A</span><span class="op">&gt;</span> <span class="ident">HttpServiceBuilder</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span>, <span class="ident">A</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">H</span>: <span class="ident">IntoHttpHandler</span>,
<span class="ident">A</span>: <span class="ident">AcceptorServiceFactory</span>,
<span class="op">&lt;</span><span class="ident">A</span>::<span class="ident">NewService</span> <span class="kw">as</span> <span class="ident">NewService</span><span class="op">&gt;</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
{
<span class="doccomment">/// Create http service builder</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">factory</span>: <span class="ident">F</span>, <span class="ident">acceptor</span>: <span class="ident">A</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">Self</span> { <span class="ident">factory</span>, <span class="ident">acceptor</span> }
}
<span class="kw">fn</span> <span class="ident">finish</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">host</span>: <span class="ident">String</span>, <span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>, <span class="ident">secure</span>: <span class="ident">bool</span>,
<span class="ident">client_timeout</span>: <span class="ident">u64</span>, <span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
) <span class="op">-&gt;</span> <span class="kw">impl</span> <span class="ident">ServiceFactory</span> {
<span class="kw">let</span> <span class="ident">factory</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">factory</span>.<span class="ident">clone</span>();
<span class="kw">let</span> <span class="ident">acceptor</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">acceptor</span>.<span class="ident">clone</span>();
<span class="kw">move</span> <span class="op">||</span> {
<span class="kw">let</span> <span class="ident">app</span> <span class="op">=</span> (<span class="ident">factory</span>)().<span class="ident">into_handler</span>();
<span class="kw">let</span> <span class="ident">settings</span> <span class="op">=</span> <span class="ident">ServiceConfig</span>::<span class="ident">new</span>(
<span class="ident">app</span>,
<span class="ident">keep_alive</span>,
<span class="ident">client_timeout</span>,
<span class="ident">client_shutdown</span>,
<span class="ident">ServerSettings</span>::<span class="ident">new</span>(<span class="ident">addr</span>, <span class="kw-2">&amp;</span><span class="ident">host</span>, <span class="bool-val">false</span>),
);
<span class="kw">if</span> <span class="ident">secure</span> {
<span class="ident">Either</span>::<span class="ident">B</span>(<span class="ident">ServerMessageAcceptor</span>::<span class="ident">new</span>(
<span class="ident">TcpAcceptor</span>::<span class="ident">new</span>(<span class="ident">AcceptorTimeout</span>::<span class="ident">new</span>(
<span class="ident">client_timeout</span>,
<span class="ident">acceptor</span>.<span class="ident">create</span>(),
)).<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">map_init_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">and_then</span>(
<span class="ident">HttpService</span>::<span class="ident">new</span>(<span class="ident">settings</span>)
.<span class="ident">map_init_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ()),
),
))
} <span class="kw">else</span> {
<span class="ident">Either</span>::<span class="ident">A</span>(<span class="ident">ServerMessageAcceptor</span>::<span class="ident">new</span>(
<span class="ident">TcpAcceptor</span>::<span class="ident">new</span>(<span class="ident">acceptor</span>.<span class="ident">create</span>().<span class="ident">map_err</span>(<span class="ident">AcceptorError</span>::<span class="ident">Service</span>))
.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">map_init_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">and_then</span>(
<span class="ident">HttpService</span>::<span class="ident">new</span>(<span class="ident">settings</span>)
.<span class="ident">map_init_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ()),
),
))
}
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span>, <span class="ident">A</span><span class="op">&gt;</span> <span class="ident">ServiceProvider</span> <span class="kw">for</span> <span class="ident">HttpServiceBuilder</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span>, <span class="ident">A</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">A</span>: <span class="ident">AcceptorServiceFactory</span>,
<span class="op">&lt;</span><span class="ident">A</span>::<span class="ident">NewService</span> <span class="kw">as</span> <span class="ident">NewService</span><span class="op">&gt;</span>::<span class="ident">InitError</span>: <span class="ident">fmt</span>::<span class="ident">Debug</span>,
<span class="ident">H</span>: <span class="ident">IntoHttpHandler</span>,
{
<span class="kw">fn</span> <span class="ident">register</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">server</span>: <span class="ident">Server</span>, <span class="ident">lst</span>: <span class="ident">net</span>::<span class="ident">TcpListener</span>, <span class="ident">host</span>: <span class="ident">String</span>,
<span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>, <span class="ident">secure</span>: <span class="ident">bool</span>, <span class="ident">client_timeout</span>: <span class="ident">u64</span>,
<span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
) <span class="op">-&gt;</span> <span class="ident">Server</span> {
<span class="ident">server</span>.<span class="ident">listen2</span>(
<span class="string">&quot;actix-web&quot;</span>,
<span class="ident">lst</span>,
<span class="self">self</span>.<span class="ident">finish</span>(
<span class="ident">host</span>,
<span class="ident">addr</span>,
<span class="ident">keep_alive</span>,
<span class="ident">secure</span>,
<span class="ident">client_timeout</span>,
<span class="ident">client_shutdown</span>,
),
)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

350
static/api/actix-web/stable/src/actix_web/server/channel.rs.html
View File

@ -298,74 +298,47 @@
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
<span id="306">306</span>
<span id="307">307</span>
<span id="308">308</span>
<span id="309">309</span>
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::{<span class="ident">Shutdown</span>, <span class="ident">SocketAddr</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">ptr</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::<span class="ident">Shutdown</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">mem</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Buf</span>, <span class="ident">BufMut</span>, <span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Buf</span>, <span class="ident">BufMut</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Future</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">tokio_io</span>::{<span class="ident">AsyncRead</span>, <span class="ident">AsyncWrite</span>};
<span class="kw">use</span> <span class="ident">tokio_timer</span>::<span class="ident">Delay</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">WorkerSettings</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::<span class="ident">HttpDispatchError</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">h1</span>, <span class="ident">h2</span>, <span class="ident">HttpHandler</span>, <span class="ident">IoStream</span>};
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">StatusCode</span>;
<span class="kw">const</span> <span class="ident">HTTP2_PREFACE</span>: [<span class="ident">u8</span>; <span class="number">14</span>] <span class="op">=</span> <span class="kw-2">*</span><span class="string">b&quot;PRI * HTTP/2.0&quot;</span>;
<span class="kw">enum</span> <span class="ident">HttpProtocol</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IoStream</span>, <span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> {
<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>),
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">HttpProtocol</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IoStream</span>, <span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> {
<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1Dispatcher</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>),
<span class="ident">H2</span>(<span class="ident">h2</span>::<span class="ident">Http2</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>),
<span class="ident">Unknown</span>(<span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">T</span>, <span class="ident">BytesMut</span>),
<span class="ident">Unknown</span>(<span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">T</span>, <span class="ident">BytesMut</span>),
<span class="prelude-val">None</span>,
}
<span class="comment">// impl&lt;T: IoStream, H: HttpHandler + &#39;static&gt; HttpProtocol&lt;T, H&gt; {</span>
<span class="comment">// fn shutdown_(&amp;mut self) {</span>
<span class="comment">// match self {</span>
<span class="comment">// HttpProtocol::H1(ref mut h1) =&gt; {</span>
<span class="comment">// let io = h1.io();</span>
<span class="comment">// let _ = IoStream::set_linger(io, Some(time::Duration::new(0, 0)));</span>
<span class="comment">// let _ = IoStream::shutdown(io, Shutdown::Both);</span>
<span class="comment">// }</span>
<span class="comment">// HttpProtocol::H2(ref mut h2) =&gt; h2.shutdown(),</span>
<span class="comment">// HttpProtocol::Unknown(_, io, _) =&gt; {</span>
<span class="comment">// let _ = IoStream::set_linger(io, Some(time::Duration::new(0, 0)));</span>
<span class="comment">// let _ = IoStream::shutdown(io, Shutdown::Both);</span>
<span class="comment">// }</span>
<span class="comment">// HttpProtocol::None =&gt; (),</span>
<span class="comment">// }</span>
<span class="comment">// }</span>
<span class="comment">// }</span>
<span class="kw">enum</span> <span class="ident">ProtocolKind</span> {
<span class="ident">Http1</span>,
<span class="ident">Http2</span>,
@ -377,8 +350,8 @@
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">proto</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">HttpProtocol</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">node</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Node</span><span class="op">&lt;</span><span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
<span class="ident">proto</span>: <span class="ident">HttpProtocol</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">ka_timeout</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>
@ -386,45 +359,12 @@
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>, <span class="kw-2">mut</span> <span class="ident">io</span>: <span class="ident">T</span>, <span class="ident">peer</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>,
<span class="ident">http2</span>: <span class="ident">bool</span>,
) <span class="op">-&gt;</span> <span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">settings</span>.<span class="ident">add_channel</span>();
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">set_nodelay</span>(<span class="bool-val">true</span>);
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">io</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">ka_timeout</span> <span class="op">=</span> <span class="ident">settings</span>.<span class="ident">client_timer</span>();
<span class="kw">if</span> <span class="ident">http2</span> {
<span class="ident">HttpChannel</span> {
<span class="ident">node</span>: <span class="prelude-val">None</span>,
<span class="ident">proto</span>: <span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="ident">h2</span>::<span class="ident">Http2</span>::<span class="ident">new</span>(
<span class="ident">settings</span>,
<span class="ident">io</span>,
<span class="ident">peer</span>,
<span class="ident">Bytes</span>::<span class="ident">new</span>(),
))),
}
} <span class="kw">else</span> {
<span class="ident">HttpChannel</span> {
<span class="ident">node</span>: <span class="prelude-val">None</span>,
<span class="ident">proto</span>: <span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(
<span class="ident">settings</span>,
<span class="ident">peer</span>,
<span class="ident">io</span>,
<span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="number">8192</span>),
)),
}
}
}
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">proto</span> {
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h1</span>)) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">io</span> <span class="op">=</span> <span class="ident">h1</span>.<span class="ident">io</span>();
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">IoStream</span>::<span class="ident">set_linger</span>(<span class="ident">io</span>, <span class="prelude-val">Some</span>(<span class="ident">time</span>::<span class="ident">Duration</span>::<span class="ident">new</span>(<span class="number">0</span>, <span class="number">0</span>)));
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">IoStream</span>::<span class="ident">shutdown</span>(<span class="ident">io</span>, <span class="ident">Shutdown</span>::<span class="ident">Both</span>);
}
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h2</span>)) <span class="op">=&gt;</span> <span class="ident">h2</span>.<span class="ident">shutdown</span>(),
<span class="kw">_</span> <span class="op">=&gt;</span> (),
<span class="ident">HttpChannel</span> {
<span class="ident">ka_timeout</span>,
<span class="ident">proto</span>: <span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="ident">settings</span>, <span class="ident">io</span>, <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="number">8192</span>)),
}
}
}
@ -435,70 +375,58 @@
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">node</span>.<span class="ident">is_some</span>() {
<span class="kw">let</span> <span class="ident">el</span> <span class="op">=</span> <span class="self">self</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>;
<span class="self">self</span>.<span class="ident">node</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">Node</span>::<span class="ident">new</span>(<span class="ident">el</span>));
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">self</span>.<span class="ident">proto</span> {
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h1</span>)) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">n</span><span class="op">|</span> <span class="ident">h1</span>.<span class="ident">settings</span>().<span class="ident">head</span>().<span class="ident">insert</span>(<span class="ident">n</span>))
<span class="comment">// keep-alive timer</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">ka_timeout</span>.<span class="ident">is_some</span>() {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">ka_timeout</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>().<span class="ident">poll</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Slow request timed out, close connection&quot;</span>);
<span class="kw">let</span> <span class="ident">proto</span> <span class="op">=</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">proto</span>, <span class="ident">HttpProtocol</span>::<span class="prelude-val">None</span>);
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="ident">settings</span>, <span class="ident">io</span>, <span class="ident">buf</span>) <span class="op">=</span> <span class="ident">proto</span> {
<span class="self">self</span>.<span class="ident">proto</span> <span class="op">=</span> <span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1Dispatcher</span>::<span class="ident">for_error</span>(
<span class="ident">settings</span>,
<span class="ident">io</span>,
<span class="ident">StatusCode</span>::<span class="ident">REQUEST_TIMEOUT</span>,
<span class="self">self</span>.<span class="ident">ka_timeout</span>.<span class="ident">take</span>(),
<span class="ident">buf</span>,
));
<span class="kw">return</span> <span class="self">self</span>.<span class="ident">poll</span>();
}
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()));
}
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h2</span>)) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">n</span><span class="op">|</span> <span class="ident">h2</span>.<span class="ident">settings</span>().<span class="ident">head</span>().<span class="ident">insert</span>(<span class="ident">n</span>))
}
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">settings</span>, <span class="kw">_</span>, <span class="kw">_</span>, <span class="kw">_</span>)) <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">n</span><span class="op">|</span> <span class="ident">settings</span>.<span class="ident">head</span>().<span class="ident">insert</span>(<span class="ident">n</span>))
}
<span class="prelude-val">None</span> <span class="op">=&gt;</span> <span class="macro">unreachable</span><span class="macro">!</span>(),
};
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (),
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="macro">panic</span><span class="macro">!</span>(<span class="string">&quot;Something is really wrong&quot;</span>),
}
}
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">is_eof</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="ident">kind</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">self</span>.<span class="ident">proto</span> {
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h1</span>)) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="ident">h1</span>.<span class="ident">poll</span>();
<span class="kw">match</span> <span class="ident">result</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(())) <span class="op">|</span> <span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">h1</span>.<span class="ident">settings</span>().<span class="ident">remove_channel</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">n</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>() {
<span class="ident">n</span>.<span class="ident">remove</span>()
};
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="kw">return</span> <span class="ident">result</span>;
}
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h2</span>)) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">result</span> <span class="op">=</span> <span class="ident">h2</span>.<span class="ident">poll</span>();
<span class="kw">match</span> <span class="ident">result</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(())) <span class="op">|</span> <span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">h2</span>.<span class="ident">settings</span>().<span class="ident">remove_channel</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">n</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>() {
<span class="ident">n</span>.<span class="ident">remove</span>()
};
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="kw">return</span> <span class="ident">result</span>;
}
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(
<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">settings</span>,
<span class="kw">_</span>,
<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">io</span>,
<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">buf</span>,
)) <span class="op">=&gt;</span> {
<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h1</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="ident">h1</span>.<span class="ident">poll</span>(),
<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h2</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="ident">h2</span>.<span class="ident">poll</span>(),
<span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="kw">_</span>, <span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">io</span>, <span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">buf</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">err</span> <span class="op">=</span> <span class="prelude-val">None</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">disconnect</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">match</span> <span class="ident">io</span>.<span class="ident">read_available</span>(<span class="ident">buf</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">true</span>)) <span class="op">|</span> <span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="macro">debug</span><span class="macro">!</span>(<span class="string">&quot;Ignored premature client disconnection&quot;</span>);
<span class="ident">settings</span>.<span class="ident">remove_channel</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">n</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">node</span>.<span class="ident">as_mut</span>() {
<span class="ident">n</span>.<span class="ident">remove</span>()
};
<span class="kw">return</span> <span class="prelude-val">Err</span>(());
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="ident">read_some</span>, <span class="ident">stream_closed</span>))) <span class="op">=&gt;</span> {
<span class="ident">is_eof</span> <span class="op">=</span> <span class="ident">stream_closed</span>;
<span class="comment">// Only disconnect if no data was read.</span>
<span class="kw">if</span> <span class="ident">is_eof</span> <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">read_some</span> {
<span class="ident">disconnect</span> <span class="op">=</span> <span class="bool-val">true</span>;
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="ident">err</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">e</span>.<span class="ident">into</span>());
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="kw">if</span> <span class="ident">disconnect</span> {
<span class="macro">debug</span><span class="macro">!</span>(<span class="string">&quot;Ignored premature client disconnection&quot;</span>);
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()));
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">e</span>) <span class="op">=</span> <span class="ident">err</span> {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>);
}
<span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">len</span>() <span class="op">&gt;=</span> <span class="number">14</span> {
<span class="kw">if</span> <span class="ident">buf</span>[..<span class="number">14</span>] <span class="op">==</span> <span class="ident">HTTP2_PREFACE</span>[..] {
@ -510,24 +438,30 @@
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
}
}
<span class="prelude-val">None</span> <span class="op">=&gt;</span> <span class="macro">unreachable</span><span class="macro">!</span>(),
<span class="ident">HttpProtocol</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> <span class="macro">unreachable</span><span class="macro">!</span>(),
};
<span class="comment">// upgrade to specific http protocol</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="ident">settings</span>, <span class="ident">addr</span>, <span class="ident">io</span>, <span class="ident">buf</span>)) <span class="op">=</span> <span class="self">self</span>.<span class="ident">proto</span>.<span class="ident">take</span>() {
<span class="kw">let</span> <span class="ident">proto</span> <span class="op">=</span> <span class="ident">mem</span>::<span class="ident">replace</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">proto</span>, <span class="ident">HttpProtocol</span>::<span class="prelude-val">None</span>);
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">HttpProtocol</span>::<span class="ident">Unknown</span>(<span class="ident">settings</span>, <span class="ident">io</span>, <span class="ident">buf</span>) <span class="op">=</span> <span class="ident">proto</span> {
<span class="kw">match</span> <span class="ident">kind</span> {
<span class="ident">ProtocolKind</span>::<span class="ident">Http1</span> <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">proto</span> <span class="op">=</span>
<span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1</span>::<span class="ident">new</span>(<span class="ident">settings</span>, <span class="ident">io</span>, <span class="ident">addr</span>, <span class="ident">buf</span>)));
<span class="self">self</span>.<span class="ident">proto</span> <span class="op">=</span> <span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1Dispatcher</span>::<span class="ident">new</span>(
<span class="ident">settings</span>,
<span class="ident">io</span>,
<span class="ident">buf</span>,
<span class="ident">is_eof</span>,
<span class="self">self</span>.<span class="ident">ka_timeout</span>.<span class="ident">take</span>(),
));
<span class="kw">return</span> <span class="self">self</span>.<span class="ident">poll</span>();
}
<span class="ident">ProtocolKind</span>::<span class="ident">Http2</span> <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">proto</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="ident">h2</span>::<span class="ident">Http2</span>::<span class="ident">new</span>(
<span class="self">self</span>.<span class="ident">proto</span> <span class="op">=</span> <span class="ident">HttpProtocol</span>::<span class="ident">H2</span>(<span class="ident">h2</span>::<span class="ident">Http2</span>::<span class="ident">new</span>(
<span class="ident">settings</span>,
<span class="ident">io</span>,
<span class="ident">addr</span>,
<span class="ident">buf</span>.<span class="ident">freeze</span>(),
)));
<span class="self">self</span>.<span class="ident">ka_timeout</span>.<span class="ident">take</span>(),
));
<span class="kw">return</span> <span class="self">self</span>.<span class="ident">poll</span>();
}
}
@ -536,79 +470,45 @@
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">next</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">*</span><span class="kw-2">mut</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span>,
<span class="ident">prev</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">*</span><span class="kw-2">mut</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span>,
<span class="ident">element</span>: <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="ident">T</span>,
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">H1Channel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">proto</span>: <span class="ident">HttpProtocol</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">el</span>: <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Node</span> {
<span class="ident">next</span>: <span class="prelude-val">None</span>,
<span class="ident">prev</span>: <span class="prelude-val">None</span>,
<span class="ident">element</span>: <span class="ident">el</span>,
}
}
<span class="kw">fn</span> <span class="ident">insert</span><span class="op">&lt;</span><span class="ident">I</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">next</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">I</span><span class="op">&gt;</span>) {
<span class="kw">unsafe</span> {
<span class="kw">let</span> <span class="ident">next</span>: <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="op">=</span> <span class="ident">next</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>;
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">next2</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">next</span> {
<span class="kw">let</span> <span class="ident">n</span> <span class="op">=</span> <span class="ident">next2</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>();
<span class="ident">n</span>.<span class="ident">prev</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">next</span>);
}
<span class="self">self</span>.<span class="ident">next</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">next</span>);
<span class="kw">let</span> <span class="ident">next</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Node</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span><span class="ident">next</span>;
<span class="ident">next</span>.<span class="ident">prev</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="self">self</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>);
}
}
<span class="kw">fn</span> <span class="ident">remove</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="kw">unsafe</span> {
<span class="self">self</span>.<span class="ident">element</span> <span class="op">=</span> <span class="ident">ptr</span>::<span class="ident">null_mut</span>();
<span class="kw">let</span> <span class="ident">next</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">next</span>.<span class="ident">take</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">prev</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">prev</span>.<span class="ident">take</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">prev</span>) <span class="op">=</span> <span class="ident">prev</span> {
<span class="ident">prev</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>().<span class="ident">next</span> <span class="op">=</span> <span class="ident">next</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="ident">H1Channel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">io</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">H1Channel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">H1Channel</span> {
<span class="ident">proto</span>: <span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="ident">h1</span>::<span class="ident">Http1Dispatcher</span>::<span class="ident">new</span>(
<span class="ident">settings</span>,
<span class="ident">io</span>,
<span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="number">8192</span>),
<span class="bool-val">false</span>,
<span class="prelude-val">None</span>,
)),
}
}
}
<span class="kw">impl</span> <span class="ident">Node</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">head</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">Node</span> {
<span class="ident">next</span>: <span class="prelude-val">None</span>,
<span class="ident">prev</span>: <span class="prelude-val">None</span>,
<span class="ident">element</span>: <span class="ident">ptr</span>::<span class="ident">null_mut</span>(),
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">H1Channel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">traverse</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>(<span class="kw-2">&amp;</span><span class="self">self</span>)
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">next</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">next</span>.<span class="ident">as_ref</span>();
<span class="kw">loop</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">n</span>) <span class="op">=</span> <span class="ident">next</span> {
<span class="kw">unsafe</span> {
<span class="kw">let</span> <span class="ident">n</span>: <span class="kw-2">&amp;</span><span class="ident">Node</span><span class="op">&lt;</span>()<span class="op">&gt;</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw-2">*</span>(<span class="ident">n</span>.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw">const</span> <span class="kw">_</span>);
<span class="ident">next</span> <span class="op">=</span> <span class="ident">n</span>.<span class="ident">next</span>.<span class="ident">as_ref</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">n</span>.<span class="ident">element</span>.<span class="ident">is_null</span>() {
<span class="kw">let</span> <span class="ident">ch</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="op">=</span>
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span>(<span class="ident">n</span>.<span class="ident">element</span> <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>) <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> () <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>);
<span class="ident">ch</span>.<span class="ident">shutdown</span>();
}
}
} <span class="kw">else</span> {
<span class="kw">return</span>;
}
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Item</span>, <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">proto</span> {
<span class="ident">HttpProtocol</span>::<span class="ident">H1</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">h1</span>) <span class="op">=&gt;</span> <span class="ident">h1</span>.<span class="ident">poll</span>(),
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="macro">unreachable</span><span class="macro">!</span>(),
}
}
}
@ -646,6 +546,10 @@
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="kw">_</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="kw">_</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> <span class="ident">io</span>::<span class="ident">Read</span> <span class="kw">for</span> <span class="ident">WrapperStream</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>

216
static/api/actix-web/stable/src/actix_web/server/error.rs.html
View File

@ -1,34 +1,193 @@
<!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="Source to the Rust file `src/server/error.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>error.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<!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="Source to the Rust file `src/server/error.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>error.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>;
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">http2</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">helpers</span>, <span class="ident">HttpHandlerTask</span>, <span class="ident">Writer</span>};
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">StatusCode</span>, <span class="ident">Version</span>};
<span class="kw">use</span> <span class="ident">Error</span>;
<span class="doccomment">/// Errors produced by `AcceptorError` service.</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>)]</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">AcceptorError</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="doccomment">/// The inner service error</span>
<span class="ident">Service</span>(<span class="ident">T</span>),
<span class="doccomment">/// Io specific error</span>
<span class="ident">Io</span>(<span class="ident">io</span>::<span class="ident">Error</span>),
<span class="doccomment">/// The request did not complete within the specified timeout.</span>
<span class="ident">Timeout</span>,
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Fail</span>, <span class="ident">Debug</span>)]</span>
<span class="doccomment">/// A set of errors that can occur during dispatching http requests</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">HttpDispatchError</span> {
<span class="doccomment">/// Application error</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Application specific error: {}&quot;</span>, <span class="ident">_0</span>)]</span>
<span class="ident">App</span>(<span class="ident">Error</span>),
<span class="doccomment">/// An `io::Error` that occurred while trying to read or write to a network</span>
<span class="doccomment">/// stream.</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;IO error: {}&quot;</span>, <span class="ident">_0</span>)]</span>
<span class="ident">Io</span>(<span class="ident">io</span>::<span class="ident">Error</span>),
<span class="doccomment">/// The first request did not complete within the specified timeout.</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;The first request did not complete within the specified timeout&quot;</span>)]</span>
<span class="ident">SlowRequestTimeout</span>,
<span class="doccomment">/// Shutdown timeout</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Connection shutdown timeout&quot;</span>)]</span>
<span class="ident">ShutdownTimeout</span>,
<span class="doccomment">/// HTTP2 error</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;HTTP2 error: {}&quot;</span>, <span class="ident">_0</span>)]</span>
<span class="ident">Http2</span>(<span class="ident">http2</span>::<span class="ident">Error</span>),
<span class="doccomment">/// Payload is not consumed</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Task is completed but request&#39;s payload is not consumed&quot;</span>)]</span>
<span class="ident">PayloadIsNotConsumed</span>,
<span class="doccomment">/// Malformed request</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Malformed request&quot;</span>)]</span>
<span class="ident">MalformedRequest</span>,
<span class="doccomment">/// Internal error</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Internal error&quot;</span>)]</span>
<span class="ident">InternalError</span>,
<span class="doccomment">/// Unknown error</span>
<span class="attribute">#[<span class="ident">fail</span>(<span class="ident">display</span> <span class="op">=</span> <span class="string">&quot;Unknown error&quot;</span>)]</span>
<span class="ident">Unknown</span>,
}
<span class="kw">impl</span> <span class="ident">From</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">HttpDispatchError</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">err</span>: <span class="ident">Error</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">HttpDispatchError</span>::<span class="ident">App</span>(<span class="ident">err</span>)
}
}
<span class="kw">impl</span> <span class="ident">From</span><span class="op">&lt;</span><span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">HttpDispatchError</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">err</span>: <span class="ident">io</span>::<span class="ident">Error</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">HttpDispatchError</span>::<span class="ident">Io</span>(<span class="ident">err</span>)
}
}
<span class="kw">impl</span> <span class="ident">From</span><span class="op">&lt;</span><span class="ident">http2</span>::<span class="ident">Error</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">HttpDispatchError</span> {
<span class="kw">fn</span> <span class="ident">from</span>(<span class="ident">err</span>: <span class="ident">http2</span>::<span class="ident">Error</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">HttpDispatchError</span>::<span class="ident">Http2</span>(<span class="ident">err</span>)
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">ServerError</span>(<span class="ident">Version</span>, <span class="ident">StatusCode</span>);
<span class="kw">impl</span> <span class="ident">ServerError</span> {
@ -41,8 +200,17 @@
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
{
<span class="kw">let</span> <span class="ident">bytes</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">buffer</span>();
<span class="comment">// Buffer should have sufficient capacity for status line</span>
<span class="comment">// and extra space</span>
<span class="ident">bytes</span>.<span class="ident">reserve</span>(<span class="ident">helpers</span>::<span class="ident">STATUS_LINE_BUF_SIZE</span> <span class="op">+</span> <span class="number">1</span>);
<span class="ident">helpers</span>::<span class="ident">write_status_line</span>(<span class="self">self</span>.<span class="number">0</span>, <span class="self">self</span>.<span class="number">1</span>.<span class="ident">as_u16</span>(), <span class="ident">bytes</span>);
}
<span class="comment">// Convert Status Code to Reason.</span>
<span class="kw">let</span> <span class="ident">reason</span> <span class="op">=</span> <span class="self">self</span>.<span class="number">1</span>.<span class="ident">canonical_reason</span>().<span class="ident">unwrap_or</span>(<span class="string">&quot;&quot;</span>);
<span class="ident">io</span>.<span class="ident">buffer</span>().<span class="ident">extend_from_slice</span>(<span class="ident">reason</span>.<span class="ident">as_bytes</span>());
<span class="comment">// No response body.</span>
<span class="ident">io</span>.<span class="ident">buffer</span>().<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\ncontent-length: 0\r\n&quot;</span>);
<span class="comment">// date header</span>
<span class="ident">io</span>.<span class="ident">set_date</span>();
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">true</span>))
}

890
static/api/actix-web/stable/src/actix_web/server/h1.rs.html
View File

File diff suppressed because it is too large Load Diff

14
static/api/actix-web/stable/src/actix_web/server/h1decoder.rs.html
View File

@ -506,6 +506,7 @@
<span id="506">506</span>
<span id="507">507</span>
<span id="508">508</span>
<span id="509">509</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">mem</span>};
@ -514,7 +515,7 @@
<span class="kw">use</span> <span class="ident">httparse</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">message</span>::{<span class="ident">MessageFlags</span>, <span class="ident">Request</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">WorkerSettings</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">ParseError</span>;
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{<span class="ident">HeaderName</span>, <span class="ident">HeaderValue</span>};
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">header</span>, <span class="ident">HttpTryFrom</span>, <span class="ident">Method</span>, <span class="ident">Uri</span>, <span class="ident">Version</span>};
@ -527,6 +528,7 @@
<span class="ident">decoder</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">EncodingDecoder</span><span class="op">&gt;</span>,
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">Message</span> {
<span class="ident">Message</span> { <span class="ident">msg</span>: <span class="ident">Request</span>, <span class="ident">payload</span>: <span class="ident">bool</span> },
<span class="ident">Chunk</span>(<span class="ident">Bytes</span>),
@ -551,7 +553,7 @@
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">decode</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">src</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">settings</span>: <span class="kw-2">&amp;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">src</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">settings</span>: <span class="kw-2">&amp;</span><span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Message</span><span class="op">&gt;</span>, <span class="ident">DecoderError</span><span class="op">&gt;</span> {
<span class="comment">// read payload</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">decoder</span>.<span class="ident">is_some</span>() {
@ -588,7 +590,7 @@
}
<span class="kw">fn</span> <span class="ident">parse_message</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">settings</span>: <span class="kw-2">&amp;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">settings</span>: <span class="kw-2">&amp;</span><span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(<span class="ident">Request</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">EncodingDecoder</span><span class="op">&gt;</span>), <span class="ident">ParseError</span><span class="op">&gt;</span> {
<span class="comment">// Parse http message</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">has_upgrade</span> <span class="op">=</span> <span class="bool-val">false</span>;
@ -675,9 +677,9 @@
{
<span class="bool-val">true</span>
} <span class="kw">else</span> {
<span class="ident">version</span> <span class="op">==</span> <span class="ident">Version</span>::<span class="ident">HTTP_11</span>
<span class="op">&amp;&amp;</span> <span class="op">!</span>(<span class="ident">conn</span>.<span class="ident">contains</span>(<span class="string">&quot;close&quot;</span>)
<span class="op">||</span> <span class="ident">conn</span>.<span class="ident">contains</span>(<span class="string">&quot;upgrade&quot;</span>))
<span class="ident">version</span> <span class="op">==</span> <span class="ident">Version</span>::<span class="ident">HTTP_11</span> <span class="op">&amp;&amp;</span> <span class="op">!</span>(<span class="ident">conn</span>
.<span class="ident">contains</span>(<span class="string">&quot;close&quot;</span>)
<span class="op">||</span> <span class="ident">conn</span>.<span class="ident">contains</span>(<span class="string">&quot;upgrade&quot;</span>))
}
} <span class="kw">else</span> {
<span class="bool-val">false</span>

140
static/api/actix-web/stable/src/actix_web/server/h1writer.rs.html
View File

@ -343,11 +343,29 @@
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
</pre><pre class="rust ">
<span class="comment">// #![cfg_attr(feature = &quot;cargo-clippy&quot;, allow(redundant_field_names))]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::{<span class="self">self</span>, <span class="ident">Write</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">BufMut</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>};
@ -355,7 +373,7 @@
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">helpers</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">output</span>::{<span class="ident">Output</span>, <span class="ident">ResponseInfo</span>, <span class="ident">ResponseLength</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">WorkerSettings</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">Request</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">Writer</span>, <span class="ident">WriterState</span>, <span class="ident">MAX_WRITE_BUFFER_SIZE</span>};
<span class="kw">use</span> <span class="ident">body</span>::{<span class="ident">Binary</span>, <span class="ident">Body</span>};
@ -384,11 +402,11 @@
<span class="ident">headers_size</span>: <span class="ident">u32</span>,
<span class="ident">buffer</span>: <span class="ident">Output</span>,
<span class="ident">buffer_capacity</span>: <span class="ident">usize</span>,
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">AsyncWrite</span>, <span class="ident">H</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">H1Writer</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">stream</span>: <span class="ident">T</span>, <span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>) <span class="op">-&gt;</span> <span class="ident">H1Writer</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">stream</span>: <span class="ident">T</span>, <span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">H1Writer</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">H1Writer</span> {
<span class="ident">flags</span>: <span class="ident">Flags</span>::<span class="ident">KEEPALIVE</span>,
<span class="ident">written</span>: <span class="number">0</span>,
@ -409,7 +427,17 @@
<span class="self">self</span>.<span class="ident">flags</span> <span class="op">=</span> <span class="ident">Flags</span>::<span class="ident">KEEPALIVE</span>;
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">disconnected</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">flushed</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="self">self</span>.<span class="ident">buffer</span>.<span class="ident">is_empty</span>()
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">disconnected</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>);
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">upgrade</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">UPGRADE</span>)
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keepalive</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">KEEPALIVE</span>) <span class="op">&amp;&amp;</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">UPGRADE</span>)
@ -498,8 +526,7 @@
<span class="kw">let</span> <span class="ident">reason</span> <span class="op">=</span> <span class="ident">msg</span>.<span class="ident">reason</span>().<span class="ident">as_bytes</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="kw-2">ref</span> <span class="ident">bytes</span>) <span class="op">=</span> <span class="ident">body</span> {
<span class="ident">buffer</span>.<span class="ident">reserve</span>(
<span class="number">256</span>
<span class="op">+</span> <span class="ident">msg</span>.<span class="ident">headers</span>().<span class="ident">len</span>() <span class="op">*</span> <span class="ident">AVERAGE_HEADER_SIZE</span>
<span class="number">256</span> <span class="op">+</span> <span class="ident">msg</span>.<span class="ident">headers</span>().<span class="ident">len</span>() <span class="op">*</span> <span class="ident">AVERAGE_HEADER_SIZE</span>
<span class="op">+</span> <span class="ident">bytes</span>.<span class="ident">len</span>()
<span class="op">+</span> <span class="ident">reason</span>.<span class="ident">len</span>(),
);
@ -514,13 +541,11 @@
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="ident">reason</span>);
<span class="comment">// content length</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">len_is_set</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="kw">match</span> <span class="ident">info</span>.<span class="ident">length</span> {
<span class="ident">ResponseLength</span>::<span class="ident">Chunked</span> <span class="op">=&gt;</span> {
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\ntransfer-encoding: chunked\r\n&quot;</span>)
}
<span class="ident">ResponseLength</span>::<span class="ident">Zero</span> <span class="op">=&gt;</span> {
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\ncontent-length: 0\r\n&quot;</span>)
}
<span class="ident">ResponseLength</span>::<span class="ident">Length</span>(<span class="ident">len</span>) <span class="op">=&gt;</span> {
<span class="ident">helpers</span>::<span class="ident">write_content_length</span>(<span class="ident">len</span>, <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buffer</span>)
}
@ -529,6 +554,10 @@
<span class="macro">write</span><span class="macro">!</span>(<span class="ident">buffer</span>.<span class="ident">writer</span>(), <span class="string">&quot;{}&quot;</span>, <span class="ident">len</span>)<span class="question-mark">?</span>;
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\n&quot;</span>);
}
<span class="ident">ResponseLength</span>::<span class="ident">Zero</span> <span class="op">=&gt;</span> {
<span class="ident">len_is_set</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\n&quot;</span>);
}
<span class="ident">ResponseLength</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> <span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;\r\n&quot;</span>),
}
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ce</span>) <span class="op">=</span> <span class="ident">info</span>.<span class="ident">content_encoding</span> {
@ -541,47 +570,57 @@
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">pos</span> <span class="op">=</span> <span class="number">0</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">has_date</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">remaining</span> <span class="op">=</span> <span class="ident">buffer</span>.<span class="ident">remaining_mut</span>();
<span class="kw">unsafe</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span>(<span class="ident">buffer</span>.<span class="ident">bytes_mut</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> [<span class="ident">u8</span>]);
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">value</span>) <span class="kw">in</span> <span class="ident">msg</span>.<span class="ident">headers</span>() {
<span class="kw">match</span> <span class="kw-2">*</span><span class="ident">key</span> {
<span class="ident">TRANSFER_ENCODING</span> <span class="op">=&gt;</span> <span class="kw">continue</span>,
<span class="ident">CONTENT_ENCODING</span> <span class="op">=&gt;</span> <span class="kw">if</span> <span class="ident">encoding</span> <span class="op">!=</span> <span class="ident">ContentEncoding</span>::<span class="ident">Identity</span> {
<span class="kw">continue</span>;
},
<span class="ident">CONTENT_LENGTH</span> <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">info</span>.<span class="ident">length</span> {
<span class="ident">ResponseLength</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> (),
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="kw">continue</span>,
},
<span class="ident">DATE</span> <span class="op">=&gt;</span> {
<span class="ident">has_date</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span> <span class="op">=</span> <span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span>(<span class="ident">buffer</span>.<span class="ident">bytes_mut</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> [<span class="ident">u8</span>]) };
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">value</span>) <span class="kw">in</span> <span class="ident">msg</span>.<span class="ident">headers</span>() {
<span class="kw">match</span> <span class="kw-2">*</span><span class="ident">key</span> {
<span class="ident">TRANSFER_ENCODING</span> <span class="op">=&gt;</span> <span class="kw">continue</span>,
<span class="ident">CONTENT_ENCODING</span> <span class="op">=&gt;</span> <span class="kw">if</span> <span class="ident">encoding</span> <span class="op">!=</span> <span class="ident">ContentEncoding</span>::<span class="ident">Identity</span> {
<span class="kw">continue</span>;
},
<span class="ident">CONTENT_LENGTH</span> <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">info</span>.<span class="ident">length</span> {
<span class="ident">ResponseLength</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> (),
<span class="ident">ResponseLength</span>::<span class="ident">Zero</span> <span class="op">=&gt;</span> {
<span class="ident">len_is_set</span> <span class="op">=</span> <span class="bool-val">true</span>;
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="kw">continue</span>,
},
<span class="ident">DATE</span> <span class="op">=&gt;</span> {
<span class="ident">has_date</span> <span class="op">=</span> <span class="bool-val">true</span>;
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="kw">let</span> <span class="ident">v</span> <span class="op">=</span> <span class="ident">value</span>.<span class="ident">as_ref</span>();
<span class="kw">let</span> <span class="ident">k</span> <span class="op">=</span> <span class="ident">key</span>.<span class="ident">as_str</span>().<span class="ident">as_bytes</span>();
<span class="kw">let</span> <span class="ident">len</span> <span class="op">=</span> <span class="ident">k</span>.<span class="ident">len</span>() <span class="op">+</span> <span class="ident">v</span>.<span class="ident">len</span>() <span class="op">+</span> <span class="number">4</span>;
<span class="kw">if</span> <span class="ident">len</span> <span class="op">&gt;</span> <span class="ident">remaining</span> {
<span class="kw">let</span> <span class="ident">v</span> <span class="op">=</span> <span class="ident">value</span>.<span class="ident">as_ref</span>();
<span class="kw">let</span> <span class="ident">k</span> <span class="op">=</span> <span class="ident">key</span>.<span class="ident">as_str</span>().<span class="ident">as_bytes</span>();
<span class="kw">let</span> <span class="ident">len</span> <span class="op">=</span> <span class="ident">k</span>.<span class="ident">len</span>() <span class="op">+</span> <span class="ident">v</span>.<span class="ident">len</span>() <span class="op">+</span> <span class="number">4</span>;
<span class="kw">if</span> <span class="ident">len</span> <span class="op">&gt;</span> <span class="ident">remaining</span> {
<span class="kw">unsafe</span> {
<span class="ident">buffer</span>.<span class="ident">advance_mut</span>(<span class="ident">pos</span>);
<span class="ident">pos</span> <span class="op">=</span> <span class="number">0</span>;
<span class="ident">buffer</span>.<span class="ident">reserve</span>(<span class="ident">len</span>);
<span class="ident">remaining</span> <span class="op">=</span> <span class="ident">buffer</span>.<span class="ident">remaining_mut</span>();
}
<span class="ident">pos</span> <span class="op">=</span> <span class="number">0</span>;
<span class="ident">buffer</span>.<span class="ident">reserve</span>(<span class="ident">len</span>);
<span class="ident">remaining</span> <span class="op">=</span> <span class="ident">buffer</span>.<span class="ident">remaining_mut</span>();
<span class="kw">unsafe</span> {
<span class="ident">buf</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span>(<span class="ident">buffer</span>.<span class="ident">bytes_mut</span>() <span class="kw">as</span> <span class="kw-2">*</span><span class="kw-2">mut</span> <span class="kw">_</span>);
}
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="ident">k</span>.<span class="ident">len</span>()].<span class="ident">copy_from_slice</span>(<span class="ident">k</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="ident">k</span>.<span class="ident">len</span>();
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="number">2</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;: &quot;</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="number">2</span>;
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="ident">v</span>.<span class="ident">len</span>()].<span class="ident">copy_from_slice</span>(<span class="ident">v</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="ident">v</span>.<span class="ident">len</span>();
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="number">2</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;\r\n&quot;</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="number">2</span>;
<span class="ident">remaining</span> <span class="op">-=</span> <span class="ident">len</span>;
}
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="ident">k</span>.<span class="ident">len</span>()].<span class="ident">copy_from_slice</span>(<span class="ident">k</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="ident">k</span>.<span class="ident">len</span>();
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="number">2</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;: &quot;</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="number">2</span>;
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="ident">v</span>.<span class="ident">len</span>()].<span class="ident">copy_from_slice</span>(<span class="ident">v</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="ident">v</span>.<span class="ident">len</span>();
<span class="ident">buf</span>[<span class="ident">pos</span>..<span class="ident">pos</span> <span class="op">+</span> <span class="number">2</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;\r\n&quot;</span>);
<span class="ident">pos</span> <span class="op">+=</span> <span class="number">2</span>;
<span class="ident">remaining</span> <span class="op">-=</span> <span class="ident">len</span>;
}
<span class="kw">unsafe</span> {
<span class="ident">buffer</span>.<span class="ident">advance_mut</span>(<span class="ident">pos</span>);
}
<span class="kw">if</span> <span class="op">!</span><span class="ident">len_is_set</span> {
<span class="ident">buffer</span>.<span class="ident">extend_from_slice</span>(<span class="string">b&quot;content-length: 0\r\n&quot;</span>)
}
<span class="comment">// optimized date header, set_date writes \r\n</span>
<span class="kw">if</span> <span class="op">!</span><span class="ident">has_date</span> {
@ -615,10 +654,7 @@
<span class="kw">let</span> <span class="ident">pl</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>] <span class="op">=</span> <span class="ident">payload</span>.<span class="ident">as_ref</span>();
<span class="kw">let</span> <span class="ident">n</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">Self</span>::<span class="ident">write_data</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">stream</span>, <span class="ident">pl</span>) {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">err</span>.<span class="ident">kind</span>() <span class="op">==</span> <span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WriteZero</span> {
<span class="self">self</span>.<span class="ident">disconnected</span>();
}
<span class="self">self</span>.<span class="ident">disconnected</span>();
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>);
}
<span class="prelude-val">Ok</span>(<span class="ident">val</span>) <span class="op">=&gt;</span> <span class="ident">val</span>,
@ -662,14 +698,15 @@
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">poll_completed</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">shutdown</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>) {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">io</span>::<span class="ident">Error</span>::<span class="ident">new</span>(<span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">Other</span>, <span class="string">&quot;disconnected&quot;</span>));
}
<span class="kw">if</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">buffer</span>.<span class="ident">is_empty</span>() {
<span class="kw">let</span> <span class="ident">written</span> <span class="op">=</span> {
<span class="kw">match</span> <span class="self">Self</span>::<span class="ident">write_data</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">stream</span>, <span class="self">self</span>.<span class="ident">buffer</span>.<span class="ident">as_ref</span>().<span class="ident">as_ref</span>()) {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">err</span>.<span class="ident">kind</span>() <span class="op">==</span> <span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WriteZero</span> {
<span class="self">self</span>.<span class="ident">disconnected</span>();
}
<span class="self">self</span>.<span class="ident">disconnected</span>();
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>);
}
<span class="prelude-val">Ok</span>(<span class="ident">val</span>) <span class="op">=&gt;</span> <span class="ident">val</span>,
@ -683,9 +720,10 @@
}
}
<span class="kw">if</span> <span class="ident">shutdown</span> {
<span class="self">self</span>.<span class="ident">stream</span>.<span class="ident">poll_flush</span>()<span class="question-mark">?</span>;
<span class="self">self</span>.<span class="ident">stream</span>.<span class="ident">shutdown</span>()
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
<span class="prelude-val">Ok</span>(<span class="self">self</span>.<span class="ident">stream</span>.<span class="ident">poll_flush</span>()<span class="question-mark">?</span>)
}
}
}

278
static/api/actix-web/stable/src/actix_web/server/h2.rs.html
View File

@ -442,12 +442,32 @@
<span id="442">442</span>
<span id="443">443</span>
<span id="444">444</span>
<span id="445">445</span>
<span id="446">446</span>
<span id="447">447</span>
<span id="448">448</span>
<span id="449">449</span>
<span id="450">450</span>
<span id="451">451</span>
<span id="452">452</span>
<span id="453">453</span>
<span id="454">454</span>
<span id="455">455</span>
<span id="456">456</span>
<span id="457">457</span>
<span id="458">458</span>
<span id="459">459</span>
<span id="460">460</span>
<span id="461">461</span>
<span id="462">462</span>
<span id="463">463</span>
<span id="464">464</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::<span class="ident">VecDeque</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::{<span class="ident">Read</span>, <span class="ident">Write</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::<span class="ident">SocketAddr</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">time</span>::{<span class="ident">Duration</span>, <span class="ident">Instant</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">time</span>::<span class="ident">Instant</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">cmp</span>, <span class="ident">io</span>, <span class="ident">mem</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Buf</span>, <span class="ident">Bytes</span>};
@ -459,19 +479,21 @@
<span class="kw">use</span> <span class="ident">tokio_timer</span>::<span class="ident">Delay</span>;
<span class="kw">use</span> <span class="ident">error</span>::{<span class="ident">Error</span>, <span class="ident">PayloadError</span>};
<span class="kw">use</span> <span class="ident">extensions</span>::<span class="ident">Extensions</span>;
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">StatusCode</span>, <span class="ident">Version</span>};
<span class="kw">use</span> <span class="ident">payload</span>::{<span class="ident">Payload</span>, <span class="ident">PayloadStatus</span>, <span class="ident">PayloadWriter</span>};
<span class="kw">use</span> <span class="ident">uri</span>::<span class="ident">Url</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::<span class="ident">ServerError</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::{<span class="ident">HttpDispatchError</span>, <span class="ident">ServerError</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">h2writer</span>::<span class="ident">H2Writer</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">input</span>::<span class="ident">PayloadType</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">WorkerSettings</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">HttpHandler</span>, <span class="ident">HttpHandlerTask</span>, <span class="ident">Writer</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">HttpHandler</span>, <span class="ident">HttpHandlerTask</span>, <span class="ident">IoStream</span>, <span class="ident">Writer</span>};
<span class="macro">bitflags</span><span class="macro">!</span> {
<span class="kw">struct</span> <span class="ident">Flags</span>: <span class="ident">u8</span> {
<span class="kw">const</span> <span class="ident">DISCONNECTED</span> <span class="op">=</span> <span class="number">0b0000_0010</span>;
<span class="kw">const</span> <span class="ident">DISCONNECTED</span> <span class="op">=</span> <span class="number">0b0000_0001</span>;
<span class="kw">const</span> <span class="ident">SHUTDOWN</span> <span class="op">=</span> <span class="number">0b0000_0010</span>;
}
}
@ -482,11 +504,13 @@
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">flags</span>: <span class="ident">Flags</span>,
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>,
<span class="ident">state</span>: <span class="ident">State</span><span class="op">&lt;</span><span class="ident">IoWrapper</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span>,
<span class="ident">tasks</span>: <span class="ident">VecDeque</span><span class="op">&lt;</span><span class="ident">Entry</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">keepalive_timer</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span>,
<span class="ident">extensions</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Extensions</span><span class="op">&gt;&gt;</span>,
<span class="ident">ka_expire</span>: <span class="ident">Instant</span>,
<span class="ident">ka_timer</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span>,
}
<span class="kw">enum</span> <span class="ident">State</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span><span class="op">&gt;</span> {
@ -497,12 +521,24 @@
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Http2</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">IoStream</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>, <span class="ident">io</span>: <span class="ident">T</span>, <span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">buf</span>: <span class="ident">Bytes</span>,
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">io</span>: <span class="ident">T</span>, <span class="ident">buf</span>: <span class="ident">Bytes</span>, <span class="ident">keepalive_timer</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span>,
) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> <span class="ident">addr</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">peer_addr</span>();
<span class="kw">let</span> <span class="ident">extensions</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">extensions</span>();
<span class="comment">// keep-alive timeout</span>
<span class="kw">let</span> (<span class="ident">ka_expire</span>, <span class="ident">ka_timer</span>) <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">delay</span>) <span class="op">=</span> <span class="ident">keepalive_timer</span> {
(<span class="ident">delay</span>.<span class="ident">deadline</span>(), <span class="prelude-val">Some</span>(<span class="ident">delay</span>))
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">delay</span>) <span class="op">=</span> <span class="ident">settings</span>.<span class="ident">keep_alive_timer</span>() {
(<span class="ident">delay</span>.<span class="ident">deadline</span>(), <span class="prelude-val">Some</span>(<span class="ident">delay</span>))
} <span class="kw">else</span> {
(<span class="ident">settings</span>.<span class="ident">now</span>(), <span class="prelude-val">None</span>)
};
<span class="ident">Http2</span> {
<span class="ident">flags</span>: <span class="ident">Flags</span>::<span class="ident">empty</span>(),
<span class="ident">tasks</span>: <span class="ident">VecDeque</span>::<span class="ident">new</span>(),
@ -510,84 +546,84 @@
<span class="ident">unread</span>: <span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">is_empty</span>() { <span class="prelude-val">None</span> } <span class="kw">else</span> { <span class="prelude-val">Some</span>(<span class="ident">buf</span>) },
<span class="ident">inner</span>: <span class="ident">io</span>,
})),
<span class="ident">keepalive_timer</span>: <span class="prelude-val">None</span>,
<span class="ident">addr</span>,
<span class="ident">settings</span>,
<span class="ident">extensions</span>,
<span class="ident">ka_expire</span>,
<span class="ident">ka_timer</span>,
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="self">self</span>.<span class="ident">state</span> <span class="op">=</span> <span class="ident">State</span>::<span class="ident">Empty</span>;
<span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">clear</span>();
<span class="self">self</span>.<span class="ident">keepalive_timer</span>.<span class="ident">take</span>();
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="ident">HttpDispatchError</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">poll_keepalive</span>()<span class="question-mark">?</span>;
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">settings</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">as_ref</span>()
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> {
<span class="comment">// server</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">State</span>::<span class="ident">Connection</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">conn</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">state</span> {
<span class="comment">// keep-alive timer</span>
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">timeout</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">keepalive_timer</span> {
<span class="kw">match</span> <span class="ident">timeout</span>.<span class="ident">poll</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Keep-alive timeout, close connection&quot;</span>);
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()));
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (),
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="macro">unreachable</span><span class="macro">!</span>(),
}
}
<span class="kw">loop</span> {
<span class="comment">// shutdown connection</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">SHUTDOWN</span>) {
<span class="kw">return</span> <span class="ident">conn</span>.<span class="ident">poll_close</span>().<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">into</span>());
}
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="kw">let</span> <span class="ident">disconnected</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>);
<span class="comment">// check in-flight connections</span>
<span class="kw">for</span> <span class="ident">item</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">tasks</span> {
<span class="comment">// read payload</span>
<span class="ident">item</span>.<span class="ident">poll_payload</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">disconnected</span> {
<span class="ident">item</span>.<span class="ident">poll_payload</span>();
}
<span class="kw">if</span> <span class="op">!</span><span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>) {
<span class="kw">let</span> <span class="ident">retry</span> <span class="op">=</span> <span class="ident">item</span>.<span class="ident">payload</span>.<span class="ident">need_read</span>() <span class="op">==</span> <span class="ident">PayloadStatus</span>::<span class="ident">Read</span>;
<span class="kw">loop</span> {
<span class="kw">match</span> <span class="ident">item</span>.<span class="ident">task</span>.<span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">item</span>.<span class="ident">stream</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">ready</span>)) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">ready</span> {
<span class="kw">if</span> <span class="ident">disconnected</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>);
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="ident">retry</span> <span class="op">=</span> <span class="ident">item</span>.<span class="ident">payload</span>.<span class="ident">need_read</span>() <span class="op">==</span> <span class="ident">PayloadStatus</span>::<span class="ident">Read</span>;
<span class="kw">loop</span> {
<span class="kw">match</span> <span class="ident">item</span>.<span class="ident">task</span>.<span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">item</span>.<span class="ident">stream</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="ident">ready</span>)) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">ready</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(
<span class="ident">EntryFlags</span>::<span class="ident">EOF</span> <span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>,
);
} <span class="kw">else</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>);
}
<span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">false</span>;
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">item</span>.<span class="ident">payload</span>.<span class="ident">need_read</span>()
<span class="op">==</span> <span class="ident">PayloadStatus</span>::<span class="ident">Read</span>
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">retry</span>
{
<span class="kw">continue</span>;
}
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Unhandled error: {}&quot;</span>, <span class="ident">err</span>);
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(
<span class="ident">EntryFlags</span>::<span class="ident">EOF</span> <span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>,
<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>
<span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">ERROR</span>
<span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>,
);
} <span class="kw">else</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>);
}
<span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">false</span>;
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">item</span>.<span class="ident">payload</span>.<span class="ident">need_read</span>() <span class="op">==</span> <span class="ident">PayloadStatus</span>::<span class="ident">Read</span>
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">retry</span>
{
<span class="kw">continue</span>;
<span class="ident">item</span>.<span class="ident">stream</span>.<span class="ident">reset</span>(<span class="ident">Reason</span>::<span class="ident">INTERNAL_ERROR</span>);
}
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Unhandled error: {}&quot;</span>, <span class="ident">err</span>);
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(
<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>
<span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">ERROR</span>
<span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>,
);
<span class="ident">item</span>.<span class="ident">stream</span>.<span class="ident">reset</span>(<span class="ident">Reason</span>::<span class="ident">INTERNAL_ERROR</span>);
}
<span class="kw">break</span>;
}
<span class="kw">break</span>;
}
} <span class="kw">else</span> <span class="kw">if</span> <span class="op">!</span><span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>) {
}
<span class="kw">if</span> <span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>)
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>)
{
<span class="kw">match</span> <span class="ident">item</span>.<span class="ident">task</span>.<span class="ident">poll_completed</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (),
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> {
<span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>);
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(
<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span> <span class="op">|</span> <span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>,
);
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(
@ -602,6 +638,7 @@
<span class="kw">if</span> <span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>)
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>)
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="ident">disconnected</span>
{
<span class="kw">match</span> <span class="ident">item</span>.<span class="ident">stream</span>.<span class="ident">poll_completed</span>(<span class="bool-val">false</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (),
@ -609,7 +646,7 @@
<span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>);
}
<span class="prelude-val">Err</span>(<span class="ident">_err</span>) <span class="op">=&gt;</span> {
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">item</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">EntryFlags</span>::<span class="ident">ERROR</span>);
}
}
@ -618,7 +655,7 @@
<span class="comment">// cleanup finished tasks</span>
<span class="kw">while</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">is_empty</span>() {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tasks</span>[<span class="number">0</span>].<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">EOF</span>)
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tasks</span>[<span class="number">0</span>].<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">FINISHED</span>)
<span class="op">&amp;&amp;</span> <span class="self">self</span>.<span class="ident">tasks</span>[<span class="number">0</span>].<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">WRITE_DONE</span>)
<span class="op">||</span> <span class="self">self</span>.<span class="ident">tasks</span>[<span class="number">0</span>].<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">EntryFlags</span>::<span class="ident">ERROR</span>)
{
@ -642,50 +679,30 @@
<span class="ident">not_ready</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> (<span class="ident">parts</span>, <span class="ident">body</span>) <span class="op">=</span> <span class="ident">req</span>.<span class="ident">into_parts</span>();
<span class="comment">// stop keepalive timer</span>
<span class="self">self</span>.<span class="ident">keepalive_timer</span>.<span class="ident">take</span>();
<span class="comment">// update keep-alive expire</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">ka_timer</span>.<span class="ident">is_some</span>() {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">expire</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">keep_alive_expire</span>() {
<span class="self">self</span>.<span class="ident">ka_expire</span> <span class="op">=</span> <span class="ident">expire</span>;
}
}
<span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">push_back</span>(<span class="ident">Entry</span>::<span class="ident">new</span>(
<span class="ident">parts</span>,
<span class="ident">body</span>,
<span class="ident">resp</span>,
<span class="self">self</span>.<span class="ident">addr</span>,
<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">settings</span>,
<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>(),
<span class="self">self</span>.<span class="ident">extensions</span>.<span class="ident">clone</span>(),
));
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> {
<span class="comment">// start keep-alive timer</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">is_empty</span>() {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">keep_alive_enabled</span>() {
<span class="kw">let</span> <span class="ident">keep_alive</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">keep_alive</span>();
<span class="kw">if</span> <span class="ident">keep_alive</span> <span class="op">&gt;</span> <span class="number">0</span> <span class="op">&amp;&amp;</span> <span class="self">self</span>.<span class="ident">keepalive_timer</span>.<span class="ident">is_none</span>() {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Start keep-alive timer&quot;</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">timeout</span> <span class="op">=</span> <span class="ident">Delay</span>::<span class="ident">new</span>(
<span class="ident">Instant</span>::<span class="ident">now</span>()
<span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">new</span>(<span class="ident">keep_alive</span>, <span class="number">0</span>),
);
<span class="comment">// register timeout</span>
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">timeout</span>.<span class="ident">poll</span>();
<span class="self">self</span>.<span class="ident">keepalive_timer</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">timeout</span>);
}
} <span class="kw">else</span> {
<span class="comment">// keep-alive disable, drop connection</span>
<span class="kw">return</span> <span class="ident">conn</span>.<span class="ident">poll_close</span>().<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Error during connection close: {}&quot;</span>, <span class="ident">e</span>)
});
}
} <span class="kw">else</span> {
<span class="comment">// keep-alive unset, rely on operating system</span>
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
}
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Connection error: {}&quot;</span>, <span class="ident">err</span>);
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>);
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">SHUTDOWN</span>);
<span class="kw">for</span> <span class="ident">entry</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>.<span class="ident">tasks</span> {
<span class="ident">entry</span>.<span class="ident">task</span>.<span class="ident">disconnected</span>()
}
<span class="self">self</span>.<span class="ident">keepalive_timer</span>.<span class="ident">take</span>();
<span class="kw">continue</span>;
}
}
}
@ -693,9 +710,7 @@
<span class="kw">if</span> <span class="ident">not_ready</span> {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">is_empty</span>() <span class="op">&amp;&amp;</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>)
{
<span class="kw">return</span> <span class="ident">conn</span>
.<span class="ident">poll_close</span>()
.<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Error during connection close: {}&quot;</span>, <span class="ident">e</span>));
<span class="kw">return</span> <span class="ident">conn</span>.<span class="ident">poll_close</span>().<span class="ident">map_err</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">into</span>());
} <span class="kw">else</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>);
}
@ -710,7 +725,7 @@
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Error handling connection: {}&quot;</span>, <span class="ident">err</span>);
<span class="kw">return</span> <span class="prelude-val">Err</span>(());
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>());
}
}
} <span class="kw">else</span> {
@ -719,6 +734,37 @@
<span class="self">self</span>.<span class="ident">poll</span>()
}
<span class="doccomment">/// keep-alive timer. returns `true` is keep-alive, otherwise drop</span>
<span class="kw">fn</span> <span class="ident">poll_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">HttpDispatchError</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">timer</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">ka_timer</span> {
<span class="kw">match</span> <span class="ident">timer</span>.<span class="ident">poll</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="kw">_</span>)) <span class="op">=&gt;</span> {
<span class="comment">// if we get timer during shutdown, just drop connection</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">SHUTDOWN</span>) {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpDispatchError</span>::<span class="ident">ShutdownTimeout</span>);
}
<span class="kw">if</span> <span class="ident">timer</span>.<span class="ident">deadline</span>() <span class="op">&gt;=</span> <span class="self">self</span>.<span class="ident">ka_expire</span> {
<span class="comment">// check for any outstanding request handling</span>
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tasks</span>.<span class="ident">is_empty</span>() {
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpDispatchError</span>::<span class="ident">ShutdownTimeout</span>);
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">dl</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">keep_alive_expire</span>() {
<span class="ident">timer</span>.<span class="ident">reset</span>(<span class="ident">dl</span>)
}
} <span class="kw">else</span> {
<span class="ident">timer</span>.<span class="ident">reset</span>(<span class="self">self</span>.<span class="ident">ka_expire</span>)
}
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>) <span class="op">=&gt;</span> (),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Timer error {:?}&quot;</span>, <span class="ident">e</span>);
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">HttpDispatchError</span>::<span class="ident">Unknown</span>);
}
}
}
<span class="prelude-val">Ok</span>(())
}
}
<span class="macro">bitflags</span><span class="macro">!</span> {
@ -768,7 +814,8 @@
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Entry</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">parts</span>: <span class="ident">Parts</span>, <span class="ident">recv</span>: <span class="ident">RecvStream</span>, <span class="ident">resp</span>: <span class="ident">SendResponse</span><span class="op">&lt;</span><span class="ident">Bytes</span><span class="op">&gt;</span>,
<span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">settings</span>: <span class="kw-2">&amp;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">extensions</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Extensions</span><span class="op">&gt;&gt;</span>,
) <span class="op">-&gt;</span> <span class="ident">Entry</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
@ -783,6 +830,7 @@
<span class="ident">inner</span>.<span class="ident">method</span> <span class="op">=</span> <span class="ident">parts</span>.<span class="ident">method</span>;
<span class="ident">inner</span>.<span class="ident">version</span> <span class="op">=</span> <span class="ident">parts</span>.<span class="ident">version</span>;
<span class="ident">inner</span>.<span class="ident">headers</span> <span class="op">=</span> <span class="ident">parts</span>.<span class="ident">headers</span>;
<span class="ident">inner</span>.<span class="ident">stream_extensions</span> <span class="op">=</span> <span class="ident">extensions</span>;
<span class="kw-2">*</span><span class="ident">inner</span>.<span class="ident">payload</span>.<span class="ident">borrow_mut</span>() <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">payload</span>);
<span class="ident">inner</span>.<span class="ident">addr</span> <span class="op">=</span> <span class="ident">addr</span>;
}
@ -791,28 +839,20 @@
<span class="kw">let</span> <span class="ident">psender</span> <span class="op">=</span> <span class="ident">PayloadType</span>::<span class="ident">new</span>(<span class="ident">msg</span>.<span class="ident">headers</span>(), <span class="ident">psender</span>);
<span class="comment">// start request processing</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">task</span> <span class="op">=</span> <span class="prelude-val">None</span>;
<span class="kw">for</span> <span class="ident">h</span> <span class="kw">in</span> <span class="ident">settings</span>.<span class="ident">handlers</span>().<span class="ident">iter_mut</span>() {
<span class="ident">msg</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">h</span>.<span class="ident">handle</span>(<span class="ident">msg</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">t</span>) <span class="op">=&gt;</span> {
<span class="ident">task</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">t</span>);
<span class="kw">break</span>;
}
<span class="prelude-val">Err</span>(<span class="ident">msg</span>) <span class="op">=&gt;</span> <span class="ident">msg</span>,
}
}
<span class="kw">let</span> <span class="ident">task</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">settings</span>.<span class="ident">handler</span>().<span class="ident">handle</span>(<span class="ident">msg</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">task</span>) <span class="op">=&gt;</span> <span class="ident">EntryPipe</span>::<span class="ident">Task</span>(<span class="ident">task</span>),
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="ident">EntryPipe</span>::<span class="ident">Error</span>(<span class="ident">ServerError</span>::<span class="ident">err</span>(
<span class="ident">Version</span>::<span class="ident">HTTP_2</span>,
<span class="ident">StatusCode</span>::<span class="ident">NOT_FOUND</span>,
)),
};
<span class="ident">Entry</span> {
<span class="ident">task</span>: <span class="ident">task</span>.<span class="ident">map</span>(<span class="ident">EntryPipe</span>::<span class="ident">Task</span>).<span class="ident">unwrap_or_else</span>(<span class="op">||</span> {
<span class="ident">EntryPipe</span>::<span class="ident">Error</span>(<span class="ident">ServerError</span>::<span class="ident">err</span>(
<span class="ident">Version</span>::<span class="ident">HTTP_2</span>,
<span class="ident">StatusCode</span>::<span class="ident">NOT_FOUND</span>,
))
}),
<span class="ident">payload</span>: <span class="ident">psender</span>,
<span class="ident">stream</span>: <span class="ident">H2Writer</span>::<span class="ident">new</span>(<span class="ident">resp</span>, <span class="ident">Rc</span>::<span class="ident">clone</span>(<span class="ident">settings</span>)),
<span class="ident">flags</span>: <span class="ident">EntryFlags</span>::<span class="ident">empty</span>(),
<span class="ident">task</span>,
<span class="ident">recv</span>,
<span class="ident">payload</span>: <span class="ident">psender</span>,
<span class="ident">stream</span>: <span class="ident">H2Writer</span>::<span class="ident">new</span>(<span class="ident">resp</span>, <span class="ident">settings</span>),
<span class="ident">flags</span>: <span class="ident">EntryFlags</span>::<span class="ident">empty</span>(),
}
}

48
static/api/actix-web/stable/src/actix_web/server/h2writer.rs.html
View File

@ -260,29 +260,37 @@
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
</pre><pre class="rust ">
<span class="attribute">#![<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">redundant_field_names</span>))]</span>
<span class="attribute">#![<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">redundant_field_names</span>)
)]</span>
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">cmp</span>, <span class="ident">io</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">http2</span>::<span class="ident">server</span>::<span class="ident">SendResponse</span>;
<span class="kw">use</span> <span class="ident">http2</span>::{<span class="ident">Reason</span>, <span class="ident">SendStream</span>};
<span class="kw">use</span> <span class="ident">modhttp</span>::<span class="ident">Response</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">cmp</span>, <span class="ident">io</span>};
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">HttpTryFrom</span>, <span class="ident">Method</span>, <span class="ident">Version</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">helpers</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">message</span>::<span class="ident">Request</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">output</span>::{<span class="ident">Output</span>, <span class="ident">ResponseInfo</span>, <span class="ident">ResponseLength</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">WorkerSettings</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="kw">super</span>::{<span class="ident">Writer</span>, <span class="ident">WriterState</span>, <span class="ident">MAX_WRITE_BUFFER_SIZE</span>};
<span class="kw">use</span> <span class="ident">body</span>::{<span class="ident">Binary</span>, <span class="ident">Body</span>};
<span class="kw">use</span> <span class="ident">header</span>::<span class="ident">ContentEncoding</span>;
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{
<span class="ident">HeaderValue</span>, <span class="ident">CONNECTION</span>, <span class="ident">CONTENT_ENCODING</span>, <span class="ident">CONTENT_LENGTH</span>, <span class="ident">DATE</span>, <span class="ident">TRANSFER_ENCODING</span>,
};
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">HttpTryFrom</span>, <span class="ident">Method</span>, <span class="ident">Version</span>};
<span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponse</span>;
<span class="kw">const</span> <span class="ident">CHUNK_SIZE</span>: <span class="ident">usize</span> <span class="op">=</span> <span class="number">16_384</span>;
@ -303,13 +311,11 @@
<span class="ident">written</span>: <span class="ident">u64</span>,
<span class="ident">buffer</span>: <span class="ident">Output</span>,
<span class="ident">buffer_capacity</span>: <span class="ident">usize</span>,
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">H2Writer</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">respond</span>: <span class="ident">SendResponse</span><span class="op">&lt;</span><span class="ident">Bytes</span><span class="op">&gt;</span>, <span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
) <span class="op">-&gt;</span> <span class="ident">H2Writer</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">respond</span>: <span class="ident">SendResponse</span><span class="op">&lt;</span><span class="ident">Bytes</span><span class="op">&gt;</span>, <span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">H2Writer</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">H2Writer</span> {
<span class="ident">stream</span>: <span class="prelude-val">None</span>,
<span class="ident">flags</span>: <span class="ident">Flags</span>::<span class="ident">empty</span>(),
@ -359,6 +365,7 @@
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">has_date</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">Response</span>::<span class="ident">new</span>(());
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">len_is_set</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw-2">*</span><span class="ident">resp</span>.<span class="ident">status_mut</span>() <span class="op">=</span> <span class="ident">msg</span>.<span class="ident">status</span>();
<span class="kw-2">*</span><span class="ident">resp</span>.<span class="ident">version_mut</span>() <span class="op">=</span> <span class="ident">Version</span>::<span class="ident">HTTP_2</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">value</span>) <span class="kw">in</span> <span class="ident">msg</span>.<span class="ident">headers</span>().<span class="ident">iter</span>() {
@ -370,12 +377,15 @@
},
<span class="ident">CONTENT_LENGTH</span> <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">info</span>.<span class="ident">length</span> {
<span class="ident">ResponseLength</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> (),
<span class="ident">ResponseLength</span>::<span class="ident">Zero</span> <span class="op">=&gt;</span> {
<span class="ident">len_is_set</span> <span class="op">=</span> <span class="bool-val">true</span>;
}
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="kw">continue</span>,
},
<span class="ident">DATE</span> <span class="op">=&gt;</span> <span class="ident">has_date</span> <span class="op">=</span> <span class="bool-val">true</span>,
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="ident">resp</span>.<span class="ident">headers_mut</span>().<span class="ident">insert</span>(<span class="ident">key</span>, <span class="ident">value</span>.<span class="ident">clone</span>());
<span class="ident">resp</span>.<span class="ident">headers_mut</span>().<span class="ident">append</span>(<span class="ident">key</span>, <span class="ident">value</span>.<span class="ident">clone</span>());
}
<span class="comment">// set date header</span>
@ -389,8 +399,10 @@
<span class="comment">// content length</span>
<span class="kw">match</span> <span class="ident">info</span>.<span class="ident">length</span> {
<span class="ident">ResponseLength</span>::<span class="ident">Zero</span> <span class="op">=&gt;</span> {
<span class="ident">resp</span>.<span class="ident">headers_mut</span>()
.<span class="ident">insert</span>(<span class="ident">CONTENT_LENGTH</span>, <span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;0&quot;</span>));
<span class="kw">if</span> <span class="op">!</span><span class="ident">len_is_set</span> {
<span class="ident">resp</span>.<span class="ident">headers_mut</span>()
.<span class="ident">insert</span>(<span class="ident">CONTENT_LENGTH</span>, <span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;0&quot;</span>));
}
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">EOF</span>);
}
<span class="ident">ResponseLength</span>::<span class="ident">Length</span>(<span class="ident">len</span>) <span class="op">=&gt;</span> {
@ -407,6 +419,9 @@
<span class="ident">resp</span>.<span class="ident">headers_mut</span>()
.<span class="ident">insert</span>(<span class="ident">CONTENT_LENGTH</span>, <span class="ident">HeaderValue</span>::<span class="ident">try_from</span>(<span class="ident">l</span>.<span class="ident">as_str</span>()).<span class="ident">unwrap</span>());
}
<span class="ident">ResponseLength</span>::<span class="prelude-val">None</span> <span class="op">=&gt;</span> {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">EOF</span>);
}
<span class="kw">_</span> <span class="op">=&gt;</span> (),
}
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ce</span>) <span class="op">=</span> <span class="ident">info</span>.<span class="ident">content_encoding</span> {
@ -414,6 +429,8 @@
.<span class="ident">insert</span>(<span class="ident">CONTENT_ENCODING</span>, <span class="ident">HeaderValue</span>::<span class="ident">try_from</span>(<span class="ident">ce</span>).<span class="ident">unwrap</span>());
}
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Response: {:?}&quot;</span>, <span class="ident">resp</span>);
<span class="kw">match</span> <span class="self">self</span>
.<span class="ident">respond</span>
.<span class="ident">send_response</span>(<span class="ident">resp</span>, <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">EOF</span>))
@ -422,15 +439,12 @@
<span class="prelude-val">Err</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">io</span>::<span class="ident">Error</span>::<span class="ident">new</span>(<span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">Other</span>, <span class="string">&quot;err&quot;</span>)),
}
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Response: {:?}&quot;</span>, <span class="ident">msg</span>);
<span class="kw">let</span> <span class="ident">body</span> <span class="op">=</span> <span class="ident">msg</span>.<span class="ident">replace_body</span>(<span class="ident">Body</span>::<span class="ident">Empty</span>);
<span class="kw">if</span> <span class="kw">let</span> <span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="ident">bytes</span>) <span class="op">=</span> <span class="ident">body</span> {
<span class="kw">if</span> <span class="ident">bytes</span>.<span class="ident">is_empty</span>() {
<span class="prelude-val">Ok</span>(<span class="ident">WriterState</span>::<span class="ident">Done</span>)
} <span class="kw">else</span> {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">EOF</span>);
<span class="self">self</span>.<span class="ident">written</span> <span class="op">=</span> <span class="ident">bytes</span>.<span class="ident">len</span>() <span class="kw">as</span> <span class="ident">u64</span>;
<span class="self">self</span>.<span class="ident">buffer</span>.<span class="ident">write</span>(<span class="ident">bytes</span>.<span class="ident">as_ref</span>())<span class="question-mark">?</span>;
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">stream</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">stream</span> {
<span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">insert</span>(<span class="ident">Flags</span>::<span class="ident">RESERVED</span>);
@ -446,8 +460,6 @@
}
<span class="kw">fn</span> <span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">payload</span>: <span class="kw-2">&amp;</span><span class="ident">Binary</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">WriterState</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">written</span> <span class="op">=</span> <span class="ident">payload</span>.<span class="ident">len</span>() <span class="kw">as</span> <span class="ident">u64</span>;
<span class="kw">if</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">DISCONNECTED</span>) {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">Flags</span>::<span class="ident">STARTED</span>) {
<span class="comment">// TODO: add warning, write after EOF</span>

419
static/api/actix-web/stable/src/actix_web/server/handler.rs.html Normal file
View File

@ -0,0 +1,419 @@
<!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="Source to the Rust file `src/server/handler.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>handler.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Future</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">message</span>::<span class="ident">Request</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">Writer</span>;
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">Error</span>;
<span class="doccomment">/// Low level http request handler</span>
<span class="attribute">#[<span class="ident">allow</span>(<span class="ident">unused_variables</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">HttpHandler</span>: <span class="lifetime">&#39;static</span> {
<span class="doccomment">/// Request handling task</span>
<span class="kw">type</span> <span class="ident">Task</span>: <span class="ident">HttpHandlerTask</span>;
<span class="doccomment">/// Handle request</span>
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Task</span>, <span class="ident">Request</span><span class="op">&gt;</span>;
}
<span class="kw">impl</span> <span class="ident">HttpHandler</span> <span class="kw">for</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandler</span><span class="op">&lt;</span><span class="ident">Task</span> <span class="op">=</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Task</span> <span class="op">=</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span>, <span class="ident">Request</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">as_ref</span>().<span class="ident">handle</span>(<span class="ident">req</span>)
}
}
<span class="doccomment">/// Low level http request handler</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">HttpHandlerTask</span> {
<span class="doccomment">/// Poll task, this method is used before or after *io* object is available</span>
<span class="kw">fn</span> <span class="ident">poll_completed</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="doccomment">/// Poll task when *io* object is available</span>
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="doccomment">/// Connection is disconnected</span>
<span class="kw">fn</span> <span class="ident">disconnected</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {}
}
<span class="kw">impl</span> <span class="ident">HttpHandlerTask</span> <span class="kw">for</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">as_mut</span>().<span class="ident">poll_io</span>(<span class="ident">io</span>)
}
}
<span class="kw">pub</span>(<span class="kw">super</span>) <span class="kw">struct</span> <span class="ident">HttpHandlerTaskFut</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">HttpHandlerTask</span><span class="op">&gt;</span> {
<span class="ident">task</span>: <span class="ident">T</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">HttpHandlerTask</span><span class="op">&gt;</span> <span class="ident">HttpHandlerTaskFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">task</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">Self</span> { <span class="ident">task</span> }
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">HttpHandlerTask</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">HttpHandlerTaskFut</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Item</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> ();
<span class="kw">fn</span> <span class="ident">poll</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">task</span>.<span class="ident">poll_completed</span>().<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ())
}
}
<span class="doccomment">/// Conversion helper trait</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">IntoHttpHandler</span> {
<span class="doccomment">/// The associated type which is result of conversion.</span>
<span class="kw">type</span> <span class="ident">Handler</span>: <span class="ident">HttpHandler</span>;
<span class="doccomment">/// Convert into `HttpHandler` object.</span>
<span class="kw">fn</span> <span class="ident">into_handler</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Handler</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span> <span class="ident">IntoHttpHandler</span> <span class="kw">for</span> <span class="ident">T</span> {
<span class="kw">type</span> <span class="ident">Handler</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">fn</span> <span class="ident">into_handler</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Handler</span> {
<span class="self">self</span>
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IntoHttpHandler</span><span class="op">&gt;</span> <span class="ident">IntoHttpHandler</span> <span class="kw">for</span> <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Handler</span> <span class="op">=</span> <span class="ident">VecHttpHandler</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Handler</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">into_handler</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Handler</span> {
<span class="ident">VecHttpHandler</span>(<span class="self">self</span>.<span class="ident">into_iter</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">item</span><span class="op">|</span> <span class="ident">item</span>.<span class="ident">into_handler</span>()).<span class="ident">collect</span>())
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">VecHttpHandler</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span>(<span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>);
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span> <span class="ident">HttpHandler</span> <span class="kw">for</span> <span class="ident">VecHttpHandler</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Task</span> <span class="op">=</span> <span class="ident">H</span>::<span class="ident">Task</span>;
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="kw-2">mut</span> <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Task</span>, <span class="ident">Request</span><span class="op">&gt;</span> {
<span class="kw">for</span> <span class="ident">h</span> <span class="kw">in</span> <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="number">0</span> {
<span class="ident">req</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">h</span>.<span class="ident">handle</span>(<span class="ident">req</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">task</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">task</span>),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="ident">e</span>,
};
}
<span class="prelude-val">Err</span>(<span class="ident">req</span>)
}
}
<span class="macro">macro_rules</span><span class="macro">!</span> <span class="ident">http_handler</span> ({<span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span>:<span class="ident">ident</span>, $((<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>:<span class="ident">tt</span>, <span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>:<span class="ident">ident</span>)),<span class="op">+</span>} <span class="op">=&gt;</span> {
<span class="kw">impl</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>: <span class="ident">HttpHandler</span>,)<span class="op">+</span><span class="op">&gt;</span> <span class="ident">HttpHandler</span> <span class="kw">for</span> ($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>) {
<span class="kw">type</span> <span class="ident">Task</span> <span class="op">=</span> <span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="kw-2">mut</span> <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Task</span>, <span class="ident">Request</span><span class="op">&gt;</span> {
$(
<span class="ident">req</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">self</span>.<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>.<span class="ident">handle</span>(<span class="ident">req</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">task</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span>::<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>(<span class="ident">task</span>)),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="ident">e</span>,
};
)<span class="op">+</span>
<span class="prelude-val">Err</span>(<span class="ident">req</span>)
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>: <span class="ident">HttpHandler</span>,)<span class="op">+</span><span class="op">&gt;</span> {
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span> (<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>::<span class="ident">Task</span>),)<span class="op">+</span>
}
<span class="kw">impl</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>: <span class="ident">HttpHandler</span>,)<span class="op">+</span><span class="op">&gt;</span> <span class="ident">HttpHandlerTask</span> <span class="kw">for</span> <span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span><span class="op">&gt;</span>
{
<span class="kw">fn</span> <span class="ident">poll_completed</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span> {
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span> :: <span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">task</span>) <span class="op">=&gt;</span> <span class="ident">task</span>.<span class="ident">poll_completed</span>(),)<span class="op">+</span>
}
}
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="self">self</span> {
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span>::<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">task</span>) <span class="op">=&gt;</span> <span class="ident">task</span>.<span class="ident">poll_io</span>(<span class="ident">io</span>),)<span class="op">+</span>
}
}
<span class="doccomment">/// Connection is disconnected</span>
<span class="kw">fn</span> <span class="ident">disconnected</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="kw">match</span> <span class="self">self</span> {
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">EN</span>::<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">task</span>) <span class="op">=&gt;</span> <span class="ident">task</span>.<span class="ident">disconnected</span>(),)<span class="op">+</span>
}
}
}
});
<span class="macro">http_handler</span><span class="macro">!</span>(<span class="ident">HttpHandlerTask1</span>, (<span class="number">0</span>, <span class="ident">A</span>));
<span class="macro">http_handler</span><span class="macro">!</span>(<span class="ident">HttpHandlerTask2</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>));
<span class="macro">http_handler</span><span class="macro">!</span>(<span class="ident">HttpHandlerTask3</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>), (<span class="number">2</span>, <span class="ident">C</span>));
<span class="macro">http_handler</span><span class="macro">!</span>(<span class="ident">HttpHandlerTask4</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>), (<span class="number">2</span>, <span class="ident">C</span>), (<span class="number">3</span>, <span class="ident">D</span>));
<span class="macro">http_handler</span><span class="macro">!</span>(<span class="ident">HttpHandlerTask5</span>, (<span class="number">0</span>, <span class="ident">A</span>), (<span class="number">1</span>, <span class="ident">B</span>), (<span class="number">2</span>, <span class="ident">C</span>), (<span class="number">3</span>, <span class="ident">D</span>), (<span class="number">4</span>, <span class="ident">E</span>));
<span class="macro">http_handler</span><span class="macro">!</span>(
<span class="ident">HttpHandlerTask6</span>,
(<span class="number">0</span>, <span class="ident">A</span>),
(<span class="number">1</span>, <span class="ident">B</span>),
(<span class="number">2</span>, <span class="ident">C</span>),
(<span class="number">3</span>, <span class="ident">D</span>),
(<span class="number">4</span>, <span class="ident">E</span>),
(<span class="number">5</span>, <span class="ident">F</span>)
);
<span class="macro">http_handler</span><span class="macro">!</span>(
<span class="ident">HttpHandlerTask7</span>,
(<span class="number">0</span>, <span class="ident">A</span>),
(<span class="number">1</span>, <span class="ident">B</span>),
(<span class="number">2</span>, <span class="ident">C</span>),
(<span class="number">3</span>, <span class="ident">D</span>),
(<span class="number">4</span>, <span class="ident">E</span>),
(<span class="number">5</span>, <span class="ident">F</span>),
(<span class="number">6</span>, <span class="ident">G</span>)
);
<span class="macro">http_handler</span><span class="macro">!</span>(
<span class="ident">HttpHandlerTask8</span>,
(<span class="number">0</span>, <span class="ident">A</span>),
(<span class="number">1</span>, <span class="ident">B</span>),
(<span class="number">2</span>, <span class="ident">C</span>),
(<span class="number">3</span>, <span class="ident">D</span>),
(<span class="number">4</span>, <span class="ident">E</span>),
(<span class="number">5</span>, <span class="ident">F</span>),
(<span class="number">6</span>, <span class="ident">G</span>),
(<span class="number">7</span>, <span class="ident">H</span>)
);
<span class="macro">http_handler</span><span class="macro">!</span>(
<span class="ident">HttpHandlerTask9</span>,
(<span class="number">0</span>, <span class="ident">A</span>),
(<span class="number">1</span>, <span class="ident">B</span>),
(<span class="number">2</span>, <span class="ident">C</span>),
(<span class="number">3</span>, <span class="ident">D</span>),
(<span class="number">4</span>, <span class="ident">E</span>),
(<span class="number">5</span>, <span class="ident">F</span>),
(<span class="number">6</span>, <span class="ident">G</span>),
(<span class="number">7</span>, <span class="ident">H</span>),
(<span class="number">8</span>, <span class="ident">I</span>)
);
<span class="macro">http_handler</span><span class="macro">!</span>(
<span class="ident">HttpHandlerTask10</span>,
(<span class="number">0</span>, <span class="ident">A</span>),
(<span class="number">1</span>, <span class="ident">B</span>),
(<span class="number">2</span>, <span class="ident">C</span>),
(<span class="number">3</span>, <span class="ident">D</span>),
(<span class="number">4</span>, <span class="ident">E</span>),
(<span class="number">5</span>, <span class="ident">F</span>),
(<span class="number">6</span>, <span class="ident">G</span>),
(<span class="number">7</span>, <span class="ident">H</span>),
(<span class="number">8</span>, <span class="ident">I</span>),
(<span class="number">9</span>, <span class="ident">J</span>)
);
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

108
static/api/actix-web/stable/src/actix_web/server/helpers.rs.html
View File

@ -192,6 +192,20 @@
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">BufMut</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">Version</span>;
@ -203,8 +217,10 @@
6061626364656667686970717273747576777879\
8081828384858687888990919293949596979899&quot;</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">const</span> <span class="ident">STATUS_LINE_BUF_SIZE</span>: <span class="ident">usize</span> <span class="op">=</span> <span class="number">13</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">write_status_line</span>(<span class="ident">version</span>: <span class="ident">Version</span>, <span class="kw-2">mut</span> <span class="ident">n</span>: <span class="ident">u16</span>, <span class="ident">bytes</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>) {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="number">13</span>] <span class="op">=</span> [
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="ident">STATUS_LINE_BUF_SIZE</span>] <span class="op">=</span> [
<span class="string">b&#39;H&#39;</span>, <span class="string">b&#39;T&#39;</span>, <span class="string">b&#39;T&#39;</span>, <span class="string">b&#39;P&#39;</span>, <span class="string">b&#39;/&#39;</span>, <span class="string">b&#39;1&#39;</span>, <span class="string">b&#39;.&#39;</span>, <span class="string">b&#39;1&#39;</span>, <span class="string">b&#39; &#39;</span>, <span class="string">b&#39; &#39;</span>, <span class="string">b&#39; &#39;</span>, <span class="string">b&#39; &#39;</span>, <span class="string">b&#39; &#39;</span>,
];
<span class="kw">match</span> <span class="ident">version</span> {
@ -222,20 +238,24 @@
<span class="kw">let</span> <span class="ident">lut_ptr</span> <span class="op">=</span> <span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>();
<span class="kw">let</span> <span class="ident">four</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&gt;</span> <span class="number">999</span>;
<span class="comment">// decode 2 more chars, if &gt; 2 chars</span>
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">100</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="kw">unsafe</span> {
<span class="comment">// decode 2 more chars, if &gt; 2 chars</span>
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">100</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d1</span> <span class="kw">as</span> <span class="ident">isize</span>), <span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>), <span class="number">2</span>);
}
<span class="comment">// decode last 1 or 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&lt;</span> <span class="number">10</span> {
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">1</span>;
<span class="comment">// decode last 1 or 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&lt;</span> <span class="number">10</span> {
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">1</span>;
<span class="kw">unsafe</span> {
<span class="kw-2">*</span><span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>) <span class="op">=</span> (<span class="ident">n</span> <span class="kw">as</span> <span class="ident">u8</span>) <span class="op">+</span> <span class="string">b&#39;0&#39;</span>;
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
}
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(
<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d1</span> <span class="kw">as</span> <span class="ident">isize</span>),
<span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>),
@ -267,7 +287,7 @@
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(
<span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>().<span class="ident">offset</span>(<span class="ident">d1</span> <span class="kw">as</span> <span class="ident">isize</span>),
<span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>().<span class="ident">add</span>(<span class="ident">d1</span>),
<span class="ident">buf</span>.<span class="ident">as_mut_ptr</span>().<span class="ident">offset</span>(<span class="number">18</span>),
<span class="number">2</span>,
);
@ -283,7 +303,7 @@
<span class="ident">n</span> <span class="op">/=</span> <span class="number">100</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(
<span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>().<span class="ident">offset</span>(<span class="ident">d1</span> <span class="kw">as</span> <span class="ident">isize</span>),
<span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>().<span class="ident">add</span>(<span class="ident">d1</span>),
<span class="ident">buf</span>.<span class="ident">as_mut_ptr</span>().<span class="ident">offset</span>(<span class="number">19</span>),
<span class="number">2</span>,
)
@ -300,47 +320,55 @@
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">convert_usize</span>(<span class="kw-2">mut</span> <span class="ident">n</span>: <span class="ident">usize</span>, <span class="ident">bytes</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>) {
<span class="kw">unsafe</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">curr</span>: <span class="ident">isize</span> <span class="op">=</span> <span class="number">39</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="number">41</span>] <span class="op">=</span> <span class="ident">mem</span>::<span class="ident">uninitialized</span>();
<span class="ident">buf</span>[<span class="number">39</span>] <span class="op">=</span> <span class="string">b&#39;\r&#39;</span>;
<span class="ident">buf</span>[<span class="number">40</span>] <span class="op">=</span> <span class="string">b&#39;\n&#39;</span>;
<span class="kw">let</span> <span class="ident">buf_ptr</span> <span class="op">=</span> <span class="ident">buf</span>.<span class="ident">as_mut_ptr</span>();
<span class="kw">let</span> <span class="ident">lut_ptr</span> <span class="op">=</span> <span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>();
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">curr</span>: <span class="ident">isize</span> <span class="op">=</span> <span class="number">39</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="number">41</span>] <span class="op">=</span> <span class="kw">unsafe</span> { <span class="ident">mem</span>::<span class="ident">uninitialized</span>() };
<span class="ident">buf</span>[<span class="number">39</span>] <span class="op">=</span> <span class="string">b&#39;\r&#39;</span>;
<span class="ident">buf</span>[<span class="number">40</span>] <span class="op">=</span> <span class="string">b&#39;\n&#39;</span>;
<span class="kw">let</span> <span class="ident">buf_ptr</span> <span class="op">=</span> <span class="ident">buf</span>.<span class="ident">as_mut_ptr</span>();
<span class="kw">let</span> <span class="ident">lut_ptr</span> <span class="op">=</span> <span class="ident">DEC_DIGITS_LUT</span>.<span class="ident">as_ptr</span>();
<span class="comment">// eagerly decode 4 characters at a time</span>
<span class="kw">while</span> <span class="ident">n</span> <span class="op">&gt;=</span> <span class="number">10_000</span> {
<span class="kw">let</span> <span class="ident">rem</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">10_000</span>) <span class="kw">as</span> <span class="ident">isize</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">10_000</span>;
<span class="comment">// eagerly decode 4 characters at a time</span>
<span class="kw">while</span> <span class="ident">n</span> <span class="op">&gt;=</span> <span class="number">10_000</span> {
<span class="kw">let</span> <span class="ident">rem</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">10_000</span>) <span class="kw">as</span> <span class="ident">isize</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">10_000</span>;
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">rem</span> <span class="op">/</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="kw">let</span> <span class="ident">d2</span> <span class="op">=</span> (<span class="ident">rem</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">4</span>;
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">rem</span> <span class="op">/</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="kw">let</span> <span class="ident">d2</span> <span class="op">=</span> (<span class="ident">rem</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">4</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d1</span>), <span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>), <span class="number">2</span>);
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d2</span>), <span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span> <span class="op">+</span> <span class="number">2</span>), <span class="number">2</span>);
}
}
<span class="comment">// if we reach here numbers are &lt;= 9999, so at most 4 chars long</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">n</span> <span class="op">=</span> <span class="ident">n</span> <span class="kw">as</span> <span class="ident">isize</span>; <span class="comment">// possibly reduce 64bit math</span>
<span class="comment">// if we reach here numbers are &lt;= 9999, so at most 4 chars long</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">n</span> <span class="op">=</span> <span class="ident">n</span> <span class="kw">as</span> <span class="ident">isize</span>; <span class="comment">// possibly reduce 64bit math</span>
<span class="comment">// decode 2 more chars, if &gt; 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&gt;=</span> <span class="number">100</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">100</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="comment">// decode 2 more chars, if &gt; 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&gt;=</span> <span class="number">100</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> (<span class="ident">n</span> <span class="op">%</span> <span class="number">100</span>) <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">n</span> <span class="op">/=</span> <span class="number">100</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d1</span>), <span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>), <span class="number">2</span>);
}
}
<span class="comment">// decode last 1 or 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&lt;</span> <span class="number">10</span> {
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">1</span>;
<span class="comment">// decode last 1 or 2 chars</span>
<span class="kw">if</span> <span class="ident">n</span> <span class="op">&lt;</span> <span class="number">10</span> {
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">1</span>;
<span class="kw">unsafe</span> {
<span class="kw-2">*</span><span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>) <span class="op">=</span> (<span class="ident">n</span> <span class="kw">as</span> <span class="ident">u8</span>) <span class="op">+</span> <span class="string">b&#39;0&#39;</span>;
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
}
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="ident">d1</span> <span class="op">=</span> <span class="ident">n</span> <span class="op">&lt;&lt;</span> <span class="number">1</span>;
<span class="ident">curr</span> <span class="op">-=</span> <span class="number">2</span>;
<span class="kw">unsafe</span> {
<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>(<span class="ident">lut_ptr</span>.<span class="ident">offset</span>(<span class="ident">d1</span>), <span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>), <span class="number">2</span>);
}
}
<span class="kw">unsafe</span> {
<span class="ident">bytes</span>.<span class="ident">extend_from_slice</span>(<span class="ident">slice</span>::<span class="ident">from_raw_parts</span>(
<span class="ident">buf_ptr</span>.<span class="ident">offset</span>(<span class="ident">curr</span>),
<span class="number">41</span> <span class="op">-</span> <span class="ident">curr</span> <span class="kw">as</span> <span class="ident">usize</span>,

1161
static/api/actix-web/stable/src/actix_web/server/http.rs.html Normal file
View File

File diff suppressed because it is too large Load Diff

141
static/api/actix-web/stable/src/actix_web/server/incoming.rs.html Normal file
View File

@ -0,0 +1,141 @@
<!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="Source to the Rust file `src/server/incoming.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>incoming.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<span id="25">25</span>
<span id="26">26</span>
<span id="27">27</span>
<span id="28">28</span>
<span id="29">29</span>
<span id="30">30</span>
<span id="31">31</span>
<span id="32">32</span>
<span id="33">33</span>
<span id="34">34</span>
<span id="35">35</span>
<span id="36">36</span>
<span id="37">37</span>
<span id="38">38</span>
<span id="39">39</span>
<span id="40">40</span>
<span id="41">41</span>
<span id="42">42</span>
<span id="43">43</span>
<span id="44">44</span>
<span id="45">45</span>
<span id="46">46</span>
<span id="47">47</span>
<span id="48">48</span>
<span id="49">49</span>
<span id="50">50</span>
<span id="51">51</span>
<span id="52">52</span>
<span id="53">53</span>
<span id="54">54</span>
<span id="55">55</span>
<span id="56">56</span>
<span id="57">57</span>
<span id="58">58</span>
<span id="59">59</span>
<span id="60">60</span>
<span id="61">61</span>
<span id="62">62</span>
<span id="63">63</span>
<span id="64">64</span>
<span id="65">65</span>
<span id="66">66</span>
<span id="67">67</span>
<span id="68">68</span>
<span id="69">69</span>
</pre><pre class="rust ">
<span class="doccomment">//! Support for `Stream&lt;Item=T::AsyncReady+AsyncWrite&gt;`, deprecated!</span>
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">net</span>};
<span class="kw">use</span> <span class="ident">actix</span>::{<span class="ident">Actor</span>, <span class="ident">Arbiter</span>, <span class="ident">AsyncContext</span>, <span class="ident">Context</span>, <span class="ident">Handler</span>, <span class="ident">Message</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Future</span>, <span class="ident">Stream</span>};
<span class="kw">use</span> <span class="ident">tokio_io</span>::{<span class="ident">AsyncRead</span>, <span class="ident">AsyncWrite</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">channel</span>::{<span class="ident">HttpChannel</span>, <span class="ident">WrapperStream</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">handler</span>::{<span class="ident">HttpHandler</span>, <span class="ident">IntoHttpHandler</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">http</span>::<span class="ident">HttpServer</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::{<span class="ident">ServerSettings</span>, <span class="ident">ServiceConfig</span>};
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Message</span> <span class="kw">for</span> <span class="ident">WrapperStream</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> ();
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">F</span><span class="op">&gt;</span> <span class="ident">HttpServer</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">F</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">IntoHttpHandler</span>,
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span>,
{
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="attribute">#[<span class="ident">deprecated</span>(<span class="ident">since</span> <span class="op">=</span> <span class="string">&quot;0.7.8&quot;</span>)]</span>
<span class="doccomment">/// Start listening for incoming connections from a stream.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// This method uses only one thread for handling incoming connections.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">start_incoming</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">stream</span>: <span class="ident">S</span>, <span class="ident">secure</span>: <span class="ident">bool</span>)
<span class="kw">where</span>
<span class="ident">S</span>: <span class="ident">Stream</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="comment">// set server settings</span>
<span class="kw">let</span> <span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span> <span class="op">=</span> <span class="string">&quot;127.0.0.1:8080&quot;</span>.<span class="ident">parse</span>().<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">apps</span> <span class="op">=</span> (<span class="self">self</span>.<span class="ident">factory</span>)().<span class="ident">into_handler</span>();
<span class="kw">let</span> <span class="ident">settings</span> <span class="op">=</span> <span class="ident">ServiceConfig</span>::<span class="ident">new</span>(
<span class="ident">apps</span>,
<span class="self">self</span>.<span class="ident">keep_alive</span>,
<span class="self">self</span>.<span class="ident">client_timeout</span>,
<span class="self">self</span>.<span class="ident">client_shutdown</span>,
<span class="ident">ServerSettings</span>::<span class="ident">new</span>(<span class="ident">addr</span>, <span class="string">&quot;127.0.0.1:8080&quot;</span>, <span class="ident">secure</span>),
);
<span class="comment">// start server</span>
<span class="ident">HttpIncoming</span>::<span class="ident">create</span>(<span class="kw">move</span> <span class="op">|</span><span class="ident">ctx</span><span class="op">|</span> {
<span class="ident">ctx</span>.<span class="ident">add_message_stream</span>(<span class="ident">stream</span>.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ()).<span class="ident">map</span>(<span class="ident">WrapperStream</span>::<span class="ident">new</span>));
<span class="ident">HttpIncoming</span> { <span class="ident">settings</span> }
});
}
}
<span class="kw">struct</span> <span class="ident">HttpIncoming</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span> {
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span> <span class="ident">Actor</span> <span class="kw">for</span> <span class="ident">HttpIncoming</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Context</span> <span class="op">=</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">WrapperStream</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span> <span class="kw">for</span> <span class="ident">HttpIncoming</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span>,
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
{
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> ();
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">msg</span>: <span class="ident">WrapperStream</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>, <span class="kw">_</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="prelude-ty">Result</span> {
<span class="ident">Arbiter</span>::<span class="ident">spawn</span>(<span class="ident">HttpChannel</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>(), <span class="ident">msg</span>).<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ()));
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

198
static/api/actix-web/stable/src/actix_web/server/input.rs.html
View File

@ -286,87 +286,15 @@
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
<span id="295">295</span>
<span id="296">296</span>
<span id="297">297</span>
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
<span id="306">306</span>
<span id="307">307</span>
<span id="308">308</span>
<span id="309">309</span>
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::{<span class="ident">Read</span>, <span class="ident">Write</span>};
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">cmp</span>, <span class="ident">io</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::{<span class="self">self</span>, <span class="ident">Write</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">brotli2</span>::<span class="ident">write</span>::<span class="ident">BrotliDecoder</span>;
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">BufMut</span>, <span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">Bytes</span>, <span class="ident">BytesMut</span>};
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">PayloadError</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">read</span>::<span class="ident">GzDecoder</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::<span class="ident">DeflateDecoder</span>;
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::{<span class="ident">GzDecoder</span>, <span class="ident">ZlibDecoder</span>};
<span class="kw">use</span> <span class="ident">header</span>::<span class="ident">ContentEncoding</span>;
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{<span class="ident">HeaderMap</span>, <span class="ident">CONTENT_ENCODING</span>};
<span class="kw">use</span> <span class="ident">payload</span>::{<span class="ident">PayloadSender</span>, <span class="ident">PayloadStatus</span>, <span class="ident">PayloadWriter</span>};
@ -500,48 +428,14 @@
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">Decoder</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Deflate</span>(<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">DeflateDecoder</span><span class="op">&lt;</span><span class="ident">Writer</span><span class="op">&gt;&gt;</span>),
<span class="ident">Deflate</span>(<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">ZlibDecoder</span><span class="op">&lt;</span><span class="ident">Writer</span><span class="op">&gt;&gt;</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Gzip</span>(<span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">GzDecoder</span><span class="op">&lt;</span><span class="ident">Wrapper</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>),
<span class="ident">Gzip</span>(<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">GzDecoder</span><span class="op">&lt;</span><span class="ident">Writer</span><span class="op">&gt;&gt;</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>)]</span>
<span class="ident">Br</span>(<span class="ident">Box</span><span class="op">&lt;</span><span class="ident">BrotliDecoder</span><span class="op">&lt;</span><span class="ident">Writer</span><span class="op">&gt;&gt;</span>),
<span class="ident">Identity</span>,
}
<span class="comment">// should go after write::GzDecoder get implemented</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">Wrapper</span> {
<span class="kw">pub</span> <span class="ident">buf</span>: <span class="ident">BytesMut</span>,
<span class="kw">pub</span> <span class="ident">eof</span>: <span class="ident">bool</span>,
}
<span class="kw">impl</span> <span class="ident">io</span>::<span class="ident">Read</span> <span class="kw">for</span> <span class="ident">Wrapper</span> {
<span class="kw">fn</span> <span class="ident">read</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> [<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">len</span> <span class="op">=</span> <span class="ident">cmp</span>::<span class="ident">min</span>(<span class="ident">buf</span>.<span class="ident">len</span>(), <span class="self">self</span>.<span class="ident">buf</span>.<span class="ident">len</span>());
<span class="ident">buf</span>[..<span class="ident">len</span>].<span class="ident">copy_from_slice</span>(<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">buf</span>[..<span class="ident">len</span>]);
<span class="self">self</span>.<span class="ident">buf</span>.<span class="ident">split_to</span>(<span class="ident">len</span>);
<span class="kw">if</span> <span class="ident">len</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">eof</span> {
<span class="prelude-val">Ok</span>(<span class="number">0</span>)
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">io</span>::<span class="ident">Error</span>::<span class="ident">new</span>(<span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WouldBlock</span>, <span class="string">&quot;&quot;</span>))
}
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="ident">len</span>)
}
}
}
<span class="kw">impl</span> <span class="ident">io</span>::<span class="ident">Write</span> <span class="kw">for</span> <span class="ident">Wrapper</span> {
<span class="kw">fn</span> <span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">buf</span>.<span class="ident">extend_from_slice</span>(<span class="ident">buf</span>);
<span class="prelude-val">Ok</span>(<span class="ident">buf</span>.<span class="ident">len</span>())
}
<span class="kw">fn</span> <span class="ident">flush</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">Writer</span> {
<span class="ident">buf</span>: <span class="ident">BytesMut</span>,
}
@ -570,28 +464,26 @@
<span class="doccomment">/// Payload stream with decompression support</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">PayloadStream</span> {
<span class="ident">decoder</span>: <span class="ident">Decoder</span>,
<span class="ident">dst</span>: <span class="ident">BytesMut</span>,
}
<span class="kw">impl</span> <span class="ident">PayloadStream</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">enc</span>: <span class="ident">ContentEncoding</span>) <span class="op">-&gt;</span> <span class="ident">PayloadStream</span> {
<span class="kw">let</span> <span class="ident">dec</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">enc</span> {
<span class="kw">let</span> <span class="ident">decoder</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">enc</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Br</span> <span class="op">=&gt;</span> {
<span class="ident">Decoder</span>::<span class="ident">Br</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">BrotliDecoder</span>::<span class="ident">new</span>(<span class="ident">Writer</span>::<span class="ident">new</span>())))
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> {
<span class="ident">Decoder</span>::<span class="ident">Deflate</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">DeflateDecoder</span>::<span class="ident">new</span>(<span class="ident">Writer</span>::<span class="ident">new</span>())))
<span class="ident">Decoder</span>::<span class="ident">Deflate</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">ZlibDecoder</span>::<span class="ident">new</span>(<span class="ident">Writer</span>::<span class="ident">new</span>())))
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> <span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="prelude-val">None</span>),
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> {
<span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">GzDecoder</span>::<span class="ident">new</span>(<span class="ident">Writer</span>::<span class="ident">new</span>())))
}
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="ident">Decoder</span>::<span class="ident">Identity</span>,
};
<span class="ident">PayloadStream</span> {
<span class="ident">decoder</span>: <span class="ident">dec</span>,
<span class="ident">dst</span>: <span class="ident">BytesMut</span>::<span class="ident">new</span>(),
}
<span class="ident">PayloadStream</span> { <span class="ident">decoder</span> }
}
}
@ -611,22 +503,17 @@
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>),
},
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=</span> <span class="kw-2">*</span><span class="ident">decoder</span> {
<span class="ident">decoder</span>.<span class="ident">as_mut</span>().<span class="ident">get_mut</span>().<span class="ident">eof</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">reserve</span>(<span class="number">8192</span>);
<span class="kw">match</span> <span class="ident">decoder</span>.<span class="ident">read</span>(<span class="kw">unsafe</span> { <span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">bytes_mut</span>() }) {
<span class="prelude-val">Ok</span>(<span class="ident">n</span>) <span class="op">=&gt;</span> {
<span class="kw">unsafe</span> { <span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">advance_mut</span>(<span class="ident">n</span>) };
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">take</span>().<span class="ident">freeze</span>()));
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>),
<span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">decoder</span>.<span class="ident">try_finish</span>() {
<span class="prelude-val">Ok</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">decoder</span>.<span class="ident">get_mut</span>().<span class="ident">take</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">b</span>.<span class="ident">is_empty</span>() {
<span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(<span class="ident">b</span>))
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="prelude-val">None</span>)
}
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="prelude-val">None</span>)
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>),
},
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Decoder</span>::<span class="ident">Deflate</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">decoder</span>.<span class="ident">try_finish</span>() {
<span class="prelude-val">Ok</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
@ -659,43 +546,18 @@
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>),
},
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">decoder</span>.<span class="ident">is_none</span>() {
<span class="kw-2">*</span><span class="ident">decoder</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">GzDecoder</span>::<span class="ident">new</span>(<span class="ident">Wrapper</span> {
<span class="ident">buf</span>: <span class="ident">BytesMut</span>::<span class="ident">from</span>(<span class="ident">data</span>),
<span class="ident">eof</span>: <span class="bool-val">false</span>,
})));
} <span class="kw">else</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">decoder</span>.<span class="ident">as_mut</span>().<span class="ident">unwrap</span>().<span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="ident">data</span>);
}
<span class="kw">loop</span> {
<span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">reserve</span>(<span class="number">8192</span>);
<span class="kw">match</span> <span class="ident">decoder</span>
.<span class="ident">as_mut</span>()
.<span class="ident">as_mut</span>()
.<span class="ident">unwrap</span>()
.<span class="ident">read</span>(<span class="kw">unsafe</span> { <span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">bytes_mut</span>() })
{
<span class="prelude-val">Ok</span>(<span class="ident">n</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">n</span> <span class="op">!=</span> <span class="number">0</span> {
<span class="kw">unsafe</span> { <span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">advance_mut</span>(<span class="ident">n</span>) };
}
<span class="kw">if</span> <span class="ident">n</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">take</span>().<span class="ident">freeze</span>()));
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">e</span>.<span class="ident">kind</span>() <span class="op">==</span> <span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WouldBlock</span>
<span class="op">&amp;&amp;</span> <span class="op">!</span><span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">is_empty</span>()
{
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">dst</span>.<span class="ident">take</span>().<span class="ident">freeze</span>()));
}
<span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>);
}
<span class="ident">Decoder</span>::<span class="ident">Gzip</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">decoder</span>.<span class="ident">write_all</span>(<span class="kw-2">&amp;</span><span class="ident">data</span>) {
<span class="prelude-val">Ok</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">decoder</span>.<span class="ident">flush</span>()<span class="question-mark">?</span>;
<span class="kw">let</span> <span class="ident">b</span> <span class="op">=</span> <span class="ident">decoder</span>.<span class="ident">get_mut</span>().<span class="ident">take</span>();
<span class="kw">if</span> <span class="op">!</span><span class="ident">b</span>.<span class="ident">is_empty</span>() {
<span class="prelude-val">Ok</span>(<span class="prelude-val">Some</span>(<span class="ident">b</span>))
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="prelude-val">None</span>)
}
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>),
},
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Decoder</span>::<span class="ident">Deflate</span>(<span class="kw-2">ref</span> <span class="kw-2">mut</span> <span class="ident">decoder</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">decoder</span>.<span class="ident">write_all</span>(<span class="kw-2">&amp;</span><span class="ident">data</span>) {
<span class="prelude-val">Ok</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {

58
static/api/actix-web/stable/src/actix_web/server/message.rs.html
View File

@ -253,9 +253,39 @@
<span id="253">253</span>
<span id="254">254</span>
<span id="255">255</span>
<span id="256">256</span>
<span id="257">257</span>
<span id="258">258</span>
<span id="259">259</span>
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::{<span class="ident">Cell</span>, <span class="ident">Ref</span>, <span class="ident">RefCell</span>, <span class="ident">RefMut</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::<span class="ident">VecDeque</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::<span class="ident">SocketAddr</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
@ -291,6 +321,7 @@
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="ident">info</span>: <span class="ident">RefCell</span><span class="op">&lt;</span><span class="ident">ConnectionInfo</span><span class="op">&gt;</span>,
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="ident">payload</span>: <span class="ident">RefCell</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Payload</span><span class="op">&gt;&gt;</span>,
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="ident">settings</span>: <span class="ident">ServerSettings</span>,
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="ident">stream_extensions</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Extensions</span><span class="op">&gt;&gt;</span>,
<span class="ident">pool</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">RequestPool</span>,
}
@ -338,6 +369,7 @@
<span class="ident">info</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="ident">ConnectionInfo</span>::<span class="ident">default</span>()),
<span class="ident">payload</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="prelude-val">None</span>),
<span class="ident">extensions</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="ident">Extensions</span>::<span class="ident">new</span>()),
<span class="ident">stream_extensions</span>: <span class="prelude-val">None</span>,
}),
}
}
@ -445,6 +477,12 @@
}
}
<span class="doccomment">/// Io stream extensions</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">stream_extensions</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="kw-2">&amp;</span><span class="ident">Extensions</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">inner</span>().<span class="ident">stream_extensions</span>.<span class="ident">as_ref</span>().<span class="ident">map</span>(<span class="op">|</span><span class="ident">e</span><span class="op">|</span> <span class="ident">e</span>.<span class="ident">as_ref</span>())
}
<span class="doccomment">/// Server settings</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">server_settings</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">ServerSettings</span> {
@ -468,6 +506,26 @@
}
}
<span class="kw">impl</span> <span class="ident">fmt</span>::<span class="ident">Debug</span> <span class="kw">for</span> <span class="ident">Request</span> {
<span class="kw">fn</span> <span class="ident">fmt</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">f</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">fmt</span>::<span class="ident">Formatter</span>) <span class="op">-&gt;</span> <span class="ident">fmt</span>::<span class="prelude-ty">Result</span> {
<span class="macro">writeln</span><span class="macro">!</span>(
<span class="ident">f</span>,
<span class="string">&quot;\nRequest {:?} {}:{}&quot;</span>,
<span class="self">self</span>.<span class="ident">version</span>(),
<span class="self">self</span>.<span class="ident">method</span>(),
<span class="self">self</span>.<span class="ident">path</span>()
)<span class="question-mark">?</span>;
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">q</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">uri</span>().<span class="ident">query</span>().<span class="ident">as_ref</span>() {
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; query: ?{:?}&quot;</span>, <span class="ident">q</span>)<span class="question-mark">?</span>;
}
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; headers:&quot;</span>)<span class="question-mark">?</span>;
<span class="kw">for</span> (<span class="ident">key</span>, <span class="ident">val</span>) <span class="kw">in</span> <span class="self">self</span>.<span class="ident">headers</span>().<span class="ident">iter</span>() {
<span class="macro">writeln</span><span class="macro">!</span>(<span class="ident">f</span>, <span class="string">&quot; {:?}: {:?}&quot;</span>, <span class="ident">key</span>, <span class="ident">val</span>)<span class="question-mark">?</span>;
}
<span class="prelude-val">Ok</span>(())
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">RequestPool</span>(
<span class="ident">RefCell</span><span class="op">&lt;</span><span class="ident">VecDeque</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">InnerRequest</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
<span class="ident">RefCell</span><span class="op">&lt;</span><span class="ident">ServerSettings</span><span class="op">&gt;</span>,

404
static/api/actix-web/stable/src/actix_web/server/mod.rs.html
View File

@ -310,9 +310,164 @@
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
<span id="365">365</span>
<span id="366">366</span>
<span id="367">367</span>
</pre><pre class="rust ">
<span class="doccomment">//! Http server</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::<span class="ident">Shutdown</span>;
<span class="doccomment">//! Http server module</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! The module contains everything necessary to setup</span>
<span class="doccomment">//! HTTP server.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! In order to start HTTP server, first you need to create and configure it</span>
<span class="doccomment">//! using factory that can be supplied to [new](fn.new.html).</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! ## Factory</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! Factory is a function that returns Application, describing how</span>
<span class="doccomment">//! to serve incoming HTTP requests.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! As the server uses worker pool, the factory function is restricted to trait bounds</span>
<span class="doccomment">//! `Send + Clone + &#39;static` so that each worker would be able to accept Application</span>
<span class="doccomment">//! without a need for synchronization.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! If you wish to share part of state among all workers you should</span>
<span class="doccomment">//! wrap it in `Arc` and potentially synchronization primitive like</span>
<span class="doccomment">//! [RwLock](https://doc.rust-lang.org/std/sync/struct.RwLock.html)</span>
<span class="doccomment">//! If the wrapped type is not thread safe.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! Note though that locking is not advisable for asynchronous programming</span>
<span class="doccomment">//! and you should minimize all locks in your request handlers</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! ## HTTPS Support</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! Actix-web provides support for major crates that provides TLS.</span>
<span class="doccomment">//! Each TLS implementation is provided with [AcceptorService](trait.AcceptorService.html)</span>
<span class="doccomment">//! that describes how HTTP Server accepts connections.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! For `bind` and `listen` there are corresponding `bind_ssl|tls|rustls` and `listen_ssl|tls|rustls` that accepts</span>
<span class="doccomment">//! these services.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! **NOTE:** `native-tls` doesn&#39;t support `HTTP2` yet</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! ## Signal handling and shutdown</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! By default HTTP Server listens for system signals</span>
<span class="doccomment">//! and, gracefully shuts down at most after 30 seconds.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! Both signal handling and shutdown timeout can be controlled</span>
<span class="doccomment">//! using corresponding methods.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! If worker, for some reason, unable to shut down within timeout</span>
<span class="doccomment">//! it is forcibly dropped.</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! ## Example</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! ```rust,ignore</span>
<span class="doccomment">//!extern crate actix;</span>
<span class="doccomment">//!extern crate actix_web;</span>
<span class="doccomment">//!extern crate rustls;</span>
<span class="doccomment">//!</span>
<span class="doccomment">//!use actix_web::{http, middleware, server, App, Error, HttpRequest, HttpResponse, Responder};</span>
<span class="doccomment">//!use std::io::BufReader;</span>
<span class="doccomment">//!use rustls::internal::pemfile::{certs, rsa_private_keys};</span>
<span class="doccomment">//!use rustls::{NoClientAuth, ServerConfig};</span>
<span class="doccomment">//!</span>
<span class="doccomment">//!fn index(req: &amp;HttpRequest) -&gt; Result&lt;HttpResponse, Error&gt; {</span>
<span class="doccomment">//! Ok(HttpResponse::Ok().content_type(&quot;text/plain&quot;).body(&quot;Welcome!&quot;))</span>
<span class="doccomment">//!}</span>
<span class="doccomment">//!</span>
<span class="doccomment">//!fn load_ssl() -&gt; ServerConfig {</span>
<span class="doccomment">//! use std::io::BufReader;</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! const CERT: &amp;&#39;static [u8] = include_bytes!(&quot;../cert.pem&quot;);</span>
<span class="doccomment">//! const KEY: &amp;&#39;static [u8] = include_bytes!(&quot;../key.pem&quot;);</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! let mut cert = BufReader::new(CERT);</span>
<span class="doccomment">//! let mut key = BufReader::new(KEY);</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! let mut config = ServerConfig::new(NoClientAuth::new());</span>
<span class="doccomment">//! let cert_chain = certs(&amp;mut cert).unwrap();</span>
<span class="doccomment">//! let mut keys = rsa_private_keys(&amp;mut key).unwrap();</span>
<span class="doccomment">//! config.set_single_cert(cert_chain, keys.remove(0)).unwrap();</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! config</span>
<span class="doccomment">//!}</span>
<span class="doccomment">//!</span>
<span class="doccomment">//!fn main() {</span>
<span class="doccomment">//! let sys = actix::System::new(&quot;http-server&quot;);</span>
<span class="doccomment">//! // load ssl keys</span>
<span class="doccomment">//! let config = load_ssl();</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! // create and start server at once</span>
<span class="doccomment">//! server::new(|| {</span>
<span class="doccomment">//! App::new()</span>
<span class="doccomment">//! // register simple handler, handle all methods</span>
<span class="doccomment">//! .resource(&quot;/index.html&quot;, |r| r.f(index))</span>
<span class="doccomment">//! }))</span>
<span class="doccomment">//! }).bind_rustls(&quot;127.0.0.1:8443&quot;, config)</span>
<span class="doccomment">//! .unwrap()</span>
<span class="doccomment">//! .start();</span>
<span class="doccomment">//!</span>
<span class="doccomment">//! println!(&quot;Started http server: 127.0.0.1:8080&quot;);</span>
<span class="doccomment">//! //Run system so that server would start accepting connections</span>
<span class="doccomment">//! let _ = sys.run();</span>
<span class="doccomment">//!}</span>
<span class="doccomment">//! ```</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::{<span class="ident">Shutdown</span>, <span class="ident">SocketAddr</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::{<span class="ident">BufMut</span>, <span class="ident">BytesMut</span>};
@ -320,6 +475,10 @@
<span class="kw">use</span> <span class="ident">tokio_io</span>::{<span class="ident">AsyncRead</span>, <span class="ident">AsyncWrite</span>};
<span class="kw">use</span> <span class="ident">tokio_tcp</span>::<span class="ident">TcpStream</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">server</span>::{<span class="ident">PauseServer</span>, <span class="ident">ResumeServer</span>, <span class="ident">StopServer</span>};
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">acceptor</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">builder</span>;
<span class="kw">mod</span> <span class="ident">channel</span>;
<span class="kw">mod</span> <span class="ident">error</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">h1</span>;
@ -327,24 +486,39 @@
<span class="kw">mod</span> <span class="ident">h1writer</span>;
<span class="kw">mod</span> <span class="ident">h2</span>;
<span class="kw">mod</span> <span class="ident">h2writer</span>;
<span class="kw">mod</span> <span class="ident">handler</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">helpers</span>;
<span class="kw">mod</span> <span class="ident">http</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">incoming</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">input</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">message</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">output</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">service</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">mod</span> <span class="ident">settings</span>;
<span class="kw">mod</span> <span class="ident">srv</span>;
<span class="kw">mod</span> <span class="ident">worker</span>;
<span class="kw">mod</span> <span class="ident">ssl</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">handler</span>::<span class="kw-2">*</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">http</span>::<span class="ident">HttpServer</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">message</span>::<span class="ident">Request</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">ssl</span>::<span class="kw-2">*</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">error</span>::{<span class="ident">AcceptorError</span>, <span class="ident">HttpDispatchError</span>};
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">settings</span>::<span class="ident">ServerSettings</span>;
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">srv</span>::<span class="ident">HttpServer</span>;
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">acceptor</span>::<span class="ident">AcceptorTimeout</span>;
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">settings</span>::{<span class="ident">ServiceConfig</span>, <span class="ident">ServiceConfigBuilder</span>};
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">service</span>::{<span class="ident">H1Service</span>, <span class="ident">HttpService</span>, <span class="ident">StreamConfiguration</span>};
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">helpers</span>::<span class="ident">write_content_length</span>;
<span class="kw">use</span> <span class="ident">actix</span>::<span class="ident">Message</span>;
<span class="kw">use</span> <span class="ident">body</span>::<span class="ident">Binary</span>;
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">extensions</span>::<span class="ident">Extensions</span>;
<span class="kw">use</span> <span class="ident">header</span>::<span class="ident">ContentEncoding</span>;
<span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponse</span>;
@ -375,15 +549,25 @@
<span class="doccomment">/// sys.run();</span>
<span class="doccomment">/// }</span>
<span class="doccomment">/// ```</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">U</span>, <span class="ident">H</span><span class="op">&gt;</span>(<span class="ident">factory</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">HttpServer</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span><span class="op">&gt;</span>(<span class="ident">factory</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">HttpServer</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">F</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">U</span> <span class="op">+</span> <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">U</span>: <span class="ident">IntoIterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">H</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">H</span>: <span class="ident">IntoHttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">HttpServer</span>::<span class="ident">new</span>(<span class="ident">factory</span>)
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="macro">bitflags</span><span class="macro">!</span> {
<span class="doccomment">///Flags that can be used to configure HTTP Server.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ServerFlags</span>: <span class="ident">u8</span> {
<span class="doccomment">///Use HTTP1 protocol</span>
<span class="kw">const</span> <span class="ident">HTTP1</span> <span class="op">=</span> <span class="number">0b0000_0001</span>;
<span class="doccomment">///Use HTTP2 protocol</span>
<span class="kw">const</span> <span class="ident">HTTP2</span> <span class="op">=</span> <span class="number">0b0000_0010</span>;
}
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>, <span class="ident">PartialEq</span>, <span class="ident">Clone</span>, <span class="ident">Copy</span>)]</span>
<span class="doccomment">/// Server keep-alive setting</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">KeepAlive</span> {
@ -413,84 +597,6 @@
}
}
<span class="doccomment">/// Pause accepting incoming connections</span>
<span class="doccomment">///</span>
<span class="doccomment">/// If socket contains some pending connection, they might be dropped.</span>
<span class="doccomment">/// All opened connection remains active.</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Message</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">PauseServer</span>;
<span class="doccomment">/// Resume accepting incoming connections</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Message</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ResumeServer</span>;
<span class="doccomment">/// Stop incoming connection processing, stop all workers and exit.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// If server starts with `spawn()` method, then spawned thread get terminated.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">StopServer</span> {
<span class="doccomment">/// Whether to try and shut down gracefully</span>
<span class="kw">pub</span> <span class="ident">graceful</span>: <span class="ident">bool</span>,
}
<span class="kw">impl</span> <span class="ident">Message</span> <span class="kw">for</span> <span class="ident">StopServer</span> {
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), ()<span class="op">&gt;</span>;
}
<span class="doccomment">/// Low level http request handler</span>
<span class="attribute">#[<span class="ident">allow</span>(<span class="ident">unused_variables</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">HttpHandler</span>: <span class="lifetime">&#39;static</span> {
<span class="doccomment">/// Request handling task</span>
<span class="kw">type</span> <span class="ident">Task</span>: <span class="ident">HttpHandlerTask</span>;
<span class="doccomment">/// Handle request</span>
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Task</span>, <span class="ident">Request</span><span class="op">&gt;</span>;
}
<span class="kw">impl</span> <span class="ident">HttpHandler</span> <span class="kw">for</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandler</span><span class="op">&lt;</span><span class="ident">Task</span> <span class="op">=</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Task</span> <span class="op">=</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">req</span>: <span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span>, <span class="ident">Request</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">as_ref</span>().<span class="ident">handle</span>(<span class="ident">req</span>)
}
}
<span class="doccomment">/// Low level http request handler</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">HttpHandlerTask</span> {
<span class="doccomment">/// Poll task, this method is used before or after *io* object is available</span>
<span class="kw">fn</span> <span class="ident">poll_completed</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="doccomment">/// Poll task when *io* object is available</span>
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span>;
<span class="doccomment">/// Connection is disconnected</span>
<span class="kw">fn</span> <span class="ident">disconnected</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {}
}
<span class="kw">impl</span> <span class="ident">HttpHandlerTask</span> <span class="kw">for</span> <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">HttpHandlerTask</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">poll_io</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">io</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Writer</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">as_mut</span>().<span class="ident">poll_io</span>(<span class="ident">io</span>)
}
}
<span class="doccomment">/// Conversion helper trait</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">IntoHttpHandler</span> {
<span class="doccomment">/// The associated type which is result of conversion.</span>
<span class="kw">type</span> <span class="ident">Handler</span>: <span class="ident">HttpHandler</span>;
<span class="doccomment">/// Convert into `HttpHandler` object.</span>
<span class="kw">fn</span> <span class="ident">into_handler</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Handler</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span> <span class="ident">IntoHttpHandler</span> <span class="kw">for</span> <span class="ident">T</span> {
<span class="kw">type</span> <span class="ident">Handler</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">fn</span> <span class="ident">into_handler</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Handler</span> {
<span class="self">self</span>
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Debug</span>)]</span>
<span class="kw">pub</span> <span class="kw">enum</span> <span class="ident">WriterState</span> {
@ -526,41 +632,79 @@
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">IoStream</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> {
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span>;
<span class="doccomment">/// Returns the socket address of the remote peer of this TCP connection.</span>
<span class="kw">fn</span> <span class="ident">peer_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span> {
<span class="prelude-val">None</span>
}
<span class="doccomment">/// Sets the value of the TCP_NODELAY option on this socket.</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">read_available</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">read_available</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(<span class="ident">bool</span>, <span class="ident">bool</span>), <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">read_some</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">loop</span> {
<span class="kw">if</span> <span class="ident">buf</span>.<span class="ident">remaining_mut</span>() <span class="op">&lt;</span> <span class="ident">LW_BUFFER_SIZE</span> {
<span class="ident">buf</span>.<span class="ident">reserve</span>(<span class="ident">HW_BUFFER_SIZE</span>);
}
<span class="kw">unsafe</span> {
<span class="kw">match</span> <span class="self">self</span>.<span class="ident">read</span>(<span class="ident">buf</span>.<span class="ident">bytes_mut</span>()) {
<span class="prelude-val">Ok</span>(<span class="ident">n</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">n</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="op">!</span><span class="ident">read_some</span>));
} <span class="kw">else</span> {
<span class="ident">read_some</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="kw">let</span> <span class="ident">read</span> <span class="op">=</span> <span class="kw">unsafe</span> { <span class="self">self</span>.<span class="ident">read</span>(<span class="ident">buf</span>.<span class="ident">bytes_mut</span>()) };
<span class="kw">match</span> <span class="ident">read</span> {
<span class="prelude-val">Ok</span>(<span class="ident">n</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">n</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">return</span> <span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="ident">read_some</span>, <span class="bool-val">true</span>)));
} <span class="kw">else</span> {
<span class="ident">read_some</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="kw">unsafe</span> {
<span class="ident">buf</span>.<span class="ident">advance_mut</span>(<span class="ident">n</span>);
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="kw">if</span> <span class="ident">e</span>.<span class="ident">kind</span>() <span class="op">==</span> <span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WouldBlock</span> {
<span class="kw">if</span> <span class="ident">read_some</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(<span class="bool-val">false</span>))
} <span class="kw">else</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>)
}
}
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> {
<span class="kw">return</span> <span class="kw">if</span> <span class="ident">e</span>.<span class="ident">kind</span>() <span class="op">==</span> <span class="ident">io</span>::<span class="ident">ErrorKind</span>::<span class="ident">WouldBlock</span> {
<span class="kw">if</span> <span class="ident">read_some</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>((<span class="ident">read_some</span>, <span class="bool-val">false</span>)))
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>)
};
}
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">NotReady</span>)
}
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">e</span>)
};
}
}
}
}
<span class="doccomment">/// Extra io stream extensions</span>
<span class="kw">fn</span> <span class="ident">extensions</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Extensions</span><span class="op">&gt;&gt;</span> {
<span class="prelude-val">None</span>
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(<span class="ident">unix</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;uds&quot;</span>))]</span>
<span class="kw">impl</span> <span class="ident">IoStream</span> <span class="kw">for</span> ::<span class="ident">tokio_uds</span>::<span class="ident">UnixStream</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
::<span class="ident">tokio_uds</span>::<span class="ident">UnixStream</span>::<span class="ident">shutdown</span>(<span class="self">self</span>, <span class="ident">how</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(())
}
}
<span class="kw">impl</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">TcpStream</span> {
@ -569,6 +713,11 @@
<span class="ident">TcpStream</span>::<span class="ident">shutdown</span>(<span class="self">self</span>, <span class="ident">how</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">peer_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span> {
<span class="ident">TcpStream</span>::<span class="ident">peer_addr</span>(<span class="self">self</span>).<span class="ident">ok</span>()
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="ident">TcpStream</span>::<span class="ident">set_nodelay</span>(<span class="self">self</span>, <span class="ident">nodelay</span>)
@ -578,49 +727,10 @@
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="ident">TcpStream</span>::<span class="ident">set_linger</span>(<span class="self">self</span>, <span class="ident">dur</span>)
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_openssl</span>::<span class="ident">SslStream</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">impl</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">SslStream</span><span class="op">&lt;</span><span class="ident">TcpStream</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">shutdown</span>();
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_nodelay</span>(<span class="ident">nodelay</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_linger</span>(<span class="ident">dur</span>)
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_tls</span>::<span class="ident">TlsStream</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">impl</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">TlsStream</span><span class="op">&lt;</span><span class="ident">TcpStream</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">shutdown</span>();
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_nodelay</span>(<span class="ident">nodelay</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_linger</span>(<span class="ident">dur</span>)
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="ident">TcpStream</span>::<span class="ident">set_keepalive</span>(<span class="self">self</span>, <span class="ident">dur</span>)
}
}
</pre>

42
static/api/actix-web/stable/src/actix_web/server/output.rs.html
View File

@ -762,6 +762,7 @@
<span id="762">762</span>
<span id="763">763</span>
<span id="764">764</span>
<span id="765">765</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>::<span class="ident">Write</span> <span class="kw">as</span> <span class="ident">FmtWrite</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">Write</span>;
@ -772,11 +773,11 @@
<span class="kw">use</span> <span class="ident">brotli2</span>::<span class="ident">write</span>::<span class="ident">BrotliEncoder</span>;
<span class="kw">use</span> <span class="ident">bytes</span>::<span class="ident">BytesMut</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::{<span class="ident">DeflateEncoder</span>, <span class="ident">GzEncoder</span>};
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">write</span>::{<span class="ident">GzEncoder</span>, <span class="ident">ZlibEncoder</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">flate2</span>::<span class="ident">Compression</span>;
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">header</span>::{<span class="ident">ACCEPT_ENCODING</span>, <span class="ident">CONTENT_LENGTH</span>};
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">Version</span>;
<span class="kw">use</span> <span class="ident">http</span>::{<span class="ident">StatusCode</span>, <span class="ident">Version</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">message</span>::<span class="ident">InnerRequest</span>;
<span class="kw">use</span> <span class="ident">body</span>::{<span class="ident">Binary</span>, <span class="ident">Body</span>};
@ -916,10 +917,9 @@
<span class="kw">let</span> <span class="ident">version</span> <span class="op">=</span> <span class="ident">resp</span>.<span class="ident">version</span>().<span class="ident">unwrap_or_else</span>(<span class="op">||</span> <span class="ident">req</span>.<span class="ident">version</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">len</span> <span class="op">=</span> <span class="number">0</span>;
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">match_ref_pats</span>))]</span>
<span class="kw">let</span> <span class="ident">has_body</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">body</span>() {
<span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Empty</span> <span class="op">=&gt;</span> <span class="bool-val">false</span>,
<span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="kw-2">ref</span> <span class="ident">bin</span>) <span class="op">=&gt;</span> {
<span class="ident">Body</span>::<span class="ident">Empty</span> <span class="op">=&gt;</span> <span class="bool-val">false</span>,
<span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="kw-2">ref</span> <span class="ident">bin</span>) <span class="op">=&gt;</span> {
<span class="ident">len</span> <span class="op">=</span> <span class="ident">bin</span>.<span class="ident">len</span>();
<span class="op">!</span>(<span class="ident">response_encoding</span> <span class="op">==</span> <span class="ident">ContentEncoding</span>::<span class="ident">Auto</span> <span class="op">&amp;&amp;</span> <span class="ident">len</span> <span class="op">&lt;</span> <span class="number">96</span>)
}
@ -955,16 +955,19 @@
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)))]</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">encoding</span> <span class="op">=</span> <span class="ident">ContentEncoding</span>::<span class="ident">Identity</span>;
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">match_ref_pats</span>))]</span>
<span class="kw">let</span> <span class="ident">transfer</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">body</span>() {
<span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Empty</span> <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="op">!</span><span class="ident">info</span>.<span class="ident">head</span> {
<span class="ident">info</span>.<span class="ident">length</span> <span class="op">=</span> <span class="ident">ResponseLength</span>::<span class="ident">Zero</span>;
}
<span class="ident">Body</span>::<span class="ident">Empty</span> <span class="op">=&gt;</span> {
<span class="ident">info</span>.<span class="ident">length</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">status</span>() {
<span class="ident">StatusCode</span>::<span class="ident">NO_CONTENT</span>
<span class="op">|</span> <span class="ident">StatusCode</span>::<span class="ident">CONTINUE</span>
<span class="op">|</span> <span class="ident">StatusCode</span>::<span class="ident">SWITCHING_PROTOCOLS</span>
<span class="op">|</span> <span class="ident">StatusCode</span>::<span class="ident">PROCESSING</span> <span class="op">=&gt;</span> <span class="ident">ResponseLength</span>::<span class="prelude-val">None</span>,
<span class="kw">_</span> <span class="op">=&gt;</span> <span class="ident">ResponseLength</span>::<span class="ident">Zero</span>,
};
<span class="kw-2">*</span><span class="self">self</span> <span class="op">=</span> <span class="ident">Output</span>::<span class="ident">Empty</span>(<span class="ident">buf</span>);
<span class="kw">return</span>;
}
<span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">Body</span>::<span class="ident">Binary</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>))]</span>
{
<span class="kw">if</span> <span class="op">!</span>(<span class="ident">encoding</span> <span class="op">==</span> <span class="ident">ContentEncoding</span>::<span class="ident">Identity</span>
@ -975,7 +978,7 @@
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">enc</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">encoding</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(
<span class="ident">DeflateEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">fast</span>()),
<span class="ident">ZlibEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">fast</span>()),
),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Gzip</span>(
@ -1009,7 +1012,7 @@
}
<span class="kw">return</span>;
}
<span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Streaming</span>(<span class="kw">_</span>) <span class="op">|</span> <span class="kw-2">&amp;</span><span class="ident">Body</span>::<span class="ident">Actor</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="ident">Body</span>::<span class="ident">Streaming</span>(<span class="kw">_</span>) <span class="op">|</span> <span class="ident">Body</span>::<span class="ident">Actor</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> {
<span class="kw">if</span> <span class="ident">resp</span>.<span class="ident">upgrade</span>() {
<span class="kw">if</span> <span class="ident">version</span> <span class="op">==</span> <span class="ident">Version</span>::<span class="ident">HTTP_2</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Connection upgrade is forbidden for HTTP/2&quot;</span>);
@ -1038,10 +1041,9 @@
<span class="kw">let</span> <span class="ident">enc</span> <span class="op">=</span> <span class="kw">match</span> <span class="ident">encoding</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> <span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(<span class="ident">DeflateEncoder</span>::<span class="ident">new</span>(
<span class="ident">transfer</span>,
<span class="ident">Compression</span>::<span class="ident">fast</span>(),
)),
<span class="ident">ContentEncoding</span>::<span class="ident">Deflate</span> <span class="op">=&gt;</span> {
<span class="ident">ContentEncoder</span>::<span class="ident">Deflate</span>(<span class="ident">ZlibEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">fast</span>()))
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">ContentEncoding</span>::<span class="ident">Gzip</span> <span class="op">=&gt;</span> {
<span class="ident">ContentEncoder</span>::<span class="ident">Gzip</span>(<span class="ident">GzEncoder</span>::<span class="ident">new</span>(<span class="ident">transfer</span>, <span class="ident">Compression</span>::<span class="ident">fast</span>()))
@ -1119,7 +1121,7 @@
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">ContentEncoder</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Deflate</span>(<span class="ident">DeflateEncoder</span><span class="op">&lt;</span><span class="ident">TransferEncoding</span><span class="op">&gt;</span>),
<span class="ident">Deflate</span>(<span class="ident">ZlibEncoder</span><span class="op">&lt;</span><span class="ident">TransferEncoding</span><span class="op">&gt;</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;flate2&quot;</span>)]</span>
<span class="ident">Gzip</span>(<span class="ident">GzEncoder</span><span class="op">&lt;</span><span class="ident">TransferEncoding</span><span class="op">&gt;</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;brotli&quot;</span>)]</span>
@ -1207,7 +1209,7 @@
}
}
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">inline_always</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">inline_always</span>))]</span>
<span class="attribute">#[<span class="ident">inline</span>(<span class="ident">always</span>)]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">write_eof</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">bool</span>, <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">encoder</span> <span class="op">=</span>
@ -1249,7 +1251,7 @@
}
}
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">inline_always</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">inline_always</span>))]</span>
<span class="attribute">#[<span class="ident">inline</span>(<span class="ident">always</span>)]</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">write</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">data</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>]) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(), <span class="ident">io</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {

547
static/api/actix-web/stable/src/actix_web/server/service.rs.html Normal file
View File

@ -0,0 +1,547 @@
<!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="Source to the Rust file `src/server/service.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>service.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
<span id="240">240</span>
<span id="241">241</span>
<span id="242">242</span>
<span id="243">243</span>
<span id="244">244</span>
<span id="245">245</span>
<span id="246">246</span>
<span id="247">247</span>
<span id="248">248</span>
<span id="249">249</span>
<span id="250">250</span>
<span id="251">251</span>
<span id="252">252</span>
<span id="253">253</span>
<span id="254">254</span>
<span id="255">255</span>
<span id="256">256</span>
<span id="257">257</span>
<span id="258">258</span>
<span id="259">259</span>
<span id="260">260</span>
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">time</span>::<span class="ident">Duration</span>;
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">service</span>::{<span class="ident">NewService</span>, <span class="ident">Service</span>};
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">future</span>::{<span class="ident">ok</span>, <span class="ident">FutureResult</span>};
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">channel</span>::{<span class="ident">H1Channel</span>, <span class="ident">HttpChannel</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">error</span>::<span class="ident">HttpDispatchError</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">handler</span>::<span class="ident">HttpHandler</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">settings</span>::<span class="ident">ServiceConfig</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">IoStream</span>;
<span class="doccomment">/// `NewService` implementation for HTTP1/HTTP2 transports</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">HttpService</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">HttpService</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="doccomment">/// Create new `HttpService` instance.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">HttpService</span> {
<span class="ident">settings</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">HttpService</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">Io</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">HttpServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Service</span>, <span class="self">Self</span>::<span class="ident">InitError</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ok</span>(<span class="ident">HttpServiceHandler</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>()))
}
}
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">HttpServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">HttpServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">HttpServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> {
<span class="ident">HttpServiceHandler</span> {
<span class="ident">settings</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">HttpServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">Io</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">HttpChannel</span><span class="op">&lt;</span><span class="ident">Io</span>, <span class="ident">H</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">HttpChannel</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>(), <span class="ident">req</span>)
}
}
<span class="doccomment">/// `NewService` implementation for HTTP1 transport</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">H1Service</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">H1Service</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="doccomment">/// Create new `HttpService` instance.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">H1Service</span> {
<span class="ident">settings</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">H1Service</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">Io</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">H1ServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Service</span>, <span class="self">Self</span>::<span class="ident">InitError</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ok</span>(<span class="ident">H1ServiceHandler</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>()))
}
}
<span class="doccomment">/// `Service` implementation for HTTP1 transport</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">H1ServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">H1ServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">settings</span>: <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">H1ServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> {
<span class="ident">H1ServiceHandler</span> {
<span class="ident">settings</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
}
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">H1ServiceHandler</span><span class="op">&lt;</span><span class="ident">H</span>, <span class="ident">Io</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span>,
<span class="ident">Io</span>: <span class="ident">IoStream</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">Io</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">HttpDispatchError</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">H1Channel</span><span class="op">&lt;</span><span class="ident">Io</span>, <span class="ident">H</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">H1Channel</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">clone</span>(), <span class="ident">req</span>)
}
}
<span class="doccomment">/// `NewService` implementation for stream configuration service</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Stream configuration service allows to change some socket level</span>
<span class="doccomment">/// parameters. for example `tcp nodelay` or `tcp keep-alive`.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">StreamConfiguration</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> {
<span class="ident">no_delay</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">bool</span><span class="op">&gt;</span>,
<span class="ident">tcp_ka</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Duration</span><span class="op">&gt;&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span>(<span class="ident">T</span>, <span class="ident">E</span>)<span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Default</span> <span class="kw">for</span> <span class="ident">StreamConfiguration</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">default</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">Self</span>::<span class="ident">new</span>()
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">StreamConfiguration</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create new `StreamConfigurationService` instance.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">Self</span> {
<span class="ident">no_delay</span>: <span class="prelude-val">None</span>,
<span class="ident">tcp_ka</span>: <span class="prelude-val">None</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
}
}
<span class="doccomment">/// Sets the value of the `TCP_NODELAY` option on this socket.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">nodelay</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">no_delay</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">nodelay</span>);
<span class="self">self</span>
}
<span class="doccomment">/// Sets whether keepalive messages are enabled to be sent on this socket.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">tcp_keepalive</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">keepalive</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">tcp_ka</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">keepalive</span>);
<span class="self">self</span>
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IoStream</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">NewService</span> <span class="kw">for</span> <span class="ident">StreamConfiguration</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> {
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span>;
<span class="kw">type</span> <span class="ident">InitError</span> <span class="op">=</span> ();
<span class="kw">type</span> <span class="ident">Service</span> <span class="op">=</span> <span class="ident">StreamConfigurationService</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="self">Self</span>::<span class="ident">Service</span>, <span class="self">Self</span>::<span class="ident">InitError</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">new_service</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="ident">ok</span>(<span class="ident">StreamConfigurationService</span> {
<span class="ident">no_delay</span>: <span class="self">self</span>.<span class="ident">no_delay</span>,
<span class="ident">tcp_ka</span>: <span class="self">self</span>.<span class="ident">tcp_ka</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span>,
})
}
}
<span class="doccomment">/// Stream configuration service</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Stream configuration service allows to change some socket level</span>
<span class="doccomment">/// parameters. for example `tcp nodelay` or `tcp keep-alive`.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">StreamConfigurationService</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> {
<span class="ident">no_delay</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">bool</span><span class="op">&gt;</span>,
<span class="ident">tcp_ka</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Duration</span><span class="op">&gt;&gt;</span>,
<span class="ident">_t</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span>(<span class="ident">T</span>, <span class="ident">E</span>)<span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Service</span> <span class="kw">for</span> <span class="ident">StreamConfigurationService</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">IoStream</span>,
{
<span class="kw">type</span> <span class="ident">Request</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">type</span> <span class="ident">Response</span> <span class="op">=</span> <span class="ident">T</span>;
<span class="kw">type</span> <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span>;
<span class="kw">type</span> <span class="ident">Future</span> <span class="op">=</span> <span class="ident">FutureResult</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">E</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">poll_ready</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span>(), <span class="self">Self</span>::<span class="ident">Error</span><span class="op">&gt;</span> {
<span class="prelude-val">Ok</span>(<span class="ident">Async</span>::<span class="ident">Ready</span>(()))
}
<span class="kw">fn</span> <span class="ident">call</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="kw-2">mut</span> <span class="ident">req</span>: <span class="self">Self</span>::<span class="ident">Request</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="ident">Future</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">no_delay</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">no_delay</span> {
<span class="kw">if</span> <span class="ident">req</span>.<span class="ident">set_nodelay</span>(<span class="ident">no_delay</span>).<span class="ident">is_err</span>() {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not set socket no-delay option&quot;</span>);
}
}
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">keepalive</span>) <span class="op">=</span> <span class="self">self</span>.<span class="ident">tcp_ka</span> {
<span class="kw">if</span> <span class="ident">req</span>.<span class="ident">set_keepalive</span>(<span class="ident">keepalive</span>).<span class="ident">is_err</span>() {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not set socket keep-alive option&quot;</span>);
}
}
<span class="ident">ok</span>(<span class="ident">req</span>)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

572
static/api/actix-web/stable/src/actix_web/server/settings.rs.html
View File

@ -319,21 +319,206 @@
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
<span id="365">365</span>
<span id="366">366</span>
<span id="367">367</span>
<span id="368">368</span>
<span id="369">369</span>
<span id="370">370</span>
<span id="371">371</span>
<span id="372">372</span>
<span id="373">373</span>
<span id="374">374</span>
<span id="375">375</span>
<span id="376">376</span>
<span id="377">377</span>
<span id="378">378</span>
<span id="379">379</span>
<span id="380">380</span>
<span id="381">381</span>
<span id="382">382</span>
<span id="383">383</span>
<span id="384">384</span>
<span id="385">385</span>
<span id="386">386</span>
<span id="387">387</span>
<span id="388">388</span>
<span id="389">389</span>
<span id="390">390</span>
<span id="391">391</span>
<span id="392">392</span>
<span id="393">393</span>
<span id="394">394</span>
<span id="395">395</span>
<span id="396">396</span>
<span id="397">397</span>
<span id="398">398</span>
<span id="399">399</span>
<span id="400">400</span>
<span id="401">401</span>
<span id="402">402</span>
<span id="403">403</span>
<span id="404">404</span>
<span id="405">405</span>
<span id="406">406</span>
<span id="407">407</span>
<span id="408">408</span>
<span id="409">409</span>
<span id="410">410</span>
<span id="411">411</span>
<span id="412">412</span>
<span id="413">413</span>
<span id="414">414</span>
<span id="415">415</span>
<span id="416">416</span>
<span id="417">417</span>
<span id="418">418</span>
<span id="419">419</span>
<span id="420">420</span>
<span id="421">421</span>
<span id="422">422</span>
<span id="423">423</span>
<span id="424">424</span>
<span id="425">425</span>
<span id="426">426</span>
<span id="427">427</span>
<span id="428">428</span>
<span id="429">429</span>
<span id="430">430</span>
<span id="431">431</span>
<span id="432">432</span>
<span id="433">433</span>
<span id="434">434</span>
<span id="435">435</span>
<span id="436">436</span>
<span id="437">437</span>
<span id="438">438</span>
<span id="439">439</span>
<span id="440">440</span>
<span id="441">441</span>
<span id="442">442</span>
<span id="443">443</span>
<span id="444">444</span>
<span id="445">445</span>
<span id="446">446</span>
<span id="447">447</span>
<span id="448">448</span>
<span id="449">449</span>
<span id="450">450</span>
<span id="451">451</span>
<span id="452">452</span>
<span id="453">453</span>
<span id="454">454</span>
<span id="455">455</span>
<span id="456">456</span>
<span id="457">457</span>
<span id="458">458</span>
<span id="459">459</span>
<span id="460">460</span>
<span id="461">461</span>
<span id="462">462</span>
<span id="463">463</span>
<span id="464">464</span>
<span id="465">465</span>
<span id="466">466</span>
<span id="467">467</span>
<span id="468">468</span>
<span id="469">469</span>
<span id="470">470</span>
<span id="471">471</span>
<span id="472">472</span>
<span id="473">473</span>
<span id="474">474</span>
<span id="475">475</span>
<span id="476">476</span>
<span id="477">477</span>
<span id="478">478</span>
<span id="479">479</span>
<span id="480">480</span>
<span id="481">481</span>
<span id="482">482</span>
<span id="483">483</span>
<span id="484">484</span>
<span id="485">485</span>
<span id="486">486</span>
<span id="487">487</span>
<span id="488">488</span>
<span id="489">489</span>
<span id="490">490</span>
<span id="491">491</span>
<span id="492">492</span>
<span id="493">493</span>
<span id="494">494</span>
<span id="495">495</span>
<span id="496">496</span>
<span id="497">497</span>
<span id="498">498</span>
<span id="499">499</span>
<span id="500">500</span>
<span id="501">501</span>
<span id="502">502</span>
<span id="503">503</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::{<span class="ident">Cell</span>, <span class="ident">RefCell</span>, <span class="ident">RefMut</span>, <span class="ident">UnsafeCell</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">cell</span>::{<span class="ident">Cell</span>, <span class="ident">RefCell</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">collections</span>::<span class="ident">VecDeque</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fmt</span>::<span class="ident">Write</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">time</span>::{<span class="ident">Duration</span>, <span class="ident">Instant</span>};
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">env</span>, <span class="ident">fmt</span>, <span class="ident">net</span>};
<span class="kw">use</span> <span class="ident">bytes</span>::<span class="ident">BytesMut</span>;
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">future</span>, <span class="ident">Future</span>};
<span class="kw">use</span> <span class="ident">futures_cpupool</span>::<span class="ident">CpuPool</span>;
<span class="kw">use</span> <span class="ident">http</span>::<span class="ident">StatusCode</span>;
<span class="kw">use</span> <span class="ident">lazycell</span>::<span class="ident">LazyCell</span>;
<span class="kw">use</span> <span class="ident">parking_lot</span>::<span class="ident">Mutex</span>;
<span class="kw">use</span> <span class="ident">time</span>;
<span class="kw">use</span> <span class="ident">tokio_current_thread</span>::<span class="ident">spawn</span>;
<span class="kw">use</span> <span class="ident">tokio_timer</span>::{<span class="ident">sleep</span>, <span class="ident">Delay</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">channel</span>::<span class="ident">Node</span>;
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">message</span>::{<span class="ident">Request</span>, <span class="ident">RequestPool</span>};
<span class="kw">use</span> <span class="kw">super</span>::<span class="ident">KeepAlive</span>;
<span class="kw">use</span> <span class="ident">body</span>::<span class="ident">Body</span>;
@ -361,7 +546,7 @@
<span class="doccomment">/// Various server settings</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ServerSettings</span> {
<span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span>,
<span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>,
<span class="ident">secure</span>: <span class="ident">bool</span>,
<span class="ident">host</span>: <span class="ident">String</span>,
<span class="ident">cpu_pool</span>: <span class="ident">LazyCell</span><span class="op">&lt;</span><span class="ident">CpuPool</span><span class="op">&gt;</span>,
@ -383,7 +568,7 @@
<span class="kw">impl</span> <span class="ident">Default</span> <span class="kw">for</span> <span class="ident">ServerSettings</span> {
<span class="kw">fn</span> <span class="ident">default</span>() <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ServerSettings</span> {
<span class="ident">addr</span>: <span class="prelude-val">None</span>,
<span class="ident">addr</span>: <span class="string">&quot;127.0.0.1:8080&quot;</span>.<span class="ident">parse</span>().<span class="ident">unwrap</span>(),
<span class="ident">secure</span>: <span class="bool-val">false</span>,
<span class="ident">host</span>: <span class="string">&quot;localhost:8080&quot;</span>.<span class="ident">to_owned</span>(),
<span class="ident">responses</span>: <span class="ident">HttpResponsePool</span>::<span class="ident">get_pool</span>(),
@ -395,15 +580,9 @@
<span class="kw">impl</span> <span class="ident">ServerSettings</span> {
<span class="doccomment">/// Crate server settings instance</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">addr</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">host</span>: <span class="kw-2">&amp;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">String</span><span class="op">&gt;</span>, <span class="ident">secure</span>: <span class="ident">bool</span>,
<span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>, <span class="ident">host</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>, <span class="ident">secure</span>: <span class="ident">bool</span>,
) <span class="op">-&gt;</span> <span class="ident">ServerSettings</span> {
<span class="kw">let</span> <span class="ident">host</span> <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">host</span>) <span class="op">=</span> <span class="kw-2">*</span><span class="ident">host</span> {
<span class="ident">host</span>.<span class="ident">clone</span>()
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="kw-2">ref</span> <span class="ident">addr</span>) <span class="op">=</span> <span class="ident">addr</span> {
<span class="macro">format</span><span class="macro">!</span>(<span class="string">&quot;{}&quot;</span>, <span class="ident">addr</span>)
} <span class="kw">else</span> {
<span class="string">&quot;localhost&quot;</span>.<span class="ident">to_owned</span>()
};
<span class="kw">let</span> <span class="ident">host</span> <span class="op">=</span> <span class="ident">host</span>.<span class="ident">to_owned</span>();
<span class="kw">let</span> <span class="ident">cpu_pool</span> <span class="op">=</span> <span class="ident">LazyCell</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="ident">responses</span> <span class="op">=</span> <span class="ident">HttpResponsePool</span>::<span class="ident">get_pool</span>();
<span class="ident">ServerSettings</span> {
@ -415,23 +594,8 @@
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">parts</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> (<span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">String</span>, <span class="ident">bool</span>) {
(<span class="self">self</span>.<span class="ident">addr</span>, <span class="self">self</span>.<span class="ident">host</span>.<span class="ident">clone</span>(), <span class="self">self</span>.<span class="ident">secure</span>)
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">from_parts</span>(<span class="ident">parts</span>: (<span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span>, <span class="ident">String</span>, <span class="ident">bool</span>)) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">let</span> (<span class="ident">addr</span>, <span class="ident">host</span>, <span class="ident">secure</span>) <span class="op">=</span> <span class="ident">parts</span>;
<span class="ident">ServerSettings</span> {
<span class="ident">addr</span>,
<span class="ident">host</span>,
<span class="ident">secure</span>,
<span class="ident">cpu_pool</span>: <span class="ident">LazyCell</span>::<span class="ident">new</span>(),
<span class="ident">responses</span>: <span class="ident">HttpResponsePool</span>::<span class="ident">get_pool</span>(),
}
}
<span class="doccomment">/// Returns the socket address of the local half of this TCP connection</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">local_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">local_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">net</span>::<span class="ident">SocketAddr</span> {
<span class="self">self</span>.<span class="ident">addr</span>
}
@ -466,105 +630,294 @@
<span class="comment">// &quot;Sun, 06 Nov 1994 08:49:37 GMT&quot;.len()</span>
<span class="kw">const</span> <span class="ident">DATE_VALUE_LENGTH</span>: <span class="ident">usize</span> <span class="op">=</span> <span class="number">29</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">h</span>: <span class="ident">RefCell</span><span class="op">&lt;</span><span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">keep_alive</span>: <span class="ident">u64</span>,
<span class="doccomment">/// Http service configuration</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>(<span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">Inner</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>);
<span class="kw">struct</span> <span class="ident">Inner</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">handler</span>: <span class="ident">H</span>,
<span class="ident">keep_alive</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Duration</span><span class="op">&gt;</span>,
<span class="ident">client_timeout</span>: <span class="ident">u64</span>,
<span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
<span class="ident">ka_enabled</span>: <span class="ident">bool</span>,
<span class="ident">bytes</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">SharedBytesPool</span><span class="op">&gt;</span>,
<span class="ident">messages</span>: <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">RequestPool</span>,
<span class="ident">channels</span>: <span class="ident">Cell</span><span class="op">&lt;</span><span class="ident">usize</span><span class="op">&gt;</span>,
<span class="ident">node</span>: <span class="ident">RefCell</span><span class="op">&lt;</span><span class="ident">Node</span><span class="op">&lt;</span>()<span class="op">&gt;&gt;</span>,
<span class="ident">date</span>: <span class="ident">UnsafeCell</span><span class="op">&lt;</span><span class="ident">Date</span><span class="op">&gt;</span>,
<span class="ident">date</span>: <span class="ident">Cell</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Date</span><span class="op">&gt;&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Clone</span> <span class="kw">for</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">fn</span> <span class="ident">clone</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">ServiceConfig</span>(<span class="self">self</span>.<span class="number">0</span>.<span class="ident">clone</span>())
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create instance of `ServiceConfig`</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">h</span>: <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>, <span class="ident">settings</span>: <span class="ident">ServerSettings</span>,
) <span class="op">-&gt;</span> <span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">handler</span>: <span class="ident">H</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>, <span class="ident">client_timeout</span>: <span class="ident">u64</span>, <span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
<span class="ident">settings</span>: <span class="ident">ServerSettings</span>,
) <span class="op">-&gt;</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">let</span> (<span class="ident">keep_alive</span>, <span class="ident">ka_enabled</span>) <span class="op">=</span> <span class="kw">match</span> <span class="ident">keep_alive</span> {
<span class="ident">KeepAlive</span>::<span class="ident">Timeout</span>(<span class="ident">val</span>) <span class="op">=&gt;</span> (<span class="ident">val</span> <span class="kw">as</span> <span class="ident">u64</span>, <span class="bool-val">true</span>),
<span class="ident">KeepAlive</span>::<span class="ident">Os</span> <span class="op">|</span> <span class="ident">KeepAlive</span>::<span class="ident">Tcp</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> (<span class="number">0</span>, <span class="bool-val">true</span>),
<span class="ident">KeepAlive</span>::<span class="ident">Disabled</span> <span class="op">=&gt;</span> (<span class="number">0</span>, <span class="bool-val">false</span>),
};
<span class="kw">let</span> <span class="ident">keep_alive</span> <span class="op">=</span> <span class="kw">if</span> <span class="ident">ka_enabled</span> <span class="op">&amp;&amp;</span> <span class="ident">keep_alive</span> <span class="op">&gt;</span> <span class="number">0</span> {
<span class="prelude-val">Some</span>(<span class="ident">Duration</span>::<span class="ident">from_secs</span>(<span class="ident">keep_alive</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
};
<span class="ident">WorkerSettings</span> {
<span class="ident">h</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="ident">h</span>),
<span class="ident">bytes</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">SharedBytesPool</span>::<span class="ident">new</span>()),
<span class="ident">messages</span>: <span class="ident">RequestPool</span>::<span class="ident">pool</span>(<span class="ident">settings</span>),
<span class="ident">channels</span>: <span class="ident">Cell</span>::<span class="ident">new</span>(<span class="number">0</span>),
<span class="ident">node</span>: <span class="ident">RefCell</span>::<span class="ident">new</span>(<span class="ident">Node</span>::<span class="ident">head</span>()),
<span class="ident">date</span>: <span class="ident">UnsafeCell</span>::<span class="ident">new</span>(<span class="ident">Date</span>::<span class="ident">new</span>()),
<span class="ident">ServiceConfig</span>(<span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">Inner</span> {
<span class="ident">handler</span>,
<span class="ident">keep_alive</span>,
<span class="ident">ka_enabled</span>,
}
<span class="ident">client_timeout</span>,
<span class="ident">client_shutdown</span>,
<span class="ident">bytes</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">SharedBytesPool</span>::<span class="ident">new</span>()),
<span class="ident">messages</span>: <span class="ident">RequestPool</span>::<span class="ident">pool</span>(<span class="ident">settings</span>),
<span class="ident">date</span>: <span class="ident">Cell</span>::<span class="ident">new</span>(<span class="prelude-val">None</span>),
}))
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">num_channels</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">usize</span> {
<span class="self">self</span>.<span class="ident">channels</span>.<span class="ident">get</span>()
<span class="doccomment">/// Create worker settings builder.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">build</span>(<span class="ident">handler</span>: <span class="ident">H</span>) <span class="op">-&gt;</span> <span class="ident">ServiceConfigBuilder</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">ServiceConfigBuilder</span>::<span class="ident">new</span>(<span class="ident">handler</span>)
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">head</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">RefMut</span><span class="op">&lt;</span><span class="ident">Node</span><span class="op">&lt;</span>()<span class="op">&gt;&gt;</span> {
<span class="self">self</span>.<span class="ident">node</span>.<span class="ident">borrow_mut</span>()
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">handler</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="ident">H</span> {
<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="number">0</span>.<span class="ident">handler</span>
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">handlers</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">RefMut</span><span class="op">&lt;</span><span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span> {
<span class="self">self</span>.<span class="ident">h</span>.<span class="ident">borrow_mut</span>()
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">u64</span> {
<span class="self">self</span>.<span class="ident">keep_alive</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="doccomment">/// Keep alive duration if configured.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Duration</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">keep_alive</span>
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="doccomment">/// Return state of connection keep-alive funcitonality</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive_enabled</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">bool</span> {
<span class="self">self</span>.<span class="ident">ka_enabled</span>
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">ka_enabled</span>
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">get_bytes</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">BytesMut</span> {
<span class="self">self</span>.<span class="ident">bytes</span>.<span class="ident">get_bytes</span>()
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">get_bytes</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">BytesMut</span> {
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">bytes</span>.<span class="ident">get_bytes</span>()
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">release_bytes</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">bytes</span>: <span class="ident">BytesMut</span>) {
<span class="self">self</span>.<span class="ident">bytes</span>.<span class="ident">release_bytes</span>(<span class="ident">bytes</span>)
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">release_bytes</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">bytes</span>: <span class="ident">BytesMut</span>) {
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">bytes</span>.<span class="ident">release_bytes</span>(<span class="ident">bytes</span>)
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">get_request</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Request</span> {
<span class="ident">RequestPool</span>::<span class="ident">get</span>(<span class="self">self</span>.<span class="ident">messages</span>)
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">add_channel</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) {
<span class="self">self</span>.<span class="ident">channels</span>.<span class="ident">set</span>(<span class="self">self</span>.<span class="ident">channels</span>.<span class="ident">get</span>() <span class="op">+</span> <span class="number">1</span>);
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">remove_channel</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) {
<span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">channels</span>.<span class="ident">get</span>();
<span class="kw">if</span> <span class="ident">num</span> <span class="op">&gt;</span> <span class="number">0</span> {
<span class="self">self</span>.<span class="ident">channels</span>.<span class="ident">set</span>(<span class="ident">num</span> <span class="op">-</span> <span class="number">1</span>);
} <span class="kw">else</span> {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Number of removed channels is bigger than added channel. Bug in actix-web&quot;</span>);
}
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">update_date</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) {
<span class="comment">// Unsafe: WorkerSetting is !Sync and !Send</span>
<span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="kw-2">*</span><span class="self">self</span>.<span class="ident">date</span>.<span class="ident">get</span>() }.<span class="ident">update</span>();
}
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">dst</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">full</span>: <span class="ident">bool</span>) {
<span class="comment">// Unsafe: WorkerSetting is !Sync and !Send</span>
<span class="kw">let</span> <span class="ident">date_bytes</span> <span class="op">=</span> <span class="kw">unsafe</span> { <span class="kw-2">&amp;</span>(<span class="kw-2">*</span><span class="self">self</span>.<span class="ident">date</span>.<span class="ident">get</span>()).<span class="ident">bytes</span> };
<span class="kw">if</span> <span class="ident">full</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="number">39</span>] <span class="op">=</span> [<span class="number">0</span>; <span class="number">39</span>];
<span class="ident">buf</span>[..<span class="number">6</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;date: &quot;</span>);
<span class="ident">buf</span>[<span class="number">6</span>..<span class="number">35</span>].<span class="ident">copy_from_slice</span>(<span class="ident">date_bytes</span>);
<span class="ident">buf</span>[<span class="number">35</span>..].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;\r\n\r\n&quot;</span>);
<span class="ident">dst</span>.<span class="ident">extend_from_slice</span>(<span class="kw-2">&amp;</span><span class="ident">buf</span>);
} <span class="kw">else</span> {
<span class="ident">dst</span>.<span class="ident">extend_from_slice</span>(<span class="ident">date_bytes</span>);
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">get_request</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Request</span> {
<span class="ident">RequestPool</span>::<span class="ident">get</span>(<span class="self">self</span>.<span class="number">0</span>.<span class="ident">messages</span>)
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="doccomment">/// Client timeout for first request.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">client_timer</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">delay</span> <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">client_timeout</span>;
<span class="kw">if</span> <span class="ident">delay</span> <span class="op">!=</span> <span class="number">0</span> {
<span class="prelude-val">Some</span>(<span class="ident">Delay</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">now</span>() <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">from_millis</span>(<span class="ident">delay</span>)))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
}
<span class="doccomment">/// Client timeout for first request.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">client_timer_expire</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Instant</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">delay</span> <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">client_timeout</span>;
<span class="kw">if</span> <span class="ident">delay</span> <span class="op">!=</span> <span class="number">0</span> {
<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">now</span>() <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">from_millis</span>(<span class="ident">delay</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
}
<span class="doccomment">/// Client shutdown timer</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">client_shutdown_timer</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Instant</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">delay</span> <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">client_shutdown</span>;
<span class="kw">if</span> <span class="ident">delay</span> <span class="op">!=</span> <span class="number">0</span> {
<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">now</span>() <span class="op">+</span> <span class="ident">Duration</span>::<span class="ident">from_millis</span>(<span class="ident">delay</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="doccomment">/// Return keep-alive timer delay is configured.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive_timer</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Delay</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ka</span>) <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">keep_alive</span> {
<span class="prelude-val">Some</span>(<span class="ident">Delay</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">now</span>() <span class="op">+</span> <span class="ident">ka</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
}
<span class="doccomment">/// Keep-alive expire time</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive_expire</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Instant</span><span class="op">&gt;</span> {
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ka</span>) <span class="op">=</span> <span class="self">self</span>.<span class="number">0</span>.<span class="ident">keep_alive</span> {
<span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">now</span>() <span class="op">+</span> <span class="ident">ka</span>)
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}
}
<span class="kw">fn</span> <span class="ident">check_date</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) {
<span class="kw">if</span> <span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">*</span><span class="self">self</span>.<span class="number">0</span>.<span class="ident">date</span>.<span class="ident">as_ptr</span>() }.<span class="ident">is_none</span>() {
<span class="self">self</span>.<span class="number">0</span>.<span class="ident">date</span>.<span class="ident">set</span>(<span class="prelude-val">Some</span>(<span class="ident">Date</span>::<span class="ident">new</span>()));
<span class="comment">// periodic date update</span>
<span class="kw">let</span> <span class="ident">s</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">clone</span>();
<span class="ident">spawn</span>(<span class="ident">sleep</span>(<span class="ident">Duration</span>::<span class="ident">from_millis</span>(<span class="number">500</span>)).<span class="ident">then</span>(<span class="kw">move</span> <span class="op">|</span><span class="kw">_</span><span class="op">|</span> {
<span class="ident">s</span>.<span class="number">0</span>.<span class="ident">date</span>.<span class="ident">set</span>(<span class="prelude-val">None</span>);
<span class="ident">future</span>::<span class="ident">ok</span>(())
}));
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">dst</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BytesMut</span>, <span class="ident">full</span>: <span class="ident">bool</span>) {
<span class="self">self</span>.<span class="ident">check_date</span>();
<span class="kw">let</span> <span class="ident">date</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">*</span><span class="self">self</span>.<span class="number">0</span>.<span class="ident">date</span>.<span class="ident">as_ptr</span>() }.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">bytes</span>;
<span class="kw">if</span> <span class="ident">full</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf</span>: [<span class="ident">u8</span>; <span class="number">39</span>] <span class="op">=</span> [<span class="number">0</span>; <span class="number">39</span>];
<span class="ident">buf</span>[..<span class="number">6</span>].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;date: &quot;</span>);
<span class="ident">buf</span>[<span class="number">6</span>..<span class="number">35</span>].<span class="ident">copy_from_slice</span>(<span class="ident">date</span>);
<span class="ident">buf</span>[<span class="number">35</span>..].<span class="ident">copy_from_slice</span>(<span class="string">b&quot;\r\n\r\n&quot;</span>);
<span class="ident">dst</span>.<span class="ident">extend_from_slice</span>(<span class="kw-2">&amp;</span><span class="ident">buf</span>);
} <span class="kw">else</span> {
<span class="ident">dst</span>.<span class="ident">extend_from_slice</span>(<span class="ident">date</span>);
}
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">now</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">Instant</span> {
<span class="self">self</span>.<span class="ident">check_date</span>();
<span class="kw">unsafe</span> { <span class="kw-2">&amp;</span><span class="kw-2">*</span><span class="self">self</span>.<span class="number">0</span>.<span class="ident">date</span>.<span class="ident">as_ptr</span>() }.<span class="ident">as_ref</span>().<span class="ident">unwrap</span>().<span class="ident">current</span>
}
}
<span class="doccomment">/// A service config builder</span>
<span class="doccomment">///</span>
<span class="doccomment">/// This type can be used to construct an instance of `ServiceConfig` through a</span>
<span class="doccomment">/// builder-like pattern.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">ServiceConfigBuilder</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">handler</span>: <span class="ident">H</span>,
<span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>,
<span class="ident">client_timeout</span>: <span class="ident">u64</span>,
<span class="ident">client_shutdown</span>: <span class="ident">u64</span>,
<span class="ident">host</span>: <span class="ident">String</span>,
<span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>,
<span class="ident">secure</span>: <span class="ident">bool</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">ServiceConfigBuilder</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create instance of `ServiceConfigBuilder`</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">handler</span>: <span class="ident">H</span>) <span class="op">-&gt;</span> <span class="ident">ServiceConfigBuilder</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="ident">ServiceConfigBuilder</span> {
<span class="ident">handler</span>,
<span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>::<span class="ident">Timeout</span>(<span class="number">5</span>),
<span class="ident">client_timeout</span>: <span class="number">5000</span>,
<span class="ident">client_shutdown</span>: <span class="number">5000</span>,
<span class="ident">secure</span>: <span class="bool-val">false</span>,
<span class="ident">host</span>: <span class="string">&quot;localhost&quot;</span>.<span class="ident">to_owned</span>(),
<span class="ident">addr</span>: <span class="string">&quot;127.0.0.1:8080&quot;</span>.<span class="ident">parse</span>().<span class="ident">unwrap</span>(),
}
}
<span class="doccomment">/// Enable secure flag for current server.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default this flag is set to false.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">secure</span>(<span class="kw-2">mut</span> <span class="self">self</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">secure</span> <span class="op">=</span> <span class="bool-val">true</span>;
<span class="self">self</span>
}
<span class="doccomment">/// Set server keep-alive setting.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default keep alive is set to a 5 seconds.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">keep_alive</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">KeepAlive</span><span class="op">&gt;&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">val</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">keep_alive</span> <span class="op">=</span> <span class="ident">val</span>.<span class="ident">into</span>();
<span class="self">self</span>
}
<span class="doccomment">/// Set server client timeout in milliseconds for first request.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Defines a timeout for reading client request header. If a client does not transmit</span>
<span class="doccomment">/// the entire set headers within this time, the request is terminated with</span>
<span class="doccomment">/// the 408 (Request Time-out) error.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// To disable timeout set value to 0.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default client timeout is set to 5000 milliseconds.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">client_timeout</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">val</span>: <span class="ident">u64</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">client_timeout</span> <span class="op">=</span> <span class="ident">val</span>;
<span class="self">self</span>
}
<span class="doccomment">/// Set server connection shutdown timeout in milliseconds.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Defines a timeout for shutdown connection. If a shutdown procedure does not complete</span>
<span class="doccomment">/// within this time, the request is dropped. This timeout affects only secure connections.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// To disable timeout set value to 0.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default client timeout is set to 5000 milliseconds.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">client_shutdown</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">val</span>: <span class="ident">u64</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">client_shutdown</span> <span class="op">=</span> <span class="ident">val</span>;
<span class="self">self</span>
}
<span class="doccomment">/// Set server host name.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Host name is used by application router aa a hostname for url</span>
<span class="doccomment">/// generation. Check [ConnectionInfo](./dev/struct.ConnectionInfo.</span>
<span class="doccomment">/// html#method.host) documentation for more information.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default host name is set to a &quot;localhost&quot; value.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">server_hostname</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">val</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">host</span> <span class="op">=</span> <span class="ident">val</span>.<span class="ident">to_owned</span>();
<span class="self">self</span>
}
<span class="doccomment">/// Set server ip address.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Host name is used by application router aa a hostname for url</span>
<span class="doccomment">/// generation. Check [ConnectionInfo](./dev/struct.ConnectionInfo.</span>
<span class="doccomment">/// html#method.host) documentation for more information.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// By default server address is set to a &quot;127.0.0.1:8080&quot;</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">server_address</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="ident">net</span>::<span class="ident">ToSocketAddrs</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">addr</span>: <span class="ident">S</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">match</span> <span class="ident">addr</span>.<span class="ident">to_socket_addrs</span>() {
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not convert to SocketAddr: {}&quot;</span>, <span class="ident">err</span>),
<span class="prelude-val">Ok</span>(<span class="kw-2">mut</span> <span class="ident">addrs</span>) <span class="op">=&gt;</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">addr</span>) <span class="op">=</span> <span class="ident">addrs</span>.<span class="ident">next</span>() {
<span class="self">self</span>.<span class="ident">addr</span> <span class="op">=</span> <span class="ident">addr</span>;
},
}
<span class="self">self</span>
}
<span class="doccomment">/// Finish service configuration and create `ServiceConfig` object.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">finish</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">ServiceConfig</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">settings</span> <span class="op">=</span> <span class="ident">ServerSettings</span>::<span class="ident">new</span>(<span class="self">self</span>.<span class="ident">addr</span>, <span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">host</span>, <span class="self">self</span>.<span class="ident">secure</span>);
<span class="kw">let</span> <span class="ident">client_shutdown</span> <span class="op">=</span> <span class="kw">if</span> <span class="self">self</span>.<span class="ident">secure</span> { <span class="self">self</span>.<span class="ident">client_shutdown</span> } <span class="kw">else</span> { <span class="number">0</span> };
<span class="ident">ServiceConfig</span>::<span class="ident">new</span>(
<span class="self">self</span>.<span class="ident">handler</span>,
<span class="self">self</span>.<span class="ident">keep_alive</span>,
<span class="self">self</span>.<span class="ident">client_timeout</span>,
<span class="ident">client_shutdown</span>,
<span class="ident">settings</span>,
)
}
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Copy</span>, <span class="ident">Clone</span>)]</span>
<span class="kw">struct</span> <span class="ident">Date</span> {
<span class="ident">current</span>: <span class="ident">Instant</span>,
<span class="ident">bytes</span>: [<span class="ident">u8</span>; <span class="ident">DATE_VALUE_LENGTH</span>],
<span class="ident">pos</span>: <span class="ident">usize</span>,
}
@ -572,6 +925,7 @@
<span class="kw">impl</span> <span class="ident">Date</span> {
<span class="kw">fn</span> <span class="ident">new</span>() <span class="op">-&gt;</span> <span class="ident">Date</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">date</span> <span class="op">=</span> <span class="ident">Date</span> {
<span class="ident">current</span>: <span class="ident">Instant</span>::<span class="ident">now</span>(),
<span class="ident">bytes</span>: [<span class="number">0</span>; <span class="ident">DATE_VALUE_LENGTH</span>],
<span class="ident">pos</span>: <span class="number">0</span>,
};
@ -580,6 +934,7 @@
}
<span class="kw">fn</span> <span class="ident">update</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>) {
<span class="self">self</span>.<span class="ident">pos</span> <span class="op">=</span> <span class="number">0</span>;
<span class="self">self</span>.<span class="ident">current</span> <span class="op">=</span> <span class="ident">Instant</span>::<span class="ident">now</span>();
<span class="macro">write</span><span class="macro">!</span>(<span class="self">self</span>, <span class="string">&quot;{}&quot;</span>, <span class="ident">time</span>::<span class="ident">at_utc</span>(<span class="ident">time</span>::<span class="ident">get_time</span>()).<span class="ident">rfc822</span>()).<span class="ident">unwrap</span>();
}
}
@ -621,6 +976,8 @@
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">test</span>)]</span>
<span class="kw">mod</span> <span class="ident">tests</span> {
<span class="kw">use</span> <span class="kw">super</span>::<span class="kw-2">*</span>;
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">future</span>;
<span class="kw">use</span> <span class="ident">tokio</span>::<span class="ident">runtime</span>::<span class="ident">current_thread</span>;
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_date_len</span>() {
@ -629,16 +986,23 @@
<span class="attribute">#[<span class="ident">test</span>]</span>
<span class="kw">fn</span> <span class="ident">test_date</span>() {
<span class="kw">let</span> <span class="ident">settings</span> <span class="op">=</span> <span class="ident">WorkerSettings</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>(
<span class="ident">Vec</span>::<span class="ident">new</span>(),
<span class="ident">KeepAlive</span>::<span class="ident">Os</span>,
<span class="ident">ServerSettings</span>::<span class="ident">default</span>(),
);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf1</span> <span class="op">=</span> <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="ident">DATE_VALUE_LENGTH</span> <span class="op">+</span> <span class="number">10</span>);
<span class="ident">settings</span>.<span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf1</span>, <span class="bool-val">true</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf2</span> <span class="op">=</span> <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="ident">DATE_VALUE_LENGTH</span> <span class="op">+</span> <span class="number">10</span>);
<span class="ident">settings</span>.<span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf2</span>, <span class="bool-val">true</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">buf1</span>, <span class="ident">buf2</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">rt</span> <span class="op">=</span> <span class="ident">current_thread</span>::<span class="ident">Runtime</span>::<span class="ident">new</span>().<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">rt</span>.<span class="ident">block_on</span>(<span class="ident">future</span>::<span class="ident">lazy</span>(<span class="op">||</span> {
<span class="kw">let</span> <span class="ident">settings</span> <span class="op">=</span> <span class="ident">ServiceConfig</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>(
(),
<span class="ident">KeepAlive</span>::<span class="ident">Os</span>,
<span class="number">0</span>,
<span class="number">0</span>,
<span class="ident">ServerSettings</span>::<span class="ident">default</span>(),
);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf1</span> <span class="op">=</span> <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="ident">DATE_VALUE_LENGTH</span> <span class="op">+</span> <span class="number">10</span>);
<span class="ident">settings</span>.<span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf1</span>, <span class="bool-val">true</span>);
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">buf2</span> <span class="op">=</span> <span class="ident">BytesMut</span>::<span class="ident">with_capacity</span>(<span class="ident">DATE_VALUE_LENGTH</span> <span class="op">+</span> <span class="number">10</span>);
<span class="ident">settings</span>.<span class="ident">set_date</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">buf2</span>, <span class="bool-val">true</span>);
<span class="macro">assert_eq</span><span class="macro">!</span>(<span class="ident">buf1</span>, <span class="ident">buf2</span>);
<span class="ident">future</span>::<span class="ident">ok</span>::<span class="op">&lt;</span><span class="kw">_</span>, ()<span class="op">&gt;</span>(())
}));
}
}
</pre>

1923
static/api/actix-web/stable/src/actix_web/server/srv.rs.html
View File

File diff suppressed because it is too large Load Diff

27
static/api/actix-web/stable/src/actix_web/server/ssl/mod.rs.html Normal file
View File

@ -0,0 +1,27 @@
<!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="Source to the Rust file `src/server/ssl/mod.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>mod.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
</pre><pre class="rust ">
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="kw">mod</span> <span class="ident">openssl</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">openssl</span>::{<span class="ident">openssl_acceptor_with_flags</span>, <span class="ident">OpensslAcceptor</span>};
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">mod</span> <span class="ident">nativetls</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">mod</span> <span class="ident">rustls</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">pub</span> <span class="kw">use</span> <span class="self">self</span>::<span class="ident">rustls</span>::<span class="ident">RustlsAcceptor</span>;
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

71
static/api/actix-web/stable/src/actix_web/server/ssl/nativetls.rs.html Normal file
View File

@ -0,0 +1,71 @@
<!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="Source to the Rust file `src/server/ssl/nativetls.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>nativetls.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<span id="25">25</span>
<span id="26">26</span>
<span id="27">27</span>
<span id="28">28</span>
<span id="29">29</span>
<span id="30">30</span>
<span id="31">31</span>
<span id="32">32</span>
<span id="33">33</span>
<span id="34">34</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::{<span class="ident">Shutdown</span>, <span class="ident">SocketAddr</span>};
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">ssl</span>::<span class="ident">TlsStream</span>;
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">IoStream</span>;
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">Io</span>: <span class="ident">IoStream</span><span class="op">&gt;</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">TlsStream</span><span class="op">&lt;</span><span class="ident">Io</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">shutdown</span>();
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">peer_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_ref</span>().<span class="ident">get_ref</span>().<span class="ident">peer_addr</span>()
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_nodelay</span>(<span class="ident">nodelay</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_linger</span>(<span class="ident">dur</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_keepalive</span>(<span class="ident">dur</span>)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

177
static/api/actix-web/stable/src/actix_web/server/ssl/openssl.rs.html Normal file
View File

@ -0,0 +1,177 @@
<!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="Source to the Rust file `src/server/ssl/openssl.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>openssl.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../../light.css" id="themeStyle"><script src="../../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../../settings.html"><img src="../../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10">10</span>
<span id="11">11</span>
<span id="12">12</span>
<span id="13">13</span>
<span id="14">14</span>
<span id="15">15</span>
<span id="16">16</span>
<span id="17">17</span>
<span id="18">18</span>
<span id="19">19</span>
<span id="20">20</span>
<span id="21">21</span>
<span id="22">22</span>
<span id="23">23</span>
<span id="24">24</span>
<span id="25">25</span>
<span id="26">26</span>
<span id="27">27</span>
<span id="28">28</span>
<span id="29">29</span>
<span id="30">30</span>
<span id="31">31</span>
<span id="32">32</span>
<span id="33">33</span>
<span id="34">34</span>
<span id="35">35</span>
<span id="36">36</span>
<span id="37">37</span>
<span id="38">38</span>
<span id="39">39</span>
<span id="40">40</span>
<span id="41">41</span>
<span id="42">42</span>
<span id="43">43</span>
<span id="44">44</span>
<span id="45">45</span>
<span id="46">46</span>
<span id="47">47</span>
<span id="48">48</span>
<span id="49">49</span>
<span id="50">50</span>
<span id="51">51</span>
<span id="52">52</span>
<span id="53">53</span>
<span id="54">54</span>
<span id="55">55</span>
<span id="56">56</span>
<span id="57">57</span>
<span id="58">58</span>
<span id="59">59</span>
<span id="60">60</span>
<span id="61">61</span>
<span id="62">62</span>
<span id="63">63</span>
<span id="64">64</span>
<span id="65">65</span>
<span id="66">66</span>
<span id="67">67</span>
<span id="68">68</span>
<span id="69">69</span>
<span id="70">70</span>
<span id="71">71</span>
<span id="72">72</span>
<span id="73">73</span>
<span id="74">74</span>
<span id="75">75</span>
<span id="76">76</span>
<span id="77">77</span>
<span id="78">78</span>
<span id="79">79</span>
<span id="80">80</span>
<span id="81">81</span>
<span id="82">82</span>
<span id="83">83</span>
<span id="84">84</span>
<span id="85">85</span>
<span id="86">86</span>
<span id="87">87</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">net</span>::{<span class="ident">Shutdown</span>, <span class="ident">SocketAddr</span>};
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">io</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">actix_net</span>::<span class="ident">ssl</span>;
<span class="kw">use</span> <span class="ident">openssl</span>::<span class="ident">ssl</span>::{<span class="ident">AlpnError</span>, <span class="ident">SslAcceptor</span>, <span class="ident">SslAcceptorBuilder</span>};
<span class="kw">use</span> <span class="ident">tokio_io</span>::{<span class="ident">AsyncRead</span>, <span class="ident">AsyncWrite</span>};
<span class="kw">use</span> <span class="ident">tokio_openssl</span>::<span class="ident">SslStream</span>;
<span class="kw">use</span> <span class="ident">server</span>::{<span class="ident">IoStream</span>, <span class="ident">ServerFlags</span>};
<span class="doccomment">/// Support `SSL` connections via openssl package</span>
<span class="doccomment">///</span>
<span class="doccomment">/// `ssl` feature enables `OpensslAcceptor` type</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">OpensslAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="ident">_t</span>: <span class="ident">ssl</span>::<span class="ident">OpensslAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">AsyncRead</span> <span class="op">+</span> <span class="ident">AsyncWrite</span><span class="op">&gt;</span> <span class="ident">OpensslAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="doccomment">/// Create `OpensslAcceptor` with enabled `HTTP/2` and `HTTP1.1` support.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">builder</span>: <span class="ident">SslAcceptorBuilder</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">ssl</span>::<span class="ident">OpensslAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span> {
<span class="ident">OpensslAcceptor</span>::<span class="ident">with_flags</span>(<span class="ident">builder</span>, <span class="ident">ServerFlags</span>::<span class="ident">HTTP1</span> <span class="op">|</span> <span class="ident">ServerFlags</span>::<span class="ident">HTTP2</span>)
}
<span class="doccomment">/// Create `OpensslAcceptor` with custom server flags.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_flags</span>(
<span class="ident">builder</span>: <span class="ident">SslAcceptorBuilder</span>, <span class="ident">flags</span>: <span class="ident">ServerFlags</span>,
) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">ssl</span>::<span class="ident">OpensslAcceptor</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;&gt;</span> {
<span class="kw">let</span> <span class="ident">acceptor</span> <span class="op">=</span> <span class="ident">openssl_acceptor_with_flags</span>(<span class="ident">builder</span>, <span class="ident">flags</span>)<span class="question-mark">?</span>;
<span class="prelude-val">Ok</span>(<span class="ident">ssl</span>::<span class="ident">OpensslAcceptor</span>::<span class="ident">new</span>(<span class="ident">acceptor</span>))
}
}
<span class="doccomment">/// Configure `SslAcceptorBuilder` with custom server flags.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">openssl_acceptor_with_flags</span>(
<span class="kw-2">mut</span> <span class="ident">builder</span>: <span class="ident">SslAcceptorBuilder</span>, <span class="ident">flags</span>: <span class="ident">ServerFlags</span>,
) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">SslAcceptor</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">protos</span> <span class="op">=</span> <span class="ident">Vec</span>::<span class="ident">new</span>();
<span class="kw">if</span> <span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">ServerFlags</span>::<span class="ident">HTTP1</span>) {
<span class="ident">protos</span>.<span class="ident">extend</span>(<span class="string">b&quot;\x08http/1.1&quot;</span>);
}
<span class="kw">if</span> <span class="ident">flags</span>.<span class="ident">contains</span>(<span class="ident">ServerFlags</span>::<span class="ident">HTTP2</span>) {
<span class="ident">protos</span>.<span class="ident">extend</span>(<span class="string">b&quot;\x02h2&quot;</span>);
<span class="ident">builder</span>.<span class="ident">set_alpn_select_callback</span>(<span class="op">|</span><span class="kw">_</span>, <span class="ident">protos</span><span class="op">|</span> {
<span class="kw">const</span> <span class="ident">H2</span>: <span class="kw-2">&amp;</span>[<span class="ident">u8</span>] <span class="op">=</span> <span class="string">b&quot;\x02h2&quot;</span>;
<span class="kw">if</span> <span class="ident">protos</span>.<span class="ident">windows</span>(<span class="number">3</span>).<span class="ident">any</span>(<span class="op">|</span><span class="ident">window</span><span class="op">|</span> <span class="ident">window</span> <span class="op">==</span> <span class="ident">H2</span>) {
<span class="prelude-val">Ok</span>(<span class="string">b&quot;h2&quot;</span>)
} <span class="kw">else</span> {
<span class="prelude-val">Err</span>(<span class="ident">AlpnError</span>::<span class="ident">NOACK</span>)
}
});
}
<span class="kw">if</span> <span class="op">!</span><span class="ident">protos</span>.<span class="ident">is_empty</span>() {
<span class="ident">builder</span>.<span class="ident">set_alpn_protos</span>(<span class="kw-2">&amp;</span><span class="ident">protos</span>)<span class="question-mark">?</span>;
}
<span class="prelude-val">Ok</span>(<span class="ident">builder</span>.<span class="ident">build</span>())
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>: <span class="ident">IoStream</span><span class="op">&gt;</span> <span class="ident">IoStream</span> <span class="kw">for</span> <span class="ident">SslStream</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">shutdown</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">_how</span>: <span class="ident">Shutdown</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">shutdown</span>();
<span class="prelude-val">Ok</span>(())
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">peer_addr</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SocketAddr</span><span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_ref</span>().<span class="ident">get_ref</span>().<span class="ident">peer_addr</span>()
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_nodelay</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">nodelay</span>: <span class="ident">bool</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_nodelay</span>(<span class="ident">nodelay</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_linger</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_linger</span>(<span class="ident">dur</span>)
}
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="kw">fn</span> <span class="ident">set_keepalive</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">dur</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">io</span>::<span class="prelude-ty">Result</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="self">self</span>.<span class="ident">get_mut</span>().<span class="ident">get_mut</span>().<span class="ident">set_keepalive</span>(<span class="ident">dur</span>)
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../../";window.currentCrate = "actix_web";</script><script src="../../../../aliases.js"></script><script src="../../../../main.js"></script><script defer src="../../../../search-index.js"></script></body></html>

507
static/api/actix-web/stable/src/actix_web/server/worker.rs.html
View File

@ -1,507 +0,0 @@
<!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="Source to the Rust file `src/server/worker.rs`."><meta name="keywords" content="rust, rustlang, rust-lang"><title>worker.rs.html -- source</title><link rel="stylesheet" type="text/css" href="../../../normalize.css"><link rel="stylesheet" type="text/css" href="../../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" type="text/css" href="../../../dark.css"><link rel="stylesheet" type="text/css" href="../../../light.css" id="themeStyle"><script src="../../../storage.js"></script></head><body class="rustdoc source"><!--[if lte IE 8]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="sidebar"><div class="sidebar-menu">&#9776;</div></nav><div class="theme-picker"><button id="theme-picker" aria-label="Pick another theme!"><img src="../../../brush.svg" width="18" alt="Pick another theme!"></button><div id="theme-choices"></div></div><script src="../../../theme.js"></script><nav class="sub"><form class="search-form js-only"><div class="search-container"><input class="search-input" name="search" autocomplete="off" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><a id="settings-menu" href="../../../settings.html"><img src="../../../wheel.svg" width="18" alt="Change settings"></a></div></form></nav><section id="main" class="content"><pre class="line-numbers"><span id="1"> 1</span>
<span id="2"> 2</span>
<span id="3"> 3</span>
<span id="4"> 4</span>
<span id="5"> 5</span>
<span id="6"> 6</span>
<span id="7"> 7</span>
<span id="8"> 8</span>
<span id="9"> 9</span>
<span id="10"> 10</span>
<span id="11"> 11</span>
<span id="12"> 12</span>
<span id="13"> 13</span>
<span id="14"> 14</span>
<span id="15"> 15</span>
<span id="16"> 16</span>
<span id="17"> 17</span>
<span id="18"> 18</span>
<span id="19"> 19</span>
<span id="20"> 20</span>
<span id="21"> 21</span>
<span id="22"> 22</span>
<span id="23"> 23</span>
<span id="24"> 24</span>
<span id="25"> 25</span>
<span id="26"> 26</span>
<span id="27"> 27</span>
<span id="28"> 28</span>
<span id="29"> 29</span>
<span id="30"> 30</span>
<span id="31"> 31</span>
<span id="32"> 32</span>
<span id="33"> 33</span>
<span id="34"> 34</span>
<span id="35"> 35</span>
<span id="36"> 36</span>
<span id="37"> 37</span>
<span id="38"> 38</span>
<span id="39"> 39</span>
<span id="40"> 40</span>
<span id="41"> 41</span>
<span id="42"> 42</span>
<span id="43"> 43</span>
<span id="44"> 44</span>
<span id="45"> 45</span>
<span id="46"> 46</span>
<span id="47"> 47</span>
<span id="48"> 48</span>
<span id="49"> 49</span>
<span id="50"> 50</span>
<span id="51"> 51</span>
<span id="52"> 52</span>
<span id="53"> 53</span>
<span id="54"> 54</span>
<span id="55"> 55</span>
<span id="56"> 56</span>
<span id="57"> 57</span>
<span id="58"> 58</span>
<span id="59"> 59</span>
<span id="60"> 60</span>
<span id="61"> 61</span>
<span id="62"> 62</span>
<span id="63"> 63</span>
<span id="64"> 64</span>
<span id="65"> 65</span>
<span id="66"> 66</span>
<span id="67"> 67</span>
<span id="68"> 68</span>
<span id="69"> 69</span>
<span id="70"> 70</span>
<span id="71"> 71</span>
<span id="72"> 72</span>
<span id="73"> 73</span>
<span id="74"> 74</span>
<span id="75"> 75</span>
<span id="76"> 76</span>
<span id="77"> 77</span>
<span id="78"> 78</span>
<span id="79"> 79</span>
<span id="80"> 80</span>
<span id="81"> 81</span>
<span id="82"> 82</span>
<span id="83"> 83</span>
<span id="84"> 84</span>
<span id="85"> 85</span>
<span id="86"> 86</span>
<span id="87"> 87</span>
<span id="88"> 88</span>
<span id="89"> 89</span>
<span id="90"> 90</span>
<span id="91"> 91</span>
<span id="92"> 92</span>
<span id="93"> 93</span>
<span id="94"> 94</span>
<span id="95"> 95</span>
<span id="96"> 96</span>
<span id="97"> 97</span>
<span id="98"> 98</span>
<span id="99"> 99</span>
<span id="100">100</span>
<span id="101">101</span>
<span id="102">102</span>
<span id="103">103</span>
<span id="104">104</span>
<span id="105">105</span>
<span id="106">106</span>
<span id="107">107</span>
<span id="108">108</span>
<span id="109">109</span>
<span id="110">110</span>
<span id="111">111</span>
<span id="112">112</span>
<span id="113">113</span>
<span id="114">114</span>
<span id="115">115</span>
<span id="116">116</span>
<span id="117">117</span>
<span id="118">118</span>
<span id="119">119</span>
<span id="120">120</span>
<span id="121">121</span>
<span id="122">122</span>
<span id="123">123</span>
<span id="124">124</span>
<span id="125">125</span>
<span id="126">126</span>
<span id="127">127</span>
<span id="128">128</span>
<span id="129">129</span>
<span id="130">130</span>
<span id="131">131</span>
<span id="132">132</span>
<span id="133">133</span>
<span id="134">134</span>
<span id="135">135</span>
<span id="136">136</span>
<span id="137">137</span>
<span id="138">138</span>
<span id="139">139</span>
<span id="140">140</span>
<span id="141">141</span>
<span id="142">142</span>
<span id="143">143</span>
<span id="144">144</span>
<span id="145">145</span>
<span id="146">146</span>
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
<span id="153">153</span>
<span id="154">154</span>
<span id="155">155</span>
<span id="156">156</span>
<span id="157">157</span>
<span id="158">158</span>
<span id="159">159</span>
<span id="160">160</span>
<span id="161">161</span>
<span id="162">162</span>
<span id="163">163</span>
<span id="164">164</span>
<span id="165">165</span>
<span id="166">166</span>
<span id="167">167</span>
<span id="168">168</span>
<span id="169">169</span>
<span id="170">170</span>
<span id="171">171</span>
<span id="172">172</span>
<span id="173">173</span>
<span id="174">174</span>
<span id="175">175</span>
<span id="176">176</span>
<span id="177">177</span>
<span id="178">178</span>
<span id="179">179</span>
<span id="180">180</span>
<span id="181">181</span>
<span id="182">182</span>
<span id="183">183</span>
<span id="184">184</span>
<span id="185">185</span>
<span id="186">186</span>
<span id="187">187</span>
<span id="188">188</span>
<span id="189">189</span>
<span id="190">190</span>
<span id="191">191</span>
<span id="192">192</span>
<span id="193">193</span>
<span id="194">194</span>
<span id="195">195</span>
<span id="196">196</span>
<span id="197">197</span>
<span id="198">198</span>
<span id="199">199</span>
<span id="200">200</span>
<span id="201">201</span>
<span id="202">202</span>
<span id="203">203</span>
<span id="204">204</span>
<span id="205">205</span>
<span id="206">206</span>
<span id="207">207</span>
<span id="208">208</span>
<span id="209">209</span>
<span id="210">210</span>
<span id="211">211</span>
<span id="212">212</span>
<span id="213">213</span>
<span id="214">214</span>
<span id="215">215</span>
<span id="216">216</span>
<span id="217">217</span>
<span id="218">218</span>
<span id="219">219</span>
<span id="220">220</span>
<span id="221">221</span>
<span id="222">222</span>
<span id="223">223</span>
<span id="224">224</span>
<span id="225">225</span>
<span id="226">226</span>
<span id="227">227</span>
<span id="228">228</span>
<span id="229">229</span>
<span id="230">230</span>
<span id="231">231</span>
<span id="232">232</span>
<span id="233">233</span>
<span id="234">234</span>
<span id="235">235</span>
<span id="236">236</span>
<span id="237">237</span>
<span id="238">238</span>
<span id="239">239</span>
<span id="240">240</span>
<span id="241">241</span>
<span id="242">242</span>
<span id="243">243</span>
<span id="244">244</span>
<span id="245">245</span>
<span id="246">246</span>
<span id="247">247</span>
<span id="248">248</span>
<span id="249">249</span>
<span id="250">250</span>
<span id="251">251</span>
<span id="252">252</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">sync</span>::<span class="ident">oneshot</span>;
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">Future</span>;
<span class="kw">use</span> <span class="ident">net2</span>::<span class="ident">TcpStreamExt</span>;
<span class="kw">use</span> <span class="ident">slab</span>::<span class="ident">Slab</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
<span class="kw">use</span> <span class="ident">std</span>::{<span class="ident">net</span>, <span class="ident">time</span>};
<span class="kw">use</span> <span class="ident">tokio</span>::<span class="ident">executor</span>::<span class="ident">current_thread</span>;
<span class="kw">use</span> <span class="ident">tokio_reactor</span>::<span class="ident">Handle</span>;
<span class="kw">use</span> <span class="ident">tokio_tcp</span>::<span class="ident">TcpStream</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
<span class="kw">use</span> <span class="ident">futures</span>::<span class="ident">future</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">native_tls</span>::<span class="ident">TlsAcceptor</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_tls</span>::<span class="ident">TlsAcceptorExt</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">openssl</span>::<span class="ident">ssl</span>::<span class="ident">SslAcceptor</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">tokio_openssl</span>::<span class="ident">SslAcceptorExt</span>;
<span class="kw">use</span> <span class="ident">actix</span>::<span class="ident">msgs</span>::<span class="ident">StopArbiter</span>;
<span class="kw">use</span> <span class="ident">actix</span>::{<span class="ident">Actor</span>, <span class="ident">Arbiter</span>, <span class="ident">AsyncContext</span>, <span class="ident">Context</span>, <span class="ident">Handler</span>, <span class="ident">Message</span>, <span class="ident">Response</span>};
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">channel</span>::<span class="ident">HttpChannel</span>;
<span class="kw">use</span> <span class="ident">server</span>::<span class="ident">settings</span>::{<span class="ident">ServerSettings</span>, <span class="ident">WorkerSettings</span>};
<span class="kw">use</span> <span class="ident">server</span>::{<span class="ident">HttpHandler</span>, <span class="ident">KeepAlive</span>};
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Message</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">Conn</span><span class="op">&lt;</span><span class="ident">T</span><span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="ident">io</span>: <span class="ident">T</span>,
<span class="kw">pub</span> <span class="ident">token</span>: <span class="ident">usize</span>,
<span class="kw">pub</span> <span class="ident">peer</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">SocketAddr</span><span class="op">&gt;</span>,
<span class="kw">pub</span> <span class="ident">http2</span>: <span class="ident">bool</span>,
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Clone</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">SocketInfo</span> {
<span class="kw">pub</span> <span class="ident">addr</span>: <span class="ident">net</span>::<span class="ident">SocketAddr</span>,
<span class="kw">pub</span> <span class="ident">htype</span>: <span class="ident">StreamHandlerType</span>,
}
<span class="doccomment">/// Stop worker message. Returns `true` on successful shutdown</span>
<span class="doccomment">/// and `false` if some connections still alive.</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">StopWorker</span> {
<span class="kw">pub</span> <span class="ident">graceful</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span> <span class="ident">Message</span> <span class="kw">for</span> <span class="ident">StopWorker</span> {
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">bool</span>, ()<span class="op">&gt;</span>;
}
<span class="doccomment">/// Http worker</span>
<span class="doccomment">///</span>
<span class="doccomment">/// Worker accepts Socket objects via unbounded channel and start requests</span>
<span class="doccomment">/// processing.</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">settings</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>,
<span class="ident">socks</span>: <span class="ident">Slab</span><span class="op">&lt;</span><span class="ident">SocketInfo</span><span class="op">&gt;</span>,
<span class="ident">tcp_ka</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">time</span>::<span class="ident">Duration</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">new</span>(
<span class="ident">h</span>: <span class="ident">Vec</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>, <span class="ident">socks</span>: <span class="ident">Slab</span><span class="op">&lt;</span><span class="ident">SocketInfo</span><span class="op">&gt;</span>, <span class="ident">keep_alive</span>: <span class="ident">KeepAlive</span>,
<span class="ident">settings</span>: <span class="ident">ServerSettings</span>,
) <span class="op">-&gt;</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">tcp_ka</span> <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="ident">KeepAlive</span>::<span class="ident">Tcp</span>(<span class="ident">val</span>) <span class="op">=</span> <span class="ident">keep_alive</span> {
<span class="prelude-val">Some</span>(<span class="ident">time</span>::<span class="ident">Duration</span>::<span class="ident">new</span>(<span class="ident">val</span> <span class="kw">as</span> <span class="ident">u64</span>, <span class="number">0</span>))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
};
<span class="ident">Worker</span> {
<span class="ident">settings</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">WorkerSettings</span>::<span class="ident">new</span>(<span class="ident">h</span>, <span class="ident">keep_alive</span>, <span class="ident">settings</span>)),
<span class="ident">socks</span>,
<span class="ident">tcp_ka</span>,
}
}
<span class="kw">fn</span> <span class="ident">update_time</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">ctx</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>) {
<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">update_date</span>();
<span class="ident">ctx</span>.<span class="ident">run_later</span>(<span class="ident">time</span>::<span class="ident">Duration</span>::<span class="ident">new</span>(<span class="number">1</span>, <span class="number">0</span>), <span class="op">|</span><span class="ident">slf</span>, <span class="ident">ctx</span><span class="op">|</span> <span class="ident">slf</span>.<span class="ident">update_time</span>(<span class="ident">ctx</span>));
}
<span class="kw">fn</span> <span class="ident">shutdown_timeout</span>(
<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">ctx</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>, <span class="ident">tx</span>: <span class="ident">oneshot</span>::<span class="ident">Sender</span><span class="op">&lt;</span><span class="ident">bool</span><span class="op">&gt;</span>, <span class="ident">dur</span>: <span class="ident">time</span>::<span class="ident">Duration</span>,
) {
<span class="comment">// sleep for 1 second and then check again</span>
<span class="ident">ctx</span>.<span class="ident">run_later</span>(<span class="ident">time</span>::<span class="ident">Duration</span>::<span class="ident">new</span>(<span class="number">1</span>, <span class="number">0</span>), <span class="kw">move</span> <span class="op">|</span><span class="ident">slf</span>, <span class="ident">ctx</span><span class="op">|</span> {
<span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="ident">slf</span>.<span class="ident">settings</span>.<span class="ident">num_channels</span>();
<span class="kw">if</span> <span class="ident">num</span> <span class="op">==</span> <span class="number">0</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">tx</span>.<span class="ident">send</span>(<span class="bool-val">true</span>);
<span class="ident">Arbiter</span>::<span class="ident">current</span>().<span class="ident">do_send</span>(<span class="ident">StopArbiter</span>(<span class="number">0</span>));
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">d</span>) <span class="op">=</span> <span class="ident">dur</span>.<span class="ident">checked_sub</span>(<span class="ident">time</span>::<span class="ident">Duration</span>::<span class="ident">new</span>(<span class="number">1</span>, <span class="number">0</span>)) {
<span class="ident">slf</span>.<span class="ident">shutdown_timeout</span>(<span class="ident">ctx</span>, <span class="ident">tx</span>, <span class="ident">d</span>);
} <span class="kw">else</span> {
<span class="macro">info</span><span class="macro">!</span>(<span class="string">&quot;Force shutdown http worker, {} connections&quot;</span>, <span class="ident">num</span>);
<span class="ident">slf</span>.<span class="ident">settings</span>.<span class="ident">head</span>().<span class="ident">traverse</span>::<span class="op">&lt;</span><span class="ident">TcpStream</span>, <span class="ident">H</span><span class="op">&gt;</span>();
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">tx</span>.<span class="ident">send</span>(<span class="bool-val">false</span>);
<span class="ident">Arbiter</span>::<span class="ident">current</span>().<span class="ident">do_send</span>(<span class="ident">StopArbiter</span>(<span class="number">0</span>));
}
});
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">Actor</span> <span class="kw">for</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">type</span> <span class="ident">Context</span> <span class="op">=</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">started</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">ctx</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">Self</span>::<span class="ident">Context</span>) {
<span class="self">self</span>.<span class="ident">update_time</span>(<span class="ident">ctx</span>);
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">Conn</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;&gt;</span> <span class="kw">for</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> ();
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">msg</span>: <span class="ident">Conn</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>, <span class="kw">_</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>) {
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">tcp_ka</span>.<span class="ident">is_some</span>() <span class="op">&amp;&amp;</span> <span class="ident">msg</span>.<span class="ident">io</span>.<span class="ident">set_keepalive</span>(<span class="self">self</span>.<span class="ident">tcp_ka</span>).<span class="ident">is_err</span>() {
<span class="macro">error</span><span class="macro">!</span>(<span class="string">&quot;Can not set socket keep-alive option&quot;</span>);
}
<span class="self">self</span>.<span class="ident">socks</span>
.<span class="ident">get_mut</span>(<span class="ident">msg</span>.<span class="ident">token</span>)
.<span class="ident">unwrap</span>()
.<span class="ident">htype</span>
.<span class="ident">handle</span>(<span class="ident">Rc</span>::<span class="ident">clone</span>(<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">settings</span>), <span class="ident">msg</span>);
}
}
<span class="doccomment">/// `StopWorker` message handler</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">StopWorker</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Worker</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">H</span>: <span class="ident">HttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">type</span> <span class="prelude-ty">Result</span> <span class="op">=</span> <span class="ident">Response</span><span class="op">&lt;</span><span class="ident">bool</span>, ()<span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">msg</span>: <span class="ident">StopWorker</span>, <span class="ident">ctx</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">Context</span><span class="op">&lt;</span><span class="self">Self</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="self">Self</span>::<span class="prelude-ty">Result</span> {
<span class="kw">let</span> <span class="ident">num</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">num_channels</span>();
<span class="kw">if</span> <span class="ident">num</span> <span class="op">==</span> <span class="number">0</span> {
<span class="macro">info</span><span class="macro">!</span>(<span class="string">&quot;Shutting down http worker, 0 connections&quot;</span>);
<span class="ident">Response</span>::<span class="ident">reply</span>(<span class="prelude-val">Ok</span>(<span class="bool-val">true</span>))
} <span class="kw">else</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">dur</span>) <span class="op">=</span> <span class="ident">msg</span>.<span class="ident">graceful</span> {
<span class="macro">info</span><span class="macro">!</span>(<span class="string">&quot;Graceful http worker shutdown, {} connections&quot;</span>, <span class="ident">num</span>);
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">oneshot</span>::<span class="ident">channel</span>();
<span class="self">self</span>.<span class="ident">shutdown_timeout</span>(<span class="ident">ctx</span>, <span class="ident">tx</span>, <span class="ident">dur</span>);
<span class="ident">Response</span>::<span class="ident">async</span>(<span class="ident">rx</span>.<span class="ident">map_err</span>(<span class="op">|</span><span class="kw">_</span><span class="op">|</span> ()))
} <span class="kw">else</span> {
<span class="macro">info</span><span class="macro">!</span>(<span class="string">&quot;Force shutdown http worker, {} connections&quot;</span>, <span class="ident">num</span>);
<span class="self">self</span>.<span class="ident">settings</span>.<span class="ident">head</span>().<span class="ident">traverse</span>::<span class="op">&lt;</span><span class="ident">TcpStream</span>, <span class="ident">H</span><span class="op">&gt;</span>();
<span class="ident">Response</span>::<span class="ident">reply</span>(<span class="prelude-val">Ok</span>(<span class="bool-val">false</span>))
}
}
}
<span class="attribute">#[<span class="ident">derive</span>(<span class="ident">Clone</span>)]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">enum</span> <span class="ident">StreamHandlerType</span> {
<span class="ident">Normal</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="ident">Tls</span>(<span class="ident">TlsAcceptor</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="ident">Alpn</span>(<span class="ident">SslAcceptor</span>),
}
<span class="kw">impl</span> <span class="ident">StreamHandlerType</span> {
<span class="kw">fn</span> <span class="ident">handle</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">HttpHandler</span><span class="op">&gt;</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">h</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">WorkerSettings</span><span class="op">&lt;</span><span class="ident">H</span><span class="op">&gt;&gt;</span>, <span class="ident">msg</span>: <span class="ident">Conn</span><span class="op">&lt;</span><span class="ident">net</span>::<span class="ident">TcpStream</span><span class="op">&gt;</span>,
) {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">StreamHandlerType</span>::<span class="ident">Normal</span> <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">msg</span>.<span class="ident">io</span>.<span class="ident">set_nodelay</span>(<span class="bool-val">true</span>);
<span class="kw">let</span> <span class="ident">io</span> <span class="op">=</span> <span class="ident">TcpStream</span>::<span class="ident">from_std</span>(<span class="ident">msg</span>.<span class="ident">io</span>, <span class="kw-2">&amp;</span><span class="ident">Handle</span>::<span class="ident">default</span>())
.<span class="ident">expect</span>(<span class="string">&quot;failed to associate TCP stream&quot;</span>);
<span class="ident">current_thread</span>::<span class="ident">spawn</span>(<span class="ident">HttpChannel</span>::<span class="ident">new</span>(<span class="ident">h</span>, <span class="ident">io</span>, <span class="ident">msg</span>.<span class="ident">peer</span>, <span class="ident">msg</span>.<span class="ident">http2</span>));
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="ident">StreamHandlerType</span>::<span class="ident">Tls</span>(<span class="kw-2">ref</span> <span class="ident">acceptor</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">Conn</span> {
<span class="ident">io</span>, <span class="ident">peer</span>, <span class="ident">http2</span>, ..
} <span class="op">=</span> <span class="ident">msg</span>;
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">set_nodelay</span>(<span class="bool-val">true</span>);
<span class="kw">let</span> <span class="ident">io</span> <span class="op">=</span> <span class="ident">TcpStream</span>::<span class="ident">from_std</span>(<span class="ident">io</span>, <span class="kw-2">&amp;</span><span class="ident">Handle</span>::<span class="ident">default</span>())
.<span class="ident">expect</span>(<span class="string">&quot;failed to associate TCP stream&quot;</span>);
<span class="ident">current_thread</span>::<span class="ident">spawn</span>(<span class="ident">TlsAcceptorExt</span>::<span class="ident">accept_async</span>(<span class="ident">acceptor</span>, <span class="ident">io</span>).<span class="ident">then</span>(
<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Ok</span>(<span class="ident">io</span>) <span class="op">=&gt;</span> <span class="ident">current_thread</span>::<span class="ident">spawn</span>(<span class="ident">HttpChannel</span>::<span class="ident">new</span>(
<span class="ident">h</span>, <span class="ident">io</span>, <span class="ident">peer</span>, <span class="ident">http2</span>,
)),
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Error during handling tls connection: {}&quot;</span>, <span class="ident">err</span>)
}
};
<span class="ident">future</span>::<span class="ident">result</span>(<span class="prelude-val">Ok</span>(()))
},
));
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="ident">StreamHandlerType</span>::<span class="ident">Alpn</span>(<span class="kw-2">ref</span> <span class="ident">acceptor</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">Conn</span> { <span class="ident">io</span>, <span class="ident">peer</span>, .. } <span class="op">=</span> <span class="ident">msg</span>;
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">io</span>.<span class="ident">set_nodelay</span>(<span class="bool-val">true</span>);
<span class="kw">let</span> <span class="ident">io</span> <span class="op">=</span> <span class="ident">TcpStream</span>::<span class="ident">from_std</span>(<span class="ident">io</span>, <span class="kw-2">&amp;</span><span class="ident">Handle</span>::<span class="ident">default</span>())
.<span class="ident">expect</span>(<span class="string">&quot;failed to associate TCP stream&quot;</span>);
<span class="ident">current_thread</span>::<span class="ident">spawn</span>(<span class="ident">SslAcceptorExt</span>::<span class="ident">accept_async</span>(<span class="ident">acceptor</span>, <span class="ident">io</span>).<span class="ident">then</span>(
<span class="kw">move</span> <span class="op">|</span><span class="ident">res</span><span class="op">|</span> {
<span class="kw">match</span> <span class="ident">res</span> {
<span class="prelude-val">Ok</span>(<span class="ident">io</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="ident">http2</span> <span class="op">=</span> <span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">p</span>) <span class="op">=</span>
<span class="ident">io</span>.<span class="ident">get_ref</span>().<span class="ident">ssl</span>().<span class="ident">selected_alpn_protocol</span>()
{
<span class="ident">p</span>.<span class="ident">len</span>() <span class="op">==</span> <span class="number">2</span> <span class="op">&amp;&amp;</span> <span class="kw-2">&amp;</span><span class="ident">p</span> <span class="op">==</span> <span class="string">b&quot;h2&quot;</span>
} <span class="kw">else</span> {
<span class="bool-val">false</span>
};
<span class="ident">current_thread</span>::<span class="ident">spawn</span>(<span class="ident">HttpChannel</span>::<span class="ident">new</span>(
<span class="ident">h</span>, <span class="ident">io</span>, <span class="ident">peer</span>, <span class="ident">http2</span>,
));
}
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> {
<span class="macro">trace</span><span class="macro">!</span>(<span class="string">&quot;Error during handling tls connection: {}&quot;</span>, <span class="ident">err</span>)
}
};
<span class="ident">future</span>::<span class="ident">result</span>(<span class="prelude-val">Ok</span>(()))
},
));
}
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">scheme</span>(<span class="kw-2">&amp;</span><span class="self">self</span>) <span class="op">-&gt;</span> <span class="kw-2">&amp;</span><span class="lifetime">&#39;static</span> <span class="ident">str</span> {
<span class="kw">match</span> <span class="kw-2">*</span><span class="self">self</span> {
<span class="ident">StreamHandlerType</span>::<span class="ident">Normal</span> <span class="op">=&gt;</span> <span class="string">&quot;http&quot;</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;tls&quot;</span>)]</span>
<span class="ident">StreamHandlerType</span>::<span class="ident">Tls</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="string">&quot;https&quot;</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="ident">StreamHandlerType</span>::<span class="ident">Alpn</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="string">&quot;https&quot;</span>,
}
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../../";window.currentCrate = "actix_web";</script><script src="../../../aliases.js"></script><script src="../../../main.js"></script><script defer src="../../../search-index.js"></script></body></html>

300
static/api/actix-web/stable/src/actix_web/test.rs.html
View File

@ -672,6 +672,100 @@
<span id="672">672</span>
<span id="673">673</span>
<span id="674">674</span>
<span id="675">675</span>
<span id="676">676</span>
<span id="677">677</span>
<span id="678">678</span>
<span id="679">679</span>
<span id="680">680</span>
<span id="681">681</span>
<span id="682">682</span>
<span id="683">683</span>
<span id="684">684</span>
<span id="685">685</span>
<span id="686">686</span>
<span id="687">687</span>
<span id="688">688</span>
<span id="689">689</span>
<span id="690">690</span>
<span id="691">691</span>
<span id="692">692</span>
<span id="693">693</span>
<span id="694">694</span>
<span id="695">695</span>
<span id="696">696</span>
<span id="697">697</span>
<span id="698">698</span>
<span id="699">699</span>
<span id="700">700</span>
<span id="701">701</span>
<span id="702">702</span>
<span id="703">703</span>
<span id="704">704</span>
<span id="705">705</span>
<span id="706">706</span>
<span id="707">707</span>
<span id="708">708</span>
<span id="709">709</span>
<span id="710">710</span>
<span id="711">711</span>
<span id="712">712</span>
<span id="713">713</span>
<span id="714">714</span>
<span id="715">715</span>
<span id="716">716</span>
<span id="717">717</span>
<span id="718">718</span>
<span id="719">719</span>
<span id="720">720</span>
<span id="721">721</span>
<span id="722">722</span>
<span id="723">723</span>
<span id="724">724</span>
<span id="725">725</span>
<span id="726">726</span>
<span id="727">727</span>
<span id="728">728</span>
<span id="729">729</span>
<span id="730">730</span>
<span id="731">731</span>
<span id="732">732</span>
<span id="733">733</span>
<span id="734">734</span>
<span id="735">735</span>
<span id="736">736</span>
<span id="737">737</span>
<span id="738">738</span>
<span id="739">739</span>
<span id="740">740</span>
<span id="741">741</span>
<span id="742">742</span>
<span id="743">743</span>
<span id="744">744</span>
<span id="745">745</span>
<span id="746">746</span>
<span id="747">747</span>
<span id="748">748</span>
<span id="749">749</span>
<span id="750">750</span>
<span id="751">751</span>
<span id="752">752</span>
<span id="753">753</span>
<span id="754">754</span>
<span id="755">755</span>
<span id="756">756</span>
<span id="757">757</span>
<span id="758">758</span>
<span id="759">759</span>
<span id="760">760</span>
<span id="761">761</span>
<span id="762">762</span>
<span id="763">763</span>
<span id="764">764</span>
<span id="765">765</span>
<span id="766">766</span>
<span id="767">767</span>
<span id="768">768</span>
</pre><pre class="rust ">
<span class="doccomment">//! Various helpers for Actix applications to use during testing.</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">rc</span>::<span class="ident">Rc</span>;
@ -688,14 +782,16 @@
<span class="kw">use</span> <span class="ident">net2</span>::<span class="ident">TcpBuilder</span>;
<span class="kw">use</span> <span class="ident">tokio</span>::<span class="ident">runtime</span>::<span class="ident">current_thread</span>::<span class="ident">Runtime</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="kw">use</span> <span class="ident">openssl</span>::<span class="ident">ssl</span>::<span class="ident">SslAcceptorBuilder</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="kw">use</span> <span class="ident">rustls</span>::<span class="ident">ServerConfig</span>;
<span class="kw">use</span> <span class="ident">application</span>::{<span class="ident">App</span>, <span class="ident">HttpApplication</span>};
<span class="kw">use</span> <span class="ident">body</span>::<span class="ident">Binary</span>;
<span class="kw">use</span> <span class="ident">client</span>::{<span class="ident">ClientConnector</span>, <span class="ident">ClientRequest</span>, <span class="ident">ClientRequestBuilder</span>};
<span class="kw">use</span> <span class="ident">error</span>::<span class="ident">Error</span>;
<span class="kw">use</span> <span class="ident">handler</span>::{<span class="ident">AsyncResultItem</span>, <span class="ident">Handler</span>, <span class="ident">Responder</span>};
<span class="kw">use</span> <span class="ident">handler</span>::{<span class="ident">AsyncResult</span>, <span class="ident">AsyncResultItem</span>, <span class="ident">Handler</span>, <span class="ident">Responder</span>};
<span class="kw">use</span> <span class="ident">header</span>::{<span class="ident">Header</span>, <span class="ident">IntoHeaderValue</span>};
<span class="kw">use</span> <span class="ident">httprequest</span>::<span class="ident">HttpRequest</span>;
<span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponse</span>;
@ -748,13 +844,13 @@
<span class="doccomment">/// middlewares or set handlers for test application.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>(<span class="ident">config</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="self">Self</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> <span class="op">+</span> <span class="ident">Fn</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">TestApp</span><span class="op">&lt;</span>()<span class="op">&gt;</span>),
<span class="ident">F</span>: <span class="ident">Clone</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> <span class="op">+</span> <span class="ident">Fn</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">TestApp</span><span class="op">&lt;</span>()<span class="op">&gt;</span>),
{
<span class="ident">TestServerBuilder</span>::<span class="ident">new</span>(<span class="op">||</span> ()).<span class="ident">start</span>(<span class="ident">config</span>)
}
<span class="doccomment">/// Create test server builder</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">build</span>() <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span>()<span class="op">&gt;</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">build</span>() <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span>(), <span class="kw">impl</span> <span class="ident">Fn</span>() <span class="op">-&gt;</span> () <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> {
<span class="ident">TestServerBuilder</span>::<span class="ident">new</span>(<span class="op">||</span> ())
}
@ -763,19 +859,18 @@
<span class="doccomment">/// This method can be used for constructing application state.</span>
<span class="doccomment">/// Also it can be used for external dependency initialization,</span>
<span class="doccomment">/// like creating sync actors for diesel integration.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">build_with_state</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">S</span><span class="op">&gt;</span>(<span class="ident">state</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">build_with_state</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">F</span><span class="op">&gt;</span>(<span class="ident">state</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">F</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="ident">TestServerBuilder</span>::<span class="ident">new</span>(<span class="ident">state</span>)
}
<span class="doccomment">/// Start new test server with application factory</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_factory</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">U</span>, <span class="ident">H</span><span class="op">&gt;</span>(<span class="ident">factory</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="self">Self</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">with_factory</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">H</span><span class="op">&gt;</span>(<span class="ident">factory</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="self">Self</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">U</span> <span class="op">+</span> <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">U</span>: <span class="ident">IntoIterator</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">H</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">H</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">H</span>: <span class="ident">IntoHttpHandler</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">mpsc</span>::<span class="ident">channel</span>();
@ -786,9 +881,10 @@
<span class="kw">let</span> <span class="ident">tcp</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpListener</span>::<span class="ident">bind</span>(<span class="string">&quot;127.0.0.1:0&quot;</span>).<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">local_addr</span> <span class="op">=</span> <span class="ident">tcp</span>.<span class="ident">local_addr</span>().<span class="ident">unwrap</span>();
<span class="ident">HttpServer</span>::<span class="ident">new</span>(<span class="ident">factory</span>)
<span class="kw">let</span> <span class="kw">_</span> <span class="op">=</span> <span class="ident">HttpServer</span>::<span class="ident">new</span>(<span class="ident">factory</span>)
.<span class="ident">disable_signals</span>()
.<span class="ident">listen</span>(<span class="ident">tcp</span>)
.<span class="ident">keep_alive</span>(<span class="number">5</span>)
.<span class="ident">start</span>();
<span class="ident">tx</span>.<span class="ident">send</span>((<span class="ident">System</span>::<span class="ident">current</span>(), <span class="ident">local_addr</span>, <span class="ident">TestServer</span>::<span class="ident">get_conn</span>()))
@ -807,7 +903,7 @@
}
<span class="kw">fn</span> <span class="ident">get_conn</span>() <span class="op">-&gt;</span> <span class="ident">Addr</span><span class="op">&lt;</span><span class="ident">ClientConnector</span><span class="op">&gt;</span> {
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
{
<span class="kw">use</span> <span class="ident">openssl</span>::<span class="ident">ssl</span>::{<span class="ident">SslConnector</span>, <span class="ident">SslMethod</span>, <span class="ident">SslVerifyMode</span>};
@ -815,7 +911,20 @@
<span class="ident">builder</span>.<span class="ident">set_verify</span>(<span class="ident">SslVerifyMode</span>::<span class="ident">NONE</span>);
<span class="ident">ClientConnector</span>::<span class="ident">with_connector</span>(<span class="ident">builder</span>.<span class="ident">build</span>()).<span class="ident">start</span>()
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">all</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>,
<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))
))]</span>
{
<span class="kw">use</span> <span class="ident">rustls</span>::<span class="ident">ClientConfig</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">fs</span>::<span class="ident">File</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">io</span>::<span class="ident">BufReader</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">config</span> <span class="op">=</span> <span class="ident">ClientConfig</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="ident">pem_file</span> <span class="op">=</span> <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">BufReader</span>::<span class="ident">new</span>(<span class="ident">File</span>::<span class="ident">open</span>(<span class="string">&quot;tests/cert.pem&quot;</span>).<span class="ident">unwrap</span>());
<span class="ident">config</span>.<span class="ident">root_store</span>.<span class="ident">add_pem_file</span>(<span class="ident">pem_file</span>).<span class="ident">unwrap</span>();
<span class="ident">ClientConnector</span>::<span class="ident">with_connector</span>(<span class="ident">config</span>).<span class="ident">start</span>()
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)))]</span>
{
<span class="ident">ClientConnector</span>::<span class="ident">default</span>().<span class="ident">start</span>()
}
@ -840,16 +949,16 @@
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">url</span>(<span class="kw-2">&amp;</span><span class="self">self</span>, <span class="ident">uri</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>) <span class="op">-&gt;</span> <span class="ident">String</span> {
<span class="kw">if</span> <span class="ident">uri</span>.<span class="ident">starts_with</span>(<span class="string">&#39;/&#39;</span>) {
<span class="macro">format</span><span class="macro">!</span>(
<span class="string">&quot;{}://{}{}&quot;</span>,
<span class="string">&quot;{}://localhost:{}{}&quot;</span>,
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">ssl</span> { <span class="string">&quot;https&quot;</span> } <span class="kw">else</span> { <span class="string">&quot;http&quot;</span> },
<span class="self">self</span>.<span class="ident">addr</span>,
<span class="self">self</span>.<span class="ident">addr</span>.<span class="ident">port</span>(),
<span class="ident">uri</span>
)
} <span class="kw">else</span> {
<span class="macro">format</span><span class="macro">!</span>(
<span class="string">&quot;{}://{}/{}&quot;</span>,
<span class="string">&quot;{}://localhost:{}/{}&quot;</span>,
<span class="kw">if</span> <span class="self">self</span>.<span class="ident">ssl</span> { <span class="string">&quot;https&quot;</span> } <span class="kw">else</span> { <span class="string">&quot;http&quot;</span> },
<span class="self">self</span>.<span class="ident">addr</span>,
<span class="self">self</span>.<span class="ident">addr</span>.<span class="ident">port</span>(),
<span class="ident">uri</span>
)
}
@ -868,13 +977,20 @@
<span class="self">self</span>.<span class="ident">rt</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>)
}
<span class="doccomment">/// Connect to websocket server</span>
<span class="doccomment">/// Connect to websocket server at a given path</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">ws_at</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">path</span>: <span class="kw-2">&amp;</span><span class="ident">str</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(<span class="ident">ws</span>::<span class="ident">ClientReader</span>, <span class="ident">ws</span>::<span class="ident">ClientWriter</span>), <span class="ident">ws</span>::<span class="ident">ClientError</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">url</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">url</span>(<span class="ident">path</span>);
<span class="self">self</span>.<span class="ident">rt</span>
.<span class="ident">block_on</span>(<span class="ident">ws</span>::<span class="ident">Client</span>::<span class="ident">with_connector</span>(<span class="ident">url</span>, <span class="self">self</span>.<span class="ident">conn</span>.<span class="ident">clone</span>()).<span class="ident">connect</span>())
}
<span class="doccomment">/// Connect to a websocket server</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">ws</span>(
<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="self">self</span>,
) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span>(<span class="ident">ws</span>::<span class="ident">ClientReader</span>, <span class="ident">ws</span>::<span class="ident">ClientWriter</span>), <span class="ident">ws</span>::<span class="ident">ClientError</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">url</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">url</span>(<span class="string">&quot;/&quot;</span>);
<span class="self">self</span>.<span class="ident">rt</span>
.<span class="ident">block_on</span>(<span class="ident">ws</span>::<span class="ident">Client</span>::<span class="ident">with_connector</span>(<span class="ident">url</span>, <span class="self">self</span>.<span class="ident">conn</span>.<span class="ident">clone</span>()).<span class="ident">connect</span>())
<span class="self">self</span>.<span class="ident">ws_at</span>(<span class="string">&quot;/&quot;</span>)
}
<span class="doccomment">/// Create `GET` request</span>
@ -912,75 +1028,105 @@
<span class="doccomment">///</span>
<span class="doccomment">/// This type can be used to construct an instance of `TestServer` through a</span>
<span class="doccomment">/// builder-like pattern.</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="ident">state</span>: <span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">F</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="ident">state</span>: <span class="ident">F</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="ident">ssl</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">SslAcceptorBuilder</span><span class="op">&gt;</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="ident">rust_ssl</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">ServerConfig</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> {
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">S</span>: <span class="lifetime">&#39;static</span>, <span class="ident">F</span><span class="op">&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">F</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="doccomment">/// Create a new test server</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>(<span class="ident">state</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>() <span class="op">-&gt;</span> <span class="ident">S</span> <span class="op">+</span> <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">state</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">TestServerBuilder</span><span class="op">&lt;</span><span class="ident">S</span>, <span class="ident">F</span><span class="op">&gt;</span> {
<span class="ident">TestServerBuilder</span> {
<span class="ident">state</span>: <span class="ident">Box</span>::<span class="ident">new</span>(<span class="ident">state</span>),
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="ident">state</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="ident">ssl</span>: <span class="prelude-val">None</span>,
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="ident">rust_ssl</span>: <span class="prelude-val">None</span>,
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
<span class="doccomment">/// Create ssl server</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">ssl</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">ssl</span>: <span class="ident">SslAcceptorBuilder</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">ssl</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ssl</span>);
<span class="self">self</span>
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
<span class="doccomment">/// Create rust tls server</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">rustls</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">ssl</span>: <span class="ident">ServerConfig</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="self">self</span>.<span class="ident">rust_ssl</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="ident">ssl</span>);
<span class="self">self</span>
}
<span class="attribute">#[<span class="ident">allow</span>(<span class="ident">unused_mut</span>)]</span>
<span class="doccomment">/// Configure test application and run test server</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">start</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">config</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="ident">TestServer</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">start</span><span class="op">&lt;</span><span class="ident">C</span><span class="op">&gt;</span>(<span class="kw-2">mut</span> <span class="self">self</span>, <span class="ident">config</span>: <span class="ident">C</span>) <span class="op">-&gt;</span> <span class="ident">TestServer</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Sync</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span> <span class="op">+</span> <span class="ident">Fn</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">TestApp</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>),
<span class="ident">C</span>: <span class="ident">Fn</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">TestApp</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">+</span> <span class="ident">Clone</span> <span class="op">+</span> <span class="ident">Send</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">let</span> (<span class="ident">tx</span>, <span class="ident">rx</span>) <span class="op">=</span> <span class="ident">mpsc</span>::<span class="ident">channel</span>();
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="kw">let</span> <span class="ident">ssl</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">ssl</span>.<span class="ident">is_some</span>();
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
<span class="kw">let</span> <span class="ident">ssl</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">has_ssl</span> <span class="op">=</span> <span class="bool-val">false</span>;
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
{
<span class="ident">has_ssl</span> <span class="op">=</span> <span class="ident">has_ssl</span> <span class="op">||</span> <span class="self">self</span>.<span class="ident">ssl</span>.<span class="ident">is_some</span>();
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
{
<span class="ident">has_ssl</span> <span class="op">=</span> <span class="ident">has_ssl</span> <span class="op">||</span> <span class="self">self</span>.<span class="ident">rust_ssl</span>.<span class="ident">is_some</span>();
}
<span class="comment">// run server in separate thread</span>
<span class="ident">thread</span>::<span class="ident">spawn</span>(<span class="kw">move</span> <span class="op">||</span> {
<span class="kw">let</span> <span class="ident">tcp</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpListener</span>::<span class="ident">bind</span>(<span class="string">&quot;127.0.0.1:0&quot;</span>).<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">local_addr</span> <span class="op">=</span> <span class="ident">tcp</span>.<span class="ident">local_addr</span>().<span class="ident">unwrap</span>();
<span class="kw">let</span> <span class="ident">addr</span> <span class="op">=</span> <span class="ident">TestServer</span>::<span class="ident">unused_addr</span>();
<span class="kw">let</span> <span class="ident">sys</span> <span class="op">=</span> <span class="ident">System</span>::<span class="ident">new</span>(<span class="string">&quot;actix-test-server&quot;</span>);
<span class="kw">let</span> <span class="ident">state</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">state</span>;
<span class="kw">let</span> <span class="ident">srv</span> <span class="op">=</span> <span class="ident">HttpServer</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">||</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">srv</span> <span class="op">=</span> <span class="ident">HttpServer</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">||</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">app</span> <span class="op">=</span> <span class="ident">TestApp</span>::<span class="ident">new</span>(<span class="ident">state</span>());
<span class="ident">config</span>(<span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">app</span>);
<span class="macro">vec</span><span class="macro">!</span>[<span class="ident">app</span>]
<span class="ident">app</span>
}).<span class="ident">workers</span>(<span class="number">1</span>)
.<span class="ident">disable_signals</span>();
.<span class="ident">keep_alive</span>(<span class="number">5</span>)
.<span class="ident">disable_signals</span>();
<span class="ident">tx</span>.<span class="ident">send</span>((<span class="ident">System</span>::<span class="ident">current</span>(), <span class="ident">local_addr</span>, <span class="ident">TestServer</span>::<span class="ident">get_conn</span>()))
<span class="ident">tx</span>.<span class="ident">send</span>((<span class="ident">System</span>::<span class="ident">current</span>(), <span class="ident">addr</span>, <span class="ident">TestServer</span>::<span class="ident">get_conn</span>()))
.<span class="ident">unwrap</span>();
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>)]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">any</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>, <span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;ssl&quot;</span>))]</span>
{
<span class="kw">let</span> <span class="ident">ssl</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">ssl</span>.<span class="ident">take</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ssl</span>) <span class="op">=</span> <span class="ident">ssl</span> {
<span class="ident">srv</span>.<span class="ident">listen_ssl</span>(<span class="ident">tcp</span>, <span class="ident">ssl</span>).<span class="ident">unwrap</span>().<span class="ident">start</span>();
} <span class="kw">else</span> {
<span class="ident">srv</span>.<span class="ident">listen</span>(<span class="ident">tcp</span>).<span class="ident">start</span>();
<span class="kw">let</span> <span class="ident">tcp</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpListener</span>::<span class="ident">bind</span>(<span class="ident">addr</span>).<span class="ident">unwrap</span>();
<span class="ident">srv</span> <span class="op">=</span> <span class="ident">srv</span>.<span class="ident">listen_ssl</span>(<span class="ident">tcp</span>, <span class="ident">ssl</span>).<span class="ident">unwrap</span>();
}
}
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">not</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;alpn&quot;</span>))]</span>
<span class="attribute">#[<span class="ident">cfg</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;rust-tls&quot;</span>)]</span>
{
<span class="ident">srv</span>.<span class="ident">listen</span>(<span class="ident">tcp</span>).<span class="ident">start</span>();
<span class="kw">let</span> <span class="ident">ssl</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">rust_ssl</span>.<span class="ident">take</span>();
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">ssl</span>) <span class="op">=</span> <span class="ident">ssl</span> {
<span class="kw">let</span> <span class="ident">tcp</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpListener</span>::<span class="ident">bind</span>(<span class="ident">addr</span>).<span class="ident">unwrap</span>();
<span class="ident">srv</span> <span class="op">=</span> <span class="ident">srv</span>.<span class="ident">listen_rustls</span>(<span class="ident">tcp</span>, <span class="ident">ssl</span>);
}
}
<span class="kw">if</span> <span class="op">!</span><span class="ident">has_ssl</span> {
<span class="kw">let</span> <span class="ident">tcp</span> <span class="op">=</span> <span class="ident">net</span>::<span class="ident">TcpListener</span>::<span class="ident">bind</span>(<span class="ident">addr</span>).<span class="ident">unwrap</span>();
<span class="ident">srv</span> <span class="op">=</span> <span class="ident">srv</span>.<span class="ident">listen</span>(<span class="ident">tcp</span>);
}
<span class="ident">srv</span>.<span class="ident">start</span>();
<span class="ident">sys</span>.<span class="ident">run</span>();
});
@ -988,8 +1134,8 @@
<span class="ident">System</span>::<span class="ident">set_current</span>(<span class="ident">system</span>);
<span class="ident">TestServer</span> {
<span class="ident">addr</span>,
<span class="ident">ssl</span>,
<span class="ident">conn</span>,
<span class="ident">ssl</span>: <span class="ident">has_ssl</span>,
<span class="ident">rt</span>: <span class="ident">Runtime</span>::<span class="ident">new</span>().<span class="ident">unwrap</span>(),
}
}
@ -1224,7 +1370,7 @@
<span class="ident">payload</span>,
<span class="ident">prefix</span>,
} <span class="op">=</span> <span class="self">self</span>;
<span class="kw">let</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">new</span>();
<span class="kw">let</span> <span class="ident">router</span> <span class="op">=</span> <span class="ident">Router</span>::<span class="op">&lt;</span>()<span class="op">&gt;</span>::<span class="ident">default</span>();
<span class="kw">let</span> <span class="ident">pool</span> <span class="op">=</span> <span class="ident">RequestPool</span>::<span class="ident">pool</span>(<span class="ident">ServerSettings</span>::<span class="ident">default</span>());
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">req</span> <span class="op">=</span> <span class="ident">RequestPool</span>::<span class="ident">get</span>(<span class="ident">pool</span>);
@ -1304,8 +1450,6 @@
<span class="doccomment">/// This method generates `HttpRequest` instance and runs handler</span>
<span class="doccomment">/// with generated request.</span>
<span class="doccomment">///</span>
<span class="doccomment">/// This method panics is handler returns actor or async result.</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">run</span><span class="op">&lt;</span><span class="ident">H</span>: <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;&gt;</span>(<span class="self">self</span>, <span class="ident">h</span>: <span class="kw-2">&amp;</span><span class="ident">H</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">HttpResponse</span>, <span class="ident">Error</span><span class="op">&gt;</span> {
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">h</span>.<span class="ident">handle</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);
@ -1314,7 +1458,10 @@
<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">into</span>().<span class="ident">into</span>() {
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">resp</span>),
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>),
<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="kw">_</span>) <span class="op">=&gt;</span> <span class="macro">panic</span><span class="macro">!</span>(<span class="string">&quot;Async handler is not supported.&quot;</span>),
<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">sys</span> <span class="op">=</span> <span class="ident">System</span>::<span class="ident">new</span>(<span class="string">&quot;test&quot;</span>);
<span class="ident">sys</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>)
}
},
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()),
}
@ -1334,8 +1481,8 @@
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">fut</span> <span class="op">=</span> <span class="ident">h</span>(<span class="ident">req</span>.<span class="ident">clone</span>());
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">core</span> <span class="op">=</span> <span class="ident">Runtime</span>::<span class="ident">new</span>().<span class="ident">unwrap</span>();
<span class="kw">match</span> <span class="ident">core</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>) {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">sys</span> <span class="op">=</span> <span class="ident">System</span>::<span class="ident">new</span>(<span class="string">&quot;test&quot;</span>);
<span class="kw">match</span> <span class="ident">sys</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">r</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">r</span>.<span class="ident">respond_to</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">reply</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">reply</span>.<span class="ident">into</span>().<span class="ident">into</span>() {
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">resp</span>),
@ -1346,6 +1493,47 @@
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>),
}
}
<span class="doccomment">/// This method generates `HttpRequest` instance and executes handler</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">run_async_result</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">f</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">FnOnce</span>(<span class="kw-2">&amp;</span><span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">AsyncResult</span><span class="op">&lt;</span><span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;&gt;</span>,
{
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">res</span> <span class="op">=</span> <span class="ident">f</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);
<span class="kw">match</span> <span class="ident">res</span>.<span class="ident">into</span>().<span class="ident">into</span>() {
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">resp</span>),
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>),
<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">sys</span> <span class="op">=</span> <span class="ident">System</span>::<span class="ident">new</span>(<span class="string">&quot;test&quot;</span>);
<span class="ident">sys</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>)
}
}
}
<span class="doccomment">/// This method generates `HttpRequest` instance and executes handler</span>
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">execute</span><span class="op">&lt;</span><span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>(<span class="self">self</span>, <span class="ident">f</span>: <span class="ident">F</span>) <span class="op">-&gt;</span> <span class="prelude-ty">Result</span><span class="op">&lt;</span><span class="ident">HttpResponse</span>, <span class="ident">Error</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">FnOnce</span>(<span class="kw-2">&amp;</span><span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
{
<span class="kw">let</span> <span class="ident">req</span> <span class="op">=</span> <span class="self">self</span>.<span class="ident">finish</span>();
<span class="kw">let</span> <span class="ident">resp</span> <span class="op">=</span> <span class="ident">f</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>);
<span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">respond_to</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="kw">match</span> <span class="ident">resp</span>.<span class="ident">into</span>().<span class="ident">into</span>() {
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Ok</span>(<span class="ident">resp</span>) <span class="op">=&gt;</span> <span class="prelude-val">Ok</span>(<span class="ident">resp</span>),
<span class="ident">AsyncResultItem</span>::<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>),
<span class="ident">AsyncResultItem</span>::<span class="ident">Future</span>(<span class="ident">fut</span>) <span class="op">=&gt;</span> {
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">sys</span> <span class="op">=</span> <span class="ident">System</span>::<span class="ident">new</span>(<span class="string">&quot;test&quot;</span>);
<span class="ident">sys</span>.<span class="ident">block_on</span>(<span class="ident">fut</span>)
}
},
<span class="prelude-val">Err</span>(<span class="ident">err</span>) <span class="op">=&gt;</span> <span class="prelude-val">Err</span>(<span class="ident">err</span>.<span class="ident">into</span>()),
}
}
}
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../";window.currentCrate = "actix_web";</script><script src="../../aliases.js"></script><script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>

2
static/api/actix-web/stable/src/actix_web/uri.rs.html
View File

@ -323,7 +323,7 @@
<span class="kw">if</span> <span class="kw">let</span> <span class="prelude-val">Some</span>(<span class="ident">data</span>) <span class="op">=</span> <span class="ident">cloned</span> {
<span class="comment">// Unsafe: we get data from http::Uri, which does utf-8 checks already</span>
<span class="comment">// this code only decodes valid pct encoded values</span>
<span class="prelude-val">Some</span>(<span class="kw">unsafe</span> { <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">String</span>::<span class="ident">from_utf8_unchecked</span>(<span class="ident">data</span>)) })
<span class="prelude-val">Some</span>(<span class="ident">Rc</span>::<span class="ident">new</span>(<span class="kw">unsafe</span> { <span class="ident">String</span>::<span class="ident">from_utf8_unchecked</span>(<span class="ident">data</span>) }))
} <span class="kw">else</span> {
<span class="prelude-val">None</span>
}

296
static/api/actix-web/stable/src/actix_web/with.rs.html
View File

@ -261,6 +261,126 @@
<span id="261">261</span>
<span id="262">262</span>
<span id="263">263</span>
<span id="264">264</span>
<span id="265">265</span>
<span id="266">266</span>
<span id="267">267</span>
<span id="268">268</span>
<span id="269">269</span>
<span id="270">270</span>
<span id="271">271</span>
<span id="272">272</span>
<span id="273">273</span>
<span id="274">274</span>
<span id="275">275</span>
<span id="276">276</span>
<span id="277">277</span>
<span id="278">278</span>
<span id="279">279</span>
<span id="280">280</span>
<span id="281">281</span>
<span id="282">282</span>
<span id="283">283</span>
<span id="284">284</span>
<span id="285">285</span>
<span id="286">286</span>
<span id="287">287</span>
<span id="288">288</span>
<span id="289">289</span>
<span id="290">290</span>
<span id="291">291</span>
<span id="292">292</span>
<span id="293">293</span>
<span id="294">294</span>
<span id="295">295</span>
<span id="296">296</span>
<span id="297">297</span>
<span id="298">298</span>
<span id="299">299</span>
<span id="300">300</span>
<span id="301">301</span>
<span id="302">302</span>
<span id="303">303</span>
<span id="304">304</span>
<span id="305">305</span>
<span id="306">306</span>
<span id="307">307</span>
<span id="308">308</span>
<span id="309">309</span>
<span id="310">310</span>
<span id="311">311</span>
<span id="312">312</span>
<span id="313">313</span>
<span id="314">314</span>
<span id="315">315</span>
<span id="316">316</span>
<span id="317">317</span>
<span id="318">318</span>
<span id="319">319</span>
<span id="320">320</span>
<span id="321">321</span>
<span id="322">322</span>
<span id="323">323</span>
<span id="324">324</span>
<span id="325">325</span>
<span id="326">326</span>
<span id="327">327</span>
<span id="328">328</span>
<span id="329">329</span>
<span id="330">330</span>
<span id="331">331</span>
<span id="332">332</span>
<span id="333">333</span>
<span id="334">334</span>
<span id="335">335</span>
<span id="336">336</span>
<span id="337">337</span>
<span id="338">338</span>
<span id="339">339</span>
<span id="340">340</span>
<span id="341">341</span>
<span id="342">342</span>
<span id="343">343</span>
<span id="344">344</span>
<span id="345">345</span>
<span id="346">346</span>
<span id="347">347</span>
<span id="348">348</span>
<span id="349">349</span>
<span id="350">350</span>
<span id="351">351</span>
<span id="352">352</span>
<span id="353">353</span>
<span id="354">354</span>
<span id="355">355</span>
<span id="356">356</span>
<span id="357">357</span>
<span id="358">358</span>
<span id="359">359</span>
<span id="360">360</span>
<span id="361">361</span>
<span id="362">362</span>
<span id="363">363</span>
<span id="364">364</span>
<span id="365">365</span>
<span id="366">366</span>
<span id="367">367</span>
<span id="368">368</span>
<span id="369">369</span>
<span id="370">370</span>
<span id="371">371</span>
<span id="372">372</span>
<span id="373">373</span>
<span id="374">374</span>
<span id="375">375</span>
<span id="376">376</span>
<span id="377">377</span>
<span id="378">378</span>
<span id="379">379</span>
<span id="380">380</span>
<span id="381">381</span>
<span id="382">382</span>
<span id="383">383</span>
</pre><pre class="rust ">
<span class="kw">use</span> <span class="ident">futures</span>::{<span class="ident">Async</span>, <span class="ident">Future</span>, <span class="ident">Poll</span>};
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">marker</span>::<span class="ident">PhantomData</span>;
@ -271,24 +391,57 @@
<span class="kw">use</span> <span class="ident">httprequest</span>::<span class="ident">HttpRequest</span>;
<span class="kw">use</span> <span class="ident">httpresponse</span>::<span class="ident">HttpResponse</span>;
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">trait</span> <span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;</span>: <span class="lifetime">&#39;static</span> {
<span class="kw">fn</span> <span class="ident">call_with</span>(<span class="self">self</span>: <span class="kw-2">&amp;</span><span class="self">Self</span>, <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>;
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span>, <span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span> <span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">F</span> {
<span class="kw">fn</span> <span class="ident">call_with</span>(<span class="self">self</span>: <span class="kw-2">&amp;</span><span class="self">Self</span>, <span class="ident">arg</span>: <span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> {
(<span class="kw-2">*</span><span class="self">self</span>)(<span class="ident">arg</span>)
}
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">WithFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>: <span class="lifetime">&#39;static</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Responder</span>,
{
<span class="kw">fn</span> <span class="ident">create</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">create_with_config</span>(<span class="self">self</span>, <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>;
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">trait</span> <span class="ident">WithAsyncFactory</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>: <span class="lifetime">&#39;static</span>
<span class="kw">where</span>
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">Responder</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span>,
{
<span class="kw">fn</span> <span class="ident">create</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>;
<span class="kw">fn</span> <span class="ident">create_with_config</span>(<span class="self">self</span>, <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>;
}
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;&gt;</span>,
<span class="ident">cfg</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span><span class="op">&gt;</span>,
<span class="ident">_s</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">f</span>: <span class="ident">F</span>, <span class="ident">cfg</span>: <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span>(<span class="ident">f</span>: <span class="ident">F</span>, <span class="ident">cfg</span>: <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">With</span> {
<span class="ident">cfg</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">cfg</span>),
<span class="ident">hnd</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">f</span>),
@ -297,9 +450,8 @@
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">With</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
@ -324,24 +476,22 @@
}
}
<span class="kw">struct</span> <span class="ident">WithHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">struct</span> <span class="ident">WithHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Responder</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="ident">started</span>: <span class="ident">bool</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;&gt;</span>,
<span class="ident">cfg</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span><span class="op">&gt;</span>,
<span class="ident">req</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">fut1</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
<span class="ident">fut2</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">HttpResponse</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">WithHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">WithHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
@ -372,7 +522,7 @@
}
};
<span class="kw">let</span> <span class="ident">item</span> <span class="op">=</span> <span class="kw">match</span> (<span class="kw-2">*</span><span class="self">self</span>.<span class="ident">hnd</span>)(<span class="ident">item</span>).<span class="ident">respond_to</span>(<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">req</span>) {
<span class="kw">let</span> <span class="ident">item</span> <span class="op">=</span> <span class="kw">match</span> <span class="self">self</span>.<span class="ident">hnd</span>.<span class="ident">as_ref</span>().<span class="ident">call_with</span>(<span class="ident">item</span>).<span class="ident">respond_to</span>(<span class="kw-2">&amp;</span><span class="self">self</span>.<span class="ident">req</span>) {
<span class="prelude-val">Ok</span>(<span class="ident">item</span>) <span class="op">=&gt;</span> <span class="ident">item</span>.<span class="ident">into</span>(),
<span class="prelude-val">Err</span>(<span class="ident">e</span>) <span class="op">=&gt;</span> <span class="kw">return</span> <span class="prelude-val">Err</span>(<span class="ident">e</span>.<span class="ident">into</span>()),
};
@ -388,30 +538,29 @@
}
}
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">struct</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="attribute">#[<span class="ident">doc</span>(<span class="ident">hidden</span>)]</span>
<span class="kw">pub</span> <span class="kw">struct</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">Responder</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;&gt;</span>,
<span class="ident">cfg</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span><span class="op">&gt;</span>,
<span class="ident">_s</span>: <span class="ident">PhantomData</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span>,
<span class="ident">I</span>: <span class="ident">Responder</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span>,
<span class="ident">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span>(<span class="ident">f</span>: <span class="ident">F</span>, <span class="ident">cfg</span>: <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="kw">pub</span> <span class="kw">fn</span> <span class="ident">new</span><span class="op">&lt;</span><span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span><span class="op">&gt;</span>(<span class="ident">f</span>: <span class="ident">F</span>, <span class="ident">cfg</span>: <span class="ident">T</span>::<span class="ident">Config</span>) <span class="op">-&gt;</span> <span class="self">Self</span> {
<span class="ident">WithAsync</span> {
<span class="ident">cfg</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">cfg</span>),
<span class="ident">hnd</span>: <span class="ident">Rc</span>::<span class="ident">new</span>(<span class="ident">f</span>),
@ -420,9 +569,8 @@
}
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Handler</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">WithAsync</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">I</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
@ -450,9 +598,8 @@
}
}
<span class="kw">struct</span> <span class="ident">WithAsyncHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">struct</span> <span class="ident">WithAsyncHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">I</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
@ -460,7 +607,7 @@
<span class="ident">S</span>: <span class="lifetime">&#39;static</span>,
{
<span class="ident">started</span>: <span class="ident">bool</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">F</span><span class="op">&gt;</span>,
<span class="ident">hnd</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">FnWith</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">R</span><span class="op">&gt;&gt;</span>,
<span class="ident">cfg</span>: <span class="ident">Rc</span><span class="op">&lt;</span><span class="ident">T</span>::<span class="ident">Config</span><span class="op">&gt;</span>,
<span class="ident">req</span>: <span class="ident">HttpRequest</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>,
<span class="ident">fut1</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">T</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
@ -468,9 +615,8 @@
<span class="ident">fut3</span>: <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">Box</span><span class="op">&lt;</span><span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">HttpResponse</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">Error</span><span class="op">&gt;&gt;</span><span class="op">&gt;</span>,
}
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">WithAsyncHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">F</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">impl</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span> <span class="ident">Future</span> <span class="kw">for</span> <span class="ident">WithAsyncHandlerFut</span><span class="op">&lt;</span><span class="ident">T</span>, <span class="ident">S</span>, <span class="ident">R</span>, <span class="ident">I</span>, <span class="ident">E</span><span class="op">&gt;</span>
<span class="kw">where</span>
<span class="ident">F</span>: <span class="ident">Fn</span>(<span class="ident">T</span>) <span class="op">-&gt;</span> <span class="ident">R</span>,
<span class="ident">R</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span> <span class="op">=</span> <span class="ident">I</span>, <span class="ident">Error</span> <span class="op">=</span> <span class="ident">E</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">I</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">E</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
@ -521,9 +667,103 @@
}
};
<span class="self">self</span>.<span class="ident">fut2</span> <span class="op">=</span> <span class="prelude-val">Some</span>((<span class="kw-2">*</span><span class="self">self</span>.<span class="ident">hnd</span>)(<span class="ident">item</span>));
<span class="self">self</span>.<span class="ident">fut2</span> <span class="op">=</span> <span class="prelude-val">Some</span>(<span class="self">self</span>.<span class="ident">hnd</span>.<span class="ident">as_ref</span>().<span class="ident">call_with</span>(<span class="ident">item</span>));
<span class="self">self</span>.<span class="ident">poll</span>()
}
}
<span class="macro">macro_rules</span><span class="macro">!</span> <span class="ident">with_factory_tuple</span> ({$((<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>:<span class="ident">tt</span>, <span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>:<span class="ident">ident</span>)),<span class="op">+</span>} <span class="op">=&gt;</span> {
<span class="kw">impl</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span> <span class="ident">State</span>, <span class="ident">Func</span>, <span class="ident">Res</span><span class="op">&gt;</span> <span class="ident">WithFactory</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Func</span>
<span class="kw">where</span> <span class="ident">Func</span>: <span class="ident">Fn</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>) <span class="op">-&gt;</span> <span class="ident">Res</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">State</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,)<span class="op">+</span>
<span class="ident">Res</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="ident">State</span>: <span class="lifetime">&#39;static</span>,
{
<span class="kw">fn</span> <span class="ident">create</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">With</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span><span class="op">&gt;</span> {
<span class="ident">With</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">|</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>)<span class="op">|</span> (<span class="self">self</span>)($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>), ($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>::<span class="ident">Config</span>::<span class="ident">default</span>(),)<span class="op">+</span>))
}
<span class="kw">fn</span> <span class="ident">create_with_config</span>(<span class="self">self</span>, <span class="ident">cfg</span>: ($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>::<span class="ident">Config</span>,)<span class="op">+</span>)) <span class="op">-&gt;</span> <span class="ident">With</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span><span class="op">&gt;</span> {
<span class="ident">With</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">|</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>)<span class="op">|</span> (<span class="self">self</span>)($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>), <span class="ident">cfg</span>)
}
}
});
<span class="macro">macro_rules</span><span class="macro">!</span> <span class="ident">with_async_factory_tuple</span> ({$((<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>:<span class="ident">tt</span>, <span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>:<span class="ident">ident</span>)),<span class="op">+</span>} <span class="op">=&gt;</span> {
<span class="kw">impl</span><span class="op">&lt;</span>$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span> <span class="ident">State</span>, <span class="ident">Func</span>, <span class="ident">Res</span>, <span class="ident">Item</span>, <span class="prelude-val">Err</span><span class="op">&gt;</span> <span class="ident">WithAsyncFactory</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span>, <span class="ident">Item</span>, <span class="prelude-val">Err</span><span class="op">&gt;</span> <span class="kw">for</span> <span class="ident">Func</span>
<span class="kw">where</span> <span class="ident">Func</span>: <span class="ident">Fn</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>) <span class="op">-&gt;</span> <span class="ident">Res</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
$(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>: <span class="ident">FromRequest</span><span class="op">&lt;</span><span class="ident">State</span><span class="op">&gt;</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,)<span class="op">+</span>
<span class="ident">Res</span>: <span class="ident">Future</span><span class="op">&lt;</span><span class="ident">Item</span><span class="op">=</span><span class="ident">Item</span>, <span class="ident">Error</span><span class="op">=</span><span class="prelude-val">Err</span><span class="op">&gt;</span>,
<span class="ident">Item</span>: <span class="ident">Responder</span> <span class="op">+</span> <span class="lifetime">&#39;static</span>,
<span class="prelude-val">Err</span>: <span class="ident">Into</span><span class="op">&lt;</span><span class="ident">Error</span><span class="op">&gt;</span>,
<span class="ident">State</span>: <span class="lifetime">&#39;static</span>,
{
<span class="kw">fn</span> <span class="ident">create</span>(<span class="self">self</span>) <span class="op">-&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span>, <span class="ident">Item</span>, <span class="prelude-val">Err</span><span class="op">&gt;</span> {
<span class="ident">WithAsync</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">|</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>)<span class="op">|</span> (<span class="self">self</span>)($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>), ($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>::<span class="ident">Config</span>::<span class="ident">default</span>(),)<span class="op">+</span>))
}
<span class="kw">fn</span> <span class="ident">create_with_config</span>(<span class="self">self</span>, <span class="ident">cfg</span>: ($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>::<span class="ident">Config</span>,)<span class="op">+</span>)) <span class="op">-&gt;</span> <span class="ident">WithAsync</span><span class="op">&lt;</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">T</span>,)<span class="op">+</span>), <span class="ident">State</span>, <span class="ident">Res</span>, <span class="ident">Item</span>, <span class="prelude-val">Err</span><span class="op">&gt;</span> {
<span class="ident">WithAsync</span>::<span class="ident">new</span>(<span class="kw">move</span> <span class="op">|</span>($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>)<span class="op">|</span> (<span class="self">self</span>)($(<span class="macro-nonterminal">$</span><span class="macro-nonterminal">n</span>,)<span class="op">+</span>), <span class="ident">cfg</span>)
}
}
});
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>), (<span class="ident">f</span>, <span class="ident">F</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>), (<span class="ident">f</span>, <span class="ident">F</span>), (<span class="ident">g</span>, <span class="ident">G</span>));
<span class="macro">with_factory_tuple</span><span class="macro">!</span>(
(<span class="ident">a</span>, <span class="ident">A</span>),
(<span class="ident">b</span>, <span class="ident">B</span>),
(<span class="ident">c</span>, <span class="ident">C</span>),
(<span class="ident">d</span>, <span class="ident">D</span>),
(<span class="ident">e</span>, <span class="ident">E</span>),
(<span class="ident">f</span>, <span class="ident">F</span>),
(<span class="ident">g</span>, <span class="ident">G</span>),
(<span class="ident">h</span>, <span class="ident">H</span>)
);
<span class="macro">with_factory_tuple</span><span class="macro">!</span>(
(<span class="ident">a</span>, <span class="ident">A</span>),
(<span class="ident">b</span>, <span class="ident">B</span>),
(<span class="ident">c</span>, <span class="ident">C</span>),
(<span class="ident">d</span>, <span class="ident">D</span>),
(<span class="ident">e</span>, <span class="ident">E</span>),
(<span class="ident">f</span>, <span class="ident">F</span>),
(<span class="ident">g</span>, <span class="ident">G</span>),
(<span class="ident">h</span>, <span class="ident">H</span>),
(<span class="ident">i</span>, <span class="ident">I</span>)
);
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>), (<span class="ident">f</span>, <span class="ident">F</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>((<span class="ident">a</span>, <span class="ident">A</span>), (<span class="ident">b</span>, <span class="ident">B</span>), (<span class="ident">c</span>, <span class="ident">C</span>), (<span class="ident">d</span>, <span class="ident">D</span>), (<span class="ident">e</span>, <span class="ident">E</span>), (<span class="ident">f</span>, <span class="ident">F</span>), (<span class="ident">g</span>, <span class="ident">G</span>));
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>(
(<span class="ident">a</span>, <span class="ident">A</span>),
(<span class="ident">b</span>, <span class="ident">B</span>),
(<span class="ident">c</span>, <span class="ident">C</span>),
(<span class="ident">d</span>, <span class="ident">D</span>),
(<span class="ident">e</span>, <span class="ident">E</span>),
(<span class="ident">f</span>, <span class="ident">F</span>),
(<span class="ident">g</span>, <span class="ident">G</span>),
(<span class="ident">h</span>, <span class="ident">H</span>)
);
<span class="macro">with_async_factory_tuple</span><span class="macro">!</span>(
(<span class="ident">a</span>, <span class="ident">A</span>),
(<span class="ident">b</span>, <span class="ident">B</span>),
(<span class="ident">c</span>, <span class="ident">C</span>),
(<span class="ident">d</span>, <span class="ident">D</span>),
(<span class="ident">e</span>, <span class="ident">E</span>),
(<span class="ident">f</span>, <span class="ident">F</span>),
(<span class="ident">g</span>, <span class="ident">G</span>),
(<span class="ident">h</span>, <span class="ident">H</span>),
(<span class="ident">i</span>, <span class="ident">I</span>)
);
</pre>
</section><section id="search" class="content hidden"></section><section class="footer"></section><aside id="help" class="hidden"><div><h1 class="hidden">Help</h1><div class="shortcuts"><h2>Keyboard Shortcuts</h2><dl><dt><kbd>?</kbd></dt><dd>Show this help dialog</dd><dt><kbd>S</kbd></dt><dd>Focus the search field</dd><dt><kbd>↑</kbd></dt><dd>Move up in search results</dd><dt><kbd>↓</kbd></dt><dd>Move down in search results</dd><dt><kbd>↹</kbd></dt><dd>Switch tab</dd><dt><kbd>&#9166;</kbd></dt><dd>Go to active search result</dd><dt><kbd>+</kbd></dt><dd>Expand all sections</dd><dt><kbd>-</kbd></dt><dd>Collapse all sections</dd></dl></div><div class="infos"><h2>Search Tricks</h2><p>Prefix searches with a type followed by a colon (e.g. <code>fn:</code>) to restrict the search to a given type.</p><p>Accepted types are: <code>fn</code>, <code>mod</code>, <code>struct</code>, <code>enum</code>, <code>trait</code>, <code>type</code>, <code>macro</code>, and <code>const</code>.</p><p>Search functions by type signature (e.g. <code>vec -> usize</code> or <code>* -> vec</code>)</p><p>Search multiple things at once by splitting your query with comma (e.g. <code>str,u8</code> or <code>String,struct:Vec,test</code>)</p></div></div></aside><script>window.rootPath = "../../";window.currentCrate = "actix_web";</script><script src="../../aliases.js"></script><script src="../../main.js"></script><script defer src="../../search-index.js"></script></body></html>

2
static/api/actix-web/stable/src/actix_web/ws/frame.rs.html
View File

@ -585,7 +585,7 @@
<span class="ident">Frame</span>::<span class="ident">message</span>(<span class="ident">payload</span>, <span class="ident">OpCode</span>::<span class="ident">Close</span>, <span class="bool-val">true</span>, <span class="ident">genmask</span>)
}
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">type_complexity</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">type_complexity</span>))]</span>
<span class="kw">fn</span> <span class="ident">read_copy_md</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>(
<span class="ident">pl</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> <span class="ident">PayloadBuffer</span><span class="op">&lt;</span><span class="ident">S</span><span class="op">&gt;</span>, <span class="ident">server</span>: <span class="ident">bool</span>, <span class="ident">max_size</span>: <span class="ident">usize</span>,
) <span class="op">-&gt;</span> <span class="ident">Poll</span><span class="op">&lt;</span><span class="prelude-ty">Option</span><span class="op">&lt;</span>(<span class="ident">usize</span>, <span class="ident">bool</span>, <span class="ident">OpCode</span>, <span class="ident">usize</span>, <span class="prelude-ty">Option</span><span class="op">&lt;</span><span class="ident">u32</span><span class="op">&gt;</span>)<span class="op">&gt;</span>, <span class="ident">ProtocolError</span><span class="op">&gt;</span>

12
static/api/actix-web/stable/src/actix_web/ws/mask.rs.html
View File

@ -147,9 +147,12 @@
<span id="147">147</span>
<span id="148">148</span>
<span id="149">149</span>
<span id="150">150</span>
<span id="151">151</span>
<span id="152">152</span>
</pre><pre class="rust ">
<span class="doccomment">//! This is code from [Tungstenite project](https://github.com/snapview/tungstenite-rs)</span>
<span class="attribute">#![<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">cast_ptr_alignment</span>))]</span>
<span class="attribute">#![<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">cast_ptr_alignment</span>))]</span>
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">ptr</span>::<span class="ident">copy_nonoverlapping</span>;
<span class="kw">use</span> <span class="ident">std</span>::<span class="ident">slice</span>;
@ -169,7 +172,7 @@
<span class="doccomment">/// Faster version of `apply_mask()` which operates on 8-byte blocks.</span>
<span class="attribute">#[<span class="ident">inline</span>]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">cast_lossless</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">cast_lossless</span>))]</span>
<span class="kw">pub</span>(<span class="kw">crate</span>) <span class="kw">fn</span> <span class="ident">apply_mask</span>(<span class="ident">buf</span>: <span class="kw-2">&amp;</span><span class="kw-2">mut</span> [<span class="ident">u8</span>], <span class="ident">mask_u32</span>: <span class="ident">u32</span>) {
<span class="comment">// Extend the mask to 64 bits</span>
<span class="kw">let</span> <span class="kw-2">mut</span> <span class="ident">mask_u64</span> <span class="op">=</span> ((<span class="ident">mask_u32</span> <span class="kw">as</span> <span class="ident">u64</span>) <span class="op">&lt;&lt;</span> <span class="number">32</span>) <span class="op">|</span> (<span class="ident">mask_u32</span> <span class="kw">as</span> <span class="ident">u64</span>);
@ -200,7 +203,10 @@
<span class="comment">// TODO: copy_nonoverlapping here compiles to call memcpy. While it is not so</span>
<span class="comment">// inefficient, it could be done better. The compiler does not understand that</span>
<span class="comment">// a `ShortSlice` must be smaller than a u64.</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>, <span class="ident">allow</span>(<span class="ident">needless_pass_by_value</span>))]</span>
<span class="attribute">#[<span class="ident">cfg_attr</span>(
<span class="ident">feature</span> <span class="op">=</span> <span class="string">&quot;cargo-clippy&quot;</span>,
<span class="ident">allow</span>(<span class="ident">clippy</span>::<span class="ident">needless_pass_by_value</span>)
)]</span>
<span class="kw">fn</span> <span class="ident">xor_short</span>(<span class="ident">buf</span>: <span class="ident">ShortSlice</span>, <span class="ident">mask</span>: <span class="ident">u64</span>) {
<span class="comment">// Unsafe: we know that a `ShortSlice` fits in a u64</span>
<span class="kw">unsafe</span> {

52
static/api/actix-web/stable/src/actix_web/ws/mod.rs.html
View File

@ -474,19 +474,6 @@
<span id="474">474</span>
<span id="475">475</span>
<span id="476">476</span>
<span id="477">477</span>
<span id="478">478</span>
<span id="479">479</span>
<span id="480">480</span>
<span id="481">481</span>
<span id="482">482</span>
<span id="483">483</span>
<span id="484">484</span>
<span id="485">485</span>
<span id="486">486</span>
<span id="487">487</span>
<span id="488">488</span>
<span id="489">489</span>
</pre><pre class="rust ">
<span class="doccomment">//! `WebSocket` support for Actix</span>
<span class="doccomment">//!</span>
@ -877,8 +864,7 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">UPGRADE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;websocket&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">HandshakeError</span>::<span class="ident">NoConnectionUpgrade</span>,
<span class="ident">handshake</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">err</span>().<span class="ident">unwrap</span>()
@ -888,12 +874,10 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">UPGRADE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;websocket&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONNECTION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;upgrade&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">HandshakeError</span>::<span class="ident">NoVersionHeader</span>,
<span class="ident">handshake</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">err</span>().<span class="ident">unwrap</span>()
@ -903,16 +887,13 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">UPGRADE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;websocket&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONNECTION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;upgrade&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">SEC_WEBSOCKET_VERSION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;5&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">HandshakeError</span>::<span class="ident">UnsupportedVersion</span>,
<span class="ident">handshake</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">err</span>().<span class="ident">unwrap</span>()
@ -922,16 +903,13 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">UPGRADE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;websocket&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONNECTION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;upgrade&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">SEC_WEBSOCKET_VERSION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;13&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">HandshakeError</span>::<span class="ident">BadWebsocketKey</span>,
<span class="ident">handshake</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">err</span>().<span class="ident">unwrap</span>()
@ -941,20 +919,16 @@
.<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">UPGRADE</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;websocket&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">CONNECTION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;upgrade&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">SEC_WEBSOCKET_VERSION</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;13&quot;</span>),
)
.<span class="ident">header</span>(
).<span class="ident">header</span>(
<span class="ident">header</span>::<span class="ident">SEC_WEBSOCKET_KEY</span>,
<span class="ident">header</span>::<span class="ident">HeaderValue</span>::<span class="ident">from_static</span>(<span class="string">&quot;13&quot;</span>),
)
.<span class="ident">finish</span>();
).<span class="ident">finish</span>();
<span class="macro">assert_eq</span><span class="macro">!</span>(
<span class="ident">StatusCode</span>::<span class="ident">SWITCHING_PROTOCOLS</span>,
<span class="ident">handshake</span>(<span class="kw-2">&amp;</span><span class="ident">req</span>).<span class="ident">unwrap</span>().<span class="ident">finish</span>().<span class="ident">status</span>()