[JAVASERVERFACES_SPEC_PUBLIC-1066] JavaDoc for Application#getNavigationHandler() method does not mention the navigation-handler within the application element of faces-config Created: 26/Jan/12 Updated: 04/Sep/15 Resolved: 04/Sep/15
|Component/s:||Documentation: Javadoc, TLDDoc, RenderkitDoc, PDF|
|Affects Version/s:||2.0, 2.1, 2.0 Rev a, 2.1 Rev a, 2.2 Sprint 1, 2.2 Sprint 2, 2.2 Sprint 3, 2.2 Sprint 4, 2.2 Sprint 5, 2.2 Sprint 6, 2.2 Sprint 7, 2.2 Sprint 8, 2.2 Sprint 9|
|Reporter:||Neil Griffin||Assignee:||Neil Griffin|
|Remaining Estimate:||Not Specified|
|Time Spent:||Not Specified|
|Original Estimate:||Not Specified|
There is a documentation bug/omission in the JSF 2.0/2.1 JavaDoc. Specifically, the omission is that the Application#getNavigationHandler() method  is supposed to let you specify a wrappable implementation from the <navigation-handler> within the <application> element of faces-config. The feature is formally specified in the faces-config XML Schema . I just checked and both Mojarra  and MyFaces  implement this feature.
Please refer to the Application#getResourceHandler() method  for an example of how to describe this feature in JavaDoc.
|Comment by Ed Burns [ 01/Aug/14 ]|
Set priority to baseline ahead of JSF 2.3 triage. Priorities will be assigned accurately after this exercise.
|Comment by Neil Griffin [ 03/Sep/15 ]|
I recommend that the following language be added to the JavaDoc for Application#getNavigationHandler(), which is based on the JavaDoc found in Application#getResourceHandler():
|Comment by Manfred Riem [ 04/Sep/15 ]|
Applied to 2.3 trunk,
svn commit -m "Fixes https://java.net/jira/browse/JAVASERVERFACES_SPEC_PUBLIC-1066, JavaDoc for Application#getNavigationHandler() method does not mention the navigation-handler within the application element of faces-config"