aboutsummaryrefslogtreecommitdiffstats
path: root/src/com/itmill/toolkit/ui/FieldFactory.java
blob: f5133f9cac7196f2cb21fe1a9895a84dd405d086 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
/* *************************************************************************
 
                               IT Mill Toolkit 

               Development of Browser User Interfaces Made Easy

                    Copyright (C) 2000-2006 IT Mill Ltd
                     
   *************************************************************************

   This product is distributed under commercial license that can be found
   from the product package on license/license.txt. Use of this product might 
   require purchasing a commercial license from IT Mill Ltd. For guidelines 
   on usage, see license/licensing-guidelines.html

   *************************************************************************
   
   For more information, contact:
   
   IT Mill Ltd                           phone: +358 2 4802 7180
   Ruukinkatu 2-4                        fax:   +358 2 4802 7181
   20540, Turku                          email:  info@itmill.com
   Finland                               company www: www.itmill.com
   
   Primary source for information and releases: www.itmill.com

   ********************************************************************** */

package com.itmill.toolkit.ui;

import com.itmill.toolkit.data.Container;
import com.itmill.toolkit.data.Item;
import com.itmill.toolkit.data.Property;

/** Factory for creating new Field-instances based on type,
 *  datasource and/or context.
 *
 * @author IT Mill Ltd.
 * @version  @VERSION@
 * @since 3.1
 */
public interface FieldFactory {


	/** Creates field based on type of data.
	 *
	 *
	 * @param type The type of data presented in field
	 * @param uiContext The component where the field is presented.
	 * @return Field The field suitable for editing the specified data.
	 *	 
	 */
	Field createField(Class type, Component uiContext);
	
	/** Creates field based on the property datasource.
	 *
	 * @param property The property datasource.
	 * @param uiContext The component where the field is presented.
	 * @return Field The field suitable for editing the specified data.
	 */
	Field createField(Property property, Component uiContext);

	/** Creates field based on the item and property id.
	 * 
	 * @param item The item where the property belongs to.
	 * @param propertyId Id of the property.
	 * @param uiContext The component where the field is presented.
	 * @return Field The field suitable for editing the specified data.
	 */
	Field createField(Item item, Object propertyId, Component uiContext);

	/** Creates field based on the container item id and property id.
	 *
	 * @param container Container where the property belongs to.
	 * @param itemId The item Id.
	 * @param propertyId Id of the property.
	 * @param uiContext The component where the field is presented.
	 * @return Field The field suitable for editing the specified data.
	 */
	Field createField(Container container, Object itemId, Object propertyId, Component uiContext);

}