com.jfinal.template.stat.ast

Class Include

java.lang.Object

com.jfinal.template.stat.ast.Stat

com.jfinal.template.stat.ast.Include

public class Include
extends Stat

Include 1：父模板被缓存时，被 include 的模板会被间接缓存，无需关心缓存问题 2：同一个模板文件被多个父模板 include，所处的背景环境不同，例如各父模板中定义的模板函数不同 各父模板所处的相对路径不同，所以多个父模板不能共用一次 parse 出来的结果，而是在每个被include 的地方重新 parse

 两种用法：
 1：只传入一个参数，参数必须是 String 常量，如果希望第一个参数是变量可以使用 #render 指令去实现
   #include("_hot.html")
   
 2：传入任意多个参数，除第一个参数以外的所有参数必须是赋值表达式，用于实现参数传递功能
   #include("_hot.html", title = "热门新闻", list = newsList)
   
   上例中传递了 title、list 两个参数，可以代替父模板中的 #set 指令传参方式
   并且此方式传入的参数只在子模板作用域有效，不会污染父模板作用域
   
   这种传参方式有利于将子模板模块化，例如上例的调用改成如下的参数：
   #include("_hot.html", title = "热门项目", list = projectList)
   通过这种传参方式在子模板 _hot.html 之中，完全不需要修改对于 title 与 list
   这两个变量的处理代码，就实现了对 “热门项目” 数据的渲染
 

Field Summary

Fields inherited from class com.jfinal.template.stat.ast.Stat

location

Constructor Summary

Constructors

Constructor and Description
Include(Env env, ExprList exprList, String parentFileName, Location location)

Method Summary

Modifier and Type	Method and Description
void	exec(Env env, Scope scope, Writer writer)
static String	getSubFileName(String fileName, String parentFileName) 获取在父模板之下子模板的最终文件名，子模板目录相对于父模板文件目录来确定 以 "/" 打头则以 baseTemplatePath 为根，否则以父文件所在路径为根

Methods inherited from class com.jfinal.template.stat.ast.Stat

getLocation, hasEnd, setExprList, setLocation, setStat, write

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Include

public Include(Env env,
               ExprList exprList,
               String parentFileName,
               Location location)

Method Detail

getSubFileName

public static String getSubFileName(String fileName,
                                    String parentFileName)

获取在父模板之下子模板的最终文件名，子模板目录相对于父模板文件目录来确定 以 "/" 打头则以 baseTemplatePath 为根，否则以父文件所在路径为根

exec

public void exec(Env env,
                 Scope scope,
                 Writer writer)

Specified by:

exec in class Stat