§配置 jetbrick-webmvc.properties

在 web.xml 中,我们配置了 jetbrick-webmvc 用到的全局配置文件,默认位于如下的路径: /WEB-INF/jetbrick-webmvc.properties

这里提供一个完整的可配置项列表,以供参考。

名称 默认值 说明
web.development true 是否属于开发模式
web.http.encoding utf-8 默认编码
web.http.cache false 是否启用 HTTP 协议的 Cache 功能
web.scan.packages 默认 Annotation 扫描的 packages
web.urls.bypass 静态资源过滤器
web.urls.router RestfulRouter URL 路由方式
web.view.default jetx 默认视图处理器别名

§1. web.development

是否属于开发模式。默认为 true

何为开发模式?即框架中专门为了开发、调试方便,提供了额外的调试日志,并且禁用了部分 cache,以便能及时发现部分 Resource 的变更,做到热加载。

§2. web.http.encoding

HTTP Request/Response 的编码方式,默认为 utf-8

request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);

§3. web.http.cache

是否启用 HTTP Response 的 cache,默认为 false,表示禁用。

// Http 1.0 header
response.setHeader("Buffer", "false");
response.setHeader("Pragma", "no-cache");
response.setDateHeader("Expires", 1L);

// Http 1.1 header
response.setHeader("Cache-Control", "no-cache, no-store, max-age=0");

§4. web.scan.packages

jetbrick-webmvc 通过 Annotation 的自动扫描,可以自动发现如下的配置:

这里,用户需要配置 classpath 下面允许扫描的 package 名称。可以配置多个。

如下:

web.scan.packages = jetbrick.docs.demo.controllers, jetbrick.docs.demo.handlers

§5. web.urls.bypass

具体可以参考:资源过滤器 BypassRequestUrls

通常来讲,只有 web.xml 中将 URL 映射配置成 /* 的时候,才需要进行配置。

目前系统提供了 2 种过滤器,用户可以选择一个,或者实现自己的过滤器。

§6. web.urls.router

默认的路由实现:jetbrick.web.mvc.router.RestfulRouter

§7. web.view.default

默认的 view 处理器别名: jsp

如果用户返回的 View Name 中,无法判断是有那个 View Handler 处理的话,那么将默认使用这里配置的 View Handler 来处理。

更多信息可以看:View/ViewHandler