覆盖 ui:insert 和 ui:include-Handler

Question

有manyothertopics关于如何覆盖JSF中现有的渲染器。所有这些都导致 faces-config 中的相同条目。你“只”需要一个component-family、renderer-type、render-kit-id 和你在renderer-class 中的实现

我理解并且可以重现所有这些示例，但在我的具体情况下，我想覆盖 <ui:include> 和 <ui:insert> 的行为。遗憾的是，我不知道我必须在上面提到的属性中输入哪些值，因为文件 ui:taglib.xml 不像其他标记库那样冗长。

你知道如何覆盖它们吗？

编辑： BalusC 提到了another topic，它使用自定义标签，如<my:include> 或<my:insert>，但我不想使用这些。如果这样做，我必须重构所有现有代码，如果不使用我的自定义 taglib，我未来的代码将无法工作。

我想在渲染<ui:include> 和<ui:insert> 之前进行挂钩，这样我就可以重用我即将开发的插件而不更改任何现有代码。

Answer 1

...无需更改任何现有代码

你不能。至少，并非没有与特定实现（Mojarra 或 MyFaces）紧密耦合。另一种方法是硬着头皮将所有<ui:include> 和<ui:define> 替换为<my:include> 和<my:define>。 Facelets 尚未完全抽象/标准化为 JSF 规范。只有Facelet cache factory，但没有 Facelet 上下文工厂，否则会很容易。通常，忘记以抽象方式自定义 <ui:xxx> 标签。你需要破解实现。

鉴于您使用的是 Mojarra 2.1.19，您需要将 copypaste 其 com.sun.faces.facelets.impl.DefaultFaceletContext 类添加到您的 Web 应用程序项目中，并维护其 com.sun.faces.facelets.impl 包。 WAR 中的类比 WAR 的 /WEB-INF/lib 和服务器的 /lib 中的类具有更高的类加载优先级。所以你的 WAR 中的这个将被使用。

鉴于您希望达到与Customize ui:include rendering to add prefix/postfix 在<ui:include> 和<ui:define> 中所要求的相同：

例如，假设一个空白文件.xhtml：

输入

<ui:include src="file.xhtml" />

输出

<!-- START file.xhtml -->
<!-- END file.xhtml -->

您可以通过编辑复制粘贴的DefaultFaceletContext 类来实现它：

1. 向创建注释组件的类添加一个辅助方法（它只是一个纯输出文本组件）。

   private static UIComponent createComment(String comment) {
       UIOutput text = new UIOutput();
       text.setValue("\n<!-- " + comment + " -->\n");
       return text;
   }
   

2. 在第 199 行扩展 oneliner 方法 includeFacelet(UIComponent, String) 如下：

   parent.getChildren().add(createComment("START INCLUDE " + relativePath));
   facelet.include(this, parent, relativePath);
   parent.getChildren().add(createComment("END INCLUDE " + relativePath));
   

3. 使用client.apply(this, parent, name) 将includeDefinition(UIComponent, String) 扩展到第366 行，如下所示：

   int start = parent.getChildCount();
   found = client.apply(this, parent, name);
   
   if (found) {
       parent.getChildren().add(start, createComment("START DEFINE " + name));
       parent.getChildren().add(createComment("END DEFINE " + name));
   }
   

在测试过程中，我发现了一个警告。我的 HTML <title> 模板如下：

<h:head>
    <title><ui:insert name="title">#{view.viewId}</ui:insert></title>
</h:head>

因此，评论也会出现在 <title> 元素中。不幸的是，HTML 标题中的 cmets 是 invalid 语法（仅允许 PCDATA），它们被逐字解释，因此显示在文档标题中。您可能希望根据定义的name 或parent 创建一个黑名单。