3.7 render 方法

1､render(String view)

render(String view) 方法将对 view 所指向的模板进行渲染，view 参数最终指向的模板文件规则如下：

  1. String template = baseViewPath + viewPath + view

其中 view 即为 render(String view) 方法所携带的参数值，而 baseViewPath、viewPath 则是在路由配置时指定的两个值，例如： 

  1. public void configRoute(Routes me) {
  2.    // baseViewPath 为 "/_view"，该 Routes 对象之下映射的所有 Controller 都将取这个值
  3.    me.setBaseViewPath("/_view");
  4.    
  5.    // basePath 为第三个参数 "/index"
  6.    me.add("/", IndexController.class, "/index");
  7.    
  8.    // 第三个参数省略时， basePath 取第一个参数的值 : "/project"
  9.    me.add("/project", ProjectController.class);
  10. }

注意看上面的代码，其中的 me.setBaseViewPath(…) 指定的值即为 baseViewPath，其中 me.add(…) 第三个参数即为 viewPath，当第三个参数省略时默认取第一个参数的值。

针对上述配置，在 IndexController 中使用 render 时的模板文件如下：

  1. public class IndexController extends Controller {
  2.    public void demo() {
  3.      // 模板指向 : "/_view/index/abc.html"
  4.      render("abc.html");
  5.    }
  6. }

上述的 render(“abc.html”) 将指向 webapp 目录下面的 “/_view/index/abc.html” 这个模板。

使用技巧：baseViewPath 配置为项目存放模板的总的根目录。viewPath 配置为当前被映射的 controller 的子目录。最终的效果就是 render(view) 的参数 view 永远是一个最终的文件名，例如： render(“index.html”)，从而消除掉了 view 参数中的目录部分。

当需要打破 baseViewPath 与 viewPath 这两个参数的限制时，view 参数以 “/“ 打头即可：

  1. render("/other_path/my_path/index.html");

view 参数以 “/“ 打头时，将勿略掉 baseViewPath 与 viewPath 这两个值：

  1. String template = "/other_path/my_path/index.html";

2、render(String view) 方法配置模板引擎

render(String view) 将根据 configConstant(Constants me) 中配置的 me.setViewType(ViewType) 方法选择一种模板引进渲染模板文件，例如：

  1. public void configConstant(Constants me) {
  2.   me.setViewType(ViewType.JFINAL_TEMPLATE);
  3. }

以上配置将选择 jfinal 内置的 enjoy 模板引擎渲染模板，该配置是默认值，在使用时无需配置。注意该配置仅仅针对 Controller.render(String view) 方法，其它 render 系方法完全不受影响。

3、render 系列其它方法

render系列方法将渲染不同类型的视图并返回给客户端。JFinal目前支持的视图类型有：JFinal Template、FreeMarker、JSP、Velocity、JSON、File、Text、Html、QrCode 二维码 等等。除了JFinal支持的视图型以外，还可以通过继承Render抽象类来无限扩展视图类型。

通常情况下使用Controller.render(String)方法来渲染视图，使用Controller.render(String)时的视图类型由JFinalConfig.configConstant(Constants constants)配置中的constants. setViewType(ViewType)来决定，该设置方法支持的ViewType有：JFINAL_TEMPLATE、FreeMarker、JSP、Velocity，不进行配置时的缺省配置为JFINAL_TEMPLATE。

此外，还可以通过 constants.setRenderFactory(RenderFactory)来设置Controller中所有render系列方法所使用的Render实现类。

以上是 render 系方法使用例子：

  1. // 渲染名为test.html的视图，且视图类型为 JFinal Template
  2. renderTemplate(”test.html”);
  3.  
  4. // 生成二维码
  5. renderQrCode("content");
  6.  
  7. // 渲染名为test.html的视图，且视图类型为FreeMarker
  8. renderFreeMarker(”test.html”);
  9.  
  10. // 渲染名为test.html的视图，且视图类型为Velocity
  11. renderVelocity(“test.html”);
  12.  
  13. // 将所有setAttr(..)设置的变量转换成 json 并渲染
  14. renderJson();
  15.  
  16. // 以 "users" 为根，仅将 userList 中的数据转换成 json 并渲染
  17. renderJson(“users”, userList);
  18.  
  19. // 将user对象转换成 json 并渲染
  20. renderJson(user);
  21.  
  22. // 直接渲染 json 字符串
  23. renderJson("{\"age\":18}" );
  24.  
  25. // 仅将setAttr(“user”, user)与setAttr(“blog”, blog)设置的属性转换成json并渲染
  26. renderJson(new  String[]{"user", "blog"});
  27.  
  28. // 渲染名为test.zip的文件，一般用于文件下载
  29. renderFile("test.zip");
  30.  
  31. // 渲染纯文本内容 "Hello JFinal"
  32. renderText("Hello JFinal");
  33.  
  34. // 渲染 Html 内容 "Hello Html"
  35. renderHtml("Hello Html");
  36.  
  37. // 渲染名为 test.html 的文件，且状态为 404
  38. renderError(404 , "test.html");
  39.  
  40. // 渲染名为 test.html 的文件，且状态为 500
  41. renderError(500 , "test.html");
  42.  
  43. // 不渲染，即不向客户端返回数据
  44. renderNull();
  45.  
  46. // 使用自定义的MyRender来渲染
  47. render(new MyRender());

注意：

1：IE不支持contentType为application/json,在ajax上传文件完成后返回json时IE提示下载文件,解决办法是使用：render(new JsonRender().forIE())或者render(new JsonRender(params).forIE())。这种情况只出现在IE浏览器 ajax 文件上传，其它普通ajax请求不必理会。

2：除renderError方法以外，在调用render系列的方法后程序并不会立即返回，如果需要立即返回需要使用return语句。在一个action中多次调用render方法只有最后一次有效。

4、定制 Controller.render 系方法的实现类

jfinal 提供了 RenderFactory 来定制 Controller.render 所有 render 方法的实现类，以下是定制 Controller.render(String view) 实现类的代码：

  1. // 定制一个 MyRender
  2. public class MyRender extends Render {
  3.   ...
  4. }
  5.  
  6. // 扩展 RenderFactory，用于将 Controller.render(String view)
  7. // 切换到自己定制的 MyRender 上去
  8. public class MyRenderFactory extends RenderFactory {
  9.    public Render getRender(String view) {
  10.       return new MyRender(view);
  11.    }
  12. }
  13.  
  14. // 配置生效
  15. public void configConstant(Constants me) {
  16.    me.setRenderFactory(new MyRenderFactory());
  17. }

以上代码中 MyRenderFactory.getRender(…) 方法重写了父类 RenderFactory.getRender(…) 方法，将切换掉 Controller.render(String view) 的实现类。同理，可以通过覆盖掉 getJsonRender() 来切换掉 Controller.renderJson()。 Controller 中所有 render 方法的实现类都可以通过这种方式来切换到自己的实现类上去，极度方便灵活，