模板语言:Velocity 和 FreeMarker
最后修改时间:2023年9月5日IntelliJ IDEA 允许您在 Velocity (VTL) 和FreeMarker (FTL)中开发模板。
编码帮助和语法突出显示依赖于Apache Velocity和FreeMarker插件,这些插件默认在 IntelliJ IDEA 中打并补充。如果相关功能不可用,请确保您没有取消该插件。有关更多信息,请参阅打开插件设置。
笔记
Apache Velocity和FreeMarker插件仅在 IntelliJ IDEA Ultimate 中可用。
默认支持以下文件类型:
虚拟传输层 | .ft、.vm、.vsl |
超光速 | .ftl、.ftlh、.ftlx |
要为编写模板静态部分的语言(称为模板数据语言)启用编码辅助,请执行以下操作之一:
修复未解决的引用
IntelliJ IDEA 提供检查来检测模板语言中未解析的引用:
未解决的引用可以使用意图操作来修复。您可以在同一文件中添加注释,或创建包含注释的单独文件。想要了解更多信息,请参阅特别评论。
笔记
在这种情况下,注释提供了有关文献的文献信息。
在后一种情况下,将创建一个具有默认名称velocity_implicit.vm
或的文件。freemarker_implicit.ftl
该文件具有以下注释:
#* @implicitly included *#
注释文件中提供了用于定义引用类型的代码完成。
如果您重命名该文件或将其移动到源根目录中的其他位置,引用定义不会丢失。
特别评论
IntelliJ IDEA 为使用模板语言提供了以下特殊注释:
<#--
FreeMarker 注释使用和-->
或[#--
和分隔--#]
。
评论 | 描述 |
---|---|
| 本文的任何 FreeMarker 文件中的注释都包含在同一模块或依赖项中的所有文件中。使用这些专用注释文件来定义 IDE 特定的注释,这样它们就不会污染您的模板文件。 |
| 定义一个变量。例如,以下注释声明一个名为 <#-- @ftlvariable name="foo" type="java.lang.String" file="path/to/file" --> 为了正确解决 |
|
<#-- @ftlroot "path/to.jar!/path/inside/jar" --> |
#*
快速使用注释和分隔*#
。
评论 | 描述 |
---|---|
| Velocity文件中的任何参考注释都包含在相同模块中的所有文件中。使用这些专用注释文件来定义IDE特定的注释,这样它们就不会污染您的模板文件。 |
| 定义一个变量。例如,以下注释声明一个名为 #* @vtlvariable name="foo" type="java.lang.String" file="path/to/file" *# 为了正确解决 |
| 使用相对于带有此注释的文件的模板宏定义文件。例如,以下注释可 #* @vtlmacrolibrary 路径=“lib.vm” 文件=“file.vm” *# |
| 使用此注释定义速度.properties文件和相对于该文件的运行时根目录。例如: #* @velocityproperties path=“path/to/velocity.properties”runtime_root=“path/to/runtime/root/dir”*# |
感谢您的反馈意见!