htmlsimpleoutcomeactionsourcecomponenthandler.java

Please read your package and describe it at least 40 bytes in English. System will automatically de

/*
 * Copyright 2002-2004 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package de.mindmatters.faces.taglib.facelets;

import javax.faces.component.ActionSource;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import javax.faces.el.ValueBinding;

import org.springframework.util.Assert;

import com.sun.facelets.FaceletContext;
import com.sun.facelets.tag.MetaRuleset;
import com.sun.facelets.tag.TagAttribute;
import com.sun.facelets.tag.jsf.ComponentConfig;
import com.sun.facelets.tag.jsf.html.HtmlComponentHandler;

import de.mindmatters.faces.el.ConstantMethodBinding;

/**
 * <strong>HtmlSimpleOutcomeActionSourceComponentHandler</strong> is a
 * TagHandler for {@link ActionSource} components .
 * 
 * @author Andreas Kuhrwahl
 * @see ActionSource
 * 
 */
public class HtmlSimpleOutcomeActionSourceComponentHandler extends
        HtmlComponentHandler {

    /** The action attribute. */
    private final TagAttribute action;

    /**
     * Default facelet constructor.
     * 
     * @param config
     *            The component configuration
     */
    public HtmlSimpleOutcomeActionSourceComponentHandler(
            final ComponentConfig config) {
        super(config);
        this.action = getAttribute("action");
    }

    /**
     * {@inheritDoc}
     */
    protected MetaRuleset createMetaRuleset(final Class type) {
        return super.createMetaRuleset(type).ignore("action");
    }

    /**
     * {@inheritDoc}
     */
    protected void setAttributes(final FaceletContext ctx, final Object instance) {
        Assert.isInstanceOf(ActionSource.class, instance);
        if (this.action != null) {
            setActionProperty(ctx, (ActionSource) instance, this.action);
        }
        super.setAttributes(ctx, instance);
    }

    /**
     * Sets the action property on the associated {@link ActionSource}
     * actionSource.
     * 
     * @param ctx
     *            the {@link FaceletContext}
     * @param actionSource
     *            the {@link ActionSource}
     * @param actionAttribute
     *            the action {@link TagAttribute}
     */
    protected void setActionProperty(final FaceletContext ctx,
            final ActionSource actionSource, final TagAttribute actionAttribute) {
        if (this.action.isLiteral()) {
            actionSource.setAction(new ConstantMethodBinding(this.action
                    .getValue()));
        } else {
            FacesContext facesContext = ctx.getFacesContext();
            ValueBinding vb = facesContext.getApplication().createValueBinding(
                    this.action.getValue());
            if (vb.getType(facesContext).equals(String.class)) {
                ((UIComponent) actionSource).setValueBinding("action", vb);
            } else {
                throw new IllegalArgumentException(
                        "Only plain string outcomes are allowed for this action attribute");
            }
        }
    }

}