在开发 Web 应用程序的时候,为了要让应用程序可以被设置在不同网域,或是不同的网址目录下,通常会需要对应用程序进行「网址前缀」的设置。举例来说,如果要把某个 Web 应用程序运作在「tool.magiclen.org」这个网域的「url」路径下,我们可以将「https://tool.magiclen.org/url」这个「网址前缀」设置给该 Web 应用程序,让它知道如何去正确处理它所用到的其它资源的路径。例如它有某个资源的路径为「images/logo.jpg」,有了「网址前缀」的数据之后,该 Web 应用程序就知道要链接到「images/logo.jpg」资源的网址是「https://tool.magiclen.org/url/images/logo.jpg」了!
但是由于我们的网址有「通信协定」(protocol)的存在,且连接也可以透过多个不同的「连接端口」(port),因此在进行「网址前缀」的产生时,并不是直接把通信协定、网域和路径串接在一起就好了。举例来说,HTTPS 协定预设使用「443」连接端口,如果我们要使用其它连接端口的话,例如 444,则必须要将网址写成「https://tool.magiclen.org:444/url」;可是如果连接端口就是使用预设的「443」,我们通常不会将网址写成「https://tool.magiclen.org:443/url」,因为它实在不太好看。
为了处理预设连接端口的问题,我们会写出以下这样的程序:
let mut url_prefix = String::new();
if is_https {
url_prefix.push_str("https://");
} else {
url_prefix.push_str("http://");
}
url_prefix.push_str(domain);
if is_https && port != 443 || !is_https && port != 80{
url_prefix.push_str(":");
url_prefix.push_str(&port.to_string());
}
if let Some(path) = path {
if !path.starts_with("/") {
url_prefix.push_str("/");
}
url_prefix.push_str(path);
}
以上的程序是让用户分别输入该 Web 应用程序有没有透过 HTTPS 协定来连接(is_https),以及其所在的网域名称(domain)和路径(path)来组成「网址前缀」(url_prefix)。
当然,您也可以让用户直接输入完整的「网址前缀」,只是这样可能就需要再用其它程序去验证用户输入的「网址前缀」是否合法,且通信协定、网域、连接端口、路径等等的信息可能也还要透过解析用户输入的「网址前缀」才能得到。两种方式的效果都差不多,不过笔者比较偏好前者一开始就把各个信息拆开设置,再由应用程序来组成「网址前缀」的方式,程序实作起来会比较简单一点。
URL Prefix
因为每次新开一个 Web 应用程序项目,几乎都要撰写上述提到的「网址前缀」产生程序。所以笔者开发了「URL Prefix」套件,提供了 create_prefix 函数来产生「网址前缀」。
Crates.io
Cargo.toml
使用方法
url_prefix 这个 crate 底下的 create_prefix 函数还必须搭配其中的 Protocol 枚举。
用法如下:
let prefix = url_prefix::create_prefix(url_prefix::Protocol::HTTPS, "magiclen.org", Some(8100), Some("url-prefix"));
assert_eq!("https://magiclen.org:8100/url-prefix", prefix);
当输入的连接端口并不是通信协定的预设连接端口时,「网址前缀」中才会明确地包含连接端口。
