You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lu...@apache.org on 2011/11/17 01:31:58 UTC
svn commit: r1202951 -
/myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml
Author: lu4242
Date: Thu Nov 17 00:31:58 2011
New Revision: 1202951
URL: http://svn.apache.org/viewvc?rev=1202951&view=rev
Log:
synch with impl shared
Modified:
myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml
Modified: myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml
URL: http://svn.apache.org/viewvc/myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml?rev=1202951&r1=1202950&r2=1202951&view=diff
==============================================================================
--- myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml (original)
+++ myfaces/shared/trunk_4.0.x/core/src/main/resources/META-INF/myfaces-metadata.xml Thu Nov 17 00:31:58 2011
@@ -74,7 +74,7 @@ component. The id is not necessarily uni
<name>binding</name>
<className>javax.faces.component.UIComponent</className>
<desc>backing bean property to bind to this component instance</desc>
- <longDesc>Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression.</longDesc>
+ <longDesc>Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind " + "to this component instance. This value must be an EL expression.</longDesc>
<generated>false</generated>
</property>
</component>
@@ -7485,6 +7485,7 @@ tree.
<defaultValue>.class .jsp .jspx .properties .xhtml</defaultValue>
<sourceClassName>javax.faces.application.ResourceHandler</sourceClassName>
<since>2.0</since>
+ <group>resources</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.STATE_SAVING_METHOD</name>
@@ -7511,6 +7512,8 @@ token is embedded in the data rendered t
<expectedValues>server,client</expectedValues>
<sourceClassName>javax.faces.application.StateManager</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>javax.faces.FULL_STATE_SAVING_VIEW_IDS</name>
@@ -7519,6 +7522,7 @@ token is embedded in the data rendered t
<longDesc>Indicate the viewId(s) separated by commas that should be saved and restored fully, without use Partial State Saving (PSS).</longDesc>
<sourceClassName>javax.faces.application.StateManager</sourceClassName>
<since>2.0</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.PARTIAL_STATE_SAVING</name>
@@ -7538,6 +7542,8 @@ state of the view.</p>
<expectedValues>true,false</expectedValues>
<sourceClassName>javax.faces.application.StateManager</sourceClassName>
<since>2.0</since>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>javax.faces.DEFAULT_SUFFIX</name>
@@ -7549,6 +7555,7 @@ used by JSF to create views and render p
<defaultValue>.xhtml .jsp</defaultValue>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>1.1</since>
+ <group>viewhandler</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.FACELETS_SUFFIX</name>
@@ -7558,6 +7565,7 @@ used by JSF to create views and render p
<defaultValue>.xhtml</defaultValue>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>2.0</since>
+ <group>viewhandler</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.FACELETS_VIEW_MAPPINGS</name>
@@ -7566,6 +7574,7 @@ used by JSF to create views and render p
<longDesc>Set of extensions handled by facelets, separated by ';'.</longDesc>
<sourceClassName>javax.faces.application.ViewHandler</sourceClassName>
<since>2.0</since>
+ <group>viewhandler</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.VALIDATE_EMPTY_FIELDS</name>
@@ -7578,6 +7587,7 @@ enabled when Bean Validation binaries ar
<expectedValues>auto, true, false</expectedValues>
<sourceClassName>javax.faces.component.UIInput</sourceClassName>
<since>2.0</since>
+ <group>validation</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL</name>
@@ -7594,6 +7604,7 @@ Submitted values are decoded as null val
<expectedValues>true, false</expectedValues>
<sourceClassName>javax.faces.component.UIInput</sourceClassName>
<since>2.0</since>
+ <group>validation</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ENUM_CONVERTER_ALLOW_STRING_PASSTROUGH</name>
@@ -7606,6 +7617,7 @@ See MYFACES-2739 for details.</longDesc>
<expectedValues>true,false</expectedValues>
<sourceClassName>javax.faces.convert.EnumConverter</sourceClassName>
<since>2.0.1</since>
+ <group>validation</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.validator.DISABLE_DEFAULT_BEAN_VALIDATOR</name>
@@ -7617,6 +7629,7 @@ Explicitly adding a BeanValidator to an
<expectedValues>true, false</expectedValues>
<sourceClassName>javax.faces.validator.BeanValidator</sourceClassName>
<since>2.0</since>
+ <group>validation</group>
</webConfigParam>
<webConfigParam>
<name>javax.faces.CONFIG_FILES</name>
@@ -7654,6 +7667,7 @@ Furthermore, the init parameter only wor
</longDesc>
<sourceClassName>javax.faces.webapp.PreJsf2ExceptionHandlerFactory$PreJsf2ExceptionHandlerImpl</sourceClassName>
<since>1.2.4</since>
+ <deprecated>true</deprecated>
</webConfigParam>
</webConfig>
<webConfig>
@@ -7661,22 +7675,36 @@ Furthermore, the init parameter only wor
<webConfigParam>
<name>org.apache.myfaces.CHECKED_VIEWID_CACHE_SIZE</name>
<fieldName>CHECKED_VIEWID_CACHE_SIZE_ATTRIBUTE</fieldName>
- <desc>Controls the size of the cache used to "remember" if a view exists or not</desc>
+ <desc>Controls the size of the cache used to 'remember' if a view exists or not.</desc>
<longDesc>Controls the size of the cache used to "remember" if a view exists or not.</longDesc>
<defaultValue>500</defaultValue>
<sourceClassName>org.apache.myfaces.shared.application.DefaultViewHandlerSupport</sourceClassName>
<since>2.0.2</since>
+ <group>viewhandler</group>
+ <tags>performance</tags>
+ <classType>java.lang.Integer</classType>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.CHECKED_VIEWID_CACHE_ENABLED</name>
<fieldName>CHECKED_VIEWID_CACHE_ENABLED_ATTRIBUTE</fieldName>
- <desc>Enable or disable a cache used to "remember" if a view exists or not and reduce the impact of
-sucesive calls to ExternalContext</desc>
+ <desc>Enable or disable a cache used to 'remember' if a view exists or not and reduce the impact of sucesive calls to ExternalContext.getResource().</desc>
<longDesc>Enable or disable a cache used to "remember" if a view exists or not and reduce the impact of
sucesive calls to ExternalContext.getResource().</longDesc>
<defaultValue>true</defaultValue>
+ <expectedValues>true, false</expectedValues>
<sourceClassName>org.apache.myfaces.shared.application.DefaultViewHandlerSupport</sourceClassName>
<since>2.0.2</since>
+ <group>viewhandler</group>
+ <tags>performance</tags>
+ </webConfigParam>
+ <webConfigParam>
+ <name>org.apache.myfaces.RESOURCE_VIRTUAL_PATH</name>
+ <fieldName>INIT_PARAM_RESOURCE_VIRTUAL_PATH</fieldName>
+ <desc>Set the virtual path used to serve resources using tomahawk addResource API</desc>
+ <longDesc>Set the virtual path used to serve resources using tomahawk addResource API. Note ExtensionsFilter should
+be able to receive request on the prefix used here.</longDesc>
+ <sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
+ <tags>tomahawk</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.PRETTY_HTML</name>
@@ -7686,9 +7714,11 @@ sucesive calls to ExternalContext.getRes
i.e. additional line separators and whitespace will be written, that do not
influence the HTML code. Default: "true"</longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ALLOW_JAVASCRIPT</name>
@@ -7701,19 +7731,25 @@ If javascript is not allowed, the state
added as url parameters.
Default: "true"</longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.DETECT_JAVASCRIPT</name>
<fieldName>INIT_PARAM_DETECT_JAVASCRIPT</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Deprecated: tomahawk specific param to detect javascript, but it is no longer valid anymore</desc>
+ <longDesc>Deprecated: tomahawk specific param to detect javascript, but it is no longer valid anymore.</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>render</group>
+ <tags>tomahawk</tags>
+ <deprecated>true</deprecated>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.AUTO_SCROLL</name>
@@ -7726,15 +7762,16 @@ with long lists and you do not want the
if you trigger a link or button action that stays on the same page.
Default: "false"</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <tags>tomahawk</tags>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ADD_RESOURCE_CLASS</name>
<fieldName>INIT_PARAM_ADD_RESOURCE_CLASS</fieldName>
- <desc>Tomahawk specific: A class implementing the
-org</desc>
+ <desc>Tomahawk specific: Indicate the class responsible to place scripts and css using " + "tomahawk AddResource API</desc>
<longDesc>Tomahawk specific: A class implementing the
org.apache.myfaces.shared.renderkit.html.util.AddResource
interface. It is responsible to
@@ -7746,13 +7783,12 @@ gain performance.</longDesc>
<defaultValue>org.apache.myfaces. renderkit.html.util. DefaultAddResource</defaultValue>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <tags>tomahawk</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.CHECK_EXTENSIONS_FILTER</name>
<fieldName>INIT_CHECK_EXTENSIONS_FILTER</fieldName>
- <desc>Tomahawk specific: A very common problem in configuring MyFaces-web-applications
-is that the Extensions-Filter is not configured at all
-or improperly configured</desc>
+ <desc>Tomahawk specific: This parameter will check for a properly configured Extensions-Filter if " + "it is needed by the web-app.</desc>
<longDesc>Tomahawk specific: A very common problem in configuring MyFaces-web-applications
is that the Extensions-Filter is not configured at all
or improperly configured. This parameter will check for a properly
@@ -7764,58 +7800,105 @@ this parameter to false.
In tomahawk for JSF 2.0 since version 1.1.11, this param is set by default to false, otherwise is true.</longDesc>
<defaultValue>for JSF 2.0 since 1.1.11 false, otherwise true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <tags>tomahawk</tags>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.READONLY_AS_DISABLED_FOR_SELECTS</name>
<fieldName>INIT_READONLY_AS_DISABLED_FOR_SELECT</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Tomahawk specific: Interpret "readonly" property as "disable" for select components like t:selectOneRow</desc>
+ <longDesc>Tomahawk specific: Interpret "readonly" property as "disable" for select components like t:selectOneRow.</longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>render</group>
+ <tags>tomahawk</tags>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.CONFIG_REFRESH_PERIOD</name>
<fieldName>INIT_PARAM_CONFIG_REFRESH_PERIOD</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Set the time in seconds that check for updates of web</desc>
+ <longDesc>Set the time in seconds that check for updates of web.xml and faces-config descriptors and
+refresh the configuration.
+This param is valid only if project stage is not production. Set this param to 0 disable this feature.</longDesc>
<defaultValue>2</defaultValue>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <classType>java.lang.Long</classType>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.VIEWSTATE_JAVASCRIPT</name>
<fieldName>INIT_PARAM_VIEWSTATE_JAVASCRIPT</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Set the view state using a javascript function instead a hidden input field</desc>
+ <longDesc>Set the view state using a javascript function instead a hidden input field.</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <deprecated>true</deprecated>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RENDER_VIEWSTATE_ID</name>
<fieldName>INIT_PARAM_RENDER_VIEWSTATE_ID</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Define if the input field that should store the state (javax</desc>
+ <longDesc>
+<![CDATA[
+Define if the input field that should store the state (javax.faces.ViewState) should render
+id="javax.faces.ViewState".
+
+JSF API 1.2 defines a "javax.faces.ViewState" client parameter, that must be rendered as both the "name"
+and the "id" attribute of the hidden input that is rendered for the purpose of state saving
+(see ResponseStateManager.VIEW_STATE_PARAM).
+Actually this causes duplicate id attributes and thus invalid XHTML pages when multiple forms are rendered on
+one page. With the org.apache.myfaces.RENDER_VIEWSTATE_ID context parameter you can tune this behaviour.
+<br/>Set it to
+<ul><li>true - to render JSF 1.2 compliant id attributes (that might cause invalid XHTML), or</li>
+<li>false - to omit rendering of the id attribute (which is only needed for very special
+AJAX/Javascript components)</li></ul>
+Default value is: true (for backwards compatibility and JSF 1.2 compliancy)
+]]>
+ </longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.STRICT_XHTML_LINKS</name>
<fieldName>INIT_PARAM_STRICT_XHTML_LINKS</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc><![CDATA[Use "&amp;" entity instead a plain "&" character within HTML]]></desc>
+ <longDesc>
+<![CDATA[
+Use "&amp;" entity instead a plain "&" character within HTML.
+<p>W3C recommends to use the "&amp;" entity instead of a plain "&" character within HTML.
+This also applies to attribute values and thus to the "href" attribute of <a> elements as well.
+Even more, when XHTML is used as output the usage of plain "&" characters is forbidden and would lead to
+invalid XML code.
+Therefore, since version 1.1.6 MyFaces renders the correct "&amp;" entity for links.</p>
+<p>The init parameter
+org.apache.myfaces.STRICT_XHTML_LINKS makes it possible to restore the old behaviour and to make MyFaces
+"bug compatible" to the Sun RI which renders plain "&" chars in links as well.</p>
+<p>
+See: <a href="http://www.w3.org/TR/html401/charset.html#h-5.3.2">HTML 4.01 Specification</a>
+See: <a href="http://issues.apache.org/jira/browse/MYFACES-1774">Jira: MYFACES-1774</a>
+</p>
+]]>
+ </longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
- <since>1.1</since>
+ <since>1.1.6</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RENDER_CLEAR_JAVASCRIPT_FOR_BUTTON</name>
@@ -7827,23 +7910,28 @@ compatibility with hidden fields feature
because jsf ri does not render javascript on onclick method for button,
so myfaces should do this.</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.2.3</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RENDER_HIDDEN_FIELDS_FOR_LINK_PARAMS</name>
<fieldName>INIT_PARAM_RENDER_HIDDEN_FIELDS_FOR_LINK_PARAMS</fieldName>
- <desc>This param renders hidden fields at the end of h:form for link params when h:commandLink + f:param is used, instead
-use javascript to create them</desc>
- <longDesc>This param renders hidden fields at the end of h:form for link params when h:commandLink + f:param is used, instead
-use javascript to create them. Set this param to true also enables org.apache.myfaces.RENDER_CLEAR_JAVASCRIPT_FOR_BUTTON
-automatically to ensure consistency. This feature is required to support Windows Mobile 6, because in this environment,
-document.createElement() and form.appendChild() javascript methods are not supported.</longDesc>
+ <desc>This param renders hidden fields at the end of h:form for link params when h:commandLink + f:param is used,
+instead use javascript to create them</desc>
+ <longDesc>This param renders hidden fields at the end of h:form for link params when h:commandLink + f:param is used,
+instead use javascript to create them. Set this param to true also enables
+org.apache.myfaces.RENDER_CLEAR_JAVASCRIPT_FOR_BUTTON
+automatically to ensure consistency. This feature is required to support Windows Mobile 6, because in
+this environment, document.createElement() and form.appendChild() javascript methods are not supported.</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.2.9</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.SAVE_FORM_SUBMIT_LINK_IE</name>
@@ -7853,15 +7941,27 @@ link (call to window</desc>
<longDesc>Add a code that save the form before submit using a
link (call to window.external.AutoCompleteSaveForm(form) ). It's a bug on IE.</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.1</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.DELEGATE_FACES_SERVLET</name>
<fieldName>INIT_PARAM_DELEGATE_FACES_SERVLET</fieldName>
- <desc>no description</desc>
- <longDesc></longDesc>
+ <desc>Define an alternate class name that will be used to initialize MyFaces, instead the default
+javax</desc>
+ <longDesc>
+<![CDATA[
+Define an alternate class name that will be used to initialize MyFaces, instead the default
+javax.faces.webapp.FacesServlet.
+
+<p>This helps MyFaces to detect the mappings and other additional configuration used to setup the
+environment, and prevent abort initialization if no FacesServlet config is detected.
+</p>
+]]>
+ </longDesc>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>1.2.7</since>
</webConfigParam>
@@ -7871,11 +7971,12 @@ link (call to window.external.AutoComple
<desc>Indicate if the facelet associated to the view should be reapplied when the view is refreshed</desc>
<longDesc>
<![CDATA[
-Indicate if the facelet associated to the view should be reapplied when the view is refreshed. Default mode is "auto".
+Indicate if the facelet associated to the view should be reapplied when the view is refreshed.
+ Default mode is "auto".
<p>This param is only valid when partial state saving is on.
-If this is set as true, the tag-handlers are always reapplied before render view, like in facelets 1.1.x, allowing
-c:if work correctly to "toggle" components based on a value changed on invoke application phase.
+If this is set as true, the tag-handlers are always reapplied before render view, like in facelets 1.1.x,
+allowing c:if work correctly to "toggle" components based on a value changed on invoke application phase.
If the param is set as "auto", the implementation check if c:if, c:forEach,
c:choose and ui:include with src=ELExpression is used on the page and if that so, mark the view
to be refreshed.</p>
@@ -7885,6 +7986,9 @@ to be refreshed.</p>
<expectedValues>true,false,auto</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0</since>
+ <group>state</group>
+ <tags>performance</tags>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.REFRESH_TRANSIENT_BUILD_ON_PSS_PRESERVE_STATE</name>
@@ -7903,8 +8007,12 @@ is preserved between request.</p>
]]>
</longDesc>
<defaultValue>false</defaultValue>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0</since>
+ <group>state</group>
+ <tags>performance</tags>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.VALIDATE_XML</name>
@@ -7921,9 +8029,10 @@ If set to <code>true</code>, tag library
will be validated during application start up
]]>
</longDesc>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0</since>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.WRAP_SCRIPT_CONTENT_WITH_XML_COMMENT_TAG</name>
@@ -7931,9 +8040,11 @@ will be validated during application sta
<desc>Wrap content inside script with xml comment to prevent old browsers to display it</desc>
<longDesc>Wrap content inside script with xml comment to prevent old browsers to display it. By default it is true.</longDesc>
<defaultValue>true</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0.1</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RENDER_FORM_SUBMIT_SCRIPT_INLINE</name>
@@ -7941,25 +8052,68 @@ will be validated during application sta
<desc>If set true, render the form submit script inline, as in myfaces core 1</desc>
<longDesc>If set true, render the form submit script inline, as in myfaces core 1.2 and earlier versions</longDesc>
<defaultValue>false</defaultValue>
- <expectedValues>true,false</expectedValues>
+ <expectedValues>true, false, on, off, yes, no</expectedValues>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0.2</since>
+ <group>render</group>
+ <ignoreUpperLowerCase>true</ignoreUpperLowerCase>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.DEBUG_PHASE_LISTENER</name>
<fieldName>INIT_PARAM_DEBUG_PHASE_LISTENER</fieldName>
- <desc>Enable/disable DebugPhaseListener feature, with provide useful information about ValueHolder variables (submittedValue, localValue, value)</desc>
- <longDesc>Enable/disable DebugPhaseListener feature, with provide useful information about ValueHolder variables (submittedValue, localValue, value).
-Note evaluate those getters for each component could cause some unwanted side effects when using "access" type scopes like on MyFaces CODI.
+ <desc>Enable/disable DebugPhaseListener feature, with provide useful information about ValueHolder
+variables (submittedValue, localValue, value)</desc>
+ <longDesc>Enable/disable DebugPhaseListener feature, with provide useful information about ValueHolder
+variables (submittedValue, localValue, value).
+Note evaluate those getters for each component could cause some unwanted side effects when
+using "access" type scopes like on MyFaces CODI.
This param only has effect when project stage is Development.</longDesc>
<sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
<since>2.0.8</since>
</webConfigParam>
<webConfigParam>
+ <name>org.apache.myfaces.STRICT_JSF_2_REFRESH_TARGET_AJAX</name>
+ <fieldName>INIT_PARAM_STRICT_JSF_2_REFRESH_TARGET_AJAX</fieldName>
+ <desc>Detect if a target (usually head) should be update for the current view in an ajax render
+operation</desc>
+ <longDesc>Detect if a target (usually head) should be update for the current view in an ajax render
+operation. This is activated if a css or js resource is added dynamically by effect of a refresh
+(c:if, ui:include src="#{...}" or a manipulation of the tree). This ensures ajax updates of content
+using ui:include will be consistent. Note this behavior is a myfaces specific extension, so to ensure strict compatibility with the spec,
+set this param to false (default false).</longDesc>
+ <defaultValue>false</defaultValue>
+ <expectedValues>true, false</expectedValues>
+ <sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
+ <since>2.0.10</since>
+ </webConfigParam>
+ <webConfigParam>
+ <name>org.apache.myfaces.STRICT_JSF_2_CC_EL_RESOLVER</name>
+ <fieldName>INIT_PARAM_STRICT_JSF_2_CC_EL_RESOLVER</fieldName>
+ <desc>Change default getType() behavior for composite component EL resolver, from return null (see JSF 2_0 spec section 5_6_2_2) to
+use the metadata information added by composite:attribute, ensuring components working with chained EL expressions to find the
+right type when a getType() is called over the source EL expression</desc>
+ <longDesc>Change default getType() behavior for composite component EL resolver, from return null (see JSF 2_0 spec section 5_6_2_2) to
+use the metadata information added by composite:attribute, ensuring components working with chained EL expressions to find the
+right type when a getType() is called over the source EL expression.
+
+To ensure strict compatibility with the spec set this param to true (by default is false, so the change is enabled by default).</longDesc>
+ <defaultValue>false</defaultValue>
+ <expectedValues>true, false</expectedValues>
+ <sourceClassName>org.apache.myfaces.shared.config.MyfacesConfig</sourceClassName>
+ <since>2.0.10</since>
+ <group>EL</group>
+ </webConfigParam>
+ <webConfigParam>
<name>org.apache.myfaces.FLASH_SCOPE_DISABLED</name>
<fieldName>FLASH_SCOPE_DISABLED_PARAM</fieldName>
- <desc>Defines whether flash scope is disabled</desc>
- <longDesc>Defines whether flash scope is disabled.</longDesc>
+ <desc>Defines whether flash scope is disabled, preventing add the Flash cookie to the response</desc>
+ <longDesc>
+<![CDATA[
+Defines whether flash scope is disabled, preventing add the Flash cookie to the response.
+
+<p>This is useful for applications that does not require to use flash scope, and instead uses other scopes.</p>
+]]>
+ </longDesc>
<defaultValue>false</defaultValue>
<sourceClassName>org.apache.myfaces.shared.context.flash.FlashImpl</sourceClassName>
<since>2.0.5</since>
@@ -7967,28 +8121,46 @@ This param only has effect when project
<webConfigParam>
<name>org.apache.myfaces.RESOURCE_MAX_TIME_EXPIRES</name>
<fieldName>RESOURCE_MAX_TIME_EXPIRES</fieldName>
- <desc>Set the max time in miliseconds set on the "Expires" header for a resource</desc>
- <longDesc>Set the max time in miliseconds set on the "Expires" header for a resource.
+ <desc>Set the max time in miliseconds set on the "Expires" header for a resource rendered by
+the default ResourceHandler</desc>
+ <longDesc>Set the max time in miliseconds set on the "Expires" header for a resource rendered by
+the default ResourceHandler.
(default to one week in miliseconds or 604800000)</longDesc>
<defaultValue>604800000</defaultValue>
<sourceClassName>org.apache.myfaces.shared.resource.BaseResourceHandlerSupport</sourceClassName>
<since>2.0</since>
+ <group>resources</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RESOURCE_HANDLER_CACHE_SIZE</name>
<fieldName>RESOURCE_HANDLER_CACHE_SIZE_ATTRIBUTE</fieldName>
- <desc>no description</desc>
+ <desc>Controls the size of the cache used to check if a resource exists or not</desc>
+ <longDesc>
+<![CDATA[
+Controls the size of the cache used to check if a resource exists or not.
+
+<p>See org.apache.myfaces.RESOURCE_HANDLER_CACHE_ENABLED for details.</p>
+]]>
+ </longDesc>
<defaultValue>500</defaultValue>
<sourceClassName>org.apache.myfaces.shared.resource.ResourceHandlerCache</sourceClassName>
<since>2.0.2</since>
+ <group>resources</group>
+ <tags>performance</tags>
+ <classType>java.lang.Integer</classType>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.RESOURCE_HANDLER_CACHE_ENABLED</name>
<fieldName>RESOURCE_HANDLER_CACHE_ENABLED_ATTRIBUTE</fieldName>
- <desc>no description</desc>
+ <desc>Enable or disable the cache used to "remember" if a resource handled by the default ResourceHandler exists or not</desc>
+ <longDesc>Enable or disable the cache used to "remember" if a resource handled by the default ResourceHandler exists or not.</longDesc>
<defaultValue>true</defaultValue>
+ <expectedValues>true,false</expectedValues>
<sourceClassName>org.apache.myfaces.shared.resource.ResourceHandlerCache</sourceClassName>
<since>2.0.2</since>
+ <group>resources</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.USE_ENCRYPTION</name>
@@ -7999,6 +8171,7 @@ This param only has effect when project
<expectedValues>true,false</expectedValues>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.SECRET</name>
@@ -8011,6 +8184,7 @@ for instructions on how to configure an
different encryption strengths.</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ALGORITHM</name>
@@ -8020,6 +8194,8 @@ different encryption strengths.</longDes
<defaultValue>DES</defaultValue>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.SECRET.CACHE</name>
@@ -8029,6 +8205,7 @@ different encryption strengths.</longDes
when the returned SecretKey for encryption algorithm is not thread safe.</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ALGORITHM.IV</name>
@@ -8037,6 +8214,7 @@ when the returned SecretKey for encrypti
<longDesc>Defines the initialization vector (Base64 encoded) used for the encryption algorithm</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.ALGORITHM.PARAMETERS</name>
@@ -8046,6 +8224,7 @@ when the returned SecretKey for encrypti
<defaultValue>ECB/PKCS5Padding</defaultValue>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.SERIAL_FACTORY</name>
@@ -8057,6 +8236,8 @@ by state manager into a byte array. The
org.apache.myfaces.shared.util.serial.SerialFactory interface.</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.COMPRESS_STATE_IN_CLIENT</name>
@@ -8067,6 +8248,8 @@ org.apache.myfaces.shared.util.serial.Se
<expectedValues>true,false</expectedValues>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
<since>1.1</since>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.MAC_ALGORITHM</name>
@@ -8077,6 +8260,8 @@ added to the view state</desc>
added to the view state.</longDesc>
<defaultValue>HmacSHA1</defaultValue>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
+ <group>state</group>
+ <tags>performance</tags>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.MAC_SECRET</name>
@@ -8086,6 +8271,7 @@ on the Message Authentication Code algor
<longDesc>Define the initialization code that are used to initialize the secret key used
on the Message Authentication Code algorithm</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
+ <group>state</group>
</webConfigParam>
<webConfigParam>
<name>org.apache.myfaces.MAC_SECRET.CACHE</name>
@@ -8094,6 +8280,7 @@ on the Message Authentication Code algor
<longDesc>If is set to "false", the secret key used for MAC algorithm is not cached. This is used
when the returned SecretKey for mac algorithm is not thread safe.</longDesc>
<sourceClassName>org.apache.myfaces.shared.util.StateUtils</sourceClassName>
+ <group>state</group>
</webConfigParam>
</webConfig>
-</model>
+</model>
\ No newline at end of file