3.7 render 方法

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

public void configRoute(Routes me) {
   // baseViewPath 为 "/_view"，该 Routes 对象之下映射的所有 Controller 都将取这个值
   me.setBaseViewPath("/_view");
 
   // basePath 为第三个参数 "/index"
   me.add("/", IndexController.class, "/index");
 
   me.add("/project", ProjectController.class);
}

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

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

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

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

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

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

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

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

以上配置将选择 jfinal 内置的 enjoy 模板引擎渲染模板，该配置是默认值，在使用时无需配置。注意该配置仅仅针对 Controller.render(String view) 方法，其它 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。

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

注意：

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

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

// 定制一个 MyRender
public class MyRender extends Render {
  ...
}
 
// 切换到自己定制的 MyRender 上去
public class MyRenderFactory extends RenderFactory {
   public Render getRender(String view) {
      return new MyRender(view);
   }
}
 
// 配置生效
public void configConstant(Constants me) {
   me.setRenderFactory(new MyRenderFactory());
}