526互联

RestTemplate-访问Web资源

发布时间 2023-09-11 11:24:21作者: AmorFati404

Spring Boot 中的RestTemplate

  • Spring Boot 中没有自动配置RestTemplate
  • Spring Boot 提供了RestTemplateBuilder
    • RestTemplate.build()

构造URL

URI uri = Uri ComponentsBuilder
		.fromUriString("http://example.com/hotels/{hotel}")
		.queryParam("q","{q}")
   		.encode()
		.buildAndExpand("Westin","123")
		.toUri();
//更为简洁
URI uri = UriComponentsBuilder
		.fromUriString("http://example.com/hotels/{hotel}?q={q}"
        .build("Westin","123");
                       
UriComponents uriComponents = MvcUriComponentsBuilder
	.fromMethodCal1(on(BookingController.class).getBooking(21)).buildAndExpand(42);
URI uri = uriComponents.encode().toUri();

Rest

"REST提供了一组架构约束，当作为一个整体来应用时，强调组件交互的
可伸缩性、接口的通用性、组件的独立部署、以及用来减少交互延迟、增
强安全性、封装遗留系统的中间组件。”

Roy Thomas Fielding

Richardson 成熟度模型

6wEgsJ.png

如何实现 Restful Web Service

  • 识别资源

  • 选择合适的资源粒度

  • 设计URL

  • 选择合适的 HTTP 方法和返回码

  • 设计资源的表述

    识别资源

    • 找到领域名词
      • 能用CRUD操作的名词
    • 将资源组织为集合（即集合资源）
    • 将资源合并为复合资源
    • 计算或处理函数

    资源的粒度

    站在服务端的角度，要考虑

    • 网络效率
    • 表述的多少
    • 客户端的易用程度

    站在客户端的角度，要考虑

    • 可缓存性
    • 修改频率
    • 可变性

    构建更好的URL

    • 使用域及子域对资源进行合理的分组或划分
    • 在URI的路径部分使用斜杠分隔符（/)来表示资源之间的层次关系
    • 在URI的路径部分使用逗号（,)和分号（;)来表示非层次元素
    • 使用连字符（-)和下划线（_)来改善长路径中名称的可读性
    • 在URI的查询部分使用“与”符号（&)来分隔参数
    • 在URI中避免出现文件扩展名（例如.php,.aspx和.jsp)

    认识HTTP状态码

    状态码 描述 状态码 描述
    200 OK 400 Bad Request
    201 Created 401 Unauthorized
    202 Accepted 403 Forbidden
    301 Moved Permanently 404 Not Found
    303 See Other 410 Gone
    304 Not Modified 500 Internal Server Error
    307 Temporary Redirect 503 Service Unavailable

    认识HTTP方法

    动作 安全/幂等 用途
    GET Y/Y 信息获取
    POST N/N 修改对象
    DELETE N/Y 删除资源
    PUT N/Y 更新资源
    HEAD Y/Y 获取和GET一样的HTTP头信息，没有响应体
    OPTIONS Y/Y 获取资源自持的HTTP方法
    TRACE Y/Y 服务器返回收到的HTTP头