Spring居然还提供了这么好用的URL工具类，以前都没发现

一时失言乱红尘 2022-10-07 00:53 218阅读 0赞

## 1. 前言 ##

开发中我们经常会操作 URL，比如提取端口、提取路径以及最常用的提取参数等等。很多时候需要借助于一些第三方类库或者自己编写工具类来实现，今天胖哥给大家介绍一种方法，无需新的类库引入，只要你使用了 Spring Web 模块都可以轻松来完成对 URL 的组装和分解提取。

## 2. UriComponents ##

JDK 虽然提供了`java.net.URI`，但是终归还是不够强大，所以 Spring 封装了一个不可变量的 URI 表示`org.springframework.web.util.UriComponents`。

### UriComponentsBuilder ###

我们可以利用其构造类`UriComponentsBuilder`从`URI`、Http 链接、URI 路径中初始化`UriComponents`。以 Http 链接为例：

String httpUrl= "https://felord.cn/spring-security/{article}?version=1&timestamp=123123325";
    UriComponents uriComponents = UriComponentsBuilder.fromHttpUrl(httpUrl).build();

> 如果不是 Http 就不能使用上面的方法了，需要使用`fromUriString(String uri)`。

我们也可以直接构造一个`UriComponents`:

UriComponents https = UriComponentsBuilder.newInstance()
            .scheme("https")
            .host("www.felord.cn")
            .port("8080")
            .path("/spring-boot/{article}")
            .queryParam("version","9527")
            .encode(StandardCharsets.UTF_8)
            .build();
    // https://www.felord.cn:8080/spring-boot/{article}?version=9527

## 3. 操作 UriComponents ##

### 提取协议头 ###

如果想提取协议头，如上面的例子我们想提取`https`。

String scheme = uriComponents.getScheme();
    // scheme = https
    System.out.println("scheme = " + scheme);

### 提取 Host ###

获取`host`也是很常见的操作。

String host = uriComponents.getHost();
    // host = felord.cn
    System.out.println("host = " + host);

### 提取 Port ###

获取 uri 的端口。

int port = uriComponents.getPort();
    // port = -1
    System.out.println("port = " + port);

> 但是很奇怪的是上面的是 `-1`,很多人误以为会是`80`。其实 Http 协议确实是`80`，但是`java.net.URL#getPort()`规定，若 URL 的实例未申明（省略）端口号，则返回值为`-1`。所以当返回了`-1`就等同于`80`，但是 URL 中不直接体现它们。

### 提取 Path ###

提取路径，这个还是经常用做判断的。

String path = uriComponents.getPath();
    // path = /spring-security/{article}
    System.out.println("path = " + path);

### 提取 Query ###

提取路径中的 Query 参数可以说是我们最常使用的功能了。

String query = uriComponents.getQuery();
    // query = version=1&timestamp=123123325
    System.out.println("query = " + query);

更加合理的提取方式：

MultiValueMap<String, String> queryParams = uriComponents.getQueryParams();
    // queryParams = {version=[1], timestamp=[123123325]}
    System.out.println("queryParams = " + queryParams);

### 填充路径参数 ###

假如我们想填充**章节 2**中代码中声明的的`httpUrl`中的路径参数`{article}`，我们可以这样：

UriComponents expand = uriComponents.expand("oauth2-authorization-request.html");//expand = https://felord.cn/spring-security/oauth2-authorization-request.html?version=1&timestamp=123123325System.out.println("expand = " + expand);

## 4. 总结 ##

Spring 作为目前 Java Web 开发中几乎不可避免的框架其实已经提供了很多有用的工具来方便我们操作。`UriComponents`只是其中一个用于操作`URI`的工具，今天我们对它的一些常用功能进行了演示，希望能够帮你解决一些相关的操作难题

> 作者：码农小胖哥  
> 原文链接：https://felord.blog.csdn.net/article/details/109634767

# **结尾** #

![查漏补缺：Java岗 千+道面试题Java基础+全家桶+容器+反射+异常等][Java_ _Java]

这不止是一份面试清单，更是一种”被期望的责任“，因为有无数个待面试者，希望从这篇文章中，找出通往期望公司的”钥匙“，所以上面每道选题都是结合我自身的经验于千万个面试题中经过艰辛的两周，一个题一个题筛选出来再次对好答案和格式做出来的，面试的答案也是再三斟酌，深怕误人子弟是小，影响他人仕途才是大过，也希望您能把这篇文章分享给更多的朋友，让他帮助更多的人，帮助他人，快乐自己，最后，感谢您的阅读。

**[资料领取方式：戳这里免费获取][Link 1]**

人仕途才是大过，也希望您能把这篇文章分享给更多的朋友，让他帮助更多的人，帮助他人，快乐自己，最后，感谢您的阅读。

**[资料领取方式：戳这里免费获取][Link 1]**

**由于细节内容实在太多啦，在这里我花了两周的时间把这些答案整理成一份文档了，在这里只把部分知识点截图出来粗略的介绍，每个小节点里面都有更细化的内容！**

[Java_ _Java]: /images/20221005/70fee50539274fb9800f7bc3c4abe8ee.png
[Link 1]: https://docs.qq.com/doc/DSmxTbFJ1cmN1R2dB