001    /*
002     * Copyright 2002-2004 the original author or authors.
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not
005     * use this file except in compliance with the License. You may obtain a copy of
006     * the License at
007     *
008     * http://www.apache.org/licenses/LICENSE-2.0
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
012     * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
013     * License for the specific language governing permissions and limitations under
014     * the License.
015     */
016    package org.springframework.richclient.form.binding;
017    
018    import java.util.Map;
019    
020    import javax.swing.JComponent;
021    
022    import org.springframework.binding.form.FormModel;
023    
024    /**
025     * A BindingFactory creates bindings for a specific FormModel. 
026     * 
027     * @author Oliver Hutchison
028     */
029    public interface BindingFactory {
030    
031        /**
032         * Returns the form model that contains the properties being bound.
033         */
034        FormModel getFormModel();
035    
036        /**
037         * Returns a binding for the provided formPropertyPath.  
038         */
039        Binding createBinding(String formPropertyPath);
040        
041        /**
042         * Returns a binding for the provided formPropertyPath.  
043         */
044        Binding createBinding(String formPropertyPath, Map context);
045    
046        /**
047         * Returns a binding to a control of type controlType for the provided formPropertyPath 
048         */
049        Binding createBinding(Class controlType, String formPropertyPath);
050        
051        /**
052         * Returns a binding to a control of type controlType for the provided formPropertyPath 
053         */
054        Binding createBinding(Class controlType, String formPropertyPath, Map context);    
055    
056        /**
057         * Returns a binding between the provided control and the provided formPropertyPath 
058         */
059        Binding bindControl(JComponent control, String formPropertyPath);
060        
061        /**
062         * Returns a binding between the provided control and the provided formPropertyPath 
063         */
064        Binding bindControl(JComponent control, String formPropertyPath, Map context);
065    }