像#render指令一样可以动态参数又支持调用子模板中的函数

也许你在jfinal的官方文档中看到enjoy指令部分有说到#render指令:

  • render指令中#define定义的模板函数只在其子模板中有效,在父模板中无效,这样设计非常有利于模块化

举个例子:

layout.html

#define layout()
#@content()
#end

index.html

#render("layout.html")
#@layout()
#define content()
显示xxx
#end

你会发现layout()函数是调用不到的,这就是和#include指令不一样的地方了。

那有人会说为什么不直接使用#include指令呢, 因为有动态变换模板的需求,而#include是不支持的; 当有layout1.html, layout2.html多个布局配置,后台根据配置加载的,所以需要#render指令接受动态的参数。这时候自定义指令上场了,在群里请教波总后,给的几个方案,只有自定义指令符合我的需求。

找到jfinal源码com.jfinal.template.ext.directive.RenderDirective,参考他的稍作改动即可。

新建类 MyRenderDirective extends Directive,拷贝RenderDirective的源码,修改parseSubStat()和SubStat类

private SubStat parseSubStat(Env env, String subFileName) {
        EngineConfig config = env.getEngineConfig();
        ISource subFileSource = config.getSourceFactory().getSource(config.getBaseTemplatePath(), subFileName, config.getEncoding());
        try {
            StatList subStatList = (new Parser(env, subFileSource.getContent(), subFileName)).parse();
            return new SubStat(env, subStatList.getActualStat(), subFileSource);
        } catch (Exception var7) {
            throw new ParseException(var7.getMessage(), this.location, var7);
        }
    }
    public static class SubStat extends Stat {
        public Env env;
        public Stat stat;
        public ISource source;
        public SubStat(Env env, Stat stat, ISource source) {
            this.env = env;
            this.stat = stat;
            this.source = source;
        }
        public void exec(Env env, Scope scope, Writer writer) {
            this.stat.exec(this.env, scope, writer);
        }
    }

只要把指令添加进引擎即可engine().addDirective("myRender", MyRenderDirective.class);

现在终于可以愉快的玩耍了,layoutPath是变量。

#myRender(layoutPath)

其他方案我也分享一下吧,这得益于enjoy的精巧强大,

方案一:

1: layout 文件中不使用 #define layout() , 而是直接写 html , 例如:

   <html>

      ….

     #@main()

   </html>

2: 主页面中直接  #define main()

   #render( 动态 layout 文件名 )

   #define main()

     …

   #end

方案二:

第二种办法是为 render 指令传入函数名, 或者约定一个函数名, 改为在子模板中调用,例如:

子模板.html 

#define layout()

    ….

    #@main()

#end

#@layout()

父模板:

#render( 子模板.html )

#define main()

 …

#end

相当于是将 #@layout 挪到子模板中去调用

如果函数名是动态的,也可以这样:

子模板.html 

#define layout()

    ….

    #@main()

#end

#call(funcName)

父模板:

#render( 子模板.html ,  funcName = "layout")

#define main()

 …

#end

方案三:

最后一个办法,也是最蠢的办法:

#if (…)

#include(…)

#else if (…)

#include(…)

#else if (…)

#include(…)

#else if (…)

#include(…)

#end

#@layout()

用 if 分支,穷尽所有动态模板,然后在 #include 中使用 String 常量


以上都是波总提供的方案,从14年关注jfinal以来,波总一直非常热心的分享和解答各种问题。

真心觉得enjoy功能很少, 但组合起来是无比强大,极简设计一直是jfinal推崇的,深深的领教了。

评论区

JFinal

2020-03-01 22:25

通过扩展 #myRender 指令使用动态的 layout,这种用法在需要动态切换布局的项目中十分美妙

博主的分享十分简洁有力,方案多种多样,扩展指令的方式最为美妙,谢谢分享,点赞 + 收藏

jfinal4cyy

2020-03-08 15:21

做了个gui来演示这个问题
https://www.bilibili.com/video/av94139101

https://cloud.tencent.com/developer/article/1595351

JFinal

2020-03-08 16:32

@jfinal4cyy 输出、提取 才是最快、最有效的学习方式,超赞

SuperEric

2020-03-08 23:27

学习学习~~这个部分还真没仔细看过

JFinal

2020-03-09 00:13

@SuperEric enjoy 中的模板函数用法极度简单,你将其想象成 java 中的方法定义与方法调用就可以了

不需要任何学习成本,但可以实现的功能可以是千变万化的,例如可以很方便地实现传统模板引擎中的 layout 功能

要知道传统模板引擎中实现 layout 功能要学习、折腾几个新的概念:nested、macro、layout 等等

SuperEric

2020-03-09 00:58

@JFinal 感谢 ~上午就开始动手写个功能。