请求和错误处理

在ZKWeb控制器只能处理固定的Url，如果需要灵活处理Url可以使用Http处理器。
控制器(ControllerManager)也是基于IHttpRequestHandler实现的。

Http请求处理器的例子

以下的处理器可以在访问/example/handler/xxx时显示"the path is xxx"

[ExportMany]
public class HttpRequestHandlerExample : IHttpRequestHandler {
    public const string Prefix = "/example/handler/";
    public void OnRequest() {
        var request = HttpManager.CurrentContext.Request;
        var response = HttpManager.CurrentContext.Response;
        if (request.Path.StartsWith(Prefix)) {
            new PlainResult("the path is " + request.Path.Substring(Prefix.Length))
                .WriteResponse(response);
            response.End();
        }
    }
}

Http错误处理器的例子

以下的处理器可以定义自定义的404页面

[ExportMany]
public class HttpErrorHandlerExample : IHttpRequestErrorHandler {
    public void OnError(Exception ex) {
        var httpEx = ex as HttpException; // HttpException in ZKWebStandard.Web
        if (httpEx != null && httpEx.StatusCode == 404) {
            var response = HttpManager.CurrentContext.Response;
            new PlainResult("custom 404 page").WriteResponse(response);
            response.End();
        }
    }
}

Http处理器的介绍

在ZKWeb中，有以下类型的Http处理器：

• IHttpRequestPreHandler
  • Http请求的预处理器
  • 这类处理器不应该返回结果，只应该用来设置数据，例如当前请求的语言
• IHttpRequestHandler
  • Http请求的处理器
  • 这类处理器在请求的路径匹配时可以直接返回结果
• IHttpRequestHandlerWrapper
  • 包装Http请求的函数
  • 适用于在里面重载Http上下文，例如实现伪静态
• IHttpRequestPostHandler
  • Http请求的后处理器
  • 一般用于清理预处理器中留下的东西
• IHttpRequestErrorHandler
  • 请求错误的处理器
  • 用于处理请求中发生的错误，例如自定义404页面

ZKWeb处理Http请求的流程如下

try {
    try {
        按插件注册顺序枚举注册的IHttpRequestPreHandler {
            调用OnRequest函数
        }
        处理函数 = {
            按插件注册相反顺序枚举注册的IHttpRequestHandler {
                调用OnRequest函数
            }
            抛出404错误
        }
        按插件注册顺序枚举注册的IHttpRequestHandlerWrapper {
            处理函数 = WrapHandlerAction(处理函数)
        }
        调用处理函数
    } finally {
        按插件注册顺序枚举注册的IHttpRequestPostHandler {
            调用OnRequest函数
        }
    }
} catch (代表请求结束的例外) {
} catch (Exception ex) {
    按插件注册顺序枚举注册的IHttpRequestErrorHandler {
        调用OnError函数
    }
}