6.5 注释

JFinal Template Engine支持单行与多行注释,以下是代码示例:

  1. ### 这里是单行注释
  2.  
  3. #--
  4. 这里是多行注释的第一行
  5. 这里是多行注释的第二行
  6. --#

如上所示,单行注释使用三个#字符,多行注释以#—打头,以—#结尾。

与传统模板引擎不同,这里的单行注释采用三个字符,主要是为了减少与文本内容相冲突的可能性,模板是极其自由化的内容,使用三个字符,冲突的概率降低一个数量级。

jfinal 4.4 之前的版本注意:注释在与指令放在同一行时,输出结果会删掉注释后方的换行字符,例如:

  1. #("AAA") ### 这里是注释
  2. BBB

以上模板的输出结果是:"AAABBB",如果希望输出结果严格遵守模板中的换行,只需将注释单独放在一行,例如:

  1. ### 这里是注释,被单独放在了一行
  2. #("AAA")
  3. BBB

以上模板的输出结果将会带有严格的换行,结果如下:

  1. AAA
  2. BBB

多行注释与单行注释也类似,只需将其单独放即可。

除了以上情况以外,其它任何情况都是严格按模板换行输出的,不必关注。jfinal 4.4 版本解决了此问题,建议升级到 4.4 或更高版本