用于MultilingualString对象的JSF复合组件

Question

我正在编写一个需要国际化的JSF应用程序。 为此，我创建了一个MultilingualString：

public class MultilingualString {
    /* The Language class is basically a wrapper for a java.util.Locale */
    private Map<Language, String> strings;

    /* business methods, getters, setters */
}

现在，有多种形式需要填充MultilingualString，并且每次我需要将这样的对象放入表单中时都重复ac：forEach循环是非常丑陋的。 所以我听说了JSF Composite Components，为此我尝试编写一个。

这是我的inputMultilingualString.xhtml：

<ui:component xmlns:h="http://xmlns.jcp.org/jsf/html"
              xmlns:composite="http://xmlns.jcp.org/jsf/composite"
              xmlns:f="http://xmlns.jcp.org/jsf/core"
              xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
    <composite:interface componentType="inputMultilingualString">
        <composite:attribute name="value" required="true"
                             type="com.tob.entities.internationalization.MultilingualString"/>
        <composite:attribute name="languages" type="java.util.List" default="#{null}"/>
    </composite:interface>

    <composite:implementation>
        <f:event type="preRenderComponent" listener="#{cc.init}"/>
        <h:dataTable id="#{cc.clientId}" value="#{cc.languages}" var="language">
            <h:column>
                <h:outputLabel value="#{language}"/>
            </h:column>
            <h:column>
                <h:inputText binding="#{cc.inputs[language]}"/>
            </h:column>
        </h:dataTable>
    </composite:implementation>
</ui:component>

因此，我希望value属性是MultilingualString的实例，而languages属性是Language List的实例。 如果语言属性为null，则我希望复合组件在dataTable中为MultilingualString中包含的映射中的每个条目显示一行。

现在这是InputMultilingualString.java中的“支持组件”：

@FacesComponent(value = "inputMultilingualString", createTag = true)
public class InputMultilingualString extends UIInput implements NamingContainer {

    private final Map<Language, UIInput> inputs = new HashMap();
    private List<Language> languages;

    @Override
    public String getFamily() {
        return (UINamingContainer.COMPONENT_FAMILY);
    }

    public void init() {
        List<Language> ls = (List<Language>) this.getAttributes().get("languages");
        MultilingualString ms = (MultilingualString) this.getValue();

        /* Setting languages */
        if (ls != null) {
            this.setLanguages(ls);
        } else {
            this.languages = new ArrayList();
            this.languages.addAll(ms.getStrings().keySet());
        }

        /* Initializing inputs */
        UIInput tmp;
        for (Language l : this.languages) {
            tmp = new UIInput();
            tmp.setValue(ms.getString(l));//
            this.inputs.put(l, tmp);
        }
    }

    @Override
    public String getSubmittedValue() {
        String ret = new String();

        for (Map.Entry<Language, UIInput> entry : this.inputs.entrySet()) {
            if (entry.getValue() != null) {
                if (!ret.isEmpty()) {
                    ret += ',';
                }
                ret += entry.getKey().getLanguageTag(); // NullPointerException here when the form is submitted
                ret += "=" + entry.getValue().getSubmittedValue();
            }
        }
        return (ret);
    }

    @Override
    protected Object getConvertedValue(FacesContext context, Object submittedValue) {
        MultilingualString ms = (MultilingualString) this.getValue();
        String[] entries = ((String) submittedValue).split(",");
        String[] pair;
        Language language;

        for (String entry : entries) {
            pair = entry.split("=");
            language = new Language();
            language.setLanguageTag(pair[0]);
            ms.addString(language, pair[1]);
        }
        return (ms);
    }

    public List<Language> getLanguages() {
        return (this.languages);
    }

    public void setLanguages(List<Language> languages) {
        this.languages = languages;
    }

    public Map<Language, UIInput> getInputs() {
        return (this.inputs);
    }
}

为了实现我要显示输入的语言的规则，我向支持组件添加了languages属性，并在调用preRenderComponent事件的init方法中对其进行了初始化。 语言列表已正确初始化。

这是我使用复合组件的方式：

<ui:composition template="/Templates/Common.xhtml"
                xmlns="http://www.w3.org/1999/xhtml"
                xmlns:h="http://xmlns.jcp.org/jsf/html"
                xmlns:ui="http://xmlns.jcp.org/jsf/facelets"
                xmlns:tob="http://xmlns.jcp.org/jsf/composite/components"
                xmlns:p="http://primefaces.org/ui">
    <ui:define name="content">
        <h:form id="testForm">
            <tob:inputMultilingualString value="#{testBean.ms}" languages="#{testBean.languages}"/>
            <!-- The testBean.ms contains :
                     [English]  => string-English
                     [français] => string-français
                     [русский]  => string-русский

                 And the testBean.languages contains a list of Language objects for English, French, and Russian -->
            <p:commandButton value="Submit" action="#{testBean.submit()}"/>
        </h:form>
    </ui:define>
</ui:composition>

问题是：

• 如果作为值输入的MultilingualString已经包含一些字符串，则它们不会像在您填充inputText值属性时那样显示在inputText中（我阅读了BalusC上有关该主题的文章，他不需要填充value属性使他的下拉列表具有正确的值）。 我在stackoverflow上的某个地方阅读了BalusC的答案，即如果将输入文本的绑定属性中引用的UIInput评估为null，则会创建UIInput，这就是为什么我尝试在init方法中对其进行初始化的原因，但是到目前为止还算运气。
• 提交表单时，在getSubmittedValue（）方法的getKey（）调用中获得了NullPointerException。 那怎么可能呢？

我希望这很清楚，希望有人能帮助我！ 谢谢 ！

编辑：我正在使用GlassFish 4，我手动将Mojarra更新为2.2.6

Answer 1

到目前为止，发布的代码中存在2个技术问题：

1. 您正在对仅在视图渲染期间可用的变量使用binding 。 binding属性在视图构建时运行，而不在视图渲染时运行。 在这种特定情况下，当执行binding时， #{language}为null 。 另请参见“绑定”属性在JSF中如何工作？ 什么时候以及如何使用？ 。 您似乎还希望会生成多个<h:inputText>组件，但这不是事实。 在渲染视图期间，只有一个可以重复使用多次。 仅当使用<c:forEach>而不是<h:dataTable> ，实际上才会生成多个<h:inputText>组件。 另请参见JSF2 Facelets中的JSTL ...有意义吗？

2. 您没有为回发保存组件的状态。 您应该删除languages属性，并将getter和setter委托给getStateHelper() 。 另请参见扩展UIComponentBase时如何保存状态 。

但是，整体方法笨拙。 您不需要支持组件即可满足功能需求。 只需将List<Languages> getter添加到MultilingualString并将其直接用作languages属性的default 。

因此，如果将其添加到MultilingualString ：

public List<Language> getLanguages() {
    return new ArrayList<>(strings.keySet());
}

然后只需通过#{cc.attrs}引用#{cc.attrs} ：

<cc:interface>
    <cc:attribute name="value" required="true" type="com.tob.entities.internationalization.MultilingualString"/>
    <cc:attribute name="languages" type="java.util.List" default="#{cc.attrs.value.languages}" />
</cc:interface>

<cc:implementation>
    <h:dataTable value="#{cc.attrs.languages}" var="language">
        <h:column>
            <h:outputLabel value="#{language}"/>
        </h:column>
        <h:column>
            <h:inputText value="#{cc.attrs.value.strings[language]}" />
        </h:column>
    </h:dataTable>
</cc:implementation>

然后，它应按预期工作。 请注意，可以使用大括号符号[]来引用动态映射键。 那可能就是解决方案的全部关键（您似乎不知道这一点，因此正在努力开发过于复杂的解决方案）。