在RestTemplate调用中直接使用字符串而非URI实例化的优势探讨

直接使用字符串作为请求地址相比手动创建URI对象，主要有以下几个实用优势：

• 代码更简洁，无需手动处理异常
  手动创建URI对象时必须显式处理URISyntaxException（受检异常），要么用try-catch包裹，要么向上抛出。而直接传字符串的话，RestTemplate内部会自动完成地址解析，把受检异常封装成运行时异常（IllegalArgumentException）抛出，省去了异常处理的冗余代码。
  示例对比：

  // 字符串方式，无需处理异常
  restTemplate.getForObject("http://api.example.com/users", String.class);
  
  // URI对象方式，必须处理异常
  try {
      URI uri = new URI("http://api.example.com/users");
      restTemplate.getForObject(uri, String.class);
  } catch (URISyntaxException e) {
      // 异常处理逻辑
      throw new RuntimeException("Invalid URI", e);
  }
  

• 自动完成URL编码，避免手动编码失误
  如果地址中包含特殊字符（比如中文、空格、&/=之外的特殊符号），手动创建URI对象时需要提前对这些字符进行URL编码，否则会抛出语法异常。而直接传入字符串地址时，RestTemplate会通过UriComponentsBuilder自动对路径和查询参数进行规范编码，省去了手动编码的麻烦，也避免了编码错误。
  比如：

  // 字符串方式，自动编码中文参数
  restTemplate.getForObject("http://api.example.com/users?name=张三", String.class);
  
  // URI对象方式，需手动编码
  try {
      String encodedName = URLEncoder.encode("张三", StandardCharsets.UTF_8);
      URI uri = new URI("http://api.example.com/users?name=" + encodedName);
      restTemplate.getForObject(uri, String.class);
  } catch (URISyntaxException | UnsupportedEncodingException e) {
      throw new RuntimeException("Invalid URI", e);
  }
  

• 更便捷的参数占位符替换
  RestTemplate支持在字符串地址中使用{}作为参数占位符，直接传入参数值即可完成替换，这比手动拼接URI字符串或者通过URI对象构建更直观、不易出错。
  示例：

  // 字符串方式，占位符替换
  String userId = "123";
  restTemplate.getForObject("http://api.example.com/users/{id}", String.class, userId);
  
  // URI对象方式，需手动拼接或用UriComponentsBuilder
  URI uri = UriComponentsBuilder.fromHttpUrl("http://api.example.com/users/{id}")
          .buildAndExpand(userId)
          .toUri();
  restTemplate.getForObject(uri, String.class);
  

当然，手动创建URI对象也有其适用场景，比如需要严格控制URI的各个组成部分（协议、主机、端口、路径、查询参数），或者复用已构建好的URI实例时。但在大多数简单的请求场景下，直接使用字符串地址会更高效、更省心。

内容的提问来源于stack exchange，提问作者Uma Chocku