迁移至Jetty 12：HandlerCollection缺失及保证处理器全执行问题

Jetty 12中移除了HandlerCollection，对应的顺序处理器是Handler.Sequence，但默认行为是当某个处理器返回true时终止后续处理。要让你的三个处理器（GreeterHandler、ContextHandlerCollection、LoggingHandler）对每个请求都执行，核心是修改Handler.Sequence的终止规则。

解决方案步骤 #

1. 用Handler.Sequence替代HandlerCollection
   Jetty 12中Handler.Sequence是管理顺序处理器的核心组件，直接替代原有的HandlerCollection。

2. 关闭"成功即终止"的默认行为
   调用setTerminateOnSuccess(false)方法，强制Sequence遍历所有添加的处理器，不管每个处理器返回true还是false。

3. 保留原有处理器结构
   原有的ContextHandlerCollection、各端点处理器、静态资源逻辑可以直接复用，无需大幅修改。

修改后的完整代码 #

private void setup() {
    Server server = new Server();
    
    //...

    // 初始化顺序处理器，关闭成功终止规则
    Handler.Sequence rootHandler = new Handler.Sequence();
    rootHandler.setTerminateOnSuccess(false);
    server.setHandler(rootHandler);

    // 添加前置数据加载处理器
    rootHandler.addHandler(new GreeterHandler(this));

    // 上下文路由集合（Jetty12中仍保留）
    ContextHandlerCollection ctxCollection = new ContextHandlerCollection();
    rootHandler.addHandler(ctxCollection);

    // 注册各端点路由
    addHandler(ctxCollection, "/", new IndexHandler(this));
    addHandler(ctxCollection, "/submit", new SubmitHandler(this));
    addHandler(ctxCollection, "/api", new ApiHandler(this));
    addHandler(ctxCollection, "/user", new UserProfileHandler(this));
    addHandler(ctxCollection, "/login", new LoginHandler(this));
    addHandler(ctxCollection, "/logout", new LogoutHandler(this));
    addHandler(ctxCollection, "/list", new ListHandler(this));

    // 静态资源处理
    ResourceHandler publicFilesHandler = new ResourceHandler();
    publicFilesHandler.setBaseResourceAsString("res/public/");
    publicFilesHandler.setDirAllowed(false);

    MimeTypes.Mutable mimeTypes = new MimeTypes.Mutable();
    mimeTypes.getMimeMap().put("js", "text/javascript; charset=utf-8");
    mimeTypes.getMimeMap().put("css", "text/css; charset=utf-8");
    publicFilesHandler.setMimeTypes(mimeTypes);

    addHandler(ctxCollection,"/files", publicFilesHandler);

    // 添加后置日志处理器
    rootHandler.addHandler(new LoggingHandler(this));
}

private void addHandler(ContextHandlerCollection handlerCollection, String contextPath, Handler.Abstract handler) {
    ContextHandler newContext = new ContextHandler(contextPath);
    newContext.setHandler(handler);
    handlerCollection.addHandler(newContext);
}

关键逻辑说明 #

• setTerminateOnSuccess(false)的作用：默认情况下，Handler.Sequence会在某个处理器返回true（表示请求已被处理）时停止执行后续处理器。设置这个参数后，会强制执行所有添加的处理器，正好匹配你需要三个组件依次执行的需求。
• ContextHandlerCollection的行为：它找到匹配的上下文路由后会返回true，但因为Sequence的终止规则已修改，不会阻止后续的LoggingHandler运行。
• 处理器执行顺序：严格按照添加顺序执行：GreeterHandler加载上下文数据 → ContextHandlerCollection处理路由 → LoggingHandler记录耗时，每个请求都会完整走过这三个环节。

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