001    // Copyright 2006 The Apache Software Foundation
002    //
003    // Licensed under the Apache License, Version 2.0 (the "License");
004    // you may not use this file except in compliance with the License.
005    // You may obtain a copy of the License at
006    //
007    //     http://www.apache.org/licenses/LICENSE-2.0
008    //
009    // Unless required by applicable law or agreed to in writing, software
010    // distributed under the License is distributed on an "AS IS" BASIS,
011    // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012    // See the License for the specific language governing permissions and
013    // limitations under the License.
014    
015    package org.apache.tapestry.form;
016    
017    import org.apache.tapestry.IForm;
018    import org.apache.tapestry.IMarkupWriter;
019    import org.apache.tapestry.IRequestCycle;
020    
021    /**
022     * Interface for factories that can generate {@link FormSupport} 
023     * objects.
024     *
025     * @since 4.1.1
026     */
027    public interface FormSupportFactory 
028    {
029        
030        /**
031         * Invoked every time an {@link IForm} is rendering in order to obtain a 
032         * {@link FormSupport} instance to support and manage the process.
033         * <p/>
034         */ 
035        FormSupport createFormSupport(IMarkupWriter writer, IRequestCycle cycle, IForm form);
036    }