AndroMDA JSF Cartridge Namespace Components

  • cartridge
  • metafacades
  • profile

AndroMDA JSF Cartridge Namespace Properties

Configuration
The properties that provide configuration of the JSF configuration files.
Messages and i18n
Properties related to the configuration of messages and internationalization in general.
Other
Other various properties that couldn't be classified into another category.
Outlets
Defines the locations to which output is generated.
Table Paging (DB paging)
These properties provide the ability to configure DB paging support for tables used by the cartridge (this is very.
UI Layout
Properties related to the configuration of the user interface layout.
Validation and Security
These properties configure the validation of user input as well as the security.
Views
Properties that configure view information.

configuration (Back to Outlets)
Required property
 No default value available
The location to which configuration files are generated. These are the files that typically appear in WEB-INF, such as faces-config.xml and validation-rules.xml, etc.
custom-resources (Back to Outlets)
Optional property
 No default value available
The location to which any customizable resources will be generated.
libraries (Back to Outlets)
Optional property
 No default value available
The location to which JSF libraries will be generated (these are the libraries required for JSF support, myfaces libraries, etc). If this isn't defined, its expected that the libraries will be provided by another means.
controllers (Back to Outlets)
Required property
 No default value available
The location to which any controllers are generated (this outlet contains classes which are fully generated and should not be touched).
controller-impls (Back to Outlets)
Required property
 No default value available
The location to which controller implementations are generated (these are where your hooks go to your services).
managed-beans (Back to Outlets)
Required property
 No default value available
The location to which any additional managed beans are generated (including layout options, etc).
messages (Back to Outlets)
Required property
 No default value available
The location to which message resource bundles are generated.
views (Back to Outlets)
Required property
 No default value available
Where the application views (JSPs, Facelets, etc) are output.
forms (Back to Outlets)
Required property
 No default value available
The forms to which input is stored are output here.
facesConfig (Back to Configuration)
Optional property
 Default value: faces-config.xml
The name of the JSF configuration file (this file stores the JSF managed bean form information and navigation rules).
facesConfigFiles (Back to Configuration)
Optional property
 No default value available
Comma separated list of URIs of (additional) faces config files. (e.g. /WEB-INF/jsf-config.xml). See JSF 1.0 PRD2, 10.3.2
formScope (Back to Configuration)
Optional property
 Default value: request
The scope to given the forms. This value can be overriddem by a tagged value.
facesServletExtension (Back to Configuration)
Optional property
 Default value: jsf
The extension used for the application's handling of JSF pages.
fileUploadMaxMemoryPerRequest (Back to Configuration)
Optional property
 Default value: 512000
Maximum memory per request (in bytes) for file uploads.
fileUploadMaxDiskSpacePerRequest (Back to Configuration)
Optional property
 Default value: 10240000
Maximum memory per request (in bytes) for file uploads.
logoutRedirectPath (Back to Configuration)
Optional property
 No default value available
The path to which the application redirects after logout occurs. If this is unspecified, the application redirects to the application use case entry point.
enablePreferences (Back to UI Layout)
Optional property
 Default value: true
Whether or not a preferences menu item should be included in the menu (this menu item allows you to control skinning, etc).
preferencesClassName (Back to UI Layout)
Optional property
 Default value: Preferences
Defines the name of the preferences class (which allows dynamic control of the UI's view preferences; skinning, etc).
skin (Back to UI Layout)
Optional property
 Default value: default
The default skin to be applied (i.e look and feel of the application).
preferencesBeanName (Back to UI Layout)
Optional property
 Default value: preferences
Defines the bean name under which the preferences class will be stored.
menuLayout (Back to UI Layout)
Optional property
 Default value: vbr
The menu layout. Valid values are:
  • hbr
  • hur
  • hul
  • vbr
  • vur
  • vur
maxTableRows (Back to UI Layout)
Optional property
 Default value: 10
The dfault value to set for the maximum rows displayed in a table.
menuTheme (Back to UI Layout)
Optional property
 Default value: ThemePanel
The navigation theme to use (the possible choices are: ThemeOffice, ThemeMiniBlack, ThemeIE, ThemePanel).
applicationName (Back to Messages and i18n)
Required property
 No default value available
The name of the application (this is used as the display name of the application).
normalizeMessages (Back to Messages and i18n)
Optional property
 Default value: true
Denotes the way application resource messages ought to be generated. When messages are normalized it means that elements with the same name will reuse the same label, even if they are located in entirely different use-cases or pages. This results in resource bundles that are not only smaller in size but also more straightforward to translate. The downside is that it will be less evident to customize labels for certain fields (which is rarely the case anyway).
viewType (Back to Views)
Optional property
 Default value: jsp
Defines the type of view to render, currently the options are: 'jsp' or 'facelets'.
welcomeFileName (Back to Views)
Optional property
 Default value: index.jsp
The path of the file that will be the welcome file (minus the extension).
loginFileName (Back to Views)
Optional property
 Default value: login
The path to the file that provides the login page (minus the extension).
logoutFileName (Back to Views)
Optional property
 Default value: logout
The path to the file that provides application logout (minus the extension)
defaultMultiSelectSize (Back to Views)
Optional property
 Default value: 3
The default size to use for multi select boxes.
enableFaceletsDevelopmentSupport (Back to Views)
Optional property
 Default value: false
Whether or not the Facelet development support should be enabled (in the generated web.xml), this is useful to enable when developing with Faclets, however should be disabled when going to production.
defaultDateFormat (Back to Views)
Optional property
 Default value: MM/dd/yyyy
The default date format to use in case it has not been explicitely specified, for event parameters. Take a look here to see how to properly construct date formats.
strictDateTimeFormat (Back to Views)
Optional property
 Default value: false
Specifies whether or not date and time formats are to be strictly matched. This property takes either true or false as values. If set to true all dates and times entered by the end-user will fail validation if they do not strictly adhere to their given format. Note that this strictness can always be overriden locally using the @andromda.struts.view.field.format tagged value.
defaultTimeFormat (Back to Views)
Optional property
 Default value: HH:mm
The default time format to use when it has not been explicitely specified for event parameters. Take a look here to see how to properly construct time formats.
securityRealm (Back to Validation and Security)
Optional property
 No default value available
The security realm to use when security is enabled.
clientValidation (Back to Validation and Security)
Optional property
 Default value: true
Indicates whether or not validation should occur on the client side.
paginationResultClassName (Back to Table Paging (DB paging))
Optional property
 No default value available
This is the fully qualified name of the class that provides the pagination results supplied from the middle tier; like a service operation. (i.e. if using the Spring cartridge, you'd set this as name.of.your.model.package.PaginationResult where "name.of.your.model.package" is the name of your model's root package). This must be defined in order for the PageableDataModel class to be generated (which is required for DB backed paging support).
virtualHost (Back to Other)
Optional property
 No default value available
The name to use for the virtual host (if one is required). For example application.myserver.com.
formSerialization (Back to Other)
Optional property
 Default value: true
Whether or not forms should be serialized to disk (and therefore stored for later retrieval for example when the user's session is lost). This just provides simple perisistence for the application state.
adfContextAttributeName (Back to Other)
Optional property
 Default value: AndroMDAADFContext
The name of the temporary variable that stores the current ADF faces context (this should typically not be changed).
useCaseForwardsClassName (Back to Other)
Optional property
 Default value: UseCaseForwards
The name of the class containing all use case forwards.
sessionTimeout (Back to Other)
Optional property
 Default value: 45
The number of minutes the session may be idle before timeout occurs.
distributable (Back to Other)
Optional property
 Default value: false
Whether or not the web application should be considered distributable; this means that the session will be persisted and restored.
stateSavingMethod (Back to Other)
Optional property
 Default value: client
The JSF state saving method to use within the application (can be either client or server).
fileTypeName (Back to Other)
Optional property
 Default value: oracle.adf.view.faces.model.UploadedFile
The fully qualified type name to use when file types are modeled for parameters (used for for file uploads).
dummyData (Back to Other)
Optional property
 Default value: true
Indicates whether or not dummy data should be rendered (in places like controllers).
formPopulatorName (Back to Other)
Optional property
 Default value: FormPopulator
The name to give the form populator utility class. This utility class provides JSF's form population when transfering information from one form to another during application flow.
backingListPattern (Back to Other)
Optional property
 Default value: {0}BackingList
The pattern used for constructing a parameter's backing list name. A backing list is used when you want to select the value of the parameter from a list (typically used for drop-down select input types).
backingValuePattern (Back to Other)
Optional property
 Default value: {0}BackingValue
The pattern used for constructing a parameter's backing value name. A backing value is used with an input table type (when you want to submit values from a table of complex objects).
labelListPattern (Back to Other)
Optional property
 Default value: {0}LabelList
The pattern used for constructing the label list name (stores the list of possible parameter value labels).
valueListPattern (Back to Other)
Optional property
 Default value: {0}ValueList
The pattern used for constructing the values list name (stores the list of possible parameter values when selecting from a list).
converterPattern (Back to Other)
Optional property
 Default value: {0}JsfConverter
The pattern used for constructing converters (like the enumeration converter), where {0} is the name of the model element.
viewPopulatorPattern (Back to Other)
Optional property
 Default value: {0}Populator
The pattern used to construct the view form populator filter, where {0} is the name of the view.
managedBeansPackage (Back to Other)
Optional property
 Default value: org.andromda.presentation.jsf
Defines the the package in which any extra managed-beans will be generated (such as the layout options class, etc).
jsfComponentsPackage (Back to Other)
Optional property
 Default value: org.andromda.presentation.jsf.components
Defines the the package to which any JSF components generated by the cartridge reside.
xmlEncoding (Back to Other)
Optional property
 Default value: UTF-8
Encoding for generated XML files.
formPattern (Back to Other)
Optional property
 Default value: {0}Form
The pattern to use for constructing the form name, where {0} is the name of the controller operation capitalized.
formImplementationPattern (Back to Other)
Optional property
 Default value: {0}FormImpl
The pattern to use for constructing the form implementation name, where {0} is the name of the controller operation capitalized.
formMessagesProperty (Back to Other)
Optional property
 Default value: jsfMessages
Defines the name of the property on a form that stores messages.
formBeanPattern (Back to Other)
Optional property
 Default value: {0}{1}Form
The pattern for constructing the name of the bean under which the form is stored, where {0} is the name of the use case and {1} is the name of the trigger.
controllerImplementationPattern (Back to Other)
Optional property
 Default value: {0}Impl
The pattern for constructing the name of the controller implementation class name (where {0} represents the modeled name of the controller).
actionFormKey (Back to Other)
Optional property
 Default value: form
The name of the key under which each action for is stored. This form is passed along from action to action in order to transfer all parameters.
messageResources (Back to Other)
Optional property
 Default value: message-resources
The path of the localized message resources (the .properties suffix is appended to this value when creating the actual file.).
jspIncludes (Back to Other)
Optional property
 Default value: includes.jspf
Defines the name of the default includes file (this contains any message resources as well as tag libs.
servicePackageNamePattern (Back to Other)
Optional property
 Default value: {0}
The name of the package in which to create the service files, {0} can be used to denote the package in which the service has been modeled.
serviceAccessorPattern (Back to Other)
Optional property
 No default value available
The pattern to use when calling the backend code for <<Service>> lookups. For calling services you would use following patterns:
  • Spring: ${application.package}.ServiceLocator.instance().get{1}()
  • EJB: ${myPackage}.{1}Util.getHome().create()
messageResourceKeyPattern (Back to Other)
Optional property
 Default value: (.*)(\\{\\s*([\\w|\\.+]*)\\s*\\})(.*)
Used to define the pattern used for retrieving message resource keys from messages (like exceptions). This is useful when exceptions or other messages are propogated from the business tier and you want to map these to messages in your presentation tier. Normally you won't need to change this pattern, however you may want to, if you want to use it for exceptions you may have no control over (i.e. SQLExceptions). Currently the default pattern supports a message with an embedded {some.resource.key} type key.
patternMatchingExceptionHandler (Back to Other)
Optional property
 Default value: PatternMatchingExceptionHandler
The name to give the pattern matching exception handler.