跳转至

52 RESTful Web Services(16):重构手法之设计方法名的名称

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

回顾架构愿景与任务列表

目前我们的架构愿景如下:


任务列表如下:

  • ResourceRouter

  • 将Resource Method的返回值包装为Response对象

    • 根据与Path匹配结果,降序排列RootResource,选择第一个的RootResource
    • 如果没有匹配的RootResource,则构造404的Response
    • 如果返回的RootResource中无法匹配剩余Path,则构造404的Response
    • 如果ResourceMethod返回null,则构造204的Response

代码目前是:

class DefaultResourceRouter implements ResourceRouter {
    private Runtime runtime;
    private List<RootResource> rootResources;
    public DefaultResourceRouter(Runtime runtime, List<RootResource> rootResources) {
        this.runtime = runtime;
        this.rootResources = rootResources;
    }
    @Override
    public OutboundResponse dispatch(HttpServletRequest request, ResourceContext resourceContext) {
        String path = request.getServletPath();
        UriInfoBuilder uri = runtime.createUriInfoBuilder(request);
        Optional<Result> matched = rootResources.stream().map(resource -> new Result(resource.getUriTemplate().match(path), resource))
                .filter(result -> result.matched.isPresent()).sorted((x, y) -> x.matched.get().compareTo(y.matched.get())).findFirst();
        Optional<ResourceMethod> method = matched.flatMap(result -> result.resource.match(result.matched.get().getRemaining(),
                request.getMethod(), Collections.list(request.getHeaders(HttpHeaders.ACCEPT)).toArray(String[]::new), uri));
        GenericEntity<?> entity = method.map(m -> m.call(resourceContext, uri)).get();
        return (OutboundResponse) Response.ok(entity).build();
    }
    record Result(Optional<UriTemplate.MatchResult> matched, RootResource resource) {
    }
}

视频演示

下面进入今日的开发:

思考题

在进入下节课之前,希望你能认真思考如下两个问题。

  1. 接下来是否还需要进行Spike的架构愿景细化?
  2. 你有没有什么比较好的学习TDD的方法?

欢迎把你的想法分享在留言区,也欢迎把你的项目代码分享出来。相信经过你的思考与实操,学习效果会更好!

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

    视频中的流式计算按功能封装方法,因为实现了单一原则,所以每个方法都能拥有一个名副其实的名字。看似简单的背后运转着大道规则(设计原则)。

    2022-07-18

  • Luke 👍(0) 💬(0)

    又踩了个坑:重构后的 result 方法里,给的 path 参数要带有 `/` 斜杠。或者之后 mock 的时候,满足的 path 条件要一致。。。

    2022-09-21