58 RESTful Web Services（22）：重构还是继续完成功能？

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

回顾架构愿景与任务列表

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

目前的任务列表：

• Resource/RootResource/ResourceMethod

• 从Path标注中获取UriTemplate

  • 如不存在Path标注，则抛出异常

  • 在处理请求派分时，可以根据客户端提供的Http方法，选择对应的资源方法

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

  • 没有资源方法于请求的Uri和Http方法一致时，返回404

  • 在处理请求派分时，可以支持多级子资源

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

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

代码为：

class RootResourceClass implements ResourceRouter.RootResource {
    private PathTemplate uriTemplate;
    private Class<?> resourceClass;
    private Map<String, List<ResourceRouter.ResourceMethod>> resourceMethods;
    public RootResourceClass(Class<?> resourceClass) {
        this.resourceClass = resourceClass;
        this.uriTemplate = new PathTemplate(resourceClass.getAnnotation(Path.class).value());
        this.resourceMethods = Arrays.stream(resourceClass.getMethods()).filter(m -> Arrays.stream(m.getAnnotations())
                        .anyMatch(a -> a.annotationType().isAnnotationPresent(HttpMethod.class)))
                .map(DefaultResourceMethod::new)
                .collect(Collectors.groupingBy(ResourceRouter.ResourceMethod::getHttpMethod));
    }
    @Override
    public Optional<ResourceRouter.ResourceMethod> match(UriTemplate.MatchResult result, String method, String[] mediaTypes, UriInfoBuilder builder) {
        String remaining = result.getRemaining();
        return resourceMethods.get(method).stream().map(m -> match(remaining, m)).filter(Result::isMatched).sorted()
                .findFirst().map(Result::resourceMethod);
    }
    @Override
    public UriTemplate getUriTemplate() {
        return uriTemplate;
    }
    private Result match(String path, ResourceRouter.ResourceMethod method) {
        return new Result(method.getUriTemplate().match(path), method);
    }
    record Result(Optional<UriTemplate.MatchResult> matched,
                  ResourceRouter.ResourceMethod resourceMethod) implements Comparable<Result> {
        public boolean isMatched() {
            return matched.map(r -> r.getRemaining() == null).orElse(false);
        }
        @Override
        public int compareTo(Result o) {
            return matched.flatMap(x -> o.matched.map(x::compareTo)).orElse(0);
        }
    }
    static class DefaultResourceMethod implements ResourceRouter.ResourceMethod {
        private String httpMethod;
        private UriTemplate uriTemplate;
        private Method method;
        public DefaultResourceMethod(Method method) {
            this.method = method;
            this.uriTemplate = new PathTemplate(method.getAnnotation(Path.class).value());
            this.httpMethod = Arrays.stream(method.getAnnotations()).filter(a -> a.annotationType().isAnnotationPresent(HttpMethod.class))
                    .findFirst().get().annotationType().getAnnotation(HttpMethod.class).value();
        }
        @Override
        public String getHttpMethod() {
            return httpMethod;
        }
        @Override
        public UriTemplate getUriTemplate() {
            return uriTemplate;
        }
        @Override
        public GenericEntity<?> call(ResourceContext resourceContext, UriInfoBuilder builder) {
            return null;
        }
        @Override
        public String toString() {
            return method.getDeclaringClass().getSimpleName() + "." + method.getName();
        }
    }
}

视频演示

进入今天的环节：

思考题

Sub Resource Locator要如何构造测试数据？

精选留言（1）

• aoe 👍（0） 💬（0）

  原来 @ParameterizedTest(name = "{2}") 这样就可以从参数中选一个做测试展示的名称

  2022-07-30