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 2014/02/11 03:55:32 UTC
svn commit: r1566968 -
/myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext
Author: lu4242
Date: Tue Feb 11 02:55:32 2014
New Revision: 1566968
URL: http://svn.apache.org/r1566968
Log:
test how to fix documentation
Modified:
myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext
Modified: myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext
URL: http://svn.apache.org/viewvc/myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext?rev=1566968&r1=1566967&r2=1566968&view=diff
==============================================================================
--- myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext (original)
+++ myfaces/site/cms-site/trunk/content/wiki/core/faq.mdtext Tue Feb 11 02:55:32 2014
@@ -58,8 +58,7 @@ href="http://myfaces.apache.org/mail-lis
lists</a> and send your suggestions there. In this way, a MyFaces PMC
member could help to include that feature on the Expert Group.</p>
-<h3>What is the difference between javax.faces.STATE_SAVING_METHOD client
-and server? </h3>
+### What is the difference between javax.faces.STATE_SAVING_METHOD client and server? ###
<p>In short, server-side-state stores information held by the UI components
(ie the "widgets") in the HTTP Session, while client-side state
@@ -84,7 +83,7 @@ href="http://java.sun.com/javaee/5/docs/
</ul>
-<h3>The Browser always shows a link to the previous page. Why?</h3>
+### The Browser always shows a link to the previous page. Why? ###
<p>By default, JSF uses "forward" operations internally to
navigate between pages.</p>
@@ -134,9 +133,9 @@ impossible for page A to pass any data t
variables. Using request-scoped variables for this purpose is quite
convenient and therefore quite common.</p>
-<h2>Myfaces FAQ </h2>
+## Myfaces FAQ ##
-<h3>Why should I use MyFaces Core?</h3>
+### Why should I use MyFaces Core? ###
<p><em>"... Every Java EE application server comes with a bundled JSF
implementation. Often the reference implementation (RI), known as
@@ -195,8 +194,8 @@ is handled "in home").</li>
href="http://lu4242.blogspot.com/2011/06/10-reason-why-choose-myfaces-core-as.html">this
blog</a>.</p>
-<h3>I have a problem. Should I open a JIRA issue on it or ask about it on
-the mailing list? </h3>
+### I have a problem. Should I open a JIRA issue on it or ask about it on
+the mailing list? ###
<p>Please ask all questions on the !MyFaces users list.</p>
@@ -215,7 +214,7 @@ it's a bug and asked you to open a JIRA
<p>In all other cases, ask first on the users mailing list.</p>
-<h3>How can I donate new components?</h3>
+### How can I donate new components? ###
<p>There are various ways, you can send a note in the mailing list of
!MyFaces for direct contact with the developers and guidance on what to do,
@@ -224,7 +223,7 @@ href="https://issues.apache.org/jira/bro
tracker</a>. There are no strict rules for the participation at the
sandbox, all you need is some good components.</p>
-<h3>Where can I download source code jars?</h3>
+### Where can I download source code jars? ###
<p>Source for released versions of MyFaces Core can be found here:</p>
@@ -274,7 +273,7 @@ rel="nofollow">http://www.ibiblio.org/ma
</ul>
-<h3>Where can I download a sandbox jar? </h3>
+### Where can I download a sandbox jar? ###
<p>Binaries of not-yet-released code can be grabbed from the maven build
repositories.</p>
@@ -301,7 +300,7 @@ rel="nofollow">https://repository.apache
</ul>
-<h3>What is the "shared" project? </h3>
+### What is the "shared" project? ###
<p>If myfaces-core, tomahawk, tobago and trinidad were completely separate
projects, then there would be no need for a "shared" code
@@ -344,7 +343,7 @@ jars so adding an extra sources jar is n
<p>Since version 2.0.8 and 2.1.2, shared code was bundled as a module in
core, to make easier work with MyFaces Core.</p>
-<h3>How can I get pretty-formatted HTML output from Myfaces?</h3>
+### How can I get pretty-formatted HTML output from Myfaces? ###
<p>The [<ac:link><ri:page ri:content-title="JTidy" /><ac:link-body>http://jtidy.sourceforge.net</ac:link-body></ac:link>](<ac:link><ri:page-ri:content-title="jtidy"-/><ac:link-body>http://jtidy.sourceforge.net</ac:link-body></ac:link>.html)
project provides a [<ac:link><ri:page ri:content-title="Servlet Filter" /><ac:link-body>http://jtidy.sourceforge.net/multiproject/jtidyservlet/filter.html</ac:link-body></ac:link>]
@@ -360,8 +359,7 @@ web.xml to enable pretty output. However
supported as it requires support from every renderer in order to work. This
feature may be removed from future versions of MyFaces.</p>
-<h3>What do version numbers mean for the MyFaces Core and Tomahawk
-releases?</h3>
+### What do version numbers mean for the MyFaces Core and Tomahawk releases? ###
<p>MyFaces Core uses 3-part version numbers, eg 1.1.1. However this value
is different from the usual version numbering. The first two digits
@@ -389,7 +387,7 @@ match exactly (due to the way the "
This has since been improved, and recent Tomahawk releases have a good
chance of working with multiple versions of MyFaces Core.</p>
-<h3>Why isn't javax.faces.model.DataModel serializable?</h3>
+### Why isn't javax.faces.model.DataModel serializable? ###
<p>The DataModel class (used with UIData components) doesn't have any state
that needs to be preserved between render and restore-view phases.
@@ -415,7 +413,7 @@ managed bean, then do this:</p>
}
}
-<h3>Why are my dates displaying the wrong day/time?</h3>
+### Why are my dates displaying the wrong day/time? ###
<p>The JSF specification requires that date->string converters default
to using the standard UTC (aka GMT) timezone.</p>
@@ -450,13 +448,13 @@ server:</p>
converter, causing your custom code to be applied by default to all
date->string conversions.</p>
-<h3>How can I access one Managed Bean from another?</h3>
+### How can I access one Managed Bean from another? ###
<p>See <a
href="https://cwiki.apache.org/confluence/display/MYFACES/Accessing+one+managed+bean+from+another">Accessing
one managed bean from another</a></p>
-<h3>Handling forward references to components in JSP pages</h3>
+### Handling forward references to components in JSP pages ###
<p>Note: this information applies only to projects using JSF 1.1 and JSP.
Projects using either JSF 1.2 or Facelets can ignore this section.</p>
@@ -499,7 +497,7 @@ problem.</p>
uses separate "create" and "render" passes; Facelets
and Clay both do this.</p>
-<h3>How do I know when a managed bean's properties have all been set?</h3>
+### How do I know when a managed bean's properties have all been set? ###
<p>A managed bean must have a default constructor (ie one with no
parameters). Any managed-property declarations then cause the appropriate
@@ -540,7 +538,7 @@ rel="nofollow">https://javaserverfaces-s
</ul>
-<h3>"My PhaseListener is called twice"</h3>
+### "My PhaseListener is called twice" ###
<p>The JSF specification requires any JSF implementation to automatically
load /WEB-INF/faces-config.xml at startup. There is consequently no need
@@ -559,8 +557,7 @@ registering each phase listener twice.</
<p>If you are using portlets, see [<ac:link><ri:page ri:content-title="MYFACES-1338" /><ac:link-body>http://issues.apache.org/jira/browse/MYFACES-1338</ac:link-body></ac:link>](<ac:link><ri:page-ri:content-title="myfaces-1338"-/><ac:link-body>http://issues.apache.org/jira/browse/myfaces-1338</ac:link-body></ac:link>.html)
</p>
-<h3>"Action listeners and actions for my commands on dataTables do not
-fire" </h3>
+### "Action listeners and actions for my commands on dataTables do not fire" ###
<p>Action listeners and actions are not invoked when the action source (
h:commandLink, h:commandButton ) is not rendered. When our action sources
@@ -588,12 +585,12 @@ bean in session scope.</p>
<p>t:saveState is preffered over a session scoped solution.</p>
-<h3>Calendar, Tree, etc wont work or javascript errors</h3>
+### Calendar, Tree, etc wont work or javascript errors ###
<p>You have to configure the MyFacesExtensionsFilter - see: [<a href="http://myfaces.apache.org/tomahawk/extensionsFilter.html">http://myfaces.apache.org/tomahawk/extensionsFilter.html</a>](<a-href="http://myfaces.apache.org/tomahawk/extensionsfilter.html">http://myfaces.apache.org/tomahawk/extensionsfilter.html</a>.html)
</p>
-<h3>Error "ExtensionsFilter not correctly configured."</h3>
+### Error "ExtensionsFilter not correctly configured." ###
<p>If you are getting the error "java.lang.!IllegalStateException:
!ExtensionsFilter not correctly configured. JSF mapping missing. JSF pages
@@ -606,7 +603,7 @@ request.getDispatcher().forward to any p
is not executed. Instead you may want to try with a
response.sendRedirect()</p>
-<h3>The Tomahawk ExtensionsFilter is not working on Websphere</h3>
+### The Tomahawk ExtensionsFilter is not working on Websphere ###
<p>You may need to set the special websphere property
com.ibm.ws.webcontainer.invokefilterscompatibility to true.</p>
@@ -619,137 +616,128 @@ to act<br />
like every other servlet engine on planet earth, and run the filters in all
cases.</p>
-<h3>Using the tomahawk :popup tag causes java.lang.NullPointerException in
-HtmlPopupRenderer.encodeEnd </h3>
+### Using the tomahawk :popup tag causes java.lang.NullPointerException in HtmlPopupRenderer.encodeEnd ###
<p>The facet name needs to be hard coded "popup".</p>
-<h3>ClassCastException in com.sun.facelets.tag.jsf.ActionSourceRule when
-using the tomahawk dataScroller</h3>
+### ClassCastException in com.sun.facelets.tag.jsf.ActionSourceRule when using the tomahawk dataScroller ###
<p>Update to the latest Tomahawk jar from <a class="external-link"
href="http://myfaces.apache.org/download.html"
rel="nofollow">http://myfaces.apache.org/download.html</a></p>
-<h3>Using the tomahawk you get java.lang.NoClassDefFoundError:
-org/apache/commons/lang/builder/HashCodeBuilder</h3>
+### Using the tomahawk you get java.lang.NoClassDefFoundError: org/apache/commons/lang/builder/HashCodeBuilder ###
<p>Download the latest jakarta commons jars (inside the MyFaces Core 1.1.3
or later distribution) from <a class="external-link"
href="http://myfaces.apache.org/download.html"
rel="nofollow">http://myfaces.apache.org/download.html</a></p>
-<h3>WARNING: The AdfFacesFilter has not been installed. ADF Faces requires
-this filter for proper execution.</h3>
+### WARNING: The AdfFacesFilter has not been installed. ADF Faces requires this filter for proper execution. ###
<p>Use a servlet-name in web.xml: adfFaces Faces Servlet ... where you've
assigned "Faces Servlet" as the name of the FacesServlet as below
Faces Servlet javax.faces.webapp.FacesServlet 1</p>
-<h3>The ADF component doesn't popup anything or submit (no javascript
-working). Error: submitForm is not defined </h3>
+### The ADF component doesn't popup anything or submit (no javascript working). Error: submitForm is not defined ###
<p>You need to define how the ADF resources (such as .js files and images)
are provided in web.xml resources
oracle.adf.view.faces.webapp.ResourceServlet resources /adf/*</p>
-<h3>The MyFaces component doesn't popup anything or submit (no javascript
-working).</h3>
+### The MyFaces component doesn't popup anything or submit (no javascript working).###
<p>You need to define how the MyFaces resources (such as .js files and
images) are provided in web.xml with a MyFacesExtensionsFilter entry.</p>
-<h3>NullPointerException in adf faces at the start of the render phase OR
-rendering warnings</h3>
-<ac:macro ac:name="code"><ac:plain-text-body><
-, rendererType = oracle.adf.Group
-Mar 21, 2006 12:10:15 AM
-org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
-Unsupported component-family/renderer-type:
-oracle.adf.Command/oracle.adf.Link
-Mar 21, 2006 12:10:15 AM oracle.adf.view.faces.component.UIXComponentBase _getRendererImpl WARNING: Could not find renderer for CoreCommandLink[CommandLinkFacesBean, id=_id41](commandlinkfacesbean,-id=_id41.html)
-, rendererType = oracle.adf.Link
-Mar 21, 2006 12:10:15 AM
-org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
-Unsupported component-family/renderer-type:
-oracle.adf.Output/oracle.adf.Formatted
-SEVERE: Error Rendering View[/main.xhtml](/main.xhtml.html)
- java.lang.NullPointerException at
-oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.setRenderingProperty(FacesRenderingContext.java:157)
-at
-oracle.adfinternal.view.faces<WBR>.ui.RenderedNodeRenderingContex<WBR>t.setProperty(RenderedNodeRenderingContext<WBR>.java:162)
-at
-oracle.adfinternal.view.faces<WBR>.ui.RootRenderingContext.init(RootRenderingContext.java:81)
-at oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext.
-(FacesRenderingContext.java:106) at
-oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.createRenderingContext(FacesRenderingContext.java:79)
-at
-oracle.adfinternal.view.faces<WBR>.uinode.UINodeRendererBase<WBR>.getRenderingContext(UINodeRendererBase.java:89)
-at
-oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:66)
-at
-oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:52)
-at
-oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.getRenderingContext(UINodeRenderer.java:79)
-at
-oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.encodeBegin(UINodeRenderer.java:38)
-at
-javax.faces.component.UICompone<WBR>ntBase.encodeBegin(UIComponentBase.java:512)
-at
-com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:555)
-at
-com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
-at
-com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
-at
-com.sun.facelets.FaceletViewHan<WBR>dler.renderView(FaceletViewHandler.java:457)
-at
-org.apache.myfaces.lifecycle<WBR>.LifecycleImpl.render(LifecycleImpl.java:367)
-at
-javax.faces.webapp.FacesServlet<WBR>.service(FacesServlet.java:138) at
-org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:252)
-at
-org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
-at
-org.apache.myfaces.webapp<WBR>.filter.ExtensionsFilter<WBR>.doFilter(ExtensionsFilter.java:130)
-at
-org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:202)
-at
-org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
-at
-org.apache.catalina.core<WBR>.StandardWrapperValve.invoke(StandardWrapperValve.java:213)
-at
-org.apache.catalina.core<WBR>.StandardContextValve.invoke(StandardContextValve.java:178)
-at
-org.apache.catalina.authenticat<WBR>or.AuthenticatorBase.invoke(AuthenticatorBase.java:432)
-at
-org.apache.catalina.core<WBR>.StandardHostValve.invoke(StandardHostValve.java:126)
-at
-org.apache.catalina.valves<WBR>.ErrorReportValve.invoke(ErrorReportValve.java:105)
-at
-org.apache.catalina.core<WBR>.StandardEngineValve.invoke(StandardEngineValve.java:107)
-at
-org.apache.catalina.connector<WBR>.CoyoteAdapter.service(CoyoteAdapter.java:148)
-at
-org.apache.coyote.http11<WBR>.Http11Processor.process(Http11Processor.java:869)
-at
-org.apache.coyote.http11<WBR>.Http11BaseProtocol$Http11Conne<WBR>ctionHandler.processConnection(Http11BaseProtocol.java:667)
-at
-org.apache.tomcat.util.net<WBR>.PoolTcpEndpoint.processSocket(PoolTcpEndpoint.java:527)
-at
-org.apache.tomcat.util.net<WBR>.LeaderFollowerWorkerThread<WBR>.runIt(LeaderFollowerWorkerThread.java:80)
-at
-org.apache.tomcat.util.threads<WBR>.ThreadPool$ControlRunnable.run(ThreadPool.java:684)
-at
-java.lang.Thread.run(Thread.java:595)
+### NullPointerException in adf faces at the start of the render phase OR rendering warnings ###
-]
-]></ac:plain-text-body></ac:macro>
+ :::text
+ Mar 21, 2006 12:10:15 AM
+ org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+ Unsupported component-family/renderer-type:
+ oracle.adf.Panel/oracle.adf.Group
+ Mar 21, 2006 12:10:15 AM oracle.adf.view.faces.component.UIXComponentBase _getRendererImpl WARNING: Could not find renderer for CorePanelGroup[UIXFacesBeanImpl, id=_id38](uixfacesbeanimpl,-id=_id38.html)
+ , rendererType = oracle.adf.Group
+ Mar 21, 2006 12:10:15 AM
+ org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+ Unsupported component-family/renderer-type:
+ oracle.adf.Command/oracle.adf.Link
+ Mar 21, 2006 12:10:15 AM oracle.adf.view.faces.component.UIXComponentBase _getRendererImpl WARNING: Could not find renderer for CoreCommandLink[CommandLinkFacesBean, id=_id41](commandlinkfacesbean,-id=_id41.html)
+ , rendererType = oracle.adf.Link
+ Mar 21, 2006 12:10:15 AM
+ org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+ Unsupported component-family/renderer-type:
+ oracle.adf.Output/oracle.adf.Formatted
+ SEVERE: Error Rendering View[/main.xhtml](/main.xhtml.html)
+ java.lang.NullPointerException at
+ oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.setRenderingProperty(FacesRenderingContext.java:157)
+ at
+ oracle.adfinternal.view.faces<WBR>.ui.RenderedNodeRenderingContex<WBR>t.setProperty(RenderedNodeRenderingContext<WBR>.java:162)
+ at
+ oracle.adfinternal.view.faces<WBR>.ui.RootRenderingContext.init(RootRenderingContext.java:81)
+ at oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext.
+ (FacesRenderingContext.java:106) at
+ oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.createRenderingContext(FacesRenderingContext.java:79)
+ at
+ oracle.adfinternal.view.faces<WBR>.uinode.UINodeRendererBase<WBR>.getRenderingContext(UINodeRendererBase.java:89)
+ at
+ oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:66)
+ at
+ oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:52)
+ at
+ oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.getRenderingContext(UINodeRenderer.java:79)
+ at
+ oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.encodeBegin(UINodeRenderer.java:38)
+ at
+ javax.faces.component.UICompone<WBR>ntBase.encodeBegin(UIComponentBase.java:512)
+ at
+ com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:555)
+ at
+ com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
+ at
+ com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
+ at
+ com.sun.facelets.FaceletViewHan<WBR>dler.renderView(FaceletViewHandler.java:457)
+ at
+ org.apache.myfaces.lifecycle<WBR>.LifecycleImpl.render(LifecycleImpl.java:367)
+ at
+ javax.faces.webapp.FacesServlet<WBR>.service(FacesServlet.java:138) at
+ org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:252)
+ at
+ org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
+ at
+ org.apache.myfaces.webapp<WBR>.filter.ExtensionsFilter<WBR>.doFilter(ExtensionsFilter.java:130)
+ at
+ org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:202)
+ at
+ org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
+ at
+ org.apache.catalina.core<WBR>.StandardWrapperValve.invoke(StandardWrapperValve.java:213)
+ at
+ org.apache.catalina.core<WBR>.StandardContextValve.invoke(StandardContextValve.java:178)
+ at
+ org.apache.catalina.authenticat<WBR>or.AuthenticatorBase.invoke(AuthenticatorBase.java:432)
+ at
+ org.apache.catalina.core<WBR>.StandardHostValve.invoke(StandardHostValve.java:126)
+ at
+ org.apache.catalina.valves<WBR>.ErrorReportValve.invoke(ErrorReportValve.java:105)
+ at
+ org.apache.catalina.core<WBR>.StandardEngineValve.invoke(StandardEngineValve.java:107)
+ at
+ org.apache.catalina.connector<WBR>.CoyoteAdapter.service(CoyoteAdapter.java:148)
+ at
+ org.apache.coyote.http11<WBR>.Http11Processor.process(Http11Processor.java:869)
+ at
+ org.apache.coyote.http11<WBR>.Http11BaseProtocol$Http11Conne<WBR>ctionHandler.processConnection(Http11BaseProtocol.java:667)
+ at
+ org.apache.tomcat.util.net<WBR>.PoolTcpEndpoint.processSocket(PoolTcpEndpoint.java:527)
+ at
+ org.apache.tomcat.util.net<WBR>.LeaderFollowerWorkerThread<WBR>.runIt(LeaderFollowerWorkerThread.java:80)
+ at
+ org.apache.tomcat.util.threads<WBR>.ThreadPool$ControlRunnable.run(ThreadPool.java:684)
+ at
+ java.lang.Thread.run(Thread.java:595)
<p>Make sure your FaceletViewHandler is commented out and the default
render kit of ADF faces defined in faces-config.xml oracle.adf.core (Note
@@ -762,7 +750,7 @@ oracle.adf.view.faces.webapp.AdfFacesFil
<p>Thanks to Murray Brandon for the initial contribution.</p>
-<h3>Select Items stop working in MyFaces 1.1.5</h3>
+### Select Items stop working in MyFaces 1.1.5 ###
<p>MyFaces 1.1.4 and earlier did not correctly implement the select
components. Although the behavior was nice, the components were not