// handle children
for (Element childComponent : design.children()) {
Attributes attr = childComponent.attributes();
- Component newChild = designContext.createChild(childComponent);
+ Component newChild = designContext.readDesign(childComponent);
StringBuilder css = new StringBuilder();
if (attr.hasKey(ATTR_TOP)) {
css.append("top:").append(attr.get(ATTR_TOP)).append(";");
}
// handle immediate
if (attr.hasKey("immediate")) {
- setImmediate(DesignAttributeHandler.getBoolean(attr
+ setImmediate(DesignAttributeHandler.parseBoolean(attr
.get("immediate")));
}
// handle responsive
if (attr.hasKey("responsive")) {
- setResponsive(DesignAttributeHandler.getBoolean(attr
+ setResponsive(DesignAttributeHandler.parseBoolean(attr
.get("responsive")));
}
// check for unsupported attributes
// handle children
for (Element childComponent : design.children()) {
Attributes attr = childComponent.attributes();
- Component newChild = designContext.createChild(childComponent);
+ Component newChild = designContext.readDesign(childComponent);
addComponent(newChild);
// handle alignment
int bitMask = 0;
+ " can have only one child component.");
} else if (childCount == 1) {
Element childElement = design.children().get(0);
- Component newChild = designContext.createChild(childElement);
+ Component newChild = designContext.readDesign(childElement);
setContent(newChild);
}
}
"A split panel can contain at most two components.");
}
for (Element childElement : design.children()) {
- Component childComponent = designContext.createChild(childElement);
+ Component childComponent = designContext.readDesign(childElement);
if (childElement.hasAttr(":second")) {
setSecondComponent(childComponent);
} else {
super.readDesign(design, designContext);
// handle children
for (Element childComponent : design.children()) {
- Component newChild = designContext.createChild(childComponent);
+ Component newChild = designContext.readDesign(childComponent);
addComponent(newChild);
}
}
}
// create the component that is in tab content
Element content = tabElement.child(0);
- Component child = designContext.createChild(content);
+ Component child = designContext.readDesign(content);
Tab tab = this.addTab(child);
if (attr.hasKey("visible")) {
tab.setVisible(DesignAttributeHandler.readAttribute("visible",
* id/local id/caption
*/
private static DesignContext designToComponentTree(Document doc,
- Component componentRoot, Class<? extends Component> classWithFields) {
+ Component componentRoot, Class<?> classWithFields) {
DesignContext designContext = new DesignContext(doc);
- designContext.getPrefixes(doc);
+ designContext.readPackageMappings(doc);
// No special handling for a document without a body element - should be
// taken care of by jsoup.
Element root = doc.body();
};
designContext.addComponentCreationListener(creationListener);
// create subtree
- designContext.synchronizeAndRegister(componentRoot, element);
+ designContext.readDesign(element, componentRoot);
// make sure that all the member fields are bound
Collection<String> unboundFields = binder.getUnboundFields();
if (!unboundFields.isEmpty()) {
designContext.removeComponentCreationListener(creationListener);
} else {
// createChild creates the entire component hierarchy
- componentRoot = designContext.createChild(element);
+ componentRoot = designContext.readDesign(element);
}
designContext.setRootComponent(componentRoot);
return designContext;
Component root = designContext.getRootComponent();
Node rootNode = designContext.createElement(root);
body.appendChild(rootNode);
- designContext.storePrefixes(doc);
+ designContext.writePackageMappings(doc);
return doc;
}
*/
public class DesignAttributeHandler implements Serializable {
- protected static Logger getLogger() {
+ private static Logger getLogger() {
return Logger.getLogger(DesignAttributeHandler.class.getName());
}
// it is present and the value is not "false" or "FALSE". Thus empty
// value evaluates to true.
if (targetType == Boolean.TYPE || targetType == Boolean.class) {
- return !value.equalsIgnoreCase("false");
+ return parseBoolean(value);
}
if (targetType == Integer.TYPE || targetType == Integer.class) {
return Integer.valueOf(value);
* Converts the given string attribute value to its corresponding boolean.
*
* An empty string and "true" are considered to represent a true value and
- * "false" to represent a false value. All other input will throw an
- * exception
+ * "false" to represent a false value.
*
* @param booleanValue
* the boolean value from an attribute
* @return the parsed boolean
*/
- public static boolean getBoolean(String booleanValue) {
- return "".equals(booleanValue) ? true : Boolean.valueOf(booleanValue);
+ public static boolean parseBoolean(String booleanValue) {
+ return !booleanValue.equalsIgnoreCase("false");
}
}
\ No newline at end of file
import org.jsoup.nodes.Node;
import com.vaadin.annotations.DesignRoot;
-import com.vaadin.ui.AbstractComponent;
import com.vaadin.ui.Component;
import com.vaadin.ui.HasComponents;
* @return the default instance for the given class. The return value must
* not be modified by the caller
*/
- public <T> T getDefaultInstance(AbstractComponent abstractComponent) {
+ public <T> T getDefaultInstance(Component component) {
// If the root is a @DesignRoot component, it can't use itself as a
// reference or the written design will be empty
// If the root component in some other way initializes itself in the
// constructor
- if (getRootComponent() == abstractComponent
- && abstractComponent.getClass().isAnnotationPresent(
- DesignRoot.class)) {
- return (T) getDefaultInstance((Class<? extends Component>) abstractComponent
+ if (getRootComponent() == component
+ && component.getClass().isAnnotationPresent(DesignRoot.class)) {
+ return (T) getDefaultInstance((Class<? extends Component>) component
.getClass().getSuperclass());
}
- return (T) getDefaultInstance(abstractComponent.getClass());
+ return (T) getDefaultInstance(component.getClass());
}
private Component getDefaultInstance(
}
/**
- * Get and store the mappings from prefixes to package names from meta tags
- * located under <head> in the html document.
- *
+ * Reads and stores the mappings from prefixes to package names from meta
+ * tags located under <head> in the html document.
*/
- protected void getPrefixes(Document doc) {
+ protected void readPackageMappings(Document doc) {
Element head = doc.head();
if (head == null) {
return;
}
/**
- * Stores the package mappings (prefix -> package name) of this object to
- * the specified document. The prefixes are stored as <meta> tags under
- * <head> in the document.
+ * Writes the package mappings (prefix -> package name) of this object to
+ * the specified document.
+ * <p>
+ * The prefixes are stored as <meta> tags under <head> in the document.
*
* @param doc
- * the Jsoup document tree where the package mappings are stored
+ * the Jsoup document tree where the package mappings are written
*/
- public void storePrefixes(Document doc) {
+ public void writePackageMappings(Document doc) {
Element head = doc.head();
for (String prefix : prefixToPackage.keySet()) {
// Only store the prefix-name mapping if it is not a default mapping
+ prefixToPackage.get(prefix);
newNode.attr("content", prefixToPackageName);
head.appendChild(newNode);
-
}
}
}
}
/**
- * Creates a Component corresponding to the given html node. Also calls
- * readDesign() for the created node, in effect creating the entire
- * component hierarchy rooted at the returned component.
+ * Reads the given design node and creates the corresponding component tree
*
* @param componentDesign
- * The html tree node containing the description of the component
- * to be created.
- * @return a Component corresponding to componentDesign
+ * The design element containing the description of the component
+ * to be created
+ * @return the root component of component tree
*/
- public Component createChild(Element componentDesign) {
+ public Component readDesign(Element componentDesign) {
// Create the component.
Component component = instantiateComponent(componentDesign);
- synchronizeAndRegister(component, componentDesign);
+ readDesign(componentDesign, component);
fireComponentCreatedEvent(componentToLocalId.get(component), component);
return component;
}
/**
- * Calls readDesign() for the given component and passes the given component
- * design as a parameter. This creates the entire component hierarchy rooted
- * at the given component. Also registers the componentid, localId and
- * caption of the given component and all its children to the context
*
- * @param component
- * The component to be synchronized from design
+ * Reads the given design node and populates the given component with the
+ * corresponding component tree
+ * <p>
+ * Additionally registers the component id, local id and caption of the
+ * given component and all its children in the context
+ *
* @param componentDesign
- * The html tree node containing the description of the component
- * @throws DesignException
- * if the design contains duplicate local or global ids
+ * The design element containing the description of the component
+ * to be created
+ * @param component
+ * The component which corresponds to the design element
*/
- public void synchronizeAndRegister(Component component,
- Element componentDesign) {
+ public void readDesign(Element componentDesign, Component component) {
component.readDesign(componentDesign, this);
// Get the ids and the caption of the component and store them in the
// maps of this design context.
html.appendChild(doc.createElement("head"));
Element body = doc.createElement("body");
html.appendChild(body);
- dc.storePrefixes(doc);
+ dc.writePackageMappings(doc);
// Append the design under <body> in the html tree. createNode
// creates the entire component hierarchy rooted at the
private AbsoluteLayout createLayout() {
DesignContext ctx = new DesignContext();
Element design = createDesign();
- Component child = ctx.createChild(design);
+ Component child = ctx.readDesign(design);
return (AbsoluteLayout) child;
}
// Synchronize with a design having no immediate attribute -
// explicitImmediate should then be null.
design = createDesign("description", "test-description");
+ component = getComponent();
component.readDesign(design, ctx);
// Synchronize with a design having immediate = false
design = createDesign("immediate", "false");
String... alignments) {
DesignContext ctx = new DesignContext();
Element design = createDesign(expandRatio, margin, alignments);
- Component child = ctx.createChild(design);
+ Component child = ctx.readDesign(design);
return (VerticalLayout) child;
}
attributes.put("icon-alt", "OK");
attributes.put("click-shortcut", "ctrl-shift-o");
Button button = (Button) ctx
- .createChild(createButtonWithAttributes(attributes));
+ .readDesign(createButtonWithAttributes(attributes));
assertEquals(3, button.getTabIndex());
assertEquals(false, button.isHtmlContentAllowed());
assertEquals("OK", button.getIconAlternateText());
*/
private void createAndTestButtons(String content, String caption) {
Element e1 = createElement("v-button", content, caption);
- Button b1 = (Button) ctx.createChild(e1);
+ Button b1 = (Button) ctx.readDesign(e1);
Element e2 = createElement("v-native-button", content, caption);
- NativeButton b2 = (NativeButton) ctx.createChild(e2);
+ NativeButton b2 = (NativeButton) ctx.readDesign(e2);
if (content != null) {
assertEquals("The button has the wrong text content.", content,
b1.getCaption());
@Test
public void testChecked() {
Element e = createElement(true);
- CheckBox box = (CheckBox) ctx.createChild(e);
+ CheckBox box = (CheckBox) ctx.readDesign(e);
assertEquals("The checkbox must be checked", Boolean.TRUE,
box.getValue());
}
@Test
public void testUnchecked() {
Element e = createElement(false);
- CheckBox box = (CheckBox) ctx.createChild(e);
+ CheckBox box = (CheckBox) ctx.readDesign(e);
assertEquals("The checkbox must be unchecked", Boolean.FALSE,
box.getValue());
}
private CssLayout createLayout() {
DesignContext ctx = new DesignContext();
Element design = createDesign();
- Component child = ctx.createChild(design);
+ Component child = ctx.readDesign(design);
return (CssLayout) child;
}
*/
private void createAndTestLabel(String content, String caption) {
Element e = createElement("v-label", content, caption);
- Label l = (Label) ctx.createChild(e);
+ Label l = (Label) ctx.readDesign(e);
if (content != null) {
assertEquals("The label has wrong text content.", content,
l.getValue());