jakarta.faces.view.facelets.BehaviorHandler Maven / Gradle / Ivy

/*
 * Copyright (c) 1997, 2020 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package jakarta.faces.view.facelets;

import jakarta.faces.view.BehaviorHolderAttachedObjectHandler;

/**
 * 
 * The {@link FaceletHandler} that corresponds to attached objects that represent an instance of
 * {@link jakarta.faces.component.behavior.ClientBehavior} that must be added to the parent component, which must
 * implement {@link jakarta.faces.component.behavior.ClientBehaviorHolder}, with a call to
 * {@link jakarta.faces.component.behavior.ClientBehaviorHolder#addClientBehavior}. The current specification defines
 * one Facelet element for this sort of attached object, <f:ajax>.
 * 
 */

public class BehaviorHandler extends FaceletsAttachedObjectHandler implements BehaviorHolderAttachedObjectHandler {

    private final TagAttribute event;

    private String behaviorId;

    private TagHandlerDelegate helper;

    public BehaviorHandler(BehaviorConfig config) {
        super(config);
        behaviorId = config.getBehaviorId();
        event = getAttribute("event");
        if (null != event && !event.isLiteral()) {
            throw new TagException(tag, "The 'event' attribute for behavior tag must be a literal");
        }
    }

    public TagAttribute getEvent() {
        return event;
    }

    @Override
    public String getEventName() {
        if (null != getEvent()) {
            return getEvent().getValue();
        }
        return null;
    }

    @Override
    protected TagHandlerDelegate getTagHandlerDelegate() {
        if (null == helper) {
            helper = delegateFactory.createBehaviorHandlerDelegate(this);
        }
        return helper;
    }

    public String getBehaviorId() {
        return behaviorId;
    }

}