Skip to content

Generated Files - Web Fragment

Default File Locations

  • src/main/java for Java source code
  • src/test/java for Java source code for testing
  • src/main/resources for message properties
  • src/main/resources/META-INF for configuration files
  • src/main/resources/META-INF/resources for XHTML, CSS and JavaScript files

You can change the default directories by setting generator options.

Files for Web Fragments (used in Web Apps)

Modeling File Naming Description
capability [name] Abstract[Name]ManagedBean.java The class is the parent of all managed beans for the given capability. It inherits from AbstractManagedBean.
layout [name]
where this layout is not used inside another layout
[Name]Bean.java The class manages the data for the web page and provides event handlers for the user interaction.
layout [name]
where this layout is not used inside another layout
[Name]BeanCustomization.java The class manages the rendered and required flags for XHTML components and also the configuration values that are relevant for this web page only.
layout [name]
where this layout is not used inside another layout
[Name]BeanNavigationCustomization.java The class manages the navigation targets for the web page. It has some getters that return a relative URL to an XHTML page or an XHTML view name. Its only purpose is to allow the default navigation target to be overwritten in web application projects.
layout [name]
where this layout is not used inside another layout
[Name]BeanDevTooltip.java The class provides hard-coded (generated) technical information about model elements that were used for the code generation. The information is going to be displayed as a tooltip for UI components. In project stage ‘Production’ those tooltips are not displayed at all.
capability [name] [Name]FeatureCustomization.java The class provides a mechanism to switch feature toggles on and off when implementing a web application. Switching a feature on or off is not visible in the model but is provided by Java coding in the web application project.
layout [name]
where this layout is not used inside another layout
[Name]BeanExtendedCustomization.java The class manages the values for some of the XHTML attributes like for instance style and styleClass. The main purpose of this class is not to be able to overwrite the values in web application projects (though this is possible), but to minimize the number of manual changes in XHTML files.
layout [name]
where this layout is not used inside another layout
[Name]BeanI.java The interface is implemented by the [Name]Bean.java class. It is needed in case you want to access a managed bean in a web fragment from a managed bean in a different web fragment, without having to have a compile-time dependency from one fragment to another.
enumeration [name]

capability [cap.‑name]



layout [layout-name]
[Name].java

[cap.-Name]Feature.java
[cap.-Name]Capability.java
[cap.-Name]Page.java

[layout-Name]Component.java,
[layout-Name]Container.java

and an inner enum of [layout‑Name]Bean.java for the tabs of a p:tabView
An enumeration that corresponds to an enumeration that is available in the model or to an enumeration that gets derived from other model information. There are enumerations derived for
- the capability itself
- all features modeled for a capability
- all containers in an XHTML file
- all components in an XHTML file
- all URLs for pages in a capability
- all tabs of a p:tabView
capability [name] faces-config.xml This class holds information about exception handlers, message properties and self-made JSF components
capability [name] web-fragment.xml This class holds information about servlets, mime types, exception mapping and initialization parameters
layout [name]
where this layout is not used inside another layout
[name].xhtml
[name]-center-center.xhtml
[name]-center-north.xhtml
[name]-center.xhtml
[name]-east.xhtml
[name]-north.xhtml
[name]-south.xhtml
[name]-west.xhtml
[name]_generated.xhtml
these XHTML files represent the web page and are going to be read through a URL that ends with
[cap.-name]/[name]/[name].xhtml. The file [name]_generated.xhtml holds the actual page content (input fields, buttons, tables, etc.).
capability [name] [cap.-name]-messages_de.properties
[cap.-name]-messages_en.properties
[cap.-name]-messages.properties
These properties files contain text that is displayed on web pages (labels, messages, titles, …). The number of message properties files is currently hard-coded to 3 (language ‘en’, ‘de’ and the default message properties). In future there will be a generator option that allows to control the language codes to be supported.

Files for Test-Support in Web Fragments

Modeling File Naming Description
layout [name]
where this layout is not used inside another layout
[Name]Page.java These classes implement the so-called ‘Page Object Pattern’ for UI tests that are based on Selenium.
layout [name]
where this layout is not used inside another layout
[Name]Test.java These classes represent Selenium tests, one test per web page. It contains test methods related to model elements of type display [name], in the order that they appear in a modeled web page.