View Javadoc

1   /***
2    * Copyright (C) 2006 Philipp Mpalampanis
3    *
4    * License: MPL 1.1/GPL 2.0/LGPL 2.1
5    *
6    * The contents of this file are subject to the Mozilla Public License Version
7    * 1.1 (the "License"); you may not use this file except in compliance with
8    * the License. You may obtain a copy of the License at
9    * http://www.mozilla.org/MPL/
10   *
11   * Software distributed under the License is distributed on an "AS IS" basis,
12   * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
13   * for the specific language governing rights and limitations under the
14   * License.
15   *
16   * Alternatively, the contents of this file may be used under the terms of
17   * either the GNU General Public License Version 2 or later (the "GPL"), or
18   * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
19   * in which case the provisions of the GPL or the LGPL are applicable instead
20   * of those above. If you wish to allow use of your version of this file only
21   * under the terms of either the GPL or the LGPL, and not to allow others to
22   * use your version of this file under the terms of the MPL, indicate your
23   * decision by deleting the provisions above and replace them with the notice
24   * and other provisions required by the GPL or the LGPL. If you do not delete
25   * the provisions above, a recipient may use your version of this file under
26   * the terms of any one of the MPL, the GPL or the LGPL.
27   */
28  package net.sf.echobinding.model;
29  
30  import net.sf.echobinding.BoundControl;
31  import net.sf.echobinding.binding.BindingContext;
32  
33  /***
34   *
35   * @see net.sf.echobinding.binding.BindingContext
36   */
37  public interface PresentationModel {
38  
39  	/***
40  	 * Returns the bound control for the given id.
41  	 * 
42  	 * @param id the adapter id
43  	 * @return the bound control
44  	 */
45  	BoundControl getControl(String id);
46  
47  	/***
48  	 * Returns the BindingContext for the presentation model.
49  	 * @return the BindingContext
50  	 */
51  	BindingContext getContext();
52  	
53  	/***
54  	 * Set the <code>BindingContext</code> for this presenation model.
55  	 * @param context
56  	 */
57  	void setContext(BindingContext context);
58  	
59  	/***
60  	 * Configures the presenatation model. Here should go all the event handling.
61  	 *
62  	 */
63  	void configure();
64  	
65  	/***
66  	 * Configures (@see congigure()) the presentation model and initialzes all it's components (widgets).
67  	 *
68  	 */
69  	void init();
70  	
71  	/***
72  	 * 
73  	 * @return a cloned instance 
74  	 */
75  	PresentationModel cloneInstance();
76  }