     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90

    // Copyright 2015-2017 Parity Technologies (UK) Ltd.
    // This file is part of Parity.

    // Parity is free software: you can redistribute it and/or modify
    // it under the terms of the GNU General Public License as published by
    // the Free Software Foundation, either version 3 of the License, or
    // (at your option) any later version.

    // Parity is distributed in the hope that it will be useful,
    // but WITHOUT ANY WARRANTY; without even the implied warranty of
    // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    // GNU General Public License for more details.

    // You should have received a copy of the GNU General Public License
    // along with Parity.  If not, see <http://www.gnu.org/licenses/>.

    //! Hyper handlers implementations.

    mod auth;
    mod content;
    mod echo;
    mod fetch;
    mod redirect;
    mod streaming;

    pub use self::auth::AuthRequiredHandler;
    pub use self::content::ContentHandler;
    pub use self::echo::EchoHandler;
    pub use self::fetch::{ContentFetcherHandler, ContentValidator, FetchControl, ValidatorResponse};
    pub use self::redirect::Redirection;
    pub use self::streaming::StreamingHandler;

    use url::Url;
    use hyper::{server, header, net, uri};
    use address;

    /// Adds security-related headers to the Response.
    pub fn add_security_headers(headers: &mut header::Headers, embeddable_on: Option<(String, u16)>) {
    	headers.set_raw("X-XSS-Protection", vec![b"1; mode=block".to_vec()]);
    	headers.set_raw("X-Content-Type-Options", vec![b"nosniff".to_vec()]);

    	// Embedding header:
    	if let Some(embeddable_on) = embeddable_on {
    		headers.set_raw(
    			"X-Frame-Options",
    			vec![format!("ALLOW-FROM http://{}", address(embeddable_on)).into_bytes()]
    			);
    	} else {
    		// TODO [ToDr] Should we be more strict here (DENY?)?
    		headers.set_raw("X-Frame-Options",  vec![b"SAMEORIGIN".to_vec()]);
    	}
    }

    /// Extracts URL part from the Request.
    pub fn extract_url(req: &server::Request<net::HttpStream>) -> Option<Url> {
    	convert_uri_to_url(req.uri(), req.headers().get::<header::Host>())
    }

    /// Extracts URL given URI and Host header.
    pub fn convert_uri_to_url(uri: &uri::RequestUri, host: Option<&header::Host>) -> Option<Url> {
    	match *uri {
    		uri::RequestUri::AbsoluteUri(ref url) => {
    			match Url::from_generic_url(url.clone()) {
    				Ok(url) => Some(url),
    				_ => None,
    			}
    		},
    		uri::RequestUri::AbsolutePath { ref path, ref query } => {
    			let query = match *query {
    				Some(ref query) => format!("?{}", query),
    				None => "".into(),
    			};
    			// Attempt to prepend the Host header (mandatory in HTTP/1.1)
    			let url_string = match host {
    				Some(ref host) => {
    					format!("http://{}:{}{}{}", host.hostname, host.port.unwrap_or(80), path, query)
    				},
    				None => return None,
    			};

    			match Url::parse(&url_string) {
    				Ok(url) => Some(url),
    				_ => None,
    			}
    		},
    		_ => None,
    	}
    }

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)