跳转至

56 RESTful Web Services(20):为什么要通过测试的方法来驱动出代码结构?

你好,我是徐昊。今天我们继续使用TDD的方式实现RESTful Web Services。

回顾架构愿景与任务列表

目前我们已经实现了ResourceRouter,和UriTemplate整体的架构愿景如下:


接下来要进入RootResource/Resource和ResourceMethod的开发。目前未经细化的任务列表如下:

  • Resource/RootResource/ResourceMethod

  • 在处理请求派分时,可以支持多级子资源(Sub-Resource)

  • 在处理请求派分时,可以根据客户端提供的超媒体类型,选择对应的资源方法(Resource Method)
  • 在处理请求派分时,可以根据客户端提供的Http方法,选择对应的资源方法
  • 资源方法可以返回Java对象,由Runtime自行推断正确的返回状态
  • 资源方法可以不明确指定返回的超媒体类型,由Runtime自行推断,比如,资源方法标注了Produces标注,那么就使用标注提供的超媒体类型等
  • 资源方法可按找期望的类型,访问Http请求的内容
  • 资源对象和资源方法可接受环境组件的注入

让我们细化一下任务列表。首先关注在请求派分的Uri匹配部分,暂时忽略其他部分:

  • Resource/RootResource/ResourceMethod

  • 从Path标注中获取UriTemplate

    • 如不存在Path标注,则抛出异常
    • 在处理请求派分时,可以根据客户端提供的Http方法,选择对应的资源方法

    • 当请求与资源方法的Uri模版一致,且Http方法一致时,派分到该方法

    • 没有资源方法于请求的Uri和Http方法一致时,返回404
    • 在处理请求派分时,可以支持多级子资源

    • 当没有资源方法可以匹配请求时,选择最优匹配SubResourceLocater,通过它继续进行派分

    • 如果SubResourceLocator也无法找到满足的请求时,返回404

视频演示

进入今天的环节:

思考题

按照三角法,接下来要如何增加新的测试案例?

精选留言(2)
  • aoe 👍(0) 💬(0)

    第一次听说“三角法”,搜索了一下,分享一下我的理解: 三角法 = happy path + sad path 参考资料: TDD笔记3 三角测量Triangulation https://blog.csdn.net/rockieyungn/article/details/83288313 《Professional Test-Driven Development with C#: Developing Real World Applications with TDD》 https://www.oreilly.com/library/view/professional-test-driven-development/9780470643204/ch007-sec010.html

    2022-07-23

  • 忘川 👍(2) 💬(0)

    - 三角法 - 我理解是基于 两条线相交 只有一个点 能同时在两条线上 也就是同事满足两个测试用例 - 三角法和TDD的关系 - 刚开始 我们有N种方法 可以满足第一个或者前几个测试用例 然后随着测试用例的不断增加 也就是线的增加 那么能同时满足的点 会越来越少 - 通过不断新增的测试 给生产代码划定更多的边界 更小的空间 然后在狭小的空间内 驱动出代码结构 这也是我理解的tdd里面的驱动

    2023-01-09