Tutoriel sur les Composite-Components de JSF2

public abstract class AbstractForeignKeyComponent extends UIInput implements NamingContainer
{
    public final Logger logger = Logger.getLogger(getClass().getSimpleName());
    protected UIInput key;
    protected UIOutput lbl;

    /*
     * ----- getter / setter à placer ici
     */

    public abstract void formatValue();
    public abstract void updateValue(AjaxBehaviorEvent event);


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

    /**
     * Début de l'encodage du composant
     */
    @Override
    public void encodeBegin(FacesContext facesContext) throws IOException
    {
        logger.log(Level.FINEST, "encodeBegin(FacesContext)");
        formatValue();
        super.encodeBegin(facesContext);
    }


    /**
     * Envoyer un message d'application
     * @param target
     * @param message
     */
    public void sendFacesMessage(String target, FacesMessage message)
    {
        if (message != null)
        {
            FacesContext facesContext = FacesContext.getCurrentInstance();
            facesContext.getExternalContext().getFlash().setKeepMessages(true);
            facesContext.addMessage(target, message);
        }
    }

    /**
     * Validation (si nécessaire)
     */
    @Override
    public void validate(FacesContext facesContext)
    {
        logger.log(Level.FINEST, "validate(FacesContext)");

        /*
         * On traite tous les validators enregistrés
         */
        for (Validator validator : getValidators())
        {
            try
            {
                validator.validate(facesContext, this, getValue());
            }
            catch (ValidatorException e)
            {
                invalidValue();
                sendFacesMessage(null, e.getFacesMessage());
            }
        }
    }

    /**
     * Valeur incorrecte
     */
    public void invalidValue()
    {
        logger.log(Level.FINEST, "invalidValue()");
        if (getKey().getValue() != null)
        {
            setValid(false);
            key.setValid(false);
        }
    }
}

/**
 * Composant : Clé externe
 * @author Olivier BUTTERLIN
 */
@FacesComponent("foreignKeyConstrComponent")
public class ForeignKeyConstrComponent extends AbstractForeignKeyComponent
{

    /**
     * La valeur change, mise à jour des composants
     * @param event
     */
    public void updateValue(AjaxBehaviorEvent event)
    {
        try
        {
            logger.log(Level.FINEST, "updateValue(AjaxBehaviorEvent) ");
            if (event instanceof SelectEvent)
            {
                Constr constr = (Constr) ((SelectEvent) event).getObject();
                setValue(constr);
                RequestContext.getCurrentInstance().execute("callChangeFunction('" + key.getClientId() + "')");
            }
            else
            {
                if (key.getValue() != null && key.getValue().toString().trim().length() > 0)
                {
                    String keyValue = (String) key.getValue();
                    Constr constr = FKComponentEJBLocator.getInstance().getConstrFacadeLocal().getConstrParCode(keyValue);
                    setValue(constr);
                }
                else
                {
                    super.setValue(null);
                    updateModel(FacesContext.getCurrentInstance());
                    formatValue();
                }
            }
        }
        catch (Exception e)
        {
            logger.log(Level.SEVERE, e.toString());
        }
    }


    /**
     * Formattage de la valeur
     */
    public void formatValue()
    {
        Constr constr = null;
        if (getValue() instanceof Constr)
        {
            constr = (Constr)getValue();
        }

        String label = "";
        if (constr != null)
        {
            key.setValue(constr.getCode());
            label = constr.getNom();
        }
        else
        {
            key.setValue(null);
        }

        lbl.setValue(label);
    }
}

<!-- Liste de sélection -->

    <p:dialog id="selectConstrDialog" widgetVar="selectConstrListWidget#{cc.clientId}"                             dynamic="true" rendered="#{cc.attrs.readOnly == false}" 
                    header="Selection d'un constructeur">
        <p:panelGrid>
            <p:row>
                <p:column>
                    <h:outputText value="Code"/>
                </p:column>
                <p:column>
                    <p:inputText value="#{foreignKeyConstrDataModel.filtreCode}" style="width:100px"/>
                </p:column>
                <p:column>
                    <h:outputText value="Nom"/>
                </p:column>
                <p:column>
                    <p:inputText value="#{foreignKeyConstrDataModel.filtreNom}" style="width:300px"/>
                </p:column>
            </p:row>

            <p:row>
                <p:column>
                    <h:outputText value="Code postal"/>
                </p:column>
                <p:column>
                    <p:inputText value="#{foreignKeyConstrDataModel.filtreCp}" style="width:100px"/>
                </p:column>
                <p:column>
                    <h:outputText value="Ville"/>
                </p:column>
                <p:column>
                    <p:inputText value="#{foreignKeyConstrDataModel.filtreVille}" style="width:300px"/>
                </p:column>
            </p:row>

            <p:row>
                <p:column colspan="2">
                    <p:commandButton value="Rechercher" action="#{foreignKeyConstrDataModel.loadData()}"                                 update="selectConstrList" />
                </p:column>
            </p:row>
        </p:panelGrid>


            <p:dataTable var="item" id="selectConstrList"
                             value="#{foreignKeyConstrDataModel.list}"
                            style="width:700px;padding-top:10px" 
                            rowKey="#{item.code}"
                            emptyMessage="Aucun enregistrement" 
                            paginator="true" 
                            rows="10"
                            selectionMode="single">

            <p:ajax event="rowSelect" listener="#{cc.updateValue}" 
                            update=":#{cc.clientId}:key :#{cc.clientId}:btn :#{cc.clientId}:txt" oncomplete="PF('selectConstrListWidget#{cc.clientId}').hide()"/>

            <p:column headerText="Code" width="80">
                <h:outputText value="#{item.code}"/>
            </p:column>

            <p:column headerText="Nom">
                <h:outputText value="#{item.nom}"/>
            </p:column>

            <p:column headerText="CP">
                <h:outputText value="#{item.cp}" width="100"/>
            </p:column>

            <p:column headerText="Ville">
                <h:outputText value="#{item.ville}" />
            </p:column>
        </p:dataTable>
    </p:dialog>