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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
|
/*
* Copyright 2000-2014 Vaadin Ltd.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package com.vaadin.ui;
import java.util.Collections;
import java.util.Iterator;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;
import com.vaadin.server.ComponentSizeValidator;
import com.vaadin.server.VaadinService;
import com.vaadin.server.VaadinSession;
import com.vaadin.ui.declarative.DesignContext;
import com.vaadin.ui.declarative.DesignException;
/**
* Abstract base class for component containers that have only one child
* component.
*
* For component containers that support multiple children, inherit
* {@link AbstractComponentContainer} instead of this class.
*
* @since 7.0
*/
public abstract class AbstractSingleComponentContainer extends
AbstractComponent implements SingleComponentContainer {
private Component content;
@Override
public int getComponentCount() {
return (content != null) ? 1 : 0;
}
@Override
public Iterator<Component> iterator() {
if (content != null) {
return Collections.singletonList(content).iterator();
} else {
return Collections.<Component> emptyList().iterator();
}
}
/* documented in interface */
@Override
public void addComponentAttachListener(ComponentAttachListener listener) {
addListener(ComponentAttachEvent.class, listener,
ComponentAttachListener.attachMethod);
}
/* documented in interface */
@Override
public void removeComponentAttachListener(ComponentAttachListener listener) {
removeListener(ComponentAttachEvent.class, listener,
ComponentAttachListener.attachMethod);
}
/* documented in interface */
@Override
public void addComponentDetachListener(ComponentDetachListener listener) {
addListener(ComponentDetachEvent.class, listener,
ComponentDetachListener.detachMethod);
}
/* documented in interface */
@Override
public void removeComponentDetachListener(ComponentDetachListener listener) {
removeListener(ComponentDetachEvent.class, listener,
ComponentDetachListener.detachMethod);
}
/**
* Fires the component attached event. This is called by the
* {@link #setContent(Component)} method after the component has been set as
* the content.
*
* @param component
* the component that has been added to this container.
*/
protected void fireComponentAttachEvent(Component component) {
fireEvent(new ComponentAttachEvent(this, component));
}
/**
* Fires the component detached event. This is called by the
* {@link #setContent(Component)} method after the content component has
* been replaced by other content.
*
* @param component
* the component that has been removed from this container.
*/
protected void fireComponentDetachEvent(Component component) {
fireEvent(new ComponentDetachEvent(this, component));
}
@Override
public Component getContent() {
return content;
}
/**
* Sets the content of this container. The content is a component that
* serves as the outermost item of the visual contents.
*
* The content must always be set, either with a constructor parameter or by
* calling this method.
*
* Previous versions of Vaadin used a {@link VerticalLayout} with margins
* enabled as the default content but that is no longer the case.
*
* @param content
* a component (typically a layout) to use as content
*/
@Override
public void setContent(Component content) {
// Make sure we're not adding the component inside it's own content
if (isOrHasAncestor(content)) {
throw new IllegalArgumentException(
"Component cannot be added inside it's own content");
}
Component oldContent = getContent();
if (oldContent == content) {
// do not set the same content twice
return;
}
if (oldContent != null && equals(oldContent.getParent())) {
oldContent.setParent(null);
fireComponentDetachEvent(oldContent);
}
this.content = content;
if (content != null) {
removeFromParent(content);
content.setParent(this);
fireComponentAttachEvent(content);
}
markAsDirty();
}
/**
* Utility method for removing a component from its parent (if possible).
*
* @param content
* component to remove
*/
// TODO move utility method elsewhere?
public static void removeFromParent(Component content)
throws IllegalArgumentException {
// Verify the appropriate session is locked
UI parentUI = content.getUI();
if (parentUI != null) {
VaadinSession parentSession = parentUI.getSession();
if (parentSession != null && !parentSession.hasLock()) {
String message = "Cannot remove from parent when the session is not locked.";
if (VaadinService.isOtherSessionLocked(parentSession)) {
message += " Furthermore, there is another locked session, indicating that the component might be about to be moved from one session to another.";
}
throw new IllegalStateException(message);
}
}
HasComponents parent = content.getParent();
if (parent instanceof ComponentContainer) {
// If the component already has a parent, try to remove it
ComponentContainer oldParent = (ComponentContainer) parent;
oldParent.removeComponent(content);
} else if (parent instanceof SingleComponentContainer) {
SingleComponentContainer oldParent = (SingleComponentContainer) parent;
if (oldParent.getContent() == content) {
oldParent.setContent(null);
}
} else if (parent != null) {
throw new IllegalArgumentException(
"Content is already attached to another parent");
}
}
// the setHeight()/setWidth() methods duplicated and simplified from
// AbstractComponentContainer
@Override
public void setWidth(float width, Unit unit) {
/*
* child tree repaints may be needed, due to our fall back support for
* invalid relative sizes
*/
boolean dirtyChild = false;
boolean childrenMayBecomeUndefined = false;
if (getWidth() == SIZE_UNDEFINED && width != SIZE_UNDEFINED) {
// children currently in invalid state may need repaint
dirtyChild = getInvalidSizedChild(false);
} else if ((width == SIZE_UNDEFINED && getWidth() != SIZE_UNDEFINED)
|| (unit == Unit.PERCENTAGE
&& getWidthUnits() != Unit.PERCENTAGE && !ComponentSizeValidator
.parentCanDefineWidth(this))) {
/*
* relative width children may get to invalid state if width becomes
* invalid. Width may also become invalid if units become percentage
* due to the fallback support
*/
childrenMayBecomeUndefined = true;
dirtyChild = getInvalidSizedChild(false);
}
super.setWidth(width, unit);
repaintChangedChildTree(dirtyChild, childrenMayBecomeUndefined, false);
}
private void repaintChangedChildTree(boolean invalidChild,
boolean childrenMayBecomeUndefined, boolean vertical) {
if (getContent() == null) {
return;
}
boolean needRepaint = false;
if (childrenMayBecomeUndefined) {
// if became invalid now
needRepaint = !invalidChild && getInvalidSizedChild(vertical);
} else if (invalidChild) {
// if not still invalid
needRepaint = !getInvalidSizedChild(vertical);
}
if (needRepaint) {
getContent().markAsDirtyRecursive();
}
}
private boolean getInvalidSizedChild(final boolean vertical) {
Component content = getContent();
if (content == null) {
return false;
}
if (vertical) {
return !ComponentSizeValidator.checkHeights(content);
} else {
return !ComponentSizeValidator.checkWidths(content);
}
}
@Override
public void setHeight(float height, Unit unit) {
/*
* child tree repaints may be needed, due to our fall back support for
* invalid relative sizes
*/
boolean dirtyChild = false;
boolean childrenMayBecomeUndefined = false;
if (getHeight() == SIZE_UNDEFINED && height != SIZE_UNDEFINED) {
// children currently in invalid state may need repaint
dirtyChild = getInvalidSizedChild(true);
} else if ((height == SIZE_UNDEFINED && getHeight() != SIZE_UNDEFINED)
|| (unit == Unit.PERCENTAGE
&& getHeightUnits() != Unit.PERCENTAGE && !ComponentSizeValidator
.parentCanDefineHeight(this))) {
/*
* relative height children may get to invalid state if height
* becomes invalid. Height may also become invalid if units become
* percentage due to the fallback support.
*/
childrenMayBecomeUndefined = true;
dirtyChild = getInvalidSizedChild(true);
}
super.setHeight(height, unit);
repaintChangedChildTree(dirtyChild, childrenMayBecomeUndefined, true);
}
/*
* (non-Javadoc)
*
* @see com.vaadin.ui.AbstractComponent#readDesign(org.jsoup.nodes .Element,
* com.vaadin.ui.declarative.DesignContext)
*/
@Override
public void readDesign(Element design, DesignContext designContext) {
// process default attributes
super.readDesign(design, designContext);
readDesignChildren(design.children(), designContext);
}
/**
* Reads the content component from the list of child elements of a design.
* The list must be empty or contain a single element; if the design
* contains multiple child elements, a DesignException is thrown. This
* method should be overridden by subclasses whose design may contain
* non-content child elements.
*
* @since 7.5.0
*
* @param children
* the child elements of the design that is being read
* @param context
* the DesignContext instance used to parse the design
*
* @throws DesignException
* if there are multiple child elements
* @throws DesignException
* if a child element could not be parsed as a Component
*/
protected void readDesignChildren(Elements children, DesignContext context) {
if (children.size() > 1) {
throw new DesignException("The container of type "
+ getClass().toString()
+ " can have only one child component.");
} else if (children.size() == 1) {
setContent(context.readDesign(children.first()));
}
}
/*
* (non-Javadoc)
*
* @see com.vaadin.ui.AbstractComponent#writeDesign(org.jsoup.nodes.Element
* , com.vaadin.ui.declarative.DesignContext)
*/
@Override
public void writeDesign(Element design, DesignContext designContext) {
// write default attributes (also clears children and attributes)
super.writeDesign(design, designContext);
AbstractSingleComponentContainer def = designContext
.getDefaultInstance(this);
if (!designContext.shouldWriteChildren(this, def)) {
return;
}
// handle child component
Component child = getContent();
if (child != null) {
Element childNode = designContext.createElement(child);
design.appendChild(childNode);
}
}
}
|