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 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
extern crate url; use self::url::percent_encoding::percent_decode; use self::url::{Host, Url}; use std::ffi::{CStr, CString}; use result::{ConnectionError, ConnectionResult}; pub struct ConnectionOptions { host: Option<CString>, user: CString, password: Option<CString>, database: Option<CString>, port: Option<u16>, } impl ConnectionOptions { pub fn parse(database_url: &str) -> ConnectionResult<Self> { let url = match Url::parse(database_url) { Ok(url) => url, Err(_) => return Err(connection_url_error()), }; if url.scheme() != "mysql" { return Err(connection_url_error()); } if url.path_segments().map(|x| x.count()).unwrap_or(0) > 1 { return Err(connection_url_error()); } let host = match url.host() { Some(Host::Ipv6(host)) => Some(CString::new(host.to_string())?), Some(host) => Some(CString::new(host.to_string())?), None => None, }; let user = decode_into_cstring(url.username())?; let password = match url.password() { Some(password) => Some(decode_into_cstring(password)?), None => None, }; let database = match url.path_segments().and_then(|mut iter| iter.nth(0)) { Some("") | None => None, Some(segment) => Some(CString::new(segment.as_bytes())?), }; Ok(ConnectionOptions { host: host, user: user, password: password, database: database, port: url.port(), }) } pub fn host(&self) -> Option<&CStr> { self.host.as_ref().map(|x| &**x) } pub fn user(&self) -> &CStr { &self.user } pub fn password(&self) -> Option<&CStr> { self.password.as_ref().map(|x| &**x) } pub fn database(&self) -> Option<&CStr> { self.database.as_ref().map(|x| &**x) } pub fn port(&self) -> Option<u16> { self.port } } fn decode_into_cstring(s: &str) -> ConnectionResult<CString> { let decoded = percent_decode(s.as_bytes()) .decode_utf8() .map_err(|_| connection_url_error())?; CString::new(decoded.as_bytes()).map_err(Into::into) } fn connection_url_error() -> ConnectionError { let msg = "MySQL connection URLs must be in the form \ `mysql://[[user]:[password]@]host[:port][/database]`"; ConnectionError::InvalidConnectionUrl(msg.into()) } #[test] fn urls_with_schemes_other_than_mysql_are_errors() { assert!(ConnectionOptions::parse("postgres://localhost").is_err()); assert!(ConnectionOptions::parse("http://localhost").is_err()); assert!(ConnectionOptions::parse("file:///tmp/mysql.sock").is_err()); assert!(ConnectionOptions::parse("socket:///tmp/mysql.sock").is_err()); assert!(ConnectionOptions::parse("mysql://localhost").is_ok()); } #[test] fn urls_must_have_zero_or_one_path_segments() { assert!(ConnectionOptions::parse("mysql://localhost/foo/bar").is_err()); assert!(ConnectionOptions::parse("mysql://localhost/foo").is_ok()); } #[test] fn first_path_segment_is_treated_as_database() { let foo_cstr = CString::new("foo").unwrap(); let bar_cstr = CString::new("bar").unwrap(); assert_eq!( Some(&*foo_cstr), ConnectionOptions::parse("mysql://localhost/foo") .unwrap() .database() ); assert_eq!( Some(&*bar_cstr), ConnectionOptions::parse("mysql://localhost/bar") .unwrap() .database() ); assert_eq!( None, ConnectionOptions::parse("mysql://localhost") .unwrap() .database() ); } #[test] fn userinfo_should_be_percent_decode() { use self::url::percent_encoding::{utf8_percent_encode, USERINFO_ENCODE_SET}; let username = "x#gfuL?4Zuj{n73m}eeJt0"; let encoded_username = utf8_percent_encode(username, USERINFO_ENCODE_SET); let password = "x/gfuL?4Zuj{n73m}eeJt1"; let encoded_password = utf8_percent_encode(password, USERINFO_ENCODE_SET); let db_url = format!( "mysql://{}:{}@localhost/bar", encoded_username, encoded_password ); let db_url = Url::parse(&db_url).unwrap(); let conn_opts = ConnectionOptions::parse(db_url.as_str()).unwrap(); let username = CString::new(username.as_bytes()).unwrap(); let password = CString::new(password.as_bytes()).unwrap(); assert_eq!(username, conn_opts.user); assert_eq!(password, conn_opts.password.unwrap()); } #[test] fn ipv6_host_not_wrapped_in_brackets() { let host1 = CString::new("::1").unwrap(); let host2 = CString::new("2001:db8:85a3::8a2e:370:7334").unwrap(); assert_eq!( Some(&*host1), ConnectionOptions::parse("mysql://[::1]").unwrap().host() ); assert_eq!( Some(&*host2), ConnectionOptions::parse("mysql://[2001:db8:85a3::8a2e:370:7334]") .unwrap() .host() ); }