3.10 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(IRenderFactory)来设置Controller中所有render系列方法所使用的Render实现类。

假设在JFinalConfig.configRoute(Routes routes)中有如下Controller映射配置:routes.add(“/user”, UserController.class, “/path”), render(String view)使用例子:

  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方法只有最后一次有效。

< 3.9 session操作方法

4.1 概述 >