Basics

Note:

本部分使用 DOM 树和在上一章中创建的变量。

使用强制性 XML 处理方法(如上一章所示)，您可以编写一个 FTL 程序，该程序遍历树以查找不同种类的节点。使用声明性方法，您可以定义如何处理不同类型的节点，然后让 FreeMarker 遍历树并调用您已定义的处理程序。这种方法对于复杂的 XML 模式非常有用，在复杂的 XML 模式中，同一元素可能与许多其他元素的子元素一样出现。这种模式的示例是 XHTML 和 XDocBook。

声明性方法中最常使用的指令是recurse directive。该指令将节点变量作为参数，并从第一个孩子开始一个接一个地“访问”其所有子节点。 “访问”节点意味着它调用一个用户定义的指令(如宏)，该指令与子节点的名称(?node_name)具有相同的名称。我们在此说，用户定义的指令“处理”节点。用户定义指令刚处理的节点可以作为特殊变量.node来使用。例如，此 FTL：

<#recurse doc>

<#macro book>
  I'm the book element handler, and the title is: ${.node.title}
</#macro>

将打印(我从输出中删除了一些令人烦恼的空白)：

I'm the book element handler, and the title is: Test Book

如果调用不带参数的recurse，则它使用.node，即，它访问当前已处理节点的所有子节点。所以这个 FTL：

<#recurse doc>

<#macro book>
  Book element with title ${.node.title}
    <#recurse>
  End book
</#macro>

<#macro title>
  Title element
</#macro>

<#macro chapter>
  Chapter element with title: ${.node.title}
</#macro>

将打印(我从输出中删除了令人烦恼的空白)：

Book element with title Test Book
Title element
Chapter element with title: Ch1
Chapter element with title: Ch2
End book

您已经看到了如何为元素节点定义处理程序，但没有看到如何为文本节点定义处理程序。由于处理程序的名称与其处理的节点的节点名称相同，并且所有文本节点的节点名称均为@text(请参见the table)，因此您可以为文本节点定义处理程序，如下所示：

<#macro @text>${.node?html}</#macro>

请注意?html。由于生成 HTML 格式的输出，因此必须 HTML 换码文本。

这是将 XML 转换为完整 HTML 的模板：

<#recurse doc>

<#macro book>
  <html>
    <head>
      <title><#recurse .node.title></title>
    </head>
    <body>
      <h1><#recurse .node.title></h1>
      <#recurse>
    </body>
  </html>
</#macro>

<#macro chapter>
  <h2><#recurse .node.title></h2>
  <#recurse>
</#macro>

<#macro para>
  <p><#recurse>
</#macro>

<#macro title>
  <#--
    We have handled this element imperatively,
    so we do nothing here.
  -->
</#macro>

<#macro @text>${.node?html}</#macro>

输出将是(现在我将诚实地包含烦人的空白...)：

<html>
    <head>
      <title>Test Book</title>
    </head>
    <body>
      <h1>Test Book</h1>

    <h2>Ch1</h2>

      <p>p1.1

      <p>p1.2

      <p>p1.3

    <h2>Ch2</h2>

      <p>p2.1

      <p>p2.2

    </body>
  </html>

请注意，您可以使用_作为<#t>来减少输出中多余的空白量。另请参阅：模板作者指南/其他/空白处理

您可能会说，使用命令式方法进行操作的 FTL 要短得多。没错，但是示例 XML 使用的是非常简单的模式，正如我所说的，声明性方法将其形式带入 XML 模式，这种模式对在哪里出现什么元素不太确定。例如，介绍元素mark，该元素应将文本颜色更改为红色，而不在您使用的位置进行匹配；在title或para中。为此，使用声明性方法，您只需添加一个宏：

<#macro mark><font color=red><#recurse></font></#macro>

然后<mark>...</mark>将自动在任何地方工作。因此，对于某些 XML 模式，声明性 XML 处理实际上将比命令性 XML 处理更短，更重要的是，FTL 更清晰。由您决定何时使用哪种方法。不要忘记，您可以自由地混合使用这两种方法。假设在元素处理程序中，您可以使用命令式方法来处理该元素的内容。

Docs

Docs4dev

Title here

Basics