methodbindingfactory.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.application;

import javax.faces.application.Application;
import javax.faces.el.MethodBinding;
import javax.faces.el.ValueBinding;

/**
 * <strong>Factory</strong> for creating {@link MethodBinding}s and
 * {@link ValueBinding}s. Used by {@link ApplicationImpl}.
 * 
 * @author Andreas Kuhrwahl
 * 
 */
public interface MethodBindingFactory {

    /**
     * Instantiate and return a new {@link MethodBinding} for the specified
     * method binding expression, which may be used to call the corresponding
     * method later.
     * 
     * @param application
     *            the <strong>original</strong> Application of the underlying
     *            JSF implementation
     * @param ref
     *            Method binding expression for which to return a
     *            {@link MethodBinding} instance
     * @param params
     *            Parameter signatures that must be compatible with those of the
     *            method to be invoked, or a zero-length array or
     *            <code>null</code> for a method that takes no parameters
     * @return the created MethodBinding
     * @exception NullPointerException
     *                if <code>ref</code> is <code>null</code>
     * @exception javax.faces.el.ReferenceSyntaxException
     *                if the specified <code>ref</code> has invalid syntax
     */
    MethodBinding createMethodBinding(Application application, String ref,
            Class[] params);

    /**
     * Instantiate and return a new {@link ValueBinding} for the specified value
     * binding expression, which may be used to manipulate the corresponding
     * property value later.
     * 
     * @param application
     *            the <strong>original</strong> Application of the underlying
     *            JSF implementation
     * @param ref
     *            Value binding expression for which to return a
     *            {@link ValueBinding} instance
     * @return the created ValueBinding
     * @exception NullPointerException
     *                if <code>ref</code> is <code>null</code>
     * @exception javax.faces.el.ReferenceSyntaxException
     *                if the specified <code>ref</code> has invalid syntax
     */
    ValueBinding createValueBinding(Application application, String ref);

}