aboutsummaryrefslogtreecommitdiffstats
path: root/src/com/itmill/toolkit/ui/FieldFactory.java
blob: fb71c4c38e7473607de4aa7ae7eddb2772f7c844 (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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/* *************************************************************************
 
 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.pdf. Use of this product might 
 require purchasing a commercial license from IT Mill Ltd. For guidelines 
 on usage, see 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 a 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 a 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 a field based on the item and property id.
	 * 
	 * @param item
	 *            the item where the property belongs to.
	 * @param propertyId
	 *            the 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 a field based on the container item id and property id.
	 * 
	 * @param container
	 *            the Container where the property belongs to.
	 * @param itemId
	 *            the item Id.
	 * @param propertyId
	 *            the 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);

}