Constructor Detail

• JspWidgetBuilder

  public JspWidgetBuilder()

• JspWidgetBuilder

  public JspWidgetBuilder(JspWidgetBuilderConfig config)

Method Detail

• buildWidget

  public StaticXmlWidget buildWidget(String elementName,
                            Map<String,String> attributes,
                            StaticXmlMetawidget metawidget)

  Description copied from interface: WidgetBuilder
  Builds the most appropriate widget for this business field.

  Specified by:

  buildWidget in interface WidgetBuilder<StaticXmlWidget,StaticXmlMetawidget>

  Parameters:

  elementName - XML node name of the business field. Typically 'entity', 'property' or 'action'. Never null

  attributes - attributes of the business field to build a widget for. Never null. This Map is modifiable - changes will be passed to subsequent WidgetBuilders, WidgetProcessors and Layouts

  metawidget - the parent Metawidget. Never null

  Returns:

  the built widget. To suppress a field, return a Stub. To defer to the next WidgetBuilder in the pipeline, return null. If there are no more WidgetBuilders in the pipeline, will create a nested Metawidget. This approach (return Stub for no field, null for nested Metawidget) as opposed to the other way around (return null for no field, return Metawidget for nested Metawidget) works better for those UI frameworks that cannot instatiate widgets without adding them to containers (eg. SWT)

• createDataTableComponent

  protected StaticXmlWidget createDataTableComponent(String elementName,
                                         Map<String,String> attributes,
                                         StaticXmlMetawidget metawidget)

  Parameters:

  elementName - such as ENTITY or PROPERTY. Can be useful in determining how to construct the EL for the table.

• addColumnComponents

  protected void addColumnComponents(HtmlTable table,
                         CoreForEach forEach,
                         Map<String,String> attributes,
                         NodeList elements,
                         StaticXmlMetawidget metawidget)

  Adds column components to the given table.

  Clients can override this method to add additional columns, such as a 'Delete' button.

• addColumnHeader

  protected void addColumnHeader(HtmlTable table,
                     Map<String,String> attributes,
                     StaticXmlMetawidget metawidget)

• addColumnComponent

  protected void addColumnComponent(HtmlTableRow row,
                        CoreForEach forEach,
                        Map<String,String> tableAttributes,
                        String elementName,
                        Map<String,String> columnAttributes,
                        StaticXmlMetawidget metawidget)

  Add an HtmlColumn component for the given attributes, to the given HtmlDataTable.

  Clients can override this method to modify the column contents. For example, to place a link around the text.

  Parameters:

  tableAttributes - the metadata attributes used to render the parent table. May be useful for determining the overall type of the row

• addSelectItems

  protected void addSelectItems(HtmlSelect select,
                    String valueExpression,
                    Map<String,String> attributes)

• addSelectItems

  protected void addSelectItems(HtmlSelect select,
                    List<String> values,
                    List<String> labels,
                    Map<String,String> attributes)